Claude Code

Collega Claude Code con le impostazioni gateway Messages native.

Installazione e preparazione

  1. Installa Claude Code con il programma nativo qui sotto; su Windows usa i comandi PowerShell qui sotto. Riapri il terminale ed esegui claude --version.
  2. Crea una chiave API nella console routerra.ai e copia un ID di modello Claude autorizzato. L’accesso con un abbonamento Claude non fornisce questa chiave. Il modello scelto deve supportare Messages in streaming e strumenti.
curl -fsSL https://claude.ai/install.sh | bash
claude --version

Per Windows PowerShell:

irm https://claude.ai/install.ps1 | iex
claude --version

Configurare Claude

  1. Unisci env in ~/.claude/settings.json (Windows: %USERPROFILE%\.claude\settings.json), conserva le altre impostazioni e sostituisci entrambi i segnaposto. ANTHROPIC_BASE_URL è la radice senza /v1; Claude Code aggiunge il percorso Messages. ANTHROPIC_AUTH_TOKEN fornisce l’autenticazione Bearer.
  2. Chiudi le sessioni, avvia claude e controlla l’autenticazione con /status. Cambia esplicitamente con /model YOUR_CLAUDE_MODEL_ID per evitare che un alias scelga un modello non disponibile.
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://routerra.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_CLAUDE_MODEL_ID"
  }
}

Verificare la connessione

Invia un breve prompt e chiedi l’elenco dei file del progetto per verificare gli strumenti. Con 401, controlla token obsoleti e un ANTHROPIC_API_KEY ereditato; elimina i conflitti e riavvia. Per un 404 del percorso, cerca /v1 duplicato. Senza /v1/messages/count_tokens, i conteggi di /context possono essere stimati o assenti. È un limite distinto dallo streaming e dagli strumenti.