How to Use AgentRouter with Claude Code, Codex & Gemini

Overview & Limited-Time Promotion

Modern AI-assisted engineering workflows frequently demand orchestrating multiple foundational models simultaneously: Claude 3.5 Sonnet for deep architectural refactoring, OpenAI models for complex logic, and Google Gemini for high-throughput multimodal analysis.

Managing disparate provider accounts, billing agreements, and rate limits often fragments developer toolchains. AgentRouter resolves this fragmentation by functioning as a centralized reverse-proxy gateway. It provides OpenAI-compatible and Anthropic-compatible routing endpoints backed by unified balance accounting.

At the time of writing, AgentRouter has reinstated its new-user promotion: eligible developers registering via GitHub currently receive $150 in AgentRouter promotional credit usable toward supported API and model consumption. This guide details how to verify the offer, secure your tokens, and configure popular developer CLIs.

01. What Is AgentRouter?

AgentRouter is an AI model aggregation gateway designed to standardize API interactions across frontier model providers (Anthropic, OpenAI, Google DeepMind, and open-weight providers).

02. Promotional Credit ($150) & Referral System

Understanding the promotion parameters is essential for realistic resource planning:

• $150 Signup Promotional Credit: Credited to new eligible users who complete account registration using an active GitHub account.
• $50 Referral Reward: Account holders can share their unique referral link to earn $50 in promotional credit for each eligible user who registers.
• Limited-Time Availability: This promotional campaign previously concluded and was subsequently reopened. Promotional terms, credit amounts, and model rate multipliers may change without advance notice.
• Usage Scope: This credit represents promotional balance usable toward supported model/API calls routed through AgentRouter. It is not cash and does not imply that frontier models are free permanently.

03. Step-by-Step GitHub Registration

1. Navigate to the registration portal via the referral link: AgentRouter GitHub Registration.
2. Select Sign in with GitHub to authorize AgentRouter through GitHub OAuth.
3. Confirm the required OAuth permissions on the GitHub confirmation screen.
4. Upon successful redirect to the AgentRouter Console dashboard, navigate to the Wallet menu tab to verify your balance.

04. Wallet Architecture & Balance Verification

The AgentRouter Console features a unified Wallet interface that reports current balance and real-time usage consumption metrics. Below is an active screenshot demonstrating the interface layout and accounting ledger:

Note: The screenshot illustrates an account with an active balance of $174.92 and $0.08 in consumption at the time of recording. This balance reflects a combination of account credits and activity; it is presented as visual evidence of the platform's Wallet mechanics rather than a guarantee of specific individual earnings.

05. Generating & Managing API Tokens

Before configuring CLI tools or IDE plugins, you must create an API token in the console:

1. In the left sidebar, click API Token.
2. Click Add API Token.
3. Provide a descriptive name (e.g., workstation-claude-code).
4. Optional: Set an expiration date and a specific dollar quota ceiling.
5. Copy the generated secret token immediately (e.g., sk-ar-...). Treat this token with the same confidentiality as a production private key.

06. Configuring with Codex & OpenAI SDKs

AgentRouter's primary endpoint adheres to the OpenAI REST specification. To route standard OpenAI SDK calls or Codex tools through AgentRouter, override the default Base URL and API key.

Environment Configuration (macOS / Linux):

# Add to ~/.zshrc or ~/.bashrc
export OPENAI_BASE_URL="https://agentrouter.org/v1"
export OPENAI_API_KEY="YOUR_AGENTROUTER_API_KEY"

Environment Configuration (Windows PowerShell):

# Persist to Windows User Registry
setx OPENAI_BASE_URL "https://agentrouter.org/v1"
setx OPENAI_API_KEY "YOUR_AGENTROUTER_API_KEY"
setx AGENTROUTER_API_KEY "YOUR_AGENTROUTER_API_KEY"

Python OpenAI SDK Example:

from openai import OpenAI
import os

client = OpenAI(
    base_url="https://agentrouter.org/v1",
    api_key=os.environ.get("AGENTROUTER_API_KEY")
)

response = client.chat.completions.create(
    model="gpt-4o", # or "claude-3-5-sonnet-20241022", "gemini-2.0-flash"
    messages=[{"role": "user", "content": "Explain vector indexing in 2 sentences."}]
)
print(response.choices[0].message.content)

07. Configuring with Claude Code CLI

Anthropic's official command-line assistant, Claude Code, communicates with Anthropic endpoints. To route Claude Code through AgentRouter, configure the Anthropic base URL environment variable:

macOS / Linux:

export ANTHROPIC_BASE_URL="https://agentrouter.org/v1"
export ANTHROPIC_API_KEY="YOUR_AGENTROUTER_API_KEY"

Windows PowerShell:

setx ANTHROPIC_BASE_URL "https://agentrouter.org/v1"
setx ANTHROPIC_API_KEY "YOUR_AGENTROUTER_API_KEY"

# Remember to open a new PowerShell window after running setx!

Once configured, run claude in your project repository to initiate interactive terminal sessions routed seamlessly through your AgentRouter credit balance.

08. Configuring with Gemini CLI & IDE Agents

Because AgentRouter standardizes OpenAI and Gemini model IDs, you can also wire your API token into AI IDE extensions (e.g., Cursor, Continue, Roo Code, Aider):

09. API Token Security & Quota Controls

To safeguard your account balance from unintended depletion or exposure:

• Isolate Keys by Context: Create dedicated tokens for specific CLI tools rather than sharing a single global key across all workstations.
• Enforce Token Quotas: Cap experimental or development tokens at $5–$10 to prevent runaway recursive agent loops from draining your central balance.
• Never Commit Secrets: Always add .env and local configuration files to your .gitignore.
• Immediate Revocation: Revoke compromised or unneeded tokens immediately via the AgentRouter Console dashboard.

10. Proxy Latency, SLAs & Architecture Trade-offs

While unified reverse-proxy gateways provide significant convenience and economic flexibility, architects should evaluate key trade-offs:

Frequently Asked Questions

Final Takeaways & Getting Started

AgentRouter offers an efficient bridge for developers and technical marketers looking to test frontier LLMs across Claude Code, OpenAI Codex, and Gemini CLI without managing separate minimum balance agreements across three different cloud providers.