CLI Agents
在 VS Code 里查找、恢复并继续本机 Linux 服务器上的原生 Codex、Claude Code 和 OpenCode 会话。会话由各 CLI 自己保存和执行，插件只负责列出、读取、恢复和接管，不复制历史，也不另配模型 API key。
安装
在 Windows（或本机）的 VS Code 里通过 Remote - SSH 连接运行 CLI 的 Linux 主机，然后在扩展市场搜索 CLI Agents 并安装到 SSH 主机。安装时 VS Code 会自动把 CLI Agents Window 一并装到本地，不需要在服务器上手工操作。
要求：
- VS Code 1.143 或更高，已安装 Remote - SSH。
- Linux x64 主机，Node.js 18+，以及至少一个原生 CLI：
codex（需支持 app-server --listen unix://PATH）、claude、opencode。
- CLI 需已在服务器上登录。插件会在
~/.local/bin、~/.npm-global/bin、~/.bun/bin、~/.opencode/bin、~/.claude/local、~/.volta/bin 和登录 shell 的 PATH 里自动查找，一般不用配置路径。
使用
- 打开远程项目，点击活动栏的 CLI Agents 图标，进入官方 Agents Window。
- 左侧栏列出最近活动的会话；30 天内未打开的历史（最多 100 条）在底部 Done 分区。
- 命令面板（F1）：
CLI Agents: 浏览全部原生历史：按时间分批加载并过滤全部历史，每行有“打开并恢复”按钮。CLI Agents: 搜索原生历史、CLI Agents: 恢复原生历史会话。CLI Agents: 新建原生会话、CLI Agents: 连接原生终端。
- 历史会话先以只读预览打开。点标题栏的恢复图标后，插件确认原 CLI 没有在别处占用该会话才会放开输入；草稿不会自动发送。
设置
都是远程主机（Machine）设置，通常保持默认：
| 设置 |
默认 |
说明 |
cliSessions.codexPath / claudePath / opencodePath / nodePath |
自动查找 |
找不到命令时填绝对路径 |
cliSessions.claudeMode |
interactive |
Claude 的执行方式 |
cliSessions.opencodeTerminalPath |
空 |
OpenCode 原生终端交接所需的独立补丁版可执行文件；留空时该功能不可用，聊天、历史和恢复不受影响 |
已知限制
- 仅支持 Linux x64 远程主机。
- 超大的 Codex 历史（超过约 28 MB）恢复时只展开最近消息，较早内容保留在原生历史里。
- 恢复校验按已验证的 Codex 版本放行（0.160.1、0.166.0-alpha.1、0.167.0），其他版本只能只读预览。
- 不会自动重发未确认的消息或授权；断线后先检查历史再决定是否重发。
开发与验证笔记见 docs/usage/developer-notes.md（仓库内，不随扩展发布）。
| |
