在 Claude Code 中配置 AnRouter

覆盖终端 CLI、VS Code 扩展，以及 Claude 桌面端的两条配置路径，含验证与模型切换。

Claude Code 向 Anthropic Messages 端点发送请求，因此 Base URL 必须使用不带 /v1 的域名。AnRouter 可以接收这种协议，但 Anthropic 官方不承诺 Claude Code 对非 Claude 模型的完整兼容性；开始真实项目之前务必验证工具调用与编辑流程。

1. 安装

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

claude --version
claude doctor

Windows PowerShell：irm https://claude.ai/install.ps1 | iex

桌面客户端：从 claude.ai/download 下载安装包，macOS 是 .dmg，Windows 是 .exe。也可用包管理器：brew install --cask claude-code 或 winget install Anthropic.ClaudeCode。

2. 获取 AnRouter API Key

在 anrouter.com 注册并登录。
进入控制台，打开 API Keys 页面。
创建密钥并复制。请像对待密码一样保管，切勿提交到代码仓库。

3. 临时测试

export ANTHROPIC_BASE_URL="https://api.anrouter.com"
export ANTHROPIC_AUTH_TOKEN="your_anrouter_api_key"
export ANTHROPIC_MODEL="glm-5.3"

claude

4. 持久化到 Claude Code 设置

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.anrouter.com",
    "ANTHROPIC_AUTH_TOKEN": "your_anrouter_api_key",
    "ANTHROPIC_MODEL": "glm-5.3"
  }
}

模型发现限制：Claude Code 的网关发现只会把 ID 以 claude 或 anthropic 开头的模型加入选择器。glm-5.3 等 AnRouter 模型不会自动出现，应使用 ANTHROPIC_MODEL 显式指定。

当前端点限制：此 AnRouter 部署已提供 POST /v1/messages，但未提供 Claude Code 可选的 POST /v1/messages/count_tokens 路由。普通 Messages 请求可以工作，但明确依赖服务端 Token 计数的客户端功能可能失败；一次普通对话成功不能代表 Claude Code 全部能力均兼容。

5. VS Code 扩展

安装官方 Claude Code 扩展，并先确认终端中的 claude 可以通过 AnRouter 完成一次请求。
扩展与 CLI 默认共享 ~/.claude/settings.json，优先使用上面的共享配置。
若扩展未读取共享变量或仍弹出登录提示，按 ⌘/Ctrl + Shift + P，运行 Preferences: Open User Settings (JSON)。
修改变量后运行 Developer: Reload Window，再发送短请求验证。

在 VS Code 命令面板中打开用户 settings.json — 在命令面板中选择 **Preferences: Open User Settings (JSON)**。截图中的界面语言不影响命令名称；点击可查看原图。

仅在需要扩展专用配置时，把下面字段合并进现有 VS Code 用户设置；不要删除文件里其他设置：

{
  "claudeCode.disableLoginPrompt": true,
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.anrouter.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "your_anrouter_api_key" },
    { "name": "ANTHROPIC_MODEL", "value": "glm-5.3" }
  ]
}

VS Code settings.json 中 Claude Code 环境变量字段的位置 — 原图用于定位字段；实际值请以紧邻图片上方这段已核验配置为准，不要照抄截图里的占位符。

6. Claude Desktop：Code 标签

Claude Desktop 的本地 Code 会话可复用 Claude Code 设置。若桌面应用没有继承 shell 变量，可在 Local 环境旁的设置入口补充环境变量；这里仍使用不带 /v1 的 ANTHROPIC_BASE_URL=https://api.anrouter.com。

7. Claude Desktop：第三方推理配置

在 Claude Desktop 打开 Help → Troubleshooting → Enable Developer Mode。
再打开 Developer → Configure Third-Party Inference…，Provider 选择 Gateway。
Gateway base URL 填 https://api.anrouter.com，填写 AnRouter API Key；认证方式选 bearer，凭据类型选 Static API key。
测试连接，在 Models 区域填写 AnRouter 模型的准确 ID，然后选择 Apply locally。

Claude Desktop Configure third-party inference 配置窗口 — Gateway base URL 填不带 `/v1` 的 `https://api.anrouter.com`；Claude Desktop 会在请求时使用 `/v1/messages`。点击图片可查看原图。

Claude 系列入口都不要追加 /v1：Claude Code、VS Code 和 Claude Desktop Gateway 均填写 https://api.anrouter.com，也不要填写完整的 /v1/messages 请求地址。Hermes、OpenCode 等 OpenAI-compatible 客户端才填写 https://api.anrouter.com/v1。若该窗口是只读状态，说明组织通过受管配置锁定了这些值，需要联系管理员。

参考：Claude Code LLM gateway · VS Code 集成 · Claude Desktop 第三方推理