All tools

Connect CC Switch

Easy · GUIGUI settings

Free GUI that imports Ahrigate into Claude Code & Codex — no env editing

Connect CC Switch through api.ahrigate.com. Choose a model and a key assigned to its provider’s supply group.


Get your API key

Create an Ahrigate API key in the console and pick its supply group. The key is shown once at creation.

Get an API key

Connect it

  1. Download

    Download CC Switch

    CC Switch app icon
    CC Switchv1.4 - Free

    Manage AI providers for Claude Code & Codex. No terminal, no config files.

    Free and open-source GUI for macOS, Windows & Linux — manages your AI providers with no terminal, no config files. Pick your OS below, install it, then come back to this step.

    ↑ Opens in a new tab and redirects to the latest GitHub release

    ⚠ Existing Claude Code users — check environment conflicts
    CC Switch conflicts-detected dialog
    Conflicts Detected
    These environment variables conflict with CC Switch. Select which to clear:
    ANTHROPIC_BASE_URL=https://other-relay.io
    ANTHROPIC_API_KEY=sk-ant-•••••
    ANTHROPIC_AUTH_TOKEN=expired

    If the shell and CC Switch define different endpoints or credentials, keep one intended configuration. Clear old variables in the current terminal before testing the provider you enabled.

    # macOS / Linux: unset ANTHROPIC_API_KEY ANTHROPIC_AUTH_TOKEN ANTHROPIC_BASE_URL
    # Windows (PowerShell): Remove-Item Env:ANTHROPIC_API_KEY, Env:ANTHROPIC_AUTH_TOKEN, Env:ANTHROPIC_BASE_URL -ErrorAction SilentlyContinue
  2. Open

    Open CC Switch — find the + button

    CC Switch + button top-right
    CC Switch
    Claude Code
    Claude Desktop
    Codex
    OpenCode
    OpenClaw
    Hermes
    A
    Claude OfficialNo routing support
    https://www.anthropic.com/claude-code
    D
    default
    No official URL configured
    Click here to add Ahrigate

    Install and launch CC Switch. Select the tool in the sidebar, then use + to add a custom provider.

    You'll see two built-in providers: "Claude Official" (Anthropic OAuth — not for Ahrigate) and "default" (backup of your original config). Click + to add Ahrigate.

  3. Fields

    Fill three fields

    CC Switch provider form filled
    Add Provider
    Provider Name
    Ahrigate
    API Endpoint
    https://api.ahrigate.com
    API Key
    sk-••••••••••••••••••••

    Click "+" and choose "Custom Config" (not Claude Official). Copy the values below into the dialog — one tab for the Claude Code app tab, one for Codex.

    CC Switch · Claude Code
    # CC Switch → Add Provider → Claude Code tab
    Provider Name:  Ahrigate
    API Endpoint:   https://api.ahrigate.com
    API Key:        sk-YOUR-AHRIGATE-KEY
    Model:          claude-opus-5-5
    Endpoint · Claude Codehttps://api.ahrigate.com
    Endpoint · Codexhttps://api.ahrigate.com/v1
    API Keyyour key (from Console)Get key →
    Model · Claude Codeclaude-opus-5-5
    Model · Codexgpt-6.1-sol

    Claude Code uses the root endpoint and a Claude-group key. Codex uses /v1, Responses, an OpenAI-group key and its own model. Configure each tool separately.

  4. Activate

    Save — then enable Ahrigate

    CC Switch
    Claude Desktop
    Codex
    Hermes
    Cursor
    Providers (2)
    Claude Official
    https://www.anthropic.com/claude-code
    AhrigateACTIVE
    https://api.ahrigate.com
    Activated just now

    Save the provider, then select it and click Enable. CC Switch writes the selected tool’s configuration. Repeat in the Codex section with its separate key and model, then restart Codex. Other tools require their own provider setup.

  5. Verify

    You're in! Verify it works

    Terminal — claude
    $ claude
      Claude Code
      Powered by Ahrigate
      Type your prompt or /help for commands
    >

    Run `claude`, then /status to confirm api.ahrigate.com is active. Send a short message and check Console → Usage. Claude Desktop requires its own provider selection and an app restart.

    Your balance and usage are visible in the Console →

  6. Essentials

    Claude Code essentials

    Claude Code /model picker
    Terminal — claude
    > /model
    Select a model↑↓ navigate · Enter select · Esc cancel
    claude-opus-4-8Anthropic · 200K · Most capable
    claude-sonnet-4-6Anthropic · 200K · Balanced
    claude-haiku-4-5Anthropic · 200K · Fast
    gpt-5.5OpenAI · 128K · GPT-5 generation

    Install Claude Code with its official installer, then launch with `claude`. These commands help verify your setup:

    /modelSwitch between Claude models (Opus, Sonnet, Haiku) at runtime.
    /helpList all available slash commands and keyboard shortcuts.
    /costShow the token usage and cost for the current session.
    /clearClear the conversation context to start fresh.
    🔌 Check /status✉ Send a test message✓ Confirm console usage
    You're all setOpen console →

Read docs

Other tools