基础配置

学习如何配置 Claude Code Router 以满足您的需求。

配置文件位置

配置文件位于：

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

配置结构

Providers（提供商）

配置 LLM 提供商以将请求路由到：

{
  "Providers": [
    {
      "name": "deepseek",
      "api_base_url": "https://api.deepseek.com/chat/completions",
      "api_key": "your-api-key",
      "models": ["deepseek-chat", "deepseek-coder"]
    },
    {
      "name": "groq",
      "api_base_url": "https://api.groq.com/openai/v1/chat/completions",
      "api_key": "your-groq-api-key",
      "models": ["llama-3.3-70b-versatile"]
    }
  ]
}

Router（路由器）

配置默认使用的模型：

{
  "Router": {
    "default": "deepseek,deepseek-chat"
  }
}

格式：{provider-name},{model-name}

Transformers（转换器）

对请求/响应应用转换：

{
  "transformers": [
    {
      "path": "/path/to/custom-transformer.js",
      "options": {
        "key": "value"
      }
    }
  ]
}

环境变量

在配置中使用环境变量：

{
  "Providers": [
    {
      "name": "deepseek",
      "api_base_url": "https://api.deepseek.com/chat/completions",
      "api_key": "$DEEPSEEK_API_KEY"
    }
  ]
}

同时支持 $VAR_NAME 和 ${VAR_NAME} 语法。

代理（Proxy）

• PROXY_URL（可选）：用于出站提供商请求的 HTTP(S) 代理，例如 "PROXY_URL": "http://127.0.0.1:7890"。
• 发往回环地址（localhost、127.0.0.1、::1）的请求始终绕过代理。
• 进程环境变量 NO_PROXY / no_proxy 中列出的主机也会绕过代理。该列表以逗号分隔，支持主机名、.domain / *.domain 后缀、CIDR，以及可选的 :port。

示例：

export NO_PROXY="api.anthropic.com,.internal,10.0.0.0/8,localhost"

完整示例

{
  "PORT": 8080,
  "APIKEY": "your-secret-key",
  "PROXY_URL": "http://127.0.0.1:7890",
  "LOG": true,
  "LOG_LEVEL": "debug",
  "API_TIMEOUT_MS": 600000,
  "Providers": [
    {
      "name": "deepseek",
      "api_base_url": "https://api.deepseek.com/chat/completions",
      "api_key": "$DEEPSEEK_API_KEY",
      "models": ["deepseek-chat", "deepseek-coder"],
      "transformer": {
        "use": ["deepseek"]
      }
    },
    {
      "name": "groq",
      "api_base_url": "https://api.groq.com/openai/v1/chat/completions",
      "api_key": "$GROQ_API_KEY",
      "models": ["llama-3.3-70b-versatile"]
    }
  ],
  "Router": {
    "default": "deepseek,deepseek-chat",
    "longContextThreshold": 100000,
    "background": "groq,llama-3.3-70b-versatile"
  }
}

编辑配置

使用 CLI 编辑配置：

ccr config edit

这将在您的默认编辑器中打开配置文件。

重新加载配置

编辑配置后，重启路由器：

ccr restart

配置选项说明

• PORT: 服务器端口号（默认：3456）
• APIKEY: API 密钥，用于身份验证
• HOST: 服务器监听地址（默认：127.0.0.1，如果配置了 Providers 且没有设置 APIKEY，则强制为 127.0.0.1）
• PROXY_URL: 代理服务器地址。回环地址与 NO_PROXY/no_proxy 匹配的主机不会走代理
• LOG: 是否启用日志（默认：true）
• LOG_LEVEL: 日志级别（fatal/error/warn/info/debug/trace）
• API_TIMEOUT_MS: API 请求超时时间（毫秒）
• NON_INTERACTIVE_MODE: 非交互模式（用于 CI/CD 环境）
• WEB_SEARCH_MAX_USES: 路由到 Anthropic 的 Responses（{type: "web_search"}）与 Chat Completions（web_search_options）托管搜索每个请求的搜索次数上限（以 max_uses 发送）。未设置时不限制，与 OpenAI、Anthropic 官方 API 一致；每次搜索均计费。Anthropic Messages 客户端沿用其 web_search_* 工具自带的 max_uses。无法执行托管搜索的目标（普通 Chat Completions 提供方）不会收到搜索工具，请求在无搜索的情况下继续。

下一步

• 提供商配置 - 详细的提供商配置
• 路由配置 - 配置路由规则
• 转换器 - 应用转换