Claude Code Router 配置指南

轻松连接各类三方API，附环境切换技巧

作者：Jiang | 发布日期：2025-08-08

最近在折腾 claude-code-router，发现它是一个非常强大的工具，可以帮助我们统一管理和调用各种大模型 API。我把配置过程中的一些经验和踩坑心得整理如下。

一、基础安装

首先，需要安装Claude Code和 claude-code-router。打开终端，运行以下命令：

安装 Claude Code 主程序

安装 claude-code-router

启动 UI 界面

二、网络代理配置

很多第三方通用 API（如 new-api、公益 API 等）的服务器都在国外，国内直接访问可能会遇到 500、api_error、internal_error 等网络错误。如果遇到此类问题，可以尝试设置代理。（遇到配置本产品不涉及配置）

代理配置示例：

http://127.0.0.1:7897

请根据你自己的代理工具进行相应修改。

三、API 分类配置教程

claude-code-router 支持多种 API，主要分为以下两类：

1. 常见直连 API

这类 API 包括：

硅基 (Siliconflow)

Kimi (Moonshot)

通义千问 (ModelScope)

火山引擎 (Volcengine)

官方仓库的 README 已经有非常详细的配置说明，建议直接参考官方文档。

官方仓库地址： https://github.com/musistudio/claude-code-router

2. 第三方通用 API 配置

Gemini (谷歌) 配置

URL： 需要以 /v1beta/models/ 结尾

供应商转换器 (Provider Converter)： 选择 gemini

模型 (Model)： 只需填写模型名称，不需要 models/ 前缀

示例：

如果模型 ID 是 models/gemini-2.5-pro，在模型字段里只填写 gemini-2.5-pro

四、配置切换技巧（高级用法）

通过智谱的配置方式可以看出，CCR 也可以作为一个简单的 CC 配置切换工具来使用。

可以在 CC 中配置：

"env": {
  "ANTHROPIC_AUTH_TOKEN": "key",
  "ANTHROPIC_BASE_URL": "http://127.0.0.1:3456"
}

让 CC 环境全部走 CCR，然后在 CCR 中配置中转商的 Claude Code 专用 Anthropic 接口，即可在 CCR 中随意切换。

注意： Claude Code 专用的 Anthropic 接口在配置中应为：供应商 API/v1/messages

五、接入第三方API完整配置示例

{
  "LOG": true,
  "LOG_LEVEL": "debug",
  "CLAUDE_PATH": "",
  "HOST": "127.0.0.1",
  "PORT": 3456,
  "APIKEY": "",
  "API_TIMEOUT_MS": "600000",
  "PROXY_URL": "",
  "transformers": [],
  "Providers": [
    {
      "name": "mtuo-ai",
      "api_base_url": "https://api.mtuo.ai/v1/messages",  //请求地址
      "api_key": "sk-********************************",  //api密钥
      "models": [
        "claude-opus-4-1-20250805",
        "claude-opus-4-20250514",
        "claude-sonnet-4-20250514",
        "claude-sonnet-4-5-20250929"
      ],
      "transformer": {
        "use": [
          "Anthropic" //注意：不同厂商大模型选择不同转换器 
        ],
        "claude-sonnet-4-20250514": {
          "use": [
            "Anthropic"
          ]
        }
      }
    }
  ],
  "StatusLine": {
    "enabled": true,
    "currentStyle": "default",
    "default": {
      "modules": []
    },
    "powerline": {
      "modules": []
    }
  },
  "Router": {
    "default": "mtuo-ai,claude-sonnet-4-5-20250929",
    "background": "",
    "think": "",
    "longContext": "mtuo-ai,anthropic/claude-sonnet-4-5-20250929",
    "longContextThreshold": 60000,
    "webSearch": "mtuo-ai,gpt-4o",
    "image": "mtuo-ai,gemini-2.5-flash"
  },
  "CUSTOM_ROUTER_PATH": ""
}

Claude Code Router 配置指南

Claude Code Router 配置指南#

一、基础安装#

安装 Claude Code 主程序#

安装 claude-code-router#

启动 UI 界面#

二、网络代理配置#

三、API 分类配置教程#

1. 常见直连 API#

2. 第三方通用 API 配置#

Gemini (谷歌) 配置#

四、配置切换技巧（高级用法）#

五、接入第三方API完整配置示例#

Claude Code Router 配置指南

一、基础安装

安装 Claude Code 主程序

安装 claude-code-router

启动 UI 界面

二、网络代理配置

三、API 分类配置教程

1. 常见直连 API

2. 第三方通用 API 配置

Gemini (谷歌) 配置

四、配置切换技巧（高级用法）

五、接入第三方API完整配置示例