前言
Claude Code 是一个非常好用的终端 Coding Agent,可以直接在项目目录里读取代码、修改文件、执行命令、生成项目结构和完成复杂开发任务。
但在国内使用 Claude Code 时,很多人会遇到几个问题:
- 原生 Anthropic API Key 不方便获取;
- 默认模型调用成本较高;
- 想使用 Kimi K2.5 这类中文体验更好、代码能力也比较强的模型;
- 配置 Kimi 时经常混淆
api.moonshot.cn、api.kimi.com/coding/、ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN等变量。
本文记录一套实测可用的方案:
Claude Code + Moonshot Anthropic 兼容接口 + kimi-k2.5
实测接口:
https://api.moonshot.cn/anthropic
模型:
kimi-k2.5
这套方案适用于你在 Moonshot / Kimi 开放平台创建的 sk-... API Key。
一、先说结论:不要把两套 Kimi 接口混在一起
Kimi 目前容易让人混淆的地方在于,它有不同的 API 入口。
1. Moonshot / Kimi 开放平台 API
这个是本文使用的方案:
https://api.moonshot.cn/anthropic
对应模型:
kimi-k2.5
适合在 Claude Code 里通过 Anthropic 兼容方式调用。
你在 Moonshot / Kimi 开放平台创建的 sk-... API Key,通常就是走这套。
2. Kimi Code 专用通道
另一套常见写法是:
https://api.kimi.com/coding/
对应模型通常是:
kimi-for-coding
这套是 Kimi Code 专用通道,不一定能直接使用 Moonshot 开放平台的 sk-... API Key。
如果你拿 Moonshot 开放平台的 Key 去请求:
https://api.kimi.com/coding/
可能会出现鉴权失败。
所以重点是:
Moonshot 平台 Key → 用 https://api.moonshot.cn/anthropic
Kimi Code 专用 Key → 才考虑 https://api.kimi.com/coding/
本文只讲第一种:Moonshot Anthropic 兼容接口。
二、准备工作
你需要准备:
- 已安装 Node.js;
- 已安装 Claude Code;
- 已在 Kimi / Moonshot 开放平台创建 API Key;
- Windows PowerShell 终端。
安装 Claude Code 的方式一般是:
npm install -g @anthropic-ai/claude-code
安装完成后可以检查:
claude --version
能看到版本号,说明 Claude Code 已经安装成功。
三、配置环境变量
Windows 下推荐写入用户环境变量,这样关闭终端后配置仍然保留。
打开 PowerShell,执行下面命令。
注意:把 你的Moonshot_API_Key 换成你自己的真实 Key。
[Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://api.moonshot.cn/anthropic', 'User')
[Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'kimi-k2.5', 'User')
[Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', '你的Moonshot_API_Key', 'User')
[Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', $null, 'User')
[Environment]::SetEnvironmentVariable('ENABLE_TOOL_SEARCH', 'false', 'User')
这里每个变量的含义如下:
| 环境变量 | 作用 |
|---|---|
ANTHROPIC_BASE_URL |
指定 Claude Code 请求的 Anthropic 兼容接口地址 |
ANTHROPIC_MODEL |
指定实际调用的模型 |
ANTHROPIC_API_KEY |
写入 Moonshot / Kimi 开放平台 API Key |
ANTHROPIC_AUTH_TOKEN |
清空旧的 Anthropic Token,避免冲突 |
ENABLE_TOOL_SEARCH |
可选,关闭部分工具搜索能力,避免不兼容问题 |
最终推荐配置是:
ANTHROPIC_BASE_URL=https://api.moonshot.cn/anthropic
ANTHROPIC_MODEL=kimi-k2.5
ANTHROPIC_API_KEY=你的 Moonshot API Key
ANTHROPIC_AUTH_TOKEN=空
ENABLE_TOOL_SEARCH=false
四、关闭 PowerShell,重新打开
这是很多人踩坑的地方。
你用 [Environment]::SetEnvironmentVariable(..., 'User') 写入的是用户环境变量,但当前已经打开的 PowerShell 不一定会立刻读取最新配置。
所以配置完成后,一定要:
- 关闭当前 PowerShell;
- 重新打开一个新的 PowerShell;
- 再运行 Claude Code。
五、检查环境变量是否生效
重新打开 PowerShell 后,执行:
[Environment]::GetEnvironmentVariable('ANTHROPIC_BASE_URL', 'User')
[Environment]::GetEnvironmentVariable('ANTHROPIC_MODEL', 'User')
[Environment]::GetEnvironmentVariable('ANTHROPIC_API_KEY', 'User')
[Environment]::GetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'User')
[Environment]::GetEnvironmentVariable('ENABLE_TOOL_SEARCH', 'User')
正常应该看到类似结果:
https://api.moonshot.cn/anthropic
kimi-k2.5
sk-xxxxxxxxxxxxxxxx
空
false
注意:不要把完整 API Key 发到群里、论坛里或者截图里。最多只展示前几位和后几位。
六、启动 Claude Code
进入你的项目目录,例如:
cd D:\your-project
然后启动 Claude Code:
claude
第一次进入项目时,可以执行:
/init
Claude Code 会在当前项目下生成 CLAUDE.md 文件。
这个文件可以理解为 Claude Code 的项目说明书,你可以把项目规范、技术栈、目录结构、禁止事项、运行命令等写进去。
例如:
# Project Instructions
- This is a Vue 3 + TypeScript project.
- Use pnpm as the package manager.
- Do not modify files under dist/.
- Before changing code, inspect the existing structure first.
- After modifying code, run typecheck if available.
七、在 Claude Code 里检查状态
进入 Claude Code 后,输入:
/status
重点看这几个字段:
Anthropic base URL: https://api.moonshot.cn/anthropic
Model: kimi-k2.5
API key: ANTHROPIC_API_KEY
如果能看到类似信息,说明 Claude Code 已经不是走默认 Anthropic 官方接口,而是走 Moonshot 的 Anthropic 兼容接口。
然后可以直接发一句:
hello
或者让它读取当前项目:
Please analyze this project structure and explain how to run it.
如果模型能正常回复,说明配置成功。
八、常见问题排查
问题 1:Claude Code 仍然提示使用 sk-ant-... Key
如果你看到类似:
ANTHROPIC_API_KEY: sk-ant-...
Do you want to use this API key?
这说明系统里还残留了旧的 Anthropic 官方 Key。
解决方式:
[Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', '你的Moonshot_API_Key', 'User')
[Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', $null, 'User')
然后关闭 PowerShell,重新打开,再运行:
claude
问题 2:用了 https://api.kimi.com/coding/ 但鉴权失败
这通常是因为你拿 Moonshot 开放平台的 sk-... Key 去请求 Kimi Code 专用接口。
本文这套配置应该使用:
https://api.moonshot.cn/anthropic
不要写成:
https://api.kimi.com/coding/
除非你明确拿到的是 Kimi Code 专用通道的 Key,并且模型也按对应文档配置。
问题 3:配置完后 Claude Code 还是旧模型
一般是终端没有重开。
重新执行:
[Environment]::GetEnvironmentVariable('ANTHROPIC_BASE_URL', 'User')
[Environment]::GetEnvironmentVariable('ANTHROPIC_MODEL', 'User')
[Environment]::GetEnvironmentVariable('ANTHROPIC_API_KEY', 'User')
确认值已经写入后,关闭所有 PowerShell 窗口,再重新打开。
问题 4:脚本里不要长期保存明文 Key
很多教程会写一个 set-env.ps1,里面直接写:
$KimiApiKey = 'sk-xxxxxxxxxxxxxxxx'
这不推荐。
更安全的做法是:
- 环境变量里保存 Key;
- 脚本模板里不要写真实 Key;
- 不要把带 Key 的脚本提交到 Git;
- 如果 Key 发到聊天记录或截图里,建议立刻去平台删除旧 Key,重新生成。
九、推荐的配置脚本模板
可以保存为:
set-kimi-claude-env.ps1
内容如下:
# Claude Code with Kimi K2.5 via Moonshot Anthropic-compatible endpoint
# 注意:不要把真实 API Key 写进这个脚本长期保存
$MoonshotApiKey = Read-Host "Please input your Moonshot API Key"
[Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://api.moonshot.cn/anthropic', 'User')
[Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'kimi-k2.5', 'User')
[Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', $MoonshotApiKey, 'User')
[Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', $null, 'User')
[Environment]::SetEnvironmentVariable('ENABLE_TOOL_SEARCH', 'false', 'User')
Write-Host "Claude Code Kimi environment variables have been configured."
Write-Host "Please close this PowerShell window and open a new one."
运行方式:
powershell -ExecutionPolicy Bypass -File .\set-kimi-claude-env.ps1
输入 API Key 后关闭当前终端,重新打开,再运行:
claude
十、最终配置汇总
本文最终使用的配置如下:
ANTHROPIC_BASE_URL=https://api.moonshot.cn/anthropic
ANTHROPIC_MODEL=kimi-k2.5
ANTHROPIC_API_KEY=Moonshot / Kimi 开放平台 API Key
ANTHROPIC_AUTH_TOKEN=空
ENABLE_TOOL_SEARCH=false
Claude Code 里执行:
/status
看到:
Anthropic base URL: https://api.moonshot.cn/anthropic
Model: kimi-k2.5
API key: ANTHROPIC_API_KEY
基本就说明配置成功。
总结
Claude Code 接入 Kimi K2.5 的关键不是简单替换一个 Key,而是要把接口、模型和环境变量对应好。
最核心的三项配置是:
ANTHROPIC_BASE_URL=https://api.moonshot.cn/anthropic
ANTHROPIC_MODEL=kimi-k2.5
ANTHROPIC_API_KEY=你的 Moonshot API Key
不要把 Moonshot 开放平台 Key 和 Kimi Code 专用接口混用。
如果你使用的是 Moonshot / Kimi 开放平台创建的 sk-... Key,那么更稳妥的方案就是本文这套:
Claude Code → Moonshot Anthropic 兼容接口 → kimi-k2.5
配置完成后,Claude Code 就可以在本地项目中调用 Kimi K2.5,完成代码分析、项目重构、自动生成文件、调试命令和复杂开发任务。