GoRoute
GoRouteDocs
Back to GatewayGitHub
Agent Integrations•Claude Code

Claude Code Complete Integration Guide

Use all frontier models (Claude 3.7 Sonnet, Gemini 3.8 Flash, DeepSeek-V3, GPT-4o) inside Claude Code with automatic failover, pooled Google Antigravity OAuth tokens, and zero rate limits.

One-Command Setup

GoRoute automatically writes your ~/.claude/settings.json and configures your environment:

goroute setup claude

This sets your proxy URL to http://127.0.0.1:8128, sets your auth token to goroute, and generates profile shortcuts under ~/.claude/profiles/.

Manual Configuration (~/.claude/settings.json)

If configuring manually, ensure your settings file matches the following structure:

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:8128",
    "ANTHROPIC_AUTH_TOKEN": "goroute"
  },
  "model": "frontier"
}
Important: Auth Token Hygiene

Claude Code warns if both ANTHROPIC_AUTH_TOKEN and ANTHROPIC_API_KEY are set simultaneously.

Always use ANTHROPIC_AUTH_TOKEN="goroute" and ensure ANTHROPIC_API_KEY is unset in your shell environment (~/.bashrc, ~/.zshrc, or ~/.config/fish/config.fish).

Clean Model Picker (Combos-Only Discovery)

By default, AI gateways expose 300+ raw upstream model names that flood the Claude Code model picker with unusable endpoints.

GoRoute automatically inspects the client User-Agent. When Claude Code queries /v1/models, GoRoute filters the catalog to only expose your active Combos:

frontierComposite cascade: Claude Sonnet 4.6 → DeepSeek → GPT
claude-modelsRotates across pooled Google Cloud Code Antigravity accounts
deepseekReasoning model with thinking tokens preserved
geminiHigh-context 1M token budget via Gemini 3.8 Flash

Instant Profile Switching

Switch models on a per-session basis when invoking Claude Code:

# Launch with primary multi-model cascade (default)
claude
# Launch specifically with DeepSeek Reasoning profile
claude --profile deepseek
# Launch specifically with Gemini high-speed profile
claude --profile gemini
← Installation & AutostartRecursive Composite Combos