一、准备工作1.1 安装 Claude Code如果你已经安装过 Claude Code可以跳过这一步。macOS / Linux# 安装 Node.js推荐 24.x curl -fsSL https://fnm.vercel.app/install | bash # 重新打开终端后执行 fnm install 24.3.0 fnm default 24.3.0 fnm use 24.3.0 # 安装 Claude Code npm install -g anthropic-ai/claude-code # 初始化配置跳过首次引导 node --eval const os require(os), fs require(fs), path require(path); const fp path.join(os.homedir(), .claude.json); const c fs.existsSync(fp) ? JSON.parse(fs.readFileSync(fp)) : {}; fs.writeFileSync(fp, JSON.stringify({ ...c, hasCompletedOnboarding: true }, null, 2)); WindowsPowerShellwinget install --exact --source winget --id Git.Git winget install --exact --source winget --id OpenJS.NodeJS # 重新打开终端 npm install -g anthropic-ai/claude-code验证安装claude --version # 应输出类似2.1.117 (Claude Code)1.2 获取 Kimi Code API Key前往 Kimi 官网购买会员订阅点击「创建 API Key」复制以sk-kimi-开头的密钥。这个 Key 是后续连接 Kimi k2.6 的凭证请妥善保管。注意Kimi Code 平台api.kimi.com和 Moonshot 开放平台api.moonshot.cn属于独立的认证体系。在该页面获取的 API Key 仅适用于api.kimi.com/coding/端点不可用于api.moonshot.cn。二、核心配置Claude Code 通过读取环境变量来决定连接哪个模型后端。根据 Kimi 官方最新文档正确的配置方式如下2.1 写入 Shell 配置文件根据你的终端类型编辑对应的配置文件ZshmacOS 默认~/.zshrcBash~/.bashrc或~/.bash_profile在文件末尾添加以下内容# # Claude Code Kimi k2.6 配置 # export ANTHROPIC_BASE_URLhttps://api.kimi.com/coding/ export ANTHROPIC_API_KEYsk-kimi-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx # 替换为你的 Key export ANTHROPIC_MODELkimi-for-coding export ANTHROPIC_DEFAULT_OPUS_MODELkimi-for-coding export ANTHROPIC_DEFAULT_SONNET_MODELkimi-for-coding export ANTHROPIC_DEFAULT_HAIKU_MODELkimi-for-coding export CLAUDE_CODE_SUBAGENT_MODELkimi-for-coding export ENABLE_TOOL_SEARCHfalse使配置生效source ~/.zshrc2.2 写入 Claude Code 用户配置可选但推荐Claude Code 也会读取~/.claude/settings.json中的env字段。写入后即使在不加载 Shell 环境的情况下如从 GUI 启动也能正确识别配置。# 确保目录存在 mkdir -p ~/.claude # 写入配置 cat ~/.claude/settings.json EOF { skipDangerousModePermissionPrompt: true, env: { ANTHROPIC_BASE_URL: https://api.kimi.com/coding/, ANTHROPIC_API_KEY: sk-kimi-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx, ANTHROPIC_MODEL: kimi-for-coding, ANTHROPIC_DEFAULT_OPUS_MODEL: kimi-for-coding, ANTHROPIC_DEFAULT_SONNET_MODEL: kimi-for-coding, ANTHROPIC_DEFAULT_HAIKU_MODEL: kimi-for-coding, CLAUDE_CODE_SUBAGENT_MODEL: kimi-for-coding, ENABLE_TOOL_SEARCH: false } } EOF安全提示建议将.claude/settings.json的权限设置为600以防止其他系统用户读取 API Key。三、验证配置3.1 检查环境变量env | grep ANTHROPIC应输出类似ANTHROPIC_BASE_URLhttps://api.kimi.com/coding/ ANTHROPIC_API_KEYsk-kimi-... ANTHROPIC_MODELkimi-for-coding3.2 启动 Claude Code进入任意项目目录启动 Claude Codecd ~/your-project claude在 Claude Code 的交互界面中输入/status如果看到类似以下输出说明配置成功3.3 发送第一条消息直接输入任意问题例如帮我看一下这个项目的目录结构如果底部状态栏开始显示 Token 消耗如↑123 ↓45说明 Kimi k2.6 已经成功响应。上图测试并成功访问了名为 /test 的 skill四、故障诊断与配置问题4.1 端点配置错误部分历史文档推荐使用https://api.moonshot.cn/anthropic作为ANTHROPIC_BASE_URL并配合ANTHROPIC_AUTH_TOKEN进行认证。该配置在当前环境下已不适用。症状API 请求返回401 Invalid Authentication即使用户确认 API Key 在平台控制台中处于有效状态。根因api.moonshot.cn属于 Moonshot 开放平台的独立认证体系而sk-kimi-前缀的 API Key 由 Kimi Code 平台签发仅对api.kimi.com域下的端点有效。两个平台之间的凭证不互通。解决方案export ANTHROPIC_BASE_URLhttps://api.kimi.com/coding/ export ANTHROPIC_API_KEYsk-kimi-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx export ANTHROPIC_MODELkimi-for-coding4.2 模型标识符错误Kimi k2.6 在 API 层面的内部模型标识符为kimi-for-coding而非kimi-k2.6。Claude Code 在不显式设置ANTHROPIC_MODEL时默认会请求claude-sonnet-4-6等 Anthropic 原生模型名。Kimi Code 后端会对这些 Claude 模型名执行自动映射将其路由至kimi-for-coding。因此不设置ANTHROPIC_MODEL亦可正常工作若显式配置则必须使用kimi-for-coding。症状请求返回404 model_not_found或类似的资源不存在错误。验证方法curl -s https://api.kimi.com/coding/v1/models \ -H Authorization: Bearer $ANTHROPIC_API_KEY | jq .data[].id预期输出仅包含kimi-for-coding。4.3 配置生效但请求无响应/status显示Anthropic base URL与Model均正确但提交消息后长时间无响应或连接超时。排查清单网络连通性确认终端可以正常解析并访问api.kimi.com。执行以下命令验证curl -I https://api.kimi.com/coding/v1/models应返回 HTTP 200。账户余额与配额登录 Kimi API 开放平台 确认账户存在有效余额或可用额度。额度耗尽时服务端通常返回429 Too Many Requests或403 Forbidden但在某些边界情况下也可能表现为连接挂起。Claude Code 版本兼容性Claude Code 2.1.x 以下版本对第三方 base URL 的支持存在已知问题。建议升级至最新版本npm install -g anthropic-ai/claude-code五、总结将 Claude Code 切换到 Kimi k2.6 的核心就三步获取 Key在 Kimi AI 官网 - K2.6 上线 创建sk-kimi-开头的 API Key改配置将ANTHROPIC_BASE_URL指向https://api.kimi.com/coding/使用ANTHROPIC_API_KEY认证