Claude Code 接入 Kimi K2.5 完整教程:使用 Moonshot Anthropic 兼容接口替换默认 Claude 模型

前言

Claude Code 是一个非常好用的终端 Coding Agent,可以直接在项目目录里读取代码、修改文件、执行命令、生成项目结构和完成复杂开发任务。

但在国内使用 Claude Code 时,很多人会遇到几个问题:

  • 原生 Anthropic API Key 不方便获取;
  • 默认模型调用成本较高;
  • 想使用 Kimi K2.5 这类中文体验更好、代码能力也比较强的模型;
  • 配置 Kimi 时经常混淆 api.moonshot.cnapi.kimi.com/coding/ANTHROPIC_API_KEYANTHROPIC_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 兼容接口。


二、准备工作

你需要准备:

  1. 已安装 Node.js;
  2. 已安装 Claude Code;
  3. 已在 Kimi / Moonshot 开放平台创建 API Key;
  4. 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 不一定会立刻读取最新配置。

所以配置完成后,一定要:

  1. 关闭当前 PowerShell;
  2. 重新打开一个新的 PowerShell;
  3. 再运行 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'

这不推荐。

更安全的做法是:

  1. 环境变量里保存 Key;
  2. 脚本模板里不要写真实 Key;
  3. 不要把带 Key 的脚本提交到 Git;
  4. 如果 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,完成代码分析、项目重构、自动生成文件、调试命令和复杂开发任务。

相关推荐
cAuth2 小时前
实现一个自己的 Agent cli
agent·claude
码农小旋风2 小时前
使用 ChatGPT 聚合站前,先看安全和隐私判断清单
人工智能·安全·自然语言处理·chatgpt·claude
周易宅2 小时前
CLAUDE.md 与 MEMORY.md:AI 编程助手配置的两条平行铁轨
人工智能·ai·agent·claude
沉默王二4 小时前
腾讯面试官问CLAUDE.md维护,我只说了两个词,他当场愣住了!!
agent·ai编程·claude
Resky08184 小时前
解决Claude Code 报错API Error: 400问题
claude
周易宅6 小时前
CLAUDE.md 终极最佳实践指南
ai·agent·claude
Bigger7 小时前
mini-cc 权限安全:给 AI 戴上枷锁
人工智能·ai编程·claude
追光者♂7 小时前
【测评系列5】CSDN AI数字营销实测体验官——Claude 大模型深度评测:从参数解析到实战边界
人工智能·ai·大模型·大语言模型·claude·模型幻觉·架构参数