xssh 快速开始
本文带你在 Windows 上安装 xssh，并让 Claude Code（或 Codex、Cursor 等其他 agent）通过它操作远程 Linux 服务器。全程约 5 分钟。
1. 安装 xssh
方式一：一行命令（推荐）。 打开 PowerShell 运行：
irm https://xiake.com/xssh/install.ps1 | iex脚本从国内节点下载最新版，校验 SHA-256，安装到 %LOCALAPPDATA%\Programs\xssh，并把该目录加入用户 PATH。已有的 data\ 数据目录会保留，所以升级也用同一条命令。
方式二：手动安装。 在 下载页 下载 zip，解压到任意目录，然后在该目录运行：
.\xssh.exe path add装好后新开一个终端，确认版本：
xssh --versionxssh 是便携程序：整个文件夹就是一份安装，配置和数据都在同目录的
data\中。如果放在Program Files这类不可写的目录，需要用--home或环境变量XSSH_HOME指定数据目录。
2. 为你的 agent 安装 skill
skill 是一份写给 agent 的使用手册（内容等同于 xssh guide），agent 读了它才知道该用 xssh 操作服务器。
xssh guide --install-skill --agent claude-code其他 agent 把 claude-code 换成对应 ID：codex、gemini-cli、github-copilot、cursor、opencode、windsurf、amp、qwen-code、kiro、trae、roo、agents；用 --agent all 安装到本机检测到的全部 agent。skill 在 agent 的下一个会话生效。
也可以在桌面程序 xssh-desktop 的「集成」页面一键安装、更新或移除。
3. 添加服务器
使用密码登录的服务器，由你本人录入密码：
xssh host add web1 --host 10.0.0.5 --user deploy --note "生产 Web 前端" --ask-password密码在终端隐藏输入，存进 Windows 凭据管理器，不会出现在命令行历史、输出或日志里。之后 agent 只需要用别名 web1。
已经配置好密钥登录的服务器无需添加，user@host、IP 或 ~/.ssh/config 里的 Host 可以直接使用；也可以批量导入：
xssh host import --dry-run # 先检查兼容性
xssh host import测试连接：
xssh host test web1
xssh exec web1 -- uptime4. 让 agent 开始工作
在 Claude Code 中直接用自然语言描述任务即可，例如：
用 xssh 登录 web1，看看 nginx 为什么返回 502，修好后告诉我改了什么。
agent 会先运行 xssh host list 查看可用服务器，再用 exec、session、file edit、logs 等命令完成工作。遇到 sudo 密码会自动从钥匙串代填；遇到主机密钥变化会停下来请你确认，不会自动绕过。