Kimi Code 接入 Cursor / Claude Code 配置全指南
Kimi Code 接入 Cursor、Roo Code、Claude Code 等第三方编程 agent 的官方配置方法,API 端点、模型名、登录技巧一篇讲清
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-agents,Kimi Code 权益仅支持在 Kimi Code CLI、Claude Code、Roo Code 中使用。其他工具(如 Cursor 直接接入)属于「OpenAI 兼容方式调用 API」,按 Kimi 开放平台的 API 计费而非 Code 权益。下面会分情况说明。
准备工作
- Kimi 账号 + API Key:去
platform.moonshot.cn注册,控制台里创建 API Key - 要接入的目标工具:Cursor / Claude Code / Roo Code / Cline / Zed / 任何 OpenAI 兼容工具
- 确认计费方式:
- 用 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,想换模型省钱 / 走国内。
- 打开 Cursor,按
Cmd+,(Mac)/Ctrl+,(Win)进设置 - 找到「Models」配置区
- 添加自定义模型,选「OpenAI Compatible」类型
- 填入:
- Base URL:
https://api.kimi.com/coding/v1 - API Key: 你的 Kimi Key
- Model:
kimi-k2.5
- Base URL:
- 保存,然后在 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。
- 在 VS Code 扩展市场装 Roo Code
- 打开 Roo Code 设置
- Provider 选「OpenAI Compatible」
- 填入:
- Base URL:
https://api.kimi.com/coding/v1 - API Key: 你的 Kimi Key
- Model:
kimi-k2.5
- Base URL:
- 保存即可使用
💡 Roo Code 也在 Kimi 官方权益清单里,所以走会员额度,不走 token 计价。
第 5 步(路径 D):接入 Cline / 其他通用工具
Cline 是另一个流行的 VS Code AI agent 插件,配置方式跟 Roo Code 类似:
- 装 Cline
- 设置 Provider 为 OpenAI Compatible
- 填上面的 Base URL / API Key / Model
⚠️ Cline 不在 Kimi 官方权益清单里,会按 API token 计价。
其他兼容 OpenAI API 的工具(Zed 编辑器、Zsh 插件、自研脚本等),按同样的三件套(Base URL / Key / Model)填入即可。
第 6 步:验证配置成功
不管哪条路径,配置完后跑一个小测试:
你好,请用一句话告诉我:你是什么模型?
如果返回的回答提到 Kimi / K2,说明配置成功。
5 个第三方接入的高级玩法
- Claude Code + Kimi 国内重型任务:用 Claude Code 的 CLI 体验做大重构,但模型走国内、合规、便宜
- Cursor 双模型策略:日常用 Cursor 自带 GPT,关键长任务切到 Kimi——同一 IDE 内一键切换
- Roo Code 开源 + Kimi 模型:完全开源 + 国产模型 + 国内合规,适合需要极致合规的团队
- 多 Key 分组追踪用量:给每个项目 / 每个团队成员配独立 Key,方便用量审计
- 设月度预算上限:Kimi 开放平台支持设上限,防止意外烧钱
常见坑 + 解决办法
| 现象 | 原因 | 解决 |
|---|---|---|
| 配置完返回 401 | API Key 错 / 已吊销 | 重建 Key,确认复制完整 |
| 返回 404 | Base 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 模型,跑:
请帮我给这个 Astro 站点加上中英双语支持。
要求:
- 用 Astro 官方推荐的 i18n 方案,不依赖第三方包
- 现有的所有页面(src/pages 下)保留中文版,复制一份到 src/pages/en 作为英文版
- 英文版页面里所有中文字符串需要翻译——你直接帮我翻译,专业术语保留英文
- 加一个语言切换组件(src/components/LangSwitcher.astro),放在 Header 里
- 修改 astro.config.mjs 配置 i18n
- 改完后给我一个 README 段说明语言切换的工作原理
请按这个顺序一步一步做,每完成一步告诉我并 diff 给我看。
Kimi 长上下文能一次读完整个 src 目录,处理这种「跨多文件、需要一致性翻译」的任务特别合适。Cursor 提供 diff 视图体验,Kimi 提供长上下文能力——拼起来比单用任意一个都猛。
进阶 / 下一步
- 想看 Kimi Code 主介绍 → Kimi Code 是什么
- 想用纯 Kimi CLI → Kimi Code CLI 怎么用
- 想用 VS Code 插件直接对话 → Kimi Code VS Code 插件实测
- 想看 Cursor 是什么 → Cursor 是什么
- 想看 Claude Code 是什么 → Claude Code 是什么
- 想看 Claude Code 订阅怎么选 → Claude Code 订阅怎么选
- 想看主流工具横评 → AI 写代码完全指南
- 想看更多国产 AI → 国产 AI 大全