返回首页

Claude Code 接入 Kimi Code：终端十分钟，VS Code 登录坑卡了我半小时

Admin 2026年9月13日 16 分钟阅读 14 次阅读 0 条评论
Claude Code 接入 Kimi Code：终端十分钟，VS Code 登录坑卡了我半小时

把 Claude Code 接入 Kimi Code，核心动作只有一个：往 ~/.claude/settings.json 的 env 里写一组变量。终端十分钟搞定。

真正的坑在 VS Code 插件——配置明明是对的，一发消息就跳回登录页。这不是配置错了，是少了一步官方文档里单独写了、但很容易翻漏的「确认登记」。

老张今天下午刚把本机的 Claude Code 从别家端点切到 Kimi Code 的 K3。终端一把过，VS Code 插件卡了半小时，最后翻官方文档的 FAQ 才发现人家早就写了这个坑。整个过程和官方配置一并整理在这篇，照抄就行。

速览

项目内容
接入原理环境变量把 Claude Code 的模型请求转发到 Kimi Code API
端点https://api.kimi.com/coding/
推荐模型k3-256k（日常）/ k3[1m]（1M 上下文）
配置文件~/.claude/settings.json 的 env 字段
最大坑VS Code 插件需在插件内终端做一次 API Key 确认登记
前提Kimi 会员 + 已开通 Kimi Code 权益

最终效果

终端和 VS Code 插件里的 Claude Code，全部走 Kimi Code 的 API。界面、快捷键、斜杠命令不变，底层模型换成 K3。

/status 里 Base URL 显示 https://api.kimi.com/coding/ 即成功。界面上模型名可能仍显示 Claude 模型，这是正常现象——实际调用的已经是 Kimi Code 的 API。

前置准备

  1. 订阅 Kimi 会员，并开通 Kimi Code 权益；
  2. 进 Kimi Code 控制台，点「新建 API Key」，复制保存。Key 只在创建时完整展示一次，关了就再也看不了；
  3. 装好 Claude Code（安装参考 Anthropic 官方文档），装完先别启动。

全流程一图

六步里⑤最容易被漏，老张就是漏在这一步。

第一步：清理旧配置（别跳过）

之前接过别家端点（MiniMax、GLM 等）的，先清残留。官方给了一段 node 脚本，做两件事：

  • 往 ~/.claude.json 写入 penguinModeOrgEnabled 和 hasCompletedOnboarding，跳过 Anthropic 默认登录流程；
  • 删除 ~/.claude/settings.json 里 env 中的旧端点、旧 Key、旧模型变量。

脚本在官方文档「配置流程」第②步，原文复制执行即可：www.kimi.com/code/docs/third-party-tools/claude-code.html

再检查 ~/.zshrc、~/.bashrc 里有没有残留的 export ANTHROPIC_*，有就删掉。

为什么要清？因为这条优先级规则：

settings.json 里 env 的值，会覆盖终端 export 的同名环境变量。

残留一个旧 ANTHROPIC_BASE_URL，你在终端怎么 export 都没用。

第二步：写入 settings.json

官方提供两种配置方式，任选其一，不要混用。推荐方式一，写入配置文件，长期生效、任何方式启动都生效。

把下面内容写进 ~/.claude/settings.json 的 env 字段（文件不存在就新建）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kimi.com/coding/",
    "ANTHROPIC_API_KEY": "<你的 Kimi Code API Key>",
    "ANTHROPIC_MODEL": "k3-256k",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "k3-256k",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "k3-256k",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "k3-256k",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "k3-256k",
    "CLAUDE_CODE_SUBAGENT_MODEL": "k3-256k",
    "CLAUDE_CODE_EFFORT_LEVEL": "high",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "262144",
    "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "262144"
  }
}

保存，重启 Claude Code 生效。

两个提醒：

  • 模型变量要写全套。 Claude Code 内部按场景分档位用模型（主对话、后台摘要、子 Agent），只写 ANTHROPIC_MODEL，对应场景会静默失败——后台标题生成不出来了、子 Agent 报错了，都是这个原因。
  • settings.json 里 Key 是明文。别提交到 git 仓库，别随 dotfiles 公开分享。

第三步：终端验证

终端直接启动：

claude

进入会话后输入 /status，Base URL 显示 https://api.kimi.com/coding/ 就接上了。启动时如果问是否使用该 API key，确认即可。

第四步：VS Code 插件的确认登记（最大的坑）

老张实际踩坑过程：插件能打开、能进会话，一发送消息，就跳回登录页。反复如此。

官方文档 FAQ 里对这个症状有原话：

插件缺少 API Key 的确认登记。如果不经过终端确认就使用插件，发送消息时会反复弹出登录页面。

VS Code 插件自带 Claude Code 程序，和命令行共用 ~/.claude 配置。配置是对的，但插件要你在它眼皮底下确认一次这个 Key。修复四步：

  1. 打开 VS Code 的 Claude Code 插件，新建会话；
  2. 出现登录页面时，点底部的「Run claude in terminal」，不要点登录；
  3. 弹出的终端里完成两个确认：信任目录选 Yes, I trust this folder；API Key 确认选 1. Yes；
  4. Cmd+Q 完全退出 VS Code（不是关窗口），重新打开。

![[Codex/自媒体/图片/2026-09-05-kimi-claude-code-02.png]]

左图红框就是「Run claude in terminal」入口，右图是确认完成后的 Welcome back 界面，模型标识已经是 k3-256k。

修好之后问一句「你用的是什么模型」，返回的模型标识是 k3-256k：

回答正文里它还是会自称 Claude——系统提示词没换，正常现象，看模型标识就行。

会员档位与模型选择

会员档位可配置模型上下文上限
Andantekimi-for-coding262144
Moderatok3 / k3-256k / kimi-for-coding262144
Allegretto 及以上上述全部 + kimi-for-coding-highspeedk3 用 1M，其余 262144

日常问答、代码补全、常规开发，用 k3-256k。官方明确说了：256k 上下文内效果和 k3 相同，而 k3（1M）的消耗约为 k3-256k 的两倍。不是天天塞整个仓库进去的，没必要上 1M。

要用 1M 上下文，把所有模型变量改成 "k3[1m]"，同时 CLAUDE_CODE_AUTO_COMPACT_WINDOW 和 CLAUDE_CODE_MAX_CONTEXT_TOKENS 改成 1048576。注意 k3[1m] 这个写法（含方括号和引号）只在 Claude Code 环境变量场景需要，其它工具的 Model ID 字段填 k3 就行。

还需要 cc-switch 中转吗？不需要了

K2 时代想在 Claude Code 里用 Kimi，基本绕不开 cc-switch 这类工具做中转。老张本机之前也是这么接的。

现在情况变了：Kimi 官方把 Claude Code 和 Codex 的接入都做成了原生支持。Claude Code 走 Anthropic 兼容端点，改一组环境变量直连，官方文档把每一步都写明了（Codex 的接入老张 9 月 3 日也写过一篇，翻公众号主页就能找到）。中间层不再是必需品。

零依赖直连，是现在的首选方案。

那 cc-switch 还有存在价值吗？有，但价值收缩了。它是多供应商的配置中心：把 Claude Code、Codex、Gemini CLI 等工具的供应商统一管起来，GUI 里一键切换，还自带用量看板。它内置「Kimi For Coding」预设，地址就是 https://api.kimi.com/coding/。注意别选错——它里面还有个「Kimi」预设，那是开放平台按量计费的 Key（https://api.moonshot.cn），和会员权益的 Kimi Code 是两套东西。

维度官方原生直连（本文方案）cc-switch
依赖零依赖，就改一个文件需额外安装一个工具
切换成本换端点要重新编辑文件多家供应商一键切换，多工具同步生效
Key 存放settings.json 明文存在 cc-switch 里，live 配置用占位符
可观测性无自带用量看板，按供应商统计花费
适合谁只接 Kimi 一家、长期不换多家模型来回切、多工具同时用

老张的选择：既然官方原生支持了，就把中间层摘掉，少一层依赖少一层牵挂。只有哪家便宜用哪家、天天在几家模型之间横跳的，cc-switch 的一键切换才有意义。

常见坑速查

症状原因
改完配置不生效settings.json 的 env 残留旧配置覆盖了终端变量；或改完没重启
401 鉴权错误API Key 无效或填错，Key 只在创建时展示一次
model not found模型名拼错（如 k3-256k 多空格、多引号）
后台任务 / 子 Agent 报错档位模型变量没配全，对应场景请求了 Kimi 端点不认识的模型名
VS Code 插件反复弹登录页缺确认登记，按第四步走一遍

最后一个使用建议：保持 thinking 开启。关掉 thinking 后 K3 会被路由到 K2.6，白瞎了 K3。会话中输入 /effort 可切档位，K3 推荐 high（Claude Code 的 medium 档实际映射到 K3 的 high）。

🎯 老张建议

  1. 配置方式就选 settings.json 一种，终端临时 export 适合调试，混用容易把自己绕晕；
  2. 遇到「配置明明对就是不生效」，先查 settings.json 的 env 残留，它覆盖一切同名环境变量；
  3. VS Code 插件弹登录页别急着改配置，先去插件里跑一次「Run claude in terminal」完成登记——这是官方流程，不是 bug。

💬 互动话题

  1. 你现在的 Claude Code 接的哪家端点？官方 Claude、Kimi 还是 GLM？
  2. K3 的 256k 上下文，日常开发你够用吗？有没有非要 1M 的场景？
  3. 接入过程中还踩过什么坑？评论区聊聊。

🔗 关注老张

公众号：老张聊运维 小程序：观简国学 个人博客：https://www.shanwaiyun.top/

A

Admin

用文字记录生活与思考。

评论 (0)
暂无评论，来抢沙发吧
Claude Code 接入 Kimi Code：终端十分钟，VS Code 登录坑卡了我半小时 | 山外云的Vlog