提供商配置

配置 LLM 提供商的详细指南。

支持的提供商

DeepSeek

{
  "name": "deepseek",
  "api_base_url": "https://api.deepseek.com/chat/completions",
  "api_key": "your-api-key",
  "models": ["deepseek-chat", "deepseek-coder", "deepseek-reasoner"],
  "transformer": {
    "use": ["deepseek"]
  }
}

Groq

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

Gemini

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

OpenRouter

{
  "name": "openrouter",
  "api_base_url": "https://openrouter.ai/api/v1/chat/completions",
  "api_key": "your-api-key",
  "models": [
    "anthropic/claude-3.5-sonnet",
    "google/gemini-2.5-pro-preview"
  ],
  "transformer": {
    "use": ["openrouter"]
  }
}

Mistral

{
  "name": "mistral",
  "api_base_url": "https://api.mistral.ai/v1/chat/completions",
  "api_key": "your-api-key",
  "models": ["mistral-large-latest", "mistral-small-latest"],
  "transformer": {
    "use": ["mistral"]
  }
}

Cerebras

{
  "name": "cerebras",
  "api_base_url": "https://api.cerebras.ai/v1/chat/completions",
  "api_key": "your-api-key",
  "models": ["cerebras-gpt"],
  "transformer": {
    "use": ["cerebras"]
  }
}

Codex（ChatGPT）

需要通过 ccr codex-auth 完成 OAuth 认证。

{
  "name": "codex",
  "baseUrl": "https://chatgpt.com/backend-api/codex",
  "apiKey": "oauth_dummy_key",
  "models": ["gpt-5", "gpt-5-high", "gpt-5-mini"],
  "transformer": {
    "use": ["codex"]
  }
}

Cursor（SDK）

通过 @cursor/sdk 路由到 Cursor 模型。认证使用以 crsr_ 开头的控制台密钥，或环境变量 CURSOR_API_KEY。

{
  "name": "cursor",
  "api_base_url": "https://cursor.com",
  "api_key": "$CURSOR_API_KEY",
  "models": ["composer-2", "claude-opus-4-8", "gpt-5.4"],
  "transformer": {
    "use": [
      [
        "cursor-sdk",
        {
          "cursorMode": "bridge"
        }
      ]
    ]
  }
}

使用 ccr model get cursor 发现模型。详见 Cursor SDK 集成指南。

Antigravity

通过 Google Antigravity 网关路由，使用 ccr antigravity-auth 完成 OAuth。将 gemini 链接在 antigravity-auth 之前。

{
  "name": "antigravity",
  "api_base_url": "https://daily-cloudcode-pa.sandbox.googleapis.com",
  "api_key": "oauth",
  "project_id": "$ANTIGRAVITY_PROJECT_ID",
  "models": [
    "gemini-3-pro-high",
    "gemini-3-flash",
    "claude-sonnet-4-6",
    "claude-opus-4-6-thinking"
  ],
  "transformer": {
    "use": [
      ["gemini", { "cachedContent": false, "thoughtSignatureFallback": "skip" }],
      "antigravity-auth"
    ]
  }
}

• cachedContent: false — 必需。Antigravity 没有 cachedContents 资源；Gemini 默认（true）会导致 404。
• thoughtSignatureFallback: "skip" — 保持默认。当缺少工具调用的 thought signature 时，盖印 Google 的 skip_thought_signature_validator 哨兵，避免网关 400。仅在端点拒绝该哨兵时设为 "none"。

完整选项说明：转换器 → gemini。另见 CLI 认证命令。

Qwen Chat

需要通过 ccr qwen-auth 完成 JWT 认证。

{
  "name": "qwen",
  "baseUrl": "https://qwen.aikit.club/v1/chat/completions",
  "apiKey": "oauth_dummy_key",
  "models": ["qwen-max", "qwen-plus", "qwen-turbo"],
  "transformer": {
    "use": ["qwen-auth", "reasoning", "OpenAI"]
  }
}

Chrome 内置模型（Gemini Nano）

需要运行 ccr chrome-bridge 桥接进程。

{
  "name": "chrome",
  "baseUrl": "http://127.0.0.1:9229",
  "apiKey": "dummy",
  "models": ["gemini-nano"],
  "transformer": {
    "use": ["chrome-on-device"]
  }
}

Ollama（本地模型）

{
  "name": "ollama",
  "api_base_url": "http://localhost:11434/v1/chat/completions",
  "api_key": "ollama",
  "models": ["qwen2.5-coder:latest"]
}

火山引擎

{
  "name": "volcengine",
  "api_base_url": "https://ark.cn-beijing.volces.com/api/v3/chat/completions",
  "api_key": "your-api-key",
  "models": ["deepseek-v3-250324", "deepseek-r1-250528"],
  "transformer": {
    "use": ["deepseek"]
  }
}

ModelScope

{
  "name": "modelscope",
  "api_base_url": "https://api-inference.modelscope.cn/v1/chat/completions",
  "api_key": "",
  "models": [
    "Qwen/Qwen3-Coder-480B-A35B-Instruct",
    "Qwen/Qwen3-235B-A22B-Thinking-2507"
  ],
  "transformer": {
    "use": [
      ["maxtoken", { "max_tokens": 65536 }],
      "enhancetool"
    ],
    "Qwen/Qwen3-235B-A22B-Thinking-2507": {
      "use": ["reasoning"]
    }
  }
}

DashScope（阿里云）

{
  "name": "dashscope",
  "api_base_url": "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions",
  "api_key": "your-api-key",
  "models": ["qwen3-coder-plus"],
  "transformer": {
    "use": [
      ["maxtoken", { "max_tokens": 65536 }],
      "enhancetool"
    ]
  }
}

提供商配置选项

字段	类型	必填	说明
name	string	是	提供商的唯一标识符
api_base_url	string	是	API 基础 URL
api_key	string	是	API 认证密钥
models	string[]	否	可用模型列表
transformer	object	否	应用的转换器配置

模型选择

在路由中选择模型时，使用以下格式：

{provider-name},{model-name}

例如：

deepseek,deepseek-chat

使用环境变量

您可以在配置中使用环境变量来保护 API 密钥：

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

支持 $VAR_NAME 和 ${VAR_NAME} 两种语法。

转换器配置

转换器用于适配不同提供商的 API 差异。您可以在提供商级别或模型级别配置转换器：

提供商级别转换器

应用于提供商的所有模型：

{
  "name": "openrouter",
  "transformer": {
    "use": ["openrouter"]
  }
}

模型级别转换器

应用于特定模型：

{
  "name": "deepseek",
  "transformer": {
    "use": ["deepseek"],
    "deepseek-chat": {
      "use": ["tooluse"]
    }
  }
}

下一步

• 路由配置 - 配置请求如何路由
• 转换器 - 对请求应用转换