Skip to main content

Providers Configuration

Detailed guide for configuring LLM providers.

Provider Schema​

In this fork, provider entries in config.json use the following fields:

{
  "name": "provider-name",
  "api_base_url": "https://example.com/v1/chat/completions",
  "api_key": "$PROVIDER_API_KEY",
  "models": ["model-1", "model-2"],
  "transformer": {
    "use": ["OpenAI"]
  }
}

Provider Configuration Options​

FieldTypeRequiredDescription
namestringYesUnique provider identifier
api_base_urlstringYesProvider API base URL or endpoint
api_keystringYesAPI key, placeholder, or subscription auth token marker depending on provider
modelsstring[]NoList of available models
transformer.usestring[]NoTransformers applied to the provider

Supported Providers​

DeepSeek​

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

Groq​

{
  "name": "groq",
  "api_base_url": "https://api.groq.com/openai/v1/chat/completions",
  "api_key": "$GROQ_API_KEY",
  "models": ["llama-3.3-70b-versatile"],
  "transformer": {
    "use": ["OpenAI"]
  }
}

Gemini​

{
  "name": "gemini",
  "api_base_url": "https://generativelanguage.googleapis.com/v1beta/models/",
  "api_key": "$GEMINI_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": "$OPENROUTER_API_KEY",
  "models": ["anthropic/claude-sonnet-4", "google/gemini-2.5-pro-preview"],
  "transformer": {
    "use": ["openrouter"]
  }
}

Mistral​

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

Codex (ChatGPT)​

Codex supports two auth modes:

  • OAuth via ccr codex-auth
  • PAT via api_key starting with at-

Codex with OAuth​

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

Codex with PAT​

{
  "name": "codex",
  "api_base_url": "https://chatgpt.com/backend-api/codex",
  "api_key": "at-your-personal-access-token",
  "models": ["gpt-5", "gpt-5-high", "gpt-5-mini"],
  "transformer": {
    "use": ["codex"]
  }
}

If api_key starts with at-, CCR uses PAT auth. Otherwise it falls back to OAuth tokens from ~/.claude-code-router/codex_auth.json.

Cursor (SDK)​

Routes through Cursor models via @cursor/sdk. Auth uses a dashboard key starting with crsr_, or the CURSOR_API_KEY environment variable.

{
  "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"
        }
      ]
    ]
  }
}

Discover models with ccr model get cursor. See the Cursor SDK guide.

Claude Subscription​

Claude subscription auth uses OAuth via ccr claude-auth and requires the claude-auth + Anthropic transformer chain.

{
  "name": "claude-subscription",
  "api_base_url": "https://api.anthropic.com",
  "api_key": "no-key",
  "models": ["claude-opus-4-8", "claude-sonnet-4-6", "claude-haiku-4-5"],
  "transformer": {
    "use": ["claude-auth", "Anthropic"]
  }
}

Antigravity​

Routes through Google's Antigravity gateway with OAuth via ccr antigravity-auth. Chain gemini before 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 — required. Antigravity has no cachedContents resource; the Gemini default (true) causes 404s.
  • thoughtSignatureFallback: "skip" — keep the default. On a missing tool-call thought signature, stamp Google's skip_thought_signature_validator sentinel so the gateway does not 400. Only set "none" if the endpoint rejects that sentinel.

Full option reference: Transformers → gemini. See also CLI auth commands.

Qwen Chat​

Requires JWT authentication via ccr qwen-auth.

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

Chrome On-Device (Gemini Nano)​

Requires the bridge process via ccr chrome-bridge.

{
  "name": "chrome-nano",
  "api_base_url": "http://127.0.0.1:3457",
  "api_key": "placeholder",
  "models": ["gemini-nano"],
  "transformer": {
    "use": ["chrome-on-device", "tooluse"]
  }
}

Model Selection​

When selecting a model in routing, use the format:

{provider-name},{model-name}

For example:

deepseek,deepseek-chat
codex,gpt-5
cursor,composer-2
claude-subscription,claude-sonnet-4-6
chrome-nano,gemini-nano

Auth Notes by Provider​

  • Standard API providers usually use a normal API key in api_key
  • Codex can use either OAuth (ccr codex-auth) or a PAT in api_key
  • Cursor uses a crsr_ key in api_key or CURSOR_API_KEY (no OAuth CLI)
  • Claude subscription uses OAuth tokens managed by ccr claude-auth; api_key is just a placeholder marker
  • Qwen uses a JWT managed by ccr qwen-auth
  • Chrome on-device uses a local bridge, so api_key is only a placeholder