> 发布日期：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：**

```sh
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
```

**Windows（PowerShell）：**

```powershell
irm https://code.kimi.com/kimi-code/install.ps1 | iex
```

> Windows 用户需要先安装 [Git for Windows](https://gitforwindows.org/)，Kimi Code 使用其中的 Git Bash 作为 Shell 环境。如果 Git Bash 安装在非标准路径，将 `KIMI_SHELL_PATH` 设为 `bash.exe` 的绝对路径。

安装完成后验证：

```sh
kimi --version
```

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

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


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

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

```sh
cd your-project
kimi
```

在 TUI 内输入：

```
/login
```

弹出两个选项：

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

选 API Key 路径时，需要先在 [platform.kimi.com](https://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 设为默认模型：

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

设置思考强度（可选）：

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

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

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

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

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

Kimi Code CLI 支持 [Agent Client Protocol（ACP）](https://agentclientprotocol.com/)，ACP 兼容的编辑器可以直接驱动会话。登录一次后不需要重复登录。

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

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

在 Zed 的 Agent 面板新建对话后，用 `/provider` 命令切换到 K3.1 Pro，方式与 CLI 相同。JetBrains 配置参考官方文档的 [IDE 集成说明](https://moonshotai.github.io/kimi-code/zh/guides/ides)。

## 切换后验证是否生效

在 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` 中配置：

```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），如果后续版本字段有变动以官方文档为准。


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

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

人工智能

开发工具

KimiCode终端AI编程Agent现已支持Kimi K3.1 Pro，在Terminal-Bench 4.0基准得分65.7%。本文详解三步接入法：安装CLI、登录授权、通过/provider命令或config.toml切换模型，并涵盖IDE集成、API兼容接入及常见报错处理，助力开发者高效使用这一高性能模型。

代码补全

代码解释

智能体

AI编程

GitHub

Linux

Agent

JSON

让每一个 Agent，都跑在云上

tione

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Kimi Code 如何接入 Kimi K3.1 Pro：三条路径全流程-腾讯云开发者社区-腾讯云

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

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

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐