跳到主要内容

CLI 基础配置

CLI 使用与 Server 相同的配置文件：~/.claude-code-router/config.json

配置文件位置​

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

快速配置​

使用交互式命令配置：

ccr model

这将引导你完成：

  1. 选择 LLM 提供商
  2. 配置 API Key
  3. 选择模型
  4. 设置路由规则

手动配置​

编辑配置文件​

# 打开配置文件
nano ~/.claude-code-router/config.json

最小配置示例​

{
  // API 密钥（可选，用于保护服务）
  "APIKEY": "your-api-key-here",

  // LLM 提供商
  "Providers": [
    {
      "name": "openai",
      "baseUrl": "https://api.openai.com/v1",
      "apiKey": "$OPENAI_API_KEY",
      "models": ["gpt-4", "gpt-3.5-turbo"]
    }
  ],

  // 默认路由
  "Router": {
    "default": "openai,gpt-4"
  }
}

环境变量​

配置支持环境变量插值：

{
  "Providers": [
    {
      "apiKey": "$OPENAI_API_KEY"  // 从环境变量读取
    }
  ]
}

在 .bashrc 或 .zshrc 中设置：

export OPENAI_API_KEY="sk-..."
export ANTHROPIC_API_KEY="sk-ant-..."

常用配置项​

HOST 和 PORT​

{
  "HOST": "127.0.0.1",  // 监听地址
  "PORT": 3456          // 监听端口
}

日志配置​

{
  "LOG": true,          // 启用日志
  "LOG_LEVEL": "info"   // 日志级别
}

路由配置​

{
  "Router": {
    "default": "openai,gpt-4",
    "background": "openai,gpt-3.5-turbo",
    "think": "openai,gpt-4",
    "longContext": "anthropic,claude-3-opus"
  }
}

配置验证​

配置文件会自动验证。常见错误：

  • 缺少 Providers：必须至少配置一个提供商
  • API Key 缺失：如果配置了 Providers，必须提供 API Key
  • 模型不存在：确保模型在提供商的 models 列表中

配置备份​

每次更新配置时会自动备份：

~/.claude-code-router/config.backup.{timestamp}.json

重新加载配置​

修改配置后需要重启服务：

ccr restart

查看当前配置​

# 通过 API 查看
curl http://localhost:3456/api/config

# 或查看配置文件
cat ~/.claude-code-router/config.json

示例配置​

OpenAI​

{
  "Providers": [
    {
      "name": "openai",
      "baseUrl": "https://api.openai.com/v1",
      "apiKey": "$OPENAI_API_KEY",
      "models": ["gpt-4", "gpt-3.5-turbo"]
    }
  ],
  "Router": {
    "default": "openai,gpt-4"
  }
}

Anthropic​

{
  "Providers": [
    {
      "name": "anthropic",
      "baseUrl": "https://api.anthropic.com/v1",
      "apiKey": "$ANTHROPIC_API_KEY",
      "models": ["claude-3-5-sonnet-20241022", "claude-3-opus-20240229"]
    }
  ],
  "Router": {
    "default": "anthropic,claude-3-5-sonnet-20241022"
  }
}

多提供商​

{
  "Providers": [
    {
      "name": "openai",
      "baseUrl": "https://api.openai.com/v1",
      "apiKey": "$OPENAI_API_KEY",
      "models": ["gpt-4", "gpt-3.5-turbo"]
    },
    {
      "name": "anthropic",
      "baseUrl": "https://api.anthropic.com/v1",
      "apiKey": "$ANTHROPIC_API_KEY",
      "models": ["claude-3-5-sonnet-20241022", "claude-3-opus-20240229"]
    }
  ],
  "Router": {
    "default": "openai,gpt-4",
    "think": "anthropic,claude-3-5-sonnet-20241022",
    "background": "openai,gpt-3.5-turbo"
  }
}