Claude Code Router实现方式一键接入多种AI模型的智能路由器实用指南

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

npm install -g @musistudio/claude-code-router

ccr code

C:UsersAdministrator>ccr code
Enter Provider Name: Gemini
Enter Provider API KEY: 123456
Enter Provider URL: https://xxx.com
Enter MODEL Name: gemini-2.5-pro

/model openrouter,anthropic/claude-3.5-sonnet

 ~/.claude-code-router/config.json

C:Users用户名.claude-code-router/config.json

PROXY_URL (可选): 为 API 请求设置代理，例如："PROXY_URL": "http://127.0.0.1:7890"

LOG (可选): 通过将其设置为true来启用日志记录。日志文件将位于$HOME/.claude-code-router.log

APIKEY (可选): 设置一个密钥来进行身份验证。设置后，客户端请求必须在Authorization 请求头 (例如, Bearer your-secret-key) 或 x-api-key 请求头中提供此密钥。例如："APIKEY": "your-secret-key"

HOST (可选): 设置服务的主机地址。如果未设置APIKEY，出于安全考虑，主机地址将强制设置为 127.0.0.1，以防止未经授权的访问。例如："HOST": "0.0.0.0"

NON_INTERACTIVE_MODE (可选): 当设置为 true 时，启用与非交互式环境（如GitHub Actions、Docker容器或其他CI/CD系统）的兼容性。这会设置适当的环境变量（CI=true、FORCE_COLOR=0 等）并配置stdin 处理，以防止进程在自动化环境中挂起。例如："NON_INTERACTIVE_MODE": true

Providers: 用于配置不同的模型提供商

Router: 用于设置路由规则。default 指定默认模型，如果未配置其他路由，则该模型将用于所有请求

API_TIMEOUT_MS: API 请求超时时间，单位为毫秒

{
  // 全局 API 密钥，用于访问此应用程序自身的主要服务。
  "APIKEY": "your-secret-key",
  // 配置代哩服务務器的 URL，所有的网络请求都将通过这个代理发出。
  // "http://127.0.0.1:5555" 指向本地运行的代理服务。
  "PROXY_URL": "http://127.0.0.1:5555", 
  // 日志记录开关。如果设置为 true，应用程序将生成并记录运行日志。
  "LOG": true,
  // API 请求的超时时间，单位为毫秒。
  // 这里的 600000 毫秒等于 600 秒（10分钟）。
  "API_TIMEOUT_MS": 600000,
  // 非交互模式开关。如果设置为 false，应用程序可以与用户进行交互（例如，请求输入）。
  // 设置为 true 时，它将在没有用户干预的情况下运行。
  "NON_INTERACTIVE_MODE": false,
  // “提供者”列表，定义了可以使用的不同 AI 模型服务。
  "Providers": [
    {
      // 提供商的唯一名称
      "name": "gemini",
      // 该提供者 API 的基础 URL 地址
      "api_base_url": "https://generativelanguage.googleapis.com/v1beta/models/",
      // 提供商的 API 密钥
      "api_key": "AIzaSyxxxxxxEfZDzBs1lC0Ac08",
      // 提供商可用的模型名称列表
      "models": ["gemini-2.5-flash", "gemini-2.5-pro"],
      // 指定用于处理请求和响应的转换器
      "transformer": {
        // 指定要使用的转换器名称
        "use": ["gemini"]
      }
    }
  ],
  // “路由器”配置，用于根据不同的任务类型，智能地选择使用哪个“提供者”和“模型”。
  "Router": {
    // 默认模型提供商 默认使用模型
    "default": "gemini,gemini-2.5-pro",
    // 用于处理后台任务的模型。可以是一个较小的本地模型以节省成本。
    "background": "gemini,gemini-2.5-flash",
    // 用于需要深度思考或推理任务的模型。
    "think": "gemini,gemini-2.5-flash",
    // 用于处理长文本上下文任务的模型。
    "longContext": "gemini,gemini-2.5-flash",
    // 定义长文本的阈值（可能是字符数或 token 数）。当输入超过此阈值时，将启用 "longContext" 路由。
    "longContextThreshold": 60000,
    // 用于处理网络搜索任务，需要模型本身支持
    "webSearch": "gemini,gemini-2.5-flash"
  }
}

  "Providers": [
    {
      "name": "gemini1",
      "api_base_url": "https://generativelanguage.googleapis.com/v1beta/models/",
      "api_key": "AIzaSyCvmL0_gwkJOH9d8jFlDFe3_9rZA1GO8OQ",
      "models": ["gemini-2.5-flash", "gemini-2.5-pro"],
      "transformer": {
        "use": ["gemini"]
      }
    }
   ]

  // “路由器”配置，用于根据不同的任务类型，智能地选择使用哪个“提供者”和“模型”。
  "Router": {
    // 默认模型提供商 默认使用模型
    "default": "gemini,gemini-2.5-pro",
    // 用于处理后台任务的模型。可以是一个较小的本地模型以节省成本。
    "background": "gemini,gemini-2.5-flash",
    // 用于需要深度思考或推理任务的模型。
    "think": "gemini,gemini-2.5-flash",
    // 用于处理长文本上下文任务的模型。
    "longContext": "gemini,gemini-2.5-flash",
    // 定义长文本的阈值（可能是字符数或 token 数）。当输入超过此阈值时，将启用 "longContext" 路由。
    "longContextThreshold": 60000,
    // 用于处理网络搜索任务，需要模型本身支持
    "webSearch": "gemini,gemini-2.5-flash"
  }

Anthropic: 如果只使用这一个转换器，则会直接透传请求和响应(可以用它来接入其他支持Anthropic端点的服务商)

deepseek: 适配 DeepSeek API 的请求/响应

gemini: 适配 Gemini API 的请求/响应

openrouter: 适配OpenRouter API 的请求/响应。它还可以接受一个provider路由参数，以指定OpenRouter应使用哪些底层提供商

 {
   "name": "openrouter",
   "api_base_url": "https://openrouter.ai/api/v1/ch@t/completions",
   "api_key": "sk-xxx",
   "models": [
     "google/gemini-2.5-pro-preview",
     "anthropic/claude-sonnet-4",
     "anthropic/claude-3.5-sonnet"
   ],
   "transformer": { "use": ["openrouter"] }
 }

 {
   "name": "deepseek",
   "api_base_url": "https://api.deepseek.com/ch@t/completions",
   "api_key": "sk-xxx",
   "models": ["deepseek-ch@t", "deepseek-reasoner"],
   "transformer": {
     "use": ["deepseek"],
     "deepseek-ch@t": { "use": ["openrouter"] }
   }
 }

{
  "name": "siliconflow",
  "api_base_url": "https://api.siliconflow.cn/v1/ch@t/completions",
  "api_key": "sk-xxx",
  "models": ["moonshotai/Kimi-K2-Instruct"],
  "transformer": {
    "use": [
      [
        "maxtoken",
        {
          "max_tokens": 16384
        }
      ]
    ]
  }
}

ccr ui

~/.claude.json

C:Users用户名.claude.json

 "error": {
    "code": 400,
    "message": "User location is not supported for the API use.",
    "status": "FAILED_PRECONDITION"
  }