Kimi K2.5 + Claude Code：在 Claude Code 中使用 Kimi K2.5（完整配置指南）

目标：你继续用 claude（Claude Code CLI）的工作流（读项目、改文件、跑命令），但把模型请求转到 Moonshot 的 Anthropic Messages API 兼容端点，从而使用 Kimi K2.5。

一句话原理

Claude Code 默认对接 Anthropic 的 Messages API，并支持通过配置把请求指向自定义的 Anthropic 兼容服务（~/.claude/settings.json 或环境变量）。
Moonshot（Kimi）提供了 /anthropic/v1/messages 这条“与 Anthropic Messages API 一致”的接口，所以能直接接上。
（Moonshot 官方社区也明确给出了该端点：https://api.moonshot.cn/anthropic/v1/messages。）

你需要准备什么

已安装 Claude Code CLI（终端里能跑 claude）。
一个 Moonshot / Kimi 的 API Key（在 Moonshot Open Platform 控制台创建）。
选好你用的域名（通常二选一）：
- 全球：https://api.moonshot.ai
- 中国：https://api.moonshot.cn

Claude Code 用的是 Anthropic 兼容，所以我们会用到：
https://api.moonshot.<ai|cn>/anthropic/v1/messages 这一类地址。

方案 A：用环境变量快速切换到 Kimi K2.5

把下面内容复制到你的终端（macOS / Linux）里，然后启动 claude：

# 1) Claude Code → Moonshot 的 Anthropic 兼容入口
#   说明：Moonshot 的 Anthropic Messages API 端点是 /anthropic/v1/messages
export ANTHROPIC_BASE_URL="https://api.moonshot.ai/anthropic"

# 2) 认证
export ANTHROPIC_AUTH_TOKEN="YOUR_MOONSHOT_API_KEY"

# 3) 模型
#   常见写法：ANTHROPIC_MODEL / ANTHROPIC_SMALL_FAST_MODEL
export ANTHROPIC_MODEL="kimi-k2.5"
export ANTHROPIC_SMALL_FAST_MODEL="kimi-k2.5"

# 4) 可选：减少非必要流量 & 提升长任务稳定性
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
export API_TIMEOUT_MS=600000

# 启动 Claude Code
claude

如果你在中国网络环境，把第一行改成：

export ANTHROPIC_BASE_URL="https://api.moonshot.cn/anthropic"

方案 B：写进 `~/.claude/settings.json`

Claude Code 官方文档说明：用户级配置文件在 ~/.claude/settings.json，并支持 env 字段。
你可以直接写成这样（把 Key 换成自己的）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.moonshot.ai/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_MOONSHOT_API_KEY",
    "ANTHROPIC_MODEL": "kimi-k2.5",
    "ANTHROPIC_SMALL_FAST_MODEL": "kimi-k2.5",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "API_TIMEOUT_MS": "600000"
  }
}