下面给你一套直接能用、一步到位的 Claude Code 接入 Kimi K2.5（月之暗面）的完整配置，国内直连、不用代理、免费额度可用。

---

一、前提

1. 已安装 Node.js（18+）
2. 已安装 Claude Code：

bash

运行

npm install -g @anthropic-ai/claude-code

国内慢就用镜像：

bash

运行

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

验证：

bash

运行

claude -v

1. 拿到 Kimi API Key（必须）

• 打开：https://platform.moonshot.cn
• 注册 / 登录 → 左侧「API Key 管理」→ 新建 Key
• 复制 sk-xxxx 格式的 Key（只显示一次）

---

二、核心原理

Claude Code 用的是 Anthropic Messages API，Kimi 官方做了兼容端点：

• 国内：https://api.moonshot.cn/anthropic
• 模型名：kimi-k2.5

只需把这三个环境变量配置好：

• ANTHROPIC_BASE_URL
• ANTHROPIC_AUTH_TOKEN
• ANTHROPIC_MODEL

---

三、配置方法（三选一，推荐方法 2）

方法 1：终端临时生效（一次性）

macOS / Linux / WSL

bash

运行

export ANTHROPIC_BASE_URL="https://api.moonshot.cn/anthropic"
export ANTHROPIC_AUTH_TOKEN="sk-你的Kimi密钥"
export ANTHROPIC_MODEL="kimi-k2.5"
claude

Windows PowerShell

powershell

$env:ANTHROPIC_BASE_URL="https://api.moonshot.cn/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="sk-你的Kimi密钥"
$env:ANTHROPIC_MODEL="kimi-k2.5"
claude

方法 2：永久生效（推荐，重启终端也在）

macOS（默认 zsh）

bash

运行

nano ~/.zshrc

末尾添加：

bash

运行

export ANTHROPIC_BASE_URL="https://api.moonshot.cn/anthropic"
export ANTHROPIC_AUTH_TOKEN="sk-你的Kimi密钥"
export ANTHROPIC_MODEL="kimi-k2.5"

保存退出（Ctrl+O → 回车 → Ctrl+X），然后：

bash

运行

source ~/.zshrc

Linux（bash）

bash

运行

nano ~/.bashrc

同上添加三行，然后：

bash

运行

source ~/.bashrc

Windows 永久环境变量

PowerShell 管理员：

powershell

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.moonshot.cn/anthropic", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的Kimi密钥", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "kimi-k2.5", "User")

重启终端。

方法 3：Claude Code 配置文件（GUI/IDE 也生效）

bash

运行

mkdir -p ~/.claude
nano ~/.claude/settings.json

写入：

json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.moonshot.cn/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Kimi密钥",
    "ANTHROPIC_MODEL": "kimi-k2.5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "kimi-k2.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "kimi-k2.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "kimi-k2.5"
  }
}

保存退出。

---

四、验证是否成功

开新终端，直接运行：

bash

运行

claude

随便问一个代码问题，看返回是否正常、速度是否国内直连（无超时）。

---

五、常见问题

• 401 Unauthorized：Key 错、没复制全、有空格
• 429 Too Many Requests：额度用完或限流
• 慢 / 超时：确认用的是 api.moonshot.cn（国内）
• 想换回原版 Claude：删掉这三个环境变量即可