Claude Code
Claude Code 是 Anthropic 提供的编程 Agent 产品,界面、配置项和支持能力可能随版本变化。本文说明一种通用接入方案:通过环境变量将 Claude Code 的模型请求转发到 Kimi Code API。
开始之前
- 确保你已经订阅 Kimi 会员并开通 Kimi Code 权益。
- 获取 API Key:
- 进入 Kimi Code 控制台;
- 点击「新建 API Key」,输入名称后确认;
- 复制生成的 Key 并妥善保存(关闭弹窗后无法再次查看完整 Key)。

配置流程
Claude Code 是 Anthropic 推出的命令行编程助手。通过配置环境变量将其接入 Kimi 的 API 端点,你就能在 Claude Code 中直接调用 Kimi Code 的 AI 能力,在熟悉的终端交互里获得 Kimi Code 的编程体验。
① 安装 Claude Code
安装方式请参考 Claude Code 官方文档。
│
② 执行脚本,跳过登录流程
安装完成后,不要直接启动 Claude。先在终端执行以下脚本,跳过 Anthropic 默认的登录流程并清理历史配置:
其中 settings.json 清理部分仅删除 env 中的端点、密钥与模型相关变量(这些残留会覆盖终端里 export 的同名环境变量),不影响其他配置。另外请检查 ~/.zshrc、~/.bashrc 等 shell 配置文件中是否残留旧的 ANTHROPIC_* export(Windows 用户请检查用户环境变量),如有请一并删除。
│
③ 配置 API 接入
模型上新推荐
K2.8 Preview 现已全量上线 Kimi Code,kimi-for-coding 直接升级、无需修改配置:综合性能接近 K3,支持 low / high / max 三档思考程度与最高 1M 上下文。详见 最新动态。
请先根据自己的会员档位确认可用的模型与上下文窗口(新老套餐规则对比见 会员权益):
| 会员档位 | 可配置模型 | 可用上下文上限 |
|---|---|---|
| Go(新套餐) | 无 coding 额度 | — |
| Andante(老套餐) | kimi-for-coding | 1048576 |
| Plus / Moderato | k3k3-256kkimi-for-coding | k3:262144k3-256k:262144kimi-for-coding:1048576 |
| Pro 及以上 / Allegretto 及以上 | k3k3-256kkimi-for-codingkimi-for-coding-highspeed | k3:1048576k3-256k:262144kimi-for-coding:1048576kimi-for-coding-highspeed:262144 |
提供两种配置方式,任选其一,不要混用:方式一写入 settings.json 配置文件,长期生效、任何方式启动都生效;方式二在当前终端临时 export,仅对当前会话有效。
方式一:写入 settings.json(推荐,长期生效)
settings.json 的路径:
将以下配置写入该文件的 env 字段(文件不存在则新建):
保存后重启 Claude Code 生效。
明文密钥风险
settings.json 中的 API Key 以明文存储,请勿将该文件提交到版本仓库或随 dotfiles 公开分享;该文件的 env 会覆盖终端里 export 的同名变量。
方式二:终端环境变量(仅当前会话)
K3-256K 配置如下:
K3 1M 上下文配置如下:
注意 k3[1m] 写法仅在 Claude Code 环境变量场景需要
k3[1m](以及外层的引号)用来明确告诉 Claude Code 把上下文窗口设为 1M;其它场景(例如 API 请求、其它第三方工具的 Model ID 字段)只需填 k3 即可。
配置项说明
Claude Code 内部会按场景使用不同档位的模型(主对话、后台摘要、子 Agent 等),只配置部分变量会让对应场景静默失败:
| 变量 | 作用 | 不配置或配置错误的影响 |
|---|---|---|
ANTHROPIC_BASE_URL | 将模型请求转发到 Kimi Code 端点 | 请求被发往 Anthropic 官方端点,鉴权失败 |
ANTHROPIC_API_KEY | 使用 Kimi Code API Key 鉴权 | 返回 401 鉴权错误 |
ANTHROPIC_MODEL | 主对话使用的模型 | 使用 Claude 默认模型名,Kimi Code 端点无法识别,报模型不存在错误 |
ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL / ANTHROPIC_DEFAULT_HAIKU_MODEL / ANTHROPIC_DEFAULT_FABLE_MODEL | Claude Code 按任务档位选择模型时使用的模型名 | 对应档位的任务(如 haiku 档的后台标题生成、摘要)请求失败 |
CLAUDE_CODE_SUBAGENT_MODEL | 子 Agent 使用的模型 | 子任务请求失败或效果明显变差 |
CLAUDE_CODE_AUTO_COMPACT_WINDOW | 触发自动压缩上下文的窗口大小 | 需与模型上下文一致:k3[1m] 为 1048576,其余模型为 262144;设置过小会过早压缩丢失上下文,过大则报上下文超限错误 |
CLAUDE_CODE_MAX_CONTEXT_TOKENS | 最大上下文 token 数 | 同上,需与所选模型的上下文窗口一致 |
CLAUDE_CODE_EFFORT_LEVEL | 默认思考档位,K3 推荐设为 high | 较低值可能在复杂任务上降低质量 |
切换模型时,请把配置中所有模型变量的值一并替换为新模型名。
切换思考档位
启动后在会话中输入 /effort 即可切换思考档位,无需配置环境变量。K3 与 K2.8 Preview 均支持 low / high / max 三档且档位一致,Claude Code 的档位与实际档位的映射关系如下:
| Claude Code 档位 | 实际档位 |
|---|---|
low | low |
medium | high(推荐) |
high | high(推荐) |
xhigh | max |
max | max |
| 未设置(默认) | high(K3)/ max(K2.8 Preview) |
注意
关闭 thinking 后路由到 K2.8 Preview 无思考版:K3 系列与 K2.8 Preview 关闭 thinking 后,请求均由 K2.8 Preview(无思考)处理;thinking 快捷键 macOS 为 Option+T,Windows / Linux 为 Alt+T。
启动后若提示是否使用该 API key,确认使用即可。随后按照指引选择你信任的项目文件夹,完成授权即可。

│
④ 启动后验证
启动后输入 /status,如果返回信息中显示 Base URL 为 https://api.kimi.com/coding/,则配置成功。此时即使模型名称仍显示为 Claude 模型,实际调用的仍是 Kimi Code 的 API。

│
在 VS Code 插件中使用
插件自带 Claude Code 程序,与命令行共用 ~/.claude 下的配置。按以下步骤接入:
- 按方式一的「配置流程」完成 API 接入配置。
- 打开插件新建会话,出现登录页面时点击底部的 Run
claudein terminal:

- 在弹出的终端中依次完成两个确认:信任目录选择 Yes, I trust this folder;API Key 确认选择 1. Yes:

- 完全退出 VS Code 后重新打开,即可在插件中直接对话。
如果不经过终端确认就使用插件,插件会缺少 API Key 的确认登记,发送消息时会反复弹出登录页面。
常见问题
修改配置后不生效
检查 ~/.claude/settings.json 的 env 中是否有残留旧配置(会覆盖终端环境变量),可执行第 ② 步中的清理脚本;另外终端中 export 的变量只对当前会话有效,重开终端后需要重新设置;如果写入了 settings.json,请确认修改后重启了 Claude Code。
返回 401 鉴权错误
检查 ANTHROPIC_API_KEY 是否为有效的 Kimi Code API Key,注意 Key 只在创建时完整展示一次。
提示模型不存在(model not found)
检查各模型变量的值是否拼写正确(如 k3-256k、k3[1m]),注意不要携带多余空格或引号。
后台任务或子 Agent 报错
通常是 ANTHROPIC_DEFAULT_HAIKU_MODEL、ANTHROPIC_DEFAULT_FABLE_MODEL 或 CLAUDE_CODE_SUBAGENT_MODEL 未配置,对应场景请求了 Kimi Code 端点无法识别的模型名,请对照「配置项说明」补齐。
VS Code 插件一直弹出登录页面
插件缺少 API Key 的确认登记。详细操作见「在 VS Code 插件中使用」。
本文是否对你有帮助