Claude Code nel terminale - Logicc Centro assistenza | Productlane

Claude Code nel terminale

Configura Claude Code tramite l'endpoint Logicc compatibile con Anthropic, seleziona i modelli Claude, monitora l'utilizzo e risolvi gli errori comuni.

Ultimo aggiornamento: 27 agosto 2026

Claude Code può essere collegato all'API Logicc utilizzando l'endpoint compatibile con Anthropic. L'interfaccia viene eseguita nel terminale. Per questa integrazione si consigliano solo modelli Claude abilitati.

Beta: Claude Code viene aggiornato regolarmente. Le nuove funzionalità client potrebbero comportare ulteriori richieste al gateway. Controllare la versione utilizzata e il flusso di lavoro previsto prima dell'uso produttivo.

Avvio rapido

Installa Claude Code.
Imposta la chiave API Logicc e l'URL di base come variabili di ambiente.
Avvia Claude Code con un modello Claude abilitato.
Controllare la connessione con /status e modello con /model.
Controllare la quota dopo la prima richiesta di test.

Requisiti

Chiave API Logicc attiva
Modello Claude abilitato
Versione attuale di Claude Code
Terminale su macOS, Linux, Windows o WSL

1. Installa Claude Code

macOS, Linux o WSL:

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

In alternativa su macOS:

brew install --cask claude-code

Controlla l'installazione:

claude --version

2. Configura l’API Logicc

macOS, Linux o WSL

export LOGICC_API_KEY="LA_TUA_CHIAVE_API_LOGICC"
export ANTHROPIC_AUTH_TOKEN="$LOGICC_API_KEY"
export ANTHROPIC_BASE_URL="https://api.logicc.cloud/anthropic"
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY="1"

Windows PowerShell

$env:LOGICC_API_KEY = "LA_TUA_CHIAVE_API_LOGICC"
$env:ANTHROPIC_AUTH_TOKEN = $env:LOGICC_API_KEY
$env:ANTHROPIC_BASE_URL = "https://api.logicc.cloud/anthropic"
$env:CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY = "1"

ANTHROPIC_AUTH_TOKEN viene inviato al gateway Logicc come token Bearer. L'URL di base sostituisce l'endpoint diretto di Anthropic per questa sessione.

3. Controlla modelli e quote

curl "https://api.logicc.cloud/v1/models" \
  -H "Authorization: Bearer $LOGICC_API_KEY"

Utilizza solo gli ID modello di questa risposta.

4. Avvia Claude Code

cd /percorso/del/progetto
claude --model claude-sonnet-5

Windows PowerShell:

Set-Location "C:\Percorso\Del\Progetto"
claude --model claude-sonnet-5

Controlla connessione e modello:

/status
/model

Quando il rilevamento del gateway è abilitato, i modelli di gateway aggiuntivi vengono visualizzati sotto /model con la nota "Dal gateway".

5. Impostazioni permanenti

Le impostazioni non segrete possono essere memorizzate in ~/.claude/settings.json:

{
  "model": "claude-sonnet-5",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.logicc.cloud/anthropic",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"
  }
}

Su Windows il percorso è %USERPROFILE%\.claude\settings.json.

Non archiviare la chiave API in un .claude/settings.json specifico del progetto, Git o script condivisi. Per un utilizzo a lungo termine, utilizzare un Secret Manager o un Credential Helper.

Scelta del modello

Modelli consigliati

Modello	ID modello	Raccomandazione	Profilo dei costi
Claude Sonnet 5	`claude-sonnet-5`	Standard per la maggior parte delle attività di codifica	Medio
Claude Haiku 4.5	`claude-haiku-4-5`	Compiti di routine rapidi	Inferiore
Claude Opus 5	`claude-opus-5`	Pianificazione complessa e compiti impegnativi	Alto

Altri ID documentati

claude-opus-4-8, claude-opus-4-6, claude-sonnet-4@20250514, claude-3-7-sonnet@20250219, claude-3-5-sonnet-v2@20241022 e claude-haiku-4-5@20251001.

I modelli più recenti potrebbero richiedere una versione aggiornata di Claude Code. Se mancano voci, esegui claude update.

Compatibilità

Tipo di modello	Stato	Nota
Modelli Claude abilitati	Raccomandato	Compatibilità nativa con Anthropic Messages
Modelli diversi da Claude	Non ufficialmente supportato	La chiamata degli strumenti, il ragionamento, la memorizzazione nella cache dei prompt e il cambio di modello potrebbero non riuscire

Per i modelli GPT, utilizzare Codex o OpenCode.

Costi e quote

Le sessioni agentiche di coding possono eseguire automaticamente molti passaggi di modelli e strumenti. Controlla regolarmente il budget rimanente:

curl "https://api.logicc.cloud/api/governance/virtual-keys/quota" \
  -H "Authorization: Bearer $LOGICC_API_KEY"

Budget, consumi e budget residuo sono mantenuti in euro.

Protezione dei dati

Claude Code funziona localmente con file di progetto condivisi e strumenti terminali. L'elaborazione del modello non avviene localmente. Le richieste e i file selezionati o i frammenti di codice vengono trasferiti al provider di modelli configurato tramite l'API Logicc. La ricerca web, i server MCP e i plugin possono creare flussi di dati aggiuntivi.

Risoluzione dei problemi

Errore	Prossimo passo
`401`	Controlla `ANTHROPIC_AUTH_TOKEN`
`403`	Controlla la disponibilità del modello e lo stato della chiave API
`404`	Imposta `ANTHROPIC_BASE_URL` esattamente su `https://api.logicc.cloud/anthropic`
`429`	Controlla la quota e il limite di velocità
Manca il modello	Controlla `/v1/models`, esegui `claude update` e riavvia la sessione
Accesso diretto ad Anthropic attivo	Avvia Claude Code dallo stesso terminale delle variabili impostate e controlla `/status`
Gli strumenti GPT non funzionano	Passa a un modello Claude o utilizzare Codex o OpenCode

Supporto

Se hai domande, scrivi a [email protected] con oggetto API. Indica la versione di Claude Code, il sistema operativo, l’ID del modello, lo stato HTTP, l’orario e il messaggio di errore completo. Non includere la chiave API.

Ulteriore documentazione:

Centro assistenza Logicc: https://help.logicc.com/docs
Connessione gateway: https://code.claude.com/docs/en/llm-gateway-connect
Configurazione del modello: https://code.claude.com/docs/en/model-config

È stato utile?

⌘J