Kimi Code CLI 2.5.0 远程环境：用 SSH 运行文件与 Shell 工具

2.5.0 把 File 和 Shell 工具交给远程环境执行

Kimi Code CLI v2.5.0 的发布条目日期为 2026-11-04，新增 SSH、Docker 或自定义命令环境，并可在创建会话时用 --environment 绑定目标。官方条目只给出日期，没有精确发布时间或时区。

File 操作和 Shell 命令在远程目标运行；CLI 保留在本机，模型请求从本机发出，凭据和会话状态也由本机保存。这只改变指定工具的执行位置，不能据此认定所有流量经过远端，或代码不会发送给模型提供方。

这与 Desktop 的手机 Remote Control 不同：手机控制功能操作的是运行在本机的桌面会话，CLI 远程环境则把 File/Shell 指向另一台主机或容器。手机控制桌面的说明见 https://puppyip.com/resources/kimi-code-desktop-110-linux-remote-control-guide 。

先准备 SSH 目标端，再在本机声明环境

在远程机器安装与目标平台匹配的 Kimi Code executor，默认路径为 ~/.kimi-code/bin/kimi；CLI 不会自动安装。客户端应已能用 SSH key 登录目标机，需要时在本机 ~/.ssh/config 配好用户名、端口或跳板机；不要把真实密钥或密码放进提示词。

在本机 config.toml 增加 [environments.dev-box]，设置 type = "ssh"、host = "dev-box" 和 defaultCwd = "/home/me/projects"。这里的 dev-box 与路径只是示例；defaultCwd 必须是目标环境上的绝对路径。

如果 executor 不在默认位置，可在该环境项中设置 remoteBin 指向目标端的 executor。此设置文件在本机，SSH 主机名和认证仍由本机 SSH 配置解析。

用新会话指定主机和工作目录

运行 kimi --environment dev-box 创建远程会话。若只想覆盖本次目录，可运行 kimi --environment dev-box --environment-cwd /home/me/another-project；--environment-cwd 必须与 --environment 一起使用。

--environment 和 --environment-cwd 只用于创建会话，不能与 --session 或 --continue 同用。恢复已有会话会自动还原原来的远程环境和工作目录；之后输入 /new 会沿用当前环境，不会重新应用启动参数。

连接断开后，下次工具调用会尝试重连，不会静默改在本机执行。断线期间正在运行的工具调用会失败，CLI 不会自动重试该失败操作；检查网络、SSH 和目标端 executor 后，再由你决定是否重发任务。

Docker、自定义命令和 Windows 目标有不同要求

除 SSH 外，可声明 Docker 兼容容器，或用 command 与 args 定义自定义启动器；同一个环境项不能同时设置 type 和 command。defaultCwd 在任何类型下都必须是目标环境的绝对路径。修改环境启动配置后，下次使用会按新配置重连，并停止正在运行的远程命令。

若目标端是 Windows，先安装 Git for Windows 和 Windows executor，默认执行文件为 ~/.kimi-code/bin/kimi.exe；defaultCwd 使用类似 C:\work\project 的原生盘符路径。Windows 目标支持 SSH 和自定义命令，但不支持 Docker 容器。

确认本地工具、路径和会话边界

WebSearch 与 FetchURL 始终从本机运行；没有 environment_id 的 hooks 和 stdio MCP servers 默认也在本机执行。Subagents 会继承父 Agent 的远程环境，但这不意味着所有工具都会转发到目标端。

提示词中的文件路径按目标端解析，本机路径不能直接由远程环境读取。Tower 模式不能管理远程环境会话；远程会话的本地 Git 状态栏也不可见。

CLI 远程环境文档没有说明会员条件、地区资格或费用；不要把 Desktop Remote Control 的条件套用到 CLI。需要确认账户可用性或价格时，应查看当前官方计划说明。