Come usare OpenRouter in Claude Code (e quando evitarlo)

Percorso 1: collega Claude Code direttamente a OpenRouter

OpenRouter espone un endpoint Messages compatibile con Anthropic insieme alla sua API in stile OpenAI. A Claude Code servono soltanto l'URL di base e una chiave, quindi la configurazione usa le stesse due variabili che useresti per qualsiasi gateway — controlla nella documentazione di OpenRouter il percorso di base attuale se quello riportato sotto è cambiato:

export ANTHROPIC_BASE_URL=https://openrouter.ai/api
export ANTHROPIC_AUTH_TOKEN=sk-or-...     # your OpenRouter key
claude --model anthropic/claude-sonnet-5   # OpenRouter's model id format

Gli ID dei modelli seguono la nomenclatura di OpenRouter vendor/model , che è anche quella da usare nelle variabili per ciascun livello (ANTHROPIC_DEFAULT_SONNET_MODEL e simili). Esegui /status per confermare l'endpoint e /model per cambiare modello. La fatturazione è quella di OpenRouter: il prezzo di listino del modello più la commissione della piattaforma OpenRouter sui crediti, quindi questo percorso costa leggermente *di più* rispetto all'uso diretto di Anthropic — il suo vantaggio è la comodità di un unico account, non il prezzo.

Percorso 2: claude-code-router per i modelli diversi da Claude

claude-code-router è un proxy locale che riceve le richieste di Claude Code e inoltra ciascuna a un fornitore scelto in base a una regola — default, background, think, long-context. Configura OpenRouter come fornitore con la tua chiave, scegli i modelli per ciascun percorso e avvia con ccr code. È così che si eseguono modelli con pesi aperti o di altri fornitori all'interno di Claude Code.

// ~/.claude-code-router/config.json (excerpt)
{
  "Providers": [{
    "name": "openrouter",
    "api_base_url": "https://openrouter.ai/api/v1/chat/completions",
    "api_key": "sk-or-...",
    "models": ["anthropic/claude-sonnet-5", "google/gemini-2.5-pro", "deepseek/deepseek-chat"]
  }],
  "Router": { "default": "openrouter,anthropic/claude-sonnet-5", "background": "openrouter,deepseek/deepseek-chat" }
}

Cosa non funziona: il ciclo operativo dell'agente di Claude Code si basa sul formato di Anthropic per l'uso degli strumenti, e il router deve tradurlo per i modelli in stile OpenAI. I modelli più capaci riescono a gestirlo; quelli più piccoli omettono chiamate agli strumenti, inventano percorsi di file o ignorano il protocollo di autorizzazione, e la sessione si riduce a una serie di nuovi tentativi. Mantieni i percorsi *default* e *think* su un modello Claude e usa gli altri per il lavoro in background: così la configurazione funziona bene.

Quanto costa, in pratica

• OpenRouter diretto: prezzo di listino di Anthropic + commissione di OpenRouter. Comodo, mai più economico di Anthropic.
• claude-code-router + OpenRouter: il costo dei modelli a cui vengono instradate le richieste; il risparmio deriva dall'invio delle attività in background a modelli economici, non da un prezzo inferiore di Claude.
• Gateway Claude (questo sito): gli stessi modelli Claude, fatturati alle tariffe di listino usando crediti acquistati a un prezzo inferiore del 87% al valore nominale ($13 → $100 di utilizzo), oppure un piano illimitato a tariffa fissa a partire da $1. Sono disponibili anche GPT-6 / GPT-5.x, tramite il gruppo Codex.

Se vuoi soltanto Claude, evita OpenRouter

La maggior parte delle persone che cerca "OpenRouter in Claude Code" vuole una di queste due cose: spendere meno per Claude oppure pagare senza un account della console Anthropic. OpenRouter risolve la seconda esigenza e peggiora la prima. Un gateway risolve entrambe — le stesse due variabili, senza proxy:

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
claude

E le due soluzioni si possono combinare: definisci questo gateway come fornitore di tipo Anthropic in claude-code-router e instrada verso di esso i livelli Claude, inviando le attività in background altrove. La guida all'ecosistema approfondisce il router.

Tutti i piani illimitati →

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Domande frequenti

AI Prime Tech è un gateway API indipendente e non è affiliato ad Anthropic, né approvato o sponsorizzato da Anthropic. «Claude» e «Claude Code» sono marchi di Anthropic. Le funzionalità di Claude Code descritte qui rispecchiano la documentazione pubblica di Anthropic al momento della stesura e cambiano frequentemente; i prezzi e gli elenchi dei modelli presenti in questa pagina vengono letti dalle impostazioni attuali di questo gateway.