Claude Code

Claude Code è l’agente di programmazione terminale di Anthropic e funziona direttamente con il pacchetto Claude di TeamSocLo. L’estensione di Claude Code per VS Code / JetBrains condivide la configurazione della CLI.

Qualsiasi chiave di pacchetto funziona: una chiave Claude esegue modelli Claude, una chiave GPT esegue modelli GPT (il gateway traduce i protocolli). La Base URL per Claude Code è https://gpt.teamsoclo.site senza /v1, a differenza delle app compatibili con OpenAI.

Claude Code non è obbligatorio. Il gateway converte i protocolli, quindi una chiave del pacchetto Claude funziona anche in Codex (--model claude-opus-5 durante l’installazione, o modifica model in config.toml), Cursor, Cline, Chatbox e qualsiasi app compatibile con OpenAI: basta usare la Base URL https://gpt.teamsoclo.site/v1, la tua chiave e un nome di modello claude-.... Gli utenti scelgono lo strumento che preferiscono.

Preferisci non usare il terminale? TeamSocLo Key Tool è un’app per Windows e macOS: incolla la tua chiave una volta per configurare Claude Code, Codex e oltre 20 altri strumenti.

Installazione con un solo comando

Sostituisci sk-xxx con la tua chiave del pacchetto Claude, incolla in un terminale e premi Invio. Lo script verifica la chiave, elenca i modelli Claude che può chiamare e ti permette di scegliere il principale (Invio = claude-opus-5), installa Claude Code e scrive la configurazione.

macOS / Linux
Windows

curl -fsSL https://redeem.teamsoclo.site/install/claude.sh | bash -s -- --key sk-xxx

Lo script chiede prima la lingua (1 = vietnamita, 2 = inglese; salta con --lang en o --lang vi). Senza --key chiede la chiave. Per forzare il modello principale aggiungi --model claude-fable-5-1.

Apri PowerShell:

$env:TSL_KEY="sk-xxx"; irm https://redeem.teamsoclo.site/install/claude.ps1 | iex

Per forzare il modello principale aggiungi $env:TSL_MODEL="claude-fable-5-1"; prima di irm.

Sorgente: claude.sh, claude.ps1. Lo script viene eseguito solo sul tuo computer e invia la chiave solo a gpt.teamsoclo.site per la verifica.

Cosa fa lo script

Verifica la chiave con il gateway; una chiave senza modelli Claude si ferma qui senza toccare il tuo computer.
Sceglie i modelli: principale claude-opus-5 (se la tua chiave ce l’ha), modello veloce per le attività in background claude-haiku-4-5, altrimenti il migliore disponibile in ordine di preferenza.
Richiede Node.js 18+; installa o aggiorna Claude Code con npm install -g @anthropic-ai/claude-code.
Esegue il backup di ~/.claude/settings.json come settings.json.bak.<timestamp>, poi scrive il blocco env che punta al gateway. Tutto il resto nel file (permessi, hook…) viene preservato.

Rieseguilo in qualsiasi momento per cambiare chiavi.

Dopo l’installazione

Apri un nuovo terminale, vai al tuo progetto, esegui claude

cd tuo-progetto
claude

Al primo avvio Claude Code potrebbe chiedere come accedere: scegli l’opzione chiave API (già configurata), non accedere con un account Anthropic.

Cambiare modello in una sessione

Digita /model e scegli. Modelli nel pacchetto: claude-fable-5-1, claude-fable-5, claude-opus-5, claude-opus-5-5, claude-opus-4-8 / 4-7 / 4-6, claude-sonnet-5, claude-sonnet-4-6, claude-haiku-4-5. I modelli più potenti consumano crediti più velocemente, vedi Modelli e pacchetti.

Estensione per VS Code / JetBrains

Installa l’estensione Claude Code e riavvia l’editor; legge lo stesso ~/.claude/settings.json.

Configurazione manuale

~/.claude/settings.json (Windows: %USERPROFILE%\.claude\settings.json) ha bisogno di questo blocco env; mantieni le altre voci che hai già:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://gpt.teamsoclo.site",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxx",
    "ANTHROPIC_MODEL": "claude-opus-5",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

Oppure esporta le stesse variabili nella tua shell. ANTHROPIC_SMALL_FAST_MODEL è importante: Claude Code usa un modello piccolo per le attività in background, e senza di esso chiama un nome di modello che il tuo pacchetto non ha.

Con l’SDK di Anthropic

import anthropic

client = anthropic.Anthropic(
    base_url="https://gpt.teamsoclo.site",
    auth_token="sk-xxx",
)
msg = client.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello"}],
)
print(msg.content[0].text)

curl https://gpt.teamsoclo.site/v1/messages \
  -H "Authorization: Bearer sk-xxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-opus-5","max_tokens":1024,"messages":[{"role":"user","content":"Hello"}]}'

Una chiave Claude funziona anche tramite il protocollo OpenAI (/v1/chat/completions, modello claude-...) in Cursor, Cline e Chatbox, vedi cURL / Python.

Disinstallare

macOS / Linux
Windows

rm -rf ~/.claude/settings.json; npm uninstall -g @anthropic-ai/claude-code

Per mantenere Claude Code ma rimuovere il gateway, elimina le righe ANTHROPIC_* in settings.json, oppure copia settings.json.bak.<timestamp> di nuovo.

Remove-Item "$env:USERPROFILE\.claude\settings.json"; npm.cmd uninstall -g @anthropic-ai/claude-code

Se non funziona

La chiave è del pacchetto Claude (la pagina di verifica elenca modelli claude-...).
ANTHROPIC_BASE_URL non ha /v1 alla fine.
Hai aperto un nuovo terminale dopo l’installazione.
model not found per un modello inaspettato: imposta ANTHROPIC_SMALL_FAST_MODEL come indicato sopra.
Altrimenti vedi Risoluzione dei problemi.

Guida introduttiva

Configurazione

Supporto

Installazione con un solo comando

Cosa fa lo script

Dopo l’installazione

Configurazione manuale

Con l’SDK di Anthropic

Disinstallare

Se non funziona

​Installazione con un solo comando

​Cosa fa lo script

​Dopo l’installazione

​Configurazione manuale

​Con l’SDK di Anthropic

​Disinstallare

​Se non funziona

Installazione con un solo comando

Cosa fa lo script

Dopo l’installazione

Configurazione manuale

Con l’SDK di Anthropic

Disinstallare

Se non funziona