Claude Code Router v1.0.33 配置指南：一站式多 API 管理的新思路

随着大模型生态的繁荣，越来越多的开发者需要同时接入 Claude、OpenAI、Gemini 等多家厂商的 API。问题也随之而来：如何优雅地管理不同的 API Key，并在不同环境间灵活切换？

Claude Code Router，它能帮助我们轻松搞定这个问题。今天就带大家快速了解它的用法和实战技巧。

一、Claude Code Router 是什么？

Claude Code Router 是一个代理服务，它能够帮助我们将请求智能地路由到不同的API服务。通过简单的配置，您可以实现：

  • 统一的API入口：无论后端连接的是哪个模型，前端应用的调用地址都无需改变。
  • 灵活的模型切换：可以轻松地在不同的API提供商之间切换，例如从 anyscale 切换到 openrouter。
  • 简化的密钥管理：只需管理 Code Router 的密钥，无需在客户端存储多个API Key。

一句话总结：有了它，你不需要再手动修改配置文件，就能轻松切换调用环境。

二、基础安装

首先,需要安装Claude Code和claude-code-router。打开终端,运行以下命令:
1.安装ClaudeCode主程序

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

2.安装claude-code-router

npm install -g @musistudio/claude-code-router
  1. 启动 UI 界面 ccr ui

二、 API 分类配置教程

claude-code-router 支持多种 API，我们主要看两类。

  1. 常见直连 API
    这类 API 包括 硅基 (Siliconflow) 、Kimi (Moonshot) 、通义千问 (ModelScope) 、火山引擎 (Volcengine) 等。
    官方仓库的 README 已经有非常详细的配置说明，大家直接参考即可，这里不再赘述

  2. 第三方通用 API (以 Gemini 和智谱为例)
    Gemini (谷歌)
    URL ：需要以 /v1beta/models/ 结尾。例如，如果你使用 gptLoad 或类似的中转服务，地址可能如下：

http://localhost:3001/proxy/gemini/v1beta/models/

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

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

例如，模型 ID 是 models/gemini-2.5-pro ，那么在模型字段里只填写 gemini-2.5-pro 。
在这里插入图片描述

智谱
智谱提供了两种连接方式一种是 CC 接口 ，即可以直接在 CC 中 使用的方式，也是官方推荐使用方式。还有一种是 OpenAI 接口

方式 1 (推荐): CC 兼容接口

URL ：

https://open.bigmodel.cn/api/anthropic/v1/messages

模型 ：如 glm-4 或 glm-4-air 。
供应商转换器 ：选择 Anthropic 。
在这里插入图片描述

方式 2: OpenAI 接口

URL ：

https://open.bigmodel.cn/api/paas/v4/chat/completions

模型选择 ： glm-4 。
其余选项 ：保持默认即可。在这里插入图片描述

从第二种方式，可见，常见 OpenAI 接口，都可以如上简单进行配置。

二、快速配置

配置 Claude Code Router 的过程非常直观，主要分为以下几个步骤：

  1. 准备配置文件：
    首先，您需要创建一个名为 config.yaml 的配置文件。这是整个服务的核心，所有的路由规则和API密钥都在这里定义。

  2. 定义模型和路由：
    在 config.yaml 文件中，您可以定义不同的模型和它们的路由规则。一个典型的配置示例如下：

    models:
  - name: claude-3-opus
    # anyscale 服务商配置
    providers:
      - name: anyscale
        apiKey: ${ANYSCALE_API_KEY} # 建议使用环境变量
    # 路由规则：定义如何以及何时使用这个模型
    route: "host == 'localhost' && path == '/v1/chat/completions'"

  - name: claude-3-sonnet
    # openrouter 服务商配置
    providers:
      - name: openrouter
        apiKey: ${OPENROUTER_API_KEY} # 建议使用环境变量
    route: "host == 'api.example.com'"

    配置要点：

    • models: 定义了一个模型列表。
    • name: 模型的名称。
    • providers: 为该模型配置一个或多个API服务商。
    • apiKey: 您的API密钥。强烈建议使用环境变量（如 ${ANYSCALE_API_KEY}）来管理密钥，以增强安全性。
    • route: 路由规则，用于决定在什么条件下使用该模型。您可以根据 host（主机名）、path（路径）等条件来设置。
      Router 使用 config.json 文件进行配置。一个典型示例如下：
{
  "services": {
    "claude": {
      "api_key": "your_claude_api_key",
      "base_url": "https://api.anthropic.com"
    },
    "openai": {
      "api_key": "your_openai_api_key",
      "base_url": "https://api.openai.com"
    }
  },
  "router": {
    "default": "claude",
    "fallback": "openai"
  }
}

说明：

默认调用 Claude

如果 Claude 服务不可用，就会自动切换到 OpenAI

📌 这就像一个“API 智能流量分发器”，让接口调用变得更智能。

三、 独门秘籍：“邪修”环境切换法

配置切换（邪修）
通过智谱的配置方式，我们可以看出，其实 CCR 其实也可以作为一个 简单的 CC 配置切换工具来使用（邪修），非常方便快捷。
我们可以直接在 CC 中配置

CC 环境全走 CCR，然后我们在 CCR 中配置中转商的 Claude Code 专用的 Anthropic 接口，那么即可在 CCR 中随意切换自如。
需注意的是，Claude Code 专用的 Anthropic 接口在配置中，应如：供应商 API/v1/messages

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

最后给一个通用的配置文件

{
  "LOG": false,
  "CLAUDE_PATH": "",
  "HOST": "127.0.0.1",
  "PORT": 3456,
  "APIKEY": "key",
  "API_TIMEOUT_MS": "600000",
  "PROXY_URL": "http://127.0.0.1:7897",
  "Transformers": [],
  "Providers": [
    {
      "api_base_url": "https://api.siliconflow.cn/v1/chat/completions",
      "api_key": "key",
      "models": ["moonshotai/Kimi-K2-Instruct"],
      "name": "siliconflow",
      "transformer": {
        "use": [
          [
            "maxtoken",
            {
              "max_tokens": 16384
            }
          ]
        ]
      }
    },
    {
      "api_base_url": "https://api-inference.modelscope.cn/v1/chat/completions",
      "api_key": "key",
      "models": ["Qwen/Qwen3-Coder-480B-A35B-Instruct"],
      "name": "modelscope",
      "transformer": {
        "use": [
          [
            "maxtoken",
            {
              "max_tokens": 65536
            },
            "enhancetool"
          ]
        ]
      }
    },
    {
      "name": "volceskimi",
      "api_base_url": "https://ark.cn-beijing.volces.com/api/v3/chat/completions",
      "api_key": "key",
      "models": ["kimi-k2-250711"]
    },
    {
      "name": "nyxar",
      "api_base_url": "https://api.nyxar.org/v1/chat/completions",
      "api_key": "key",
      "models": [
        "gemini-2.5-pro",
        "claude-4.0-sonnet",
        "anthropic/claude-3.7-sonnet",
        "anthropic/claude-4-sonnet-20250522"
      ]
    },
    {
      "name": "bigmodelOpen",
      "api_base_url": "https://open.bigmodel.cn/api/paas/v4/chat/completions",
      "api_key": "key",
      "models": ["glm-4.5"]
    },
    {
      "name": "bigmodelCC",
      "api_base_url": "https://open.bigmodel.cn/api/anthropic/v1/messages",
      "api_key": "key",
      "models": ["glm-4.5"],
      "transformer": {
        "use": ["Anthropic"]
      }
    },
    {
      "name": "geminiC",
      "api_base_url": "http://localhost:3001/proxy/gemini/v1beta/models/",
      "api_key": "key",
      "models": [
        "gemini-2.5-flash",
        "gemini-2.5-pro",
        "gemini-2.5-flash-preview-05-20"
      ],
      "transformer": {
        "use": ["gemini"]
      }
    }
  ],
  "Router": {
    "default": "nyxar,claude-4.0-sonnet",
    "background": "siliconflow,moonshotai/Kimi-K2-Instruct",
    "think": "siliconflow,moonshotai/Kimi-K2-Instruct",
    "longContext": "geminiC,gemini-2.5-pro",
    "longContextThreshold": 60000,
    "webSearch": "geminiC,gemini-2.5-flash"
  }
}
# 开发语言 # 后端 # 经验分享 # 人工智能
Logo
亚马逊云科技技术品牌专区

更多推荐

cover

别再只聊大模型！AI的下一场革命，藏在“身体”里

avatar 亚马逊云科技技术品牌专区
cover

别再只聊大模型！人工智能的下一场革命，藏在“身体”里

avatar 亚马逊云科技技术品牌专区
cover

别再只聊大模型！AI的下一场革命，藏在“身体”里

avatar 亚马逊云科技技术品牌专区