Kimi Code 如何接入 Kimi K3.1 Pro：三条路径全流程

发布日期：2026-10-24 ｜ 数据截至 2026-10-24，来源为 Kimi Code 官方 GitHub 仓库（MoonshotAI/kimi-code，v2.3.1）及 Kimi 开放平台

Kimi Code 是月之暗面推出的终端 AI 编程 Agent，开箱对接 Kimi 系列模型，支持读写代码、执行 Shell 命令、抓取网页，并可在 Zed、JetBrains 等 IDE 中通过 ACP 协议集成。2026 年 10 月 24 日 Kimi K3.1 Pro 正式发布后，Kimi Code 支持切换到该模型，涵盖 CLI 界面内的交互切换和 config.toml 配置文件两条路径；对于已有其他编程工具（opencode、Cursor、Roo Code 等）的开发者，K3.1 Pro 同样支持通过兼容 OpenAI 接口的第三方 API 端点接入。本文按"全新安装 → 登录 → 切换模型"的顺序逐步说明，并附上 config.toml 配置片段和常见报错的处理方法，模型 ID 为 kimi-k3.1-pro，Highspeed 版为 kimi-k3.1-pro-highspeed。

---

Kimi Code 是什么，和 Kimi K3.1 Pro 什么关系

Kimi Code CLI 是一个运行在终端的 AI 编程 Agent，底层由 Moonshot AI 模型驱动。默认模型为 K2.7 Code，从 K3.1 Pro 发布当天起，可以通过 TUI 内的 /provider 命令或配置文件切换到 K3.1 Pro。

K3.1 Pro 在 Kimi Code 里的优势主要体现在：

• Terminal-Bench 4.0 编程智能体基准得分 65.7%，超过 GPT-6 Astra（58.2%），逼近 Claude Opus 5.5（66.4%）
• 新增 medium 思考强度档，可按任务复杂度选 low / medium / high / max 四档
• Highspeed 版在同等智能水平下输出速度 2-3 倍，适合实时补全场景

第一步：安装 Kimi Code CLI

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

Windows 用户需要先安装 Git for Windows，Kimi Code 使用其中的 Git Bash 作为 Shell 环境。如果 Git Bash 安装在非标准路径，将 KIMI_SHELL_PATH 设为 bash.exe 的绝对路径。

安装完成后验证：

kimi --version

也可以用 npm 安装，包名为 @moonshot-ai/kimi-code（当前版本 2.3.1）：

npm install -g @moonshot-ai/kimi-code

第二步：登录，拿到 K3.1 Pro 的调用权限

进入任意项目目录，启动 Kimi Code：

cd your-project
kimi

在 TUI 内输入：

/login

弹出两个选项：

• Kimi Code OAuth：用 Kimi 账号授权，适合直接用 kimi.com 账号的用户
• Moonshot AI Open Platform API Key：适合已有 Kimi 开放平台账号、想精确控制用量和账单的开发者

选 API Key 路径时，需要先在 platform.kimi.com 创建一个 Key，复制后粘贴到提示框。Key 会写入 ~/.kimi-code/auth.json，不需要手动设环境变量。

第三步：切换到 K3.1 Pro

方式 A：在 TUI 内交互切换（推荐新手）

启动 Kimi Code 后，在对话框输入：

/provider

在弹出的 Provider Manager 界面里找到 Kimi 官方提供商，选择模型列表，切换到 kimi-k3.1-pro。

如果模型列表里还没出现 K3.1 Pro，执行一次刷新：

/provider refresh

注意：在已有对话历史的 Session 中切换模型会弹出确认框，提示"切换模型会使已有提示缓存失效，建议用 /new 开新会话避免额外 Token 消耗"。如果用量敏感，选"开新会话"更划算。

方式 B：写入 config.toml 设为默认

配置文件路径：~/.kimi-code/config.toml（不存在则新建）

最小配置片段，把 K3.1 Pro 设为默认模型：

[model]
default = "kimi-k3.1-pro"

设置思考强度（可选）：

[thinking]
effort = "medium"   # low / medium / high / max

保存后重启 Kimi Code 生效。如果想保留 K3.1 Pro 为主力、K2.7 Code 为快速切换备选：

[model]
default = "kimi-k3.1-pro"

然后在 TUI 内用 /provider 随时切换。

方式 C：IDE 集成（Zed / JetBrains）

Kimi Code CLI 支持 Agent Client Protocol（ACP），ACP 兼容的编辑器可以直接驱动会话。登录一次后不需要重复登录。

Zed 在 ~/.config/zed/settings.json 中加入：

{
  "agent_servers": {
    "Kimi Code CLI": {
      "type": "custom",
      "command": "kimi",
      "args": ["acp"],
      "env": {}
    }
  }
}

在 Zed 的 Agent 面板新建对话后，用 /provider 命令切换到 K3.1 Pro，方式与 CLI 相同。JetBrains 配置参考官方文档的 IDE 集成说明。

切换后验证是否生效

在 TUI 状态栏底部有 model 字段，显示当前使用的模型名。如果显示 kimi-k3.1-pro，说明切换成功。

也可以在对话里直接问：

你用的是哪个模型？

标准版 vs Highspeed 版怎么选

场景	推荐版本	原因
复杂多文件重构、长上下文代码库分析	kimi-k3.1-pro	推理更深，适合一次性吃进大量上下文
实时代码补全、快速问答	kimi-k3.1-pro-highspeed	2-3 倍输出速度，等待感更短
预算敏感的批量任务	kimi-k3.1-pro	Highspeed 版定价为标准版 2 倍

两个版本的智能水平官方标注为"相同"，差别只在速度和价格。

用其他编程工具（opencode、Cursor、Roo Code）接 K3.1 Pro

K3.1 Pro 和 K3 一样支持通过兼容 OpenAI 接口的端点接入任意编程 Agent 工具，三要素：

• Base URL ：https://api.moonshot.cn/v1（Kimi 官方开放平台）
• API Key：Kimi 开放平台创建的 Key
• Model ID ：kimi-k3.1-pro

以 opencode 为例，在 ~/.config/opencode/opencode.json 中配置：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "kimi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Kimi",
      "options": {
        "baseURL": "https://api.moonshot.cn/v1"
      },
      "models": {
        "kimi-k3.1-pro": {
          "name": "Kimi K3.1 Pro"
        },
        "kimi-k3.1-pro-highspeed": {
          "name": "Kimi K3.1 Pro Highspeed"
        }
      }
    }
  }
}

API Key 通过 opencode 的 /connect 命令写入，不要硬编码在配置文件里。

如果已有七牛云 Token Plan 等多模型 API 订阅，K3.1 Pro 上线后只需在控制台确认模型已收录，Base URL 和 Key 不变，只把 Model ID 改为 kimi-k3.1-pro 即可。

常见报错

报错	原因	处理方法
model not found: kimi-k3.1-pro	K3.1 Pro 尚未同步到本地模型列表	执行 /provider refresh 拉取最新列表
This API key has expired	Key 在服务端失效	去 Kimi 开放平台重新生成 Key，执行 /login 替换
This model is not available in your country	地区限制	切换其他模型或检查网络环境
切换模型后仍用旧模型	Session 内缓存未清除	执行 /new 开新会话

总结

Kimi Code 接入 K3.1 Pro 的核心路径：安装 CLI → /login 绑定 API Key → /provider 切换或 config.toml 写入默认模型。模型 ID 为 kimi-k3.1-pro，高速版为 kimi-k3.1-pro-highspeed。本文配置格式来自 Kimi Code CLI 官方 GitHub 仓库（v2.3.1，2026-10-24），如果后续版本字段有变动以官方文档为准。

延伸阅读

• Kimi Code CLI 官方文档：moonshotai.github.io/kimi-code/zh/
• Kimi Code CLI GitHub：github.com/MoonshotAI/kimi-code
• Kimi 开放平台定价（含 K3.1 Pro）：platform.kimi.com/docs/pricing/chat
• opencode 提供商配置文档：opencode.ai/docs/providers
• 七牛云Token Plan（kimi模型低至1.2折）：https://www.qiniu.com/ai/plan