将 Kimi K3.1 Pro 接入 Kimi Code CLI：安装、登录与 Windows 陷阱

Kimi Code CLI 是 Moonshot 的终端编码智能体，也是唯一一个将 Kimi K3.1 Pro 作为默认模型而非第三方集成的客户端。其设置比 Claude Code 或 Codex 路线更短——一个安装脚本、一次 /login、一个平台选择——因为客户端和模型来自同一家公司。需要注意的是平台特定问题：在 Windows 上，CLI 运行在其捆绑的 Git Bash 中，如果该 shell 不在安装程序预期位置，工具会启动，然后以看似模型错误的方式失败。

这是可行的操作顺序，已于 2026 年 10 月 24 日对照 Moonshot 的文档核对，并在故障模式实际出现的位置予以标注。

安装

macOS 和 Linux 只需一行：curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash。Windows PowerShell 也只需一行：irm https://code.kimi.com/kimi-code/install.ps1 | iex。该脚本会下载最新版本、校验其校验和，并将 kimi 可执行文件添加到你的 PATH 中。无需 Node.js 或 Python 运行时。

Windows 有一个容易忽略的前提条件：请先安装 Git for Windows。Kimi Code CLI 使用随附的 Git Bash 作为其 shell 环境。如果 Git Bash 位于非标准位置，请在启动前将 KIMI_SHELL_PATH 环境变量设置为 bash.exe 的绝对路径——否则代理会启动，但它尝试运行的每条 shell 命令都会失败。

使用 API 密钥登录

在你想要工作的项目目录中启动 CLI：

• 运行 kimi 以打开交互界面。

• 输入 /login。Kimi Code CLI 会打开平台选择器。

• 选择 Kimi Platform（API 密钥 · platform.kimi.ai）此选项适用于在开放平台上创建的密钥；其他选项对应不同的账户入口。

• 粘贴密钥。如果没有密钥，请在 platform.kimi.ai 的 API Keys 下创建一个。CLI 会将其存储在本地，因此请将配置目录视为凭据存储库。

这就是全部的连接关系。CLI 里的模型选择器会列出当前的 Kimi 模型，其中对智能体（agentic）工作真正重要的是 Kimi K3.1 Pro 及其高速版本这两款。

切换现有设置，并更换密钥

有两种常见的迁移情形，二者都会经过同一个界面。如果 Kimi Code CLI 已经通过订阅而不是 API 密钥登录，那么再次运行 /login 并选择 API 密钥平台，即可在不重新安装的情况下完成切换。如果你正在轮换密钥——因为它泄露了，或者因为某个项目需要独立的计费——同样的流程会替换已存储的凭据。

唯一不要做的事，就是在 CLI 运行期间手动编辑已存储的配置；该进程会在启动时读取凭据，而会话中途的编辑会在退出时被覆盖。

智能体实际做什么

Kimi Code CLI 不是终端里的聊天窗口。它会读取和编辑代码、搜索代码仓库、运行命令并读取结果，在任务需要项目之外的内容时，还能引入网页内容或进行搜索。Moonshot 将其描述为一个运行在你自己机器上的编码 agent，由模型负责规划——形态与 Claude Code 或 Codex 相同，在权限方面也有相同的含义：一个能够运行 shell 命令的 agent，应当在你愿意让它修改的目录中启动，并且在推送任何内容之前先经过审查。

这位客户同时涉及两种计费模式。Kimi Code 应用以订阅形式出售，并设有不同套餐层级；而 CLI 既可使用该订阅，也可使用来自开放平台的 API 密钥。API 密钥路径提供的是按 token 计费的成本结构——K3.1 Pro 为每百万 token 2.00 美元和 10.00 美元，高速版本为 4.00 美元和 20.00 美元——而订阅则是带配额的固定费用。对于已经在其他地方支付 API 使用费的团队，密钥路径可将支出集中在一处；对于整天写代码的个人，订阅通常更便宜，而且无论采用哪种方式，CLI 都是同一个下载。

选择模型和投入程度

Kimi K3.1 Pro 始终会进行推理，其 effort 通过一个顶层字段设置，该字段接受 low、high 和 max，默认值为 max。Kimi Code CLI 会暴露该模型；effort 的默认值是成本较高的那个，因此感觉缓慢的会话通常是运行在 max 档位的会话，而不是连接出了问题。高速变体以价格换低延迟——每百万 token 为 $4.00 和 $20.00，而不是 $2.00 和 $10.00——对于模型本来就在等待人类的交互式工作来说，这是合理的默认选择。

有两条约束会跟随模型进入任何客户端：采样参数是固定的（temperature 1.0、top-p 0.95、n 为 1），并且在对话中途更改 effort 会使前缀缓存命中失效。请在会话开始时确定级别。

这条路线与 Claude Code 和 Codex 相比如何

这三个客户端使用三种不同的协议来访问同一个模型，选择主要取决于你的团队已经习惯使用哪种接口。Kimi Code CLI 的配置最少：不需要环境块，也不需要 TOML 文件，而且供应商维护两端。Claude Code 需要正确设置兼容 Anthropic 的端点和四个模型层级变量，Codex 需要一个带 wire_api = "responses" 的 provider 块，但两者随后都能对接任何支持这些协议的提供商——包括同时提供其他厂商模型的网关。

实际的分工方式：当 Kimi 是你唯一需要的模型、并且你想走最短路径时，使用 Kimi Code CLI；当同一个会话必须在不同厂商之间切换，或者你团队的工具、权限和技能已经存在于那些客户端中时，使用 Claude Code 或 Codex。

能节省时间的故障排查顺序

• CLI 启动后没有任何 shell 命令执行——请先检查 Git Bash 和 KIMI_SHELL_PATH，然后再归咎于模型。

• 在设置已正常工作后出现身份验证错误——请重新运行 /login，并确认平台选项与创建密钥时所在平台一致；来自不同界面的密钥不可互换。

• 会话感觉变慢时——在更换模型之前，先检查 effort 的默认值；max 在延迟和 token 消耗上都很昂贵。

• 更新后出现“找不到模型”——CLI 会列出平台所提供的模型；如果缺少 K3.1 Pro，说明客户端指向的是尚未更新的界面。

平台上的 Kimi K3.1 Pro 价格为每百万输入 token $2.00、每百万输出 token $10.00，上下文长度为 1M token，输出 token 最高可达 943,718 个。如果你想通过其他工具已在使用的 API 访问它，OrcaRouter 会按供应商标价提供相同模型 kimi/kimi-k3.1-pro，且不额外加价——该路由的配置已在 Claude Code 和 Codex 指南中说明。