Claude Code 集成指南

• Node.js 18 或更新版本（Claude Code 运行环境）
• Windows 用户需先安装 Git for Windows

安装 Claude Code

在命令行执行以下命令安装：

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

安装后执行 claude --version，能显示版本号即安装成功。

核心配置

接入 KOPRouter 需要三个参数：

• Base URL：https://koprouter.kopglobal.com（根地址，不带 /v1）
• API Key：你的 KOPRouter API Key（sk- 开头）
• 模型：KOPRouter 中的模型 ID，取自 /v1/models 返回的 id

方式一：写入 settings.json（推荐）

Claude Code 读取用户级配置文件 ~/.claude/settings.json，一次把上述参数全部写进去，任何启动方式（含 VS Code / JetBrains 插件）都生效。

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

```bat
if not exist "%USERPROFILE%\.claude" mkdir "%USERPROFILE%\.claude"
notepad "%USERPROFILE%\.claude\settings.json"
```

把下面内容写进文件（若文件里已有 env，在其内部追加，不要重复写第二个 "env": {}）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://koprouter.kopglobal.com",
    "ANTHROPIC_API_KEY": "sk-...",
    "ANTHROPIC_MODEL": "MODEL_ID"
  }
}

其中 MODEL_ID 换成 /v1/models 返回的某个模型 ID。保存后重启 Claude Code 生效。

方式二：环境变量

若偏好环境变量，可在终端里 export（仅当前窗口有效），或写入 shell 启动文件持久化。按操作系统选择：

```bash
echo 'export ANTHROPIC_BASE_URL="https://koprouter.kopglobal.com"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-..."' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="MODEL_ID"' >> ~/.zshrc
source ~/.zshrc
```

```bash
echo 'export ANTHROPIC_BASE_URL="https://koprouter.kopglobal.com"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="sk-..."' >> ~/.bashrc
echo 'export ANTHROPIC_MODEL="MODEL_ID"' >> ~/.bashrc
source ~/.bashrc
```

```powershell
setx ANTHROPIC_BASE_URL "https://koprouter.kopglobal.com"
setx ANTHROPIC_API_KEY "sk-..."
setx ANTHROPIC_MODEL "MODEL_ID"
```

选择与切换模型

• 启动时指定：claude --model <MODEL_ID>
• 对话中切换：输入 /model，或直接 /model <MODEL_ID>

模型 ID 一律取自 /v1/models 返回的 id。若不指定模型，Claude Code 会使用其内置默认模型名，若 KOPRouter 无对应模型会报「模型不存在」。

鉴权变量说明

Claude Code 有两个凭证变量，二者只设置一个：

• ANTHROPIC_API_KEY —— 以 x-api-key 头发送，对应 KOPRouter 的 Anthropic 鉴权方式（见「概述」），推荐使用。
• ANTHROPIC_AUTH_TOKEN —— 以 Authorization: Bearer 头发送；KOPRouter 同样接受该头。

不要同时设置这两个变量，否则 Claude Code 会提示鉴权可能不生效。

验证

claude --version

配置完成后，进入项目目录运行 claude 启动会话；输入 /status 可确认「Anthropic base URL」已指向 KOPRouter。

常见问题

unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_BASE_URL

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://koprouter.kopglobal.com",
    "ANTHROPIC_API_KEY": "sk-...",
    "HTTPS_PROXY": "http://127.0.0.1:7890",
    "HTTP_PROXY": "http://127.0.0.1:7890"
  }
}