🤖 AI 跟我学 新手入门

Kimi Code 接入 Cursor / Claude Code 配置全指南

Kimi Code 接入 Cursor、Roo Code、Claude Code 等第三方编程 agent 的官方配置方法,API 端点、模型名、登录技巧一篇讲清

发布 2026/05/18 📎 参考官方文档

30 秒了解:为什么要把 Kimi Code 接到第三方 agent

Kimi Code 不只能在自家 CLI 和 VS Code 插件 里用——它的 API 端点 OpenAI 兼容,可以接到 Cursor、Claude Code、Roo Code 等主流第三方 AI 编程工具里,让这些工具用 Kimi 模型做后端。

适用场景:

  • 要保留 Cursor 的现代 IDE 体验,但模型走国内合规 + 人民币付款
  • 已经习惯 Claude Code 的工作流,想在国内场景下用 Kimi 模型替代 Claude
  • 想拼装 Roo Code / Cline 这种开源 VS Code 插件,但找一个性价比高的模型后端
  • 公司禁止数据出境,但又喜欢某个海外开源工具的交互

谁应该开启:已经在用 Cursor / Claude Code / Cline / Roo Code 任意一个,又想试试 Kimi 模型的人

⚠️ Kimi 官方限制:根据 kimi.com/zh-cn/help/kimi-code/third-party-agentsKimi Code 权益仅支持在 Kimi Code CLI、Claude Code、Roo Code 中使用。其他工具(如 Cursor 直接接入)属于「OpenAI 兼容方式调用 API」,按 Kimi 开放平台的 API 计费而非 Code 权益。下面会分情况说明。

准备工作

  1. Kimi 账号 + API Key:去 platform.moonshot.cn 注册,控制台里创建 API Key
  2. 要接入的目标工具:Cursor / Claude Code / Roo Code / Cline / Zed / 任何 OpenAI 兼容工具
  3. 确认计费方式
    • 用 Kimi Code CLI / Claude Code / Roo Code → 走 Kimi Code 权益(吃 Kimi 会员额度)
    • 用其他工具 → 走 Kimi 开放平台 API(按 token 计费)

不熟悉 Kimi Code 本身的话,先看 Kimi Code 是什么 入门。

核心 API 配置参数(所有工具通用)

参数
API 端点(Base URL)https://api.kimi.com/coding/v1
模型名kimi-k2.5
认证方式API Key
协议OpenAI 兼容

💡 模型名和端点以官方文档为准——版本会更新。如果上面值在某天失效,去 kimi.com/zh-cn/help/kimi-code/third-party-agents 查最新。

详细操作步骤

第 1 步:拿到 Kimi API Key

打开 platform.moonshot.cn,登录后进 API Keys 页面,点「创建」,复制 Key(只显示一次,存好)。

[此处放截图:Kimi 控制台 API Key 创建页面]

💡 建议给不同工具创建独立 Key,方便后续追踪用量和吊销。

第 2 步(路径 A):接入 Cursor

适合场景:你已经在用 Cursor,想换模型省钱 / 走国内。

  1. 打开 Cursor,按 Cmd+,(Mac)/ Ctrl+,(Win)进设置
  2. 找到「Models」配置区
  3. 添加自定义模型,选「OpenAI Compatible」类型
  4. 填入:
    • Base URL: https://api.kimi.com/coding/v1
    • API Key: 你的 Kimi Key
    • Model: kimi-k2.5
  5. 保存,然后在 Chat / Composer 里选这个新模型

⚠️ 走 Cursor 接入属于「OpenAI 兼容 API 调用」,按 Kimi 开放平台 token 计价,不吃 Kimi Code 会员额度。要省钱可以在 Kimi 控制台设月度预算上限。

第 3 步(路径 B):接入 Claude Code

适合场景:你想保留 Claude Code 的强大 CLI 工作流,但换 Kimi 当模型后端。

按 Kimi 官方文档,需要绕过 Claude Code 的默认登录,通过环境变量启动:

Mac / Linux:

export ANTHROPIC_BASE_URL=https://api.kimi.com/coding/v1
export ANTHROPIC_API_KEY=你的_Kimi_Key
claude

Windows(PowerShell):

$env:ANTHROPIC_BASE_URL = "https://api.kimi.com/coding/v1"
$env:ANTHROPIC_API_KEY = "你的_Kimi_Key"
claude

启动后在 Claude Code 里敲:

/status

确认显示的是 Kimi 模型而不是 Anthropic 默认模型。

💡 这条路径下,Kimi Code 权益生效——会从你的 Kimi 会员额度扣,不走 token 计价。

Thinking 模式快捷键

  • macOS:Option+T
  • Windows / Linux:Alt+T

第 4 步(路径 C):接入 Roo Code

适合场景:你在 VS Code 里想要一个开源的、能接任意模型的编程 agent。

  1. 在 VS Code 扩展市场装 Roo Code
  2. 打开 Roo Code 设置
  3. Provider 选「OpenAI Compatible」
  4. 填入:
    • Base URL: https://api.kimi.com/coding/v1
    • API Key: 你的 Kimi Key
    • Model: kimi-k2.5
  5. 保存即可使用

💡 Roo Code 也在 Kimi 官方权益清单里,所以走会员额度,不走 token 计价。

第 5 步(路径 D):接入 Cline / 其他通用工具

Cline 是另一个流行的 VS Code AI agent 插件,配置方式跟 Roo Code 类似:

  1. 装 Cline
  2. 设置 Provider 为 OpenAI Compatible
  3. 填上面的 Base URL / API Key / Model

⚠️ Cline 不在 Kimi 官方权益清单里,会按 API token 计价。

其他兼容 OpenAI API 的工具(Zed 编辑器、Zsh 插件、自研脚本等),按同样的三件套(Base URL / Key / Model)填入即可。

第 6 步:验证配置成功

不管哪条路径,配置完后跑一个小测试:

你好,请用一句话告诉我:你是什么模型?

如果返回的回答提到 Kimi / K2,说明配置成功。

5 个第三方接入的高级玩法

  1. Claude Code + Kimi 国内重型任务:用 Claude Code 的 CLI 体验做大重构,但模型走国内、合规、便宜
  2. Cursor 双模型策略:日常用 Cursor 自带 GPT,关键长任务切到 Kimi——同一 IDE 内一键切换
  3. Roo Code 开源 + Kimi 模型:完全开源 + 国产模型 + 国内合规,适合需要极致合规的团队
  4. 多 Key 分组追踪用量:给每个项目 / 每个团队成员配独立 Key,方便用量审计
  5. 设月度预算上限:Kimi 开放平台支持设上限,防止意外烧钱

常见坑 + 解决办法

现象原因解决
配置完返回 401API Key 错 / 已吊销重建 Key,确认复制完整
返回 404Base URL 写错确认是 https://api.kimi.com/coding/v1,结尾不带斜杠
返回模型不存在模型名写错kimi-k2.5(具体以官方文档为准)
Cursor 选了新模型但没生效没在 Chat 面板切换在 Chat 顶部模型下拉里手动选
Claude Code 还在用默认 Anthropic环境变量没生效确认在同一个终端会话里设的;或重启终端
用量超出预期没在 Kimi 控制台设上限platform.moonshot.cn 设月度预算
国外朋友配不通Kimi API 主要服务国内部分海外网络访问 api.kimi.com 不稳,可能要切节点

一个实战案例:用 Cursor + Kimi 写一个 Astro 站点

我自己在 Cursor 里配了 Kimi 当备用模型。日常用 Cursor 自带 GPT 写小 patch,遇到大块改动切到 Kimi(长上下文是强项)。

举个具体例子,给一个 Astro 站点加多语言支持:

在 Cursor Composer 里选 Kimi 模型,跑:

📋 Prompt 模板

请帮我给这个 Astro 站点加上中英双语支持。

要求:

  1. 用 Astro 官方推荐的 i18n 方案,不依赖第三方包
  2. 现有的所有页面(src/pages 下)保留中文版,复制一份到 src/pages/en 作为英文版
  3. 英文版页面里所有中文字符串需要翻译——你直接帮我翻译,专业术语保留英文
  4. 加一个语言切换组件(src/components/LangSwitcher.astro),放在 Header 里
  5. 修改 astro.config.mjs 配置 i18n
  6. 改完后给我一个 README 段说明语言切换的工作原理

请按这个顺序一步一步做,每完成一步告诉我并 diff 给我看。

Kimi 长上下文能一次读完整个 src 目录,处理这种「跨多文件、需要一致性翻译」的任务特别合适。Cursor 提供 diff 视图体验,Kimi 提供长上下文能力——拼起来比单用任意一个都猛

进阶 / 下一步