Vai al contenuto principale
Usa questa guida per collegare Claude Code a CometAPI. Riferimenti ufficiali:
La disponibilità dei modelli cambia nel tempo. Per gli ID correnti dei modelli Claude, consulta la pagina Modelli di CometAPI.

Prerequisiti

  • Una chiave CometAPI dal tuo dashboard (inizia con sk-)
  • Git installato
  • OS supportato: macOS, Linux o Windows

Installa Claude Code

1

Esegui l’installer ufficiale

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

Verifica l’installazione

claude --version

Configura l’endpoint CometAPI

Crea o modifica il file di configurazione:
  • macOS / Linux: ~/.claude/settings.json
  • Windows: %USERPROFILE%\.claude\settings.json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-cometapi-key",
    "ANTHROPIC_BASE_URL": "https://api.cometapi.com"
  }
}
Sostituisci sk-your-cometapi-key con la tua chiave CometAPI reale, quindi avvia Claude Code:
cd your-project
claude

Risoluzione dei problemi

settings.json non ha effetto?
  1. Riavvia completamente il terminale (chiudi tutte le finestre e riaprile)
  2. Se ancora non funziona, crea ~/.claude.json e aggiungi:
    {
      "hasCompletedOnboarding": true
    }
    
  3. Come soluzione alternativa, esporta direttamente le variabili d’ambiente:
    # Add to ~/.zshrc (macOS) or ~/.bashrc (Linux)
    export ANTHROPIC_AUTH_TOKEN="sk-your-cometapi-key"
    export ANTHROPIC_BASE_URL="https://api.cometapi.com"
    
Invalid API Key o Please run /login? Controlla che ~/.claude/settings.json esista e che il formato JSON sia valido (niente virgole finali, virgolette corrette). Verificalo su jsonlint.com. Hai effettuato l’accesso in precedenza al servizio ufficiale di Anthropic? Claude Code dà priorità alle credenziali ufficiali memorizzate nella cache. Esegui /logout all’interno di Claude Code, chiudilo e poi riavvialo. Se ancora non funziona:
rm -rf ~/.config/claude-code/auth.json
Lo stato mostra offline? Claude Code verifica la connettività tramite Google. offline significa solo che Google non è raggiungibile — questo non influisce sull’uso di CometAPI. Fetch / navigazione web non funziona? La funzione Fetch di Claude Code chiama prima il servizio nativo di Anthropic, che richiede accesso diretto a internet. Potrebbe essere necessario un proxy a livello di sistema.