摘要TermPilot 是开源 SSH 客户端支持 Windows、macOS、Linux。正向连接时把ssh userhost -p 端口粘进去就能保存。Cursor、Claude Code、Codex 这类 Agent 可以操作同一条已经登录的 SSH密码留在本机危险命令会先等你点允许。同一条ssh userhost -p 2222我在 Windows 上敲过太多次。系统自带的 OpenSSH 能连上下次还是得把地址、端口、用户名重新想一遍。更麻烦的是把服务器交给 AI助手自己去连就要把密码交出去连上之后这次调用结束目录和正在跑的程序也对不上。TermPilot 把这条命令收成左侧的一条连接。你在窗口里登录账号存在这台电脑上。Agent 接着操作的是这个还没断开的会话按键打进当前画面你看得到。仓库在 github.com/xy200303/termpilot安装包在 Releases。这篇写两件事怎么做正向 SSH以及Agent 怎么操作这条 SSH。没有公网地址的机器怎么连回来、远程文件怎么改后面分开写。正向 SSH 是什么正向就是你平时敲的那种 SSH。机器有 IP 或域名你从本机连过去。TermPilot 左侧「连接」里这一类单独放在「正向 SSH」下面。一台机器可以存多个账号按主机收在一起。搜索框能按名称或地址找。点连接名称会直接打开终端。主机那一行右边的加号是在这台机器上再加一个账号主机已经锁死不用重填。新建连接粘贴 ssh 命令点「正向 SSH」右边的加号弹出「新建正向 SSH」。说明就一句本机作为客户端主动 SSH 到有地址的服务器。第一格叫「粘贴命令」。把终端里那条命令贴进去例如ssh ubuntu203.0.113.10 -p 22名称、主机、端口、用户名会按这条命令填上。端口没写时按 22。带-i的私钥路径也能认出来。认证有两种密码或私钥。选私钥再填路径私钥有口令就填口令。口令写在本机不会进代码仓库Agent 也不会向你再要一遍。名称、主机、用户名齐了填上密码点保存。这条就会出现在对应主机下面。上面的203.0.113.10是文档里的示例地址用来看粘贴之后表单怎么拆。保存之后怎么打开连接名称上右键菜单里有复制为 Agent 提示词、连接、复制、编辑、删除。左键点名称和菜单里的「连接」是一回事。上面多一个标签终端里就是这台机器。窗口最下面写着当前这条正向 SSH 的用户和地址免得开了好几台还对不上。本机终端也在左侧「本机终端」里和远程标签排在同一行。远程这边有选中文字时CtrlC是复制没选中时是中断当前命令CtrlV粘贴。Agent 可以操作这条 SSH人和 Agent 用的是同一套连接、同一个终端。你先在 TermPilot 里登上去Cursor、Claude Code、Codex、Kimi Code、WorkBuddy、CodeBuddy 再接着敲命令、看输出、截画面。已经打开的终端会接着用不会为了同一件事再连一次。第一次要在设置里打开 MCP 并保存。软件不会在首次启动时自己打开。监听只在本机Agent 要带令牌才能连。令牌留在你电脑上的mcp.json里Windows 是%APPDATA%\TermPilot\mcp.json。删文件、写系统路径这类危险操作会先在窗口里等你点允许。设置里还有一页「Agent 接入」可以把 TermPilot 写进上面那些助手的配置只改名为 termpilot 的那一条。也可以把下面这段话直接发给助手让它自己装好请安装 TermPilot 配套 skill读取 https://raw.githubusercontent.com/xy200303/termpilot/main/skills/termpilot/SKILL.md 并安装到你的用户级 skills 目录再读取本机 TermPilot 的 mcp.jsonWindows 是 %APPDATA%\TermPilot\mcp.json只把名为 termpilot 的 MCP 注册到你自己的配置里其它服务器不要动完成后用这个 skill 操作 TermPilot。接上之后在某一条正向 SSH 上右键「复制为 Agent 提示词」贴到对话里。复制出来的是会话名称、主机、用户、端口这个终端已经打开时还会带上termId。助手就按这一份去连不用你再口述地址。它能做的和你在窗口里做的是同一件事列出已保存的连接、连上、执行命令、把按键打进当前画面、读终端输出、列远程目录、上传下载以及截当前画面或一段滚动内容。菜单和安装向导还停在屏幕上时助手按的是方向键和回车回到命令提示符之后再执行下一条命令。密码和验证码仍然由你在窗口里输入。MCP 没接上时也可以在本机运行termpilot。窗口没开时这条命令会先把 TermPilot 打开操作的还是同一个窗口。连上之后看服务器文件左侧从「连接」切到「文件」。文件树跟着当前这条正向 SSH走已经建立的连接不用再开端口也不用再输一遍密码。Agent 列目录、改文件走的也是这条连接。目录可以展开。双击文本能改CtrlS写回服务器。文件编辑留到后面那篇细说这里先能看到连上的是哪台文件就是哪台的。下载最新安装包在 ReleasesWindows、macOS、Linux 都有。从源码跑的话仓库里npm install然后npm run dev。会话记在本机数据库里。Windows 上是%APPDATA%\TermPilot\termpilot.db。下一篇写没有公网地址时的反向监听。