在 Codex 中直接管理 SSH 主机、执行远程命令和传输文件。
Codex SSH 是一个本地 stdio MCP 插件,支持:
- 首次运行自动导入
~/.ssh/config,包括常见Include文件 - 通过 Codex 添加、删除和重新导入主机
- 使用稳定
alias和中文displayName - 支持用户明确提供的明文密码并保存在本地配置中,不会从工具结果回传
- 命令执行、目录浏览、文件读写和上传下载
- TOFU/固定指纹主机校验、命令策略、输出和文件大小限制
- 插件内置安全卸载器
irm https://raw.githubusercontent.com/skaduv/codex-ssh/v0.6.2/install.ps1 | iexcurl -fsSL https://raw.githubusercontent.com/skaduv/codex-ssh/v0.6.2/install.sh | bash安装完成后:
- 新建 Codex 会话。
- 输入“列出 SSH 主机”,或直接指定 Codex SSH。
- 如需添加机器,输入“通过 Codex SSH 添加机器 prod”。
要求 Codex 支持插件和本地 stdio MCP,Node.js 版本为 20 或更高。
codex plugin marketplace add skaduv/codex-ssh --ref main
codex plugin add codex-ssh@skaduv刷新插件市场或重启 Codex 后,从 Plugins 中启用 Codex SSH。
默认插件配置:
~/.codex-ssh/servers.json
默认导入:
~/.ssh/config
示例:
{
"hosts": {
"prod": {
"displayName": "生产服务器 A",
"host": "10.0.0.20",
"port": 22,
"username": "deploy",
"auth": {
"type": "password",
"password": "本地保存的密码"
},
"defaultCwd": "/srv/app"
}
}
}用户可以直接在聊天中提供密码,Codex 会将其写入本地配置。该密码会出现在对应的工具调用记录中, 但不会出现在工具返回值或主机列表中;如果需要防范 Codex 其他本地文件工具访问配置文件, 请限制 Codex 的文件系统权限或使用独立系统账户。
完整使用说明见 插件 README。
在 Codex 中说:
卸载 Codex SSH 插件
或运行独立卸载器:
node plugins/codex-ssh/scripts/uninstall.mjs --project-root .卸载器会处理 Windows 下 MCP 原生模块占用导致的 Access Denied,并默认保留主机配置。
cd plugins/codex-ssh
npm install
npm run check
npm run buildserver/dist/index.cjs 是提交到仓库的自包含 MCP 服务,因此从 GitHub 安装不需要在插件目录
运行 npm install。
本插件使用本地 stdio MCP。根据 OpenAI 官方文档,本地 MCP 插件属于 Desktop only 插件,公开提交目前只对获批合作伙伴开放。准备材料见 PUBLISHING.md。
MIT