Claude Code attraverso il Portale Modello

Questa guida utilizza un permanente settings.json configurazione. ANTHROPIC_BASE_URL deve essere specificato senza /v1.

Valori richiesti

ANTHROPIC_BASE_URL=https://api.model-gate.com
ANTHROPIC_AUTH_TOKEN=mg_live_...

ANTHROPIC_AUTH_TOKEN viene inviato come token Portatore. Anche Model Gate accetta x-api-key, ma il formato del token di autenticazione è appropriato per un gateway LLM.

1. Installa Claude Code

Programma di installazione nativo per macOS o Linux

curl -fsSL https://claude.ai/install.sh | bash

alternativa npm

npm install -g @anthropic-ai/claude-code

Windows PowerShell

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

Chiudi e riapri il terminale, quindi verifica:

claude --version

Utilizzare le attuali istruzioni di installazione ufficiali quando il programma di installazione cambia: https://docs.anthropic.com/en/docs/claude-code/getting-started.

2. Creare la directory delle impostazioni

Linux o macOS

mkdir -p ~/.claude
nano ~/.claude/settings.json

Windows PowerShell

New-Item -ItemType Directory -Force "$HOME\.claude" | Out-Null
notepad "$HOME\.claude\settings.json"

3. settings.json consigliato

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.model-gate.com",
    "ANTHROPIC_AUTH_TOKEN": "mg_live_...",
    "ANTHROPIC_MODEL": "claude-sonnet-4.6",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4.5"
  },
  "model": "claude-sonnet-4.6"
}

Sostituisci gli ID modello con gli ID abilitati restituiti da:

curl https://api.model-gate.com/v1/models \
  -H "Authorization: Bearer mg_live_..."

4. Sostituisci gli slot Opus, Sonnet e Haiku

Claude Code espone tre slot del modello standard. Puoi mapparli agli ID modello Model Gate:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.model-gate.com",
    "ANTHROPIC_AUTH_TOKEN": "mg_live_...",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
  }
}

Questi valori sovrascrivono i tre slot standard; non creano nuovi pulsanti illimitati della GUI.

5. Impostazioni facoltative di privacy e timeout

Aggiungi solo le impostazioni che comprendi:

{
  "env": {
    "DISABLE_TELEMETRY": "1",
    "DISABLE_ERROR_REPORTING": "1",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "BASH_DEFAULT_TIMEOUT_MS": "120000",
    "BASH_MAX_TIMEOUT_MS": "600000"
  }
}

Non abilitare l'esclusione delle autorizzazioni a livello globale a meno che non si comprenda l'impatto sulla sicurezza. Model Gate non richiede bypassPermissions.

6. Inizio Claude Code

claude

Utilizzo /model per verificare o modificare il modello selezionato.

7. Test una tantum senza settings.json

Linux o macOS

export ANTHROPIC_BASE_URL="https://api.model-gate.com"
export ANTHROPIC_AUTH_TOKEN="mg_live_..."
claude

Windows PowerShell

$env:ANTHROPIC_BASE_URL = "https://api.model-gate.com"
$env:ANTHROPIC_AUTH_TOKEN = "mg_live_..."
claude

Risoluzione dei problemi

Problema	Risoluzione
claude non è stato trovato	Chiudi e riapri il terminale, quindi esegui claude --version. Controllo where.exe claude su Windows o which claude su Unix.
È richiesta l'autenticazione	Verificare ANTHROPIC_AUTH_TOKEN, chiudi Claude Code e riavvialo.
Il modello non è stato trovato	Utilizza un ID canonico o un alias abilitato restituito da /v1/models.
Le richieste vanno direttamente ad Anthropic	Verifica che l'URL di base sia esatto https://api.model-gate.com senza /v1.
401 invalid_api_key	Ruota la chiave Model Gate e aggiorna settings.json.

Riferimento al gateway ufficiale: https://docs.anthropic.com/en/docs/claude-code/llm-gateway.