Sezioni dell'archivio conoscenza ▾

Navigazione

▸ Inizia qui Per ruolo

Categorie

Strumenti 52
Glossario 12

Strumenti

Claude Code + Gonka AI — LLM per terminale

Claude Code è un potente assistente AI per lo sviluppo direttamente nel terminale. Lavora con Git, file system, esegue test e refactoring del codice. Ma il Claude Sonnet 4.6 nativo costa $3-15 per 1M di token e, con un lavoro attivo, il conto settimanale può superare i $200.

JoinGonka Gateway supporta l'Anthropic API nativa (/v1/messages) — Claude Code si connette direttamente, senza proxy. I modelli MiniMax M2.7, DeepSeek V4 Flash e GLM-5.3 Flash tramite la rete decentralizzata Gonka costano $0.0069/1M di token — centinaia di volte meno, con una qualità comparabile nei compiti di coding.

La configurazione richiede 2 minuti: un singolo comando di installazione o alcune variabili d'ambiente.

Passo 1: Ottieni la chiave API

Se non hai ancora una chiave JoinGonka Gateway:

  1. Registrati su gate.joingonka.ai/register.
  2. Ottieni un bonus di 3M token gratuiti.
  3. Crea una API-key nella Dashboard → API Keys.
  4. Copia la chiave (formato: jg-xxx).

Una sola chiave funziona con qualsiasi strumento compatibile con OpenAI: Cursor, Aider, LangChain, ecc.

Passaggio 2: Connettere Claude Code

JoinGonka Gateway supporta nativamente l'Anthropic Messages API (/v1/messages) — nessun proxy necessario.

Il metodo consigliato — installer con un solo comando:

npx @joingonka/setup --tool claude-code

Questo è l'installer universale di JoinGonka: avvialo senza flag — npx @joingonka/setup — e ti proporrà di scegliere uno strumento da un elenco. Ce ne sono già 25: Claude Code, Codex CLI, OpenClaw, Cursor, Cline e altri — l'elenco completo nel README del pacchetto.

L'installer chiederà l'API key, farà un backup di ~/.claude/settings.json e nel blocco env scriverà solo i propri campi, senza toccare le altre tue impostazioni: l'indirizzo del gateway (ANTHROPIC_BASE_URL), la chiave (ANTHROPIC_AUTH_TOKEN), il modello (ANTHROPIC_MODEL e gli alias opus, sonnet, haiku) e i suoi limiti reali — CLAUDE_CODE_MAX_CONTEXT_TOKENS e CLAUDE_CODE_MAX_OUTPUT_TOKENS. I limiti sono importanti: per un identificatore sconosciuto Claude Code presume una propria finestra di contesto e non riesce a comprimere la cronologia in tempo, mentre i modelli della rete hanno una finestra propria — da 200K a 390K token. Il file con la chiave riceve i permessi 600. Di default viene installato DeepSeek V4 Flash, un altro modello si sceglie con il flag --model minimax|deepseek|glm. Con il flag --scope local le impostazioni vengono scritte in .claude/settings.local.json del progetto corrente, e il file stesso viene aggiunto a .gitignore.

Configurare manualmente (piano B)

Oppure manualmente — tramite variabili d'ambiente:

export ANTHROPIC_BASE_URL=https://gate.joingonka.ai
export ANTHROPIC_AUTH_TOKEN=jg-your-key
export ANTHROPIC_MODEL=deepseek-ai/DeepSeek-V4-Flash-0731
export CLAUDE_CODE_MAX_CONTEXT_TOKENS=380000
export CLAUDE_CODE_MAX_OUTPUT_TOKENS=32768
claude

Le prime due variabili indirizzano Claude Code verso il gateway: le richieste viaggiano nel formato nativo Anthropic, il Gateway le converte in richieste alla rete Gonka e restituisce la risposta in formato Anthropic. ANTHROPIC_MODEL fissa il modello della rete — senza di essa Claude Code invierebbe il proprio identificatore claude-*, e il gateway inserirebbe il modello predefinito. Le ultime due dichiarano la finestra di contesto reale e il tetto di risposta del modello scelto (serve Claude Code 2.1.223 o più recente): altrimenti, per un identificatore sconosciuto, Claude Code presume una propria finestra e non riesce a comprimere la cronologia in tempo. I valori per gli altri modelli della rete sono nella sezione «Consigli operativi» qui sotto.

Cosa è supportato:

  • Streaming — la risposta inizia a comparire subito (SSE in formato Anthropic: message_start, content_block_delta, message_stop)
  • Tool calling — Claude Code usa intensamente le funzioni per lavorare con file e comandi. Tool calling nativo su tutti i modelli della rete.
  • System prompts — i system prompt vengono trasmessi così come sono

Verifica: in Claude Code fai una domanda qualsiasi. Se compare la risposta — tutto funziona.

Per Windows/PowerShell:

$env:ANTHROPIC_BASE_URL="https://gate.joingonka.ai"
$env:ANTHROPIC_AUTH_TOKEN="jg-your-key"
$env:ANTHROPIC_MODEL="deepseek-ai/DeepSeek-V4-Flash-0731"
$env:CLAUDE_CODE_MAX_CONTEXT_TOKENS="380000"
$env:CLAUDE_CODE_MAX_OUTPUT_TOKENS="32768"
claude

Il precedente installer specifico npx @joingonka/claude-code è stato sostituito dall'universale @joingonka/setup e non viene più sviluppato — usa quello nuovo.

Confronto dei costi con Anthropic

Claude Code è uno degli strumenti AI più "avidi": invia il contesto completo dei file, la cronologia dei comandi e i diff. Una sessione tipica consuma 20-50M di token.

ProviderModelloPrezzo input/output per 1MSessione 4h (~30M token)Mese (20 giorni lavorativi)
JoinGonkaMiniMax M2.7 / DeepSeek V4 Flash / GLM-5.3 Flash$0.0069 / $0.021$0.14$2.9
AnthropicClaude Sonnet 4.6$3.00 / $15.00$210$4,200
OpenAIGPT-5.5$5.00 / $30.00$300$6,000

La differenza è di tre ordini di grandezza. Per $2.9 al mese tramite JoinGonka ottieni ciò che costa $4,200+ con Anthropic. Per uno sviluppatore indie, questa è la differenza tra "posso permettermi un AI-assistant" e "non posso".

Consigli per il lavoro

Alcuni consigli per un lavoro efficace con Claude Code tramite Gonka:

  • Contesto: MiniMax M2.7 ha una finestra di contesto di 200K token (~100K parole) — sufficiente per la maggior parte dei progetti, DeepSeek V4 Flash ha 380K, GLM-5.3 Flash ha 390K. La lunghezza massima della risposta tramite Gateway è di 8192 token per MiniMax M2.7 e GLM-5.3 Flash, 32768 per DeepSeek V4 Flash. Per generazioni lunghe potrebbe essere necessario suddividere il compito in parti. L'elenco attuale dei modelli di rete è GET https://gate.joingonka.ai/v1/models.
  • Streaming: Gateway supporta lo streaming nel formato nativo Anthropic — la risposta inizia ad apparire immediatamente, come con il Claude nativo.
  • Tool calling: tutti i modelli di rete supportano il tool calling nativo, fondamentale per Claude Code — lo strumento utilizza attivamente funzioni per lavorare con file e comandi.
  • Latenza: la prima richiesta può richiedere 5-10 secondi (cold start del nodo). Le successive — 1-3 secondi.
  • Altri strumenti: JoinGonka Gateway è compatibile anche con OpenAI API — Aider, OpenCode, Cursor si collegano tramite /v1/chat/completions.

Per gli sviluppatori che preferiscono altri strumenti da terminale, vedere anche: Aider, OpenCode.

Claude Code + Gonka = potente assistente AI da terminale a circa $0.60/mese invece di $4,200 con Anthropic. Connessione diretta tramite Anthropic API — senza proxy: un comando di installazione, 2 minuti. Token gratuiti all'avvio.
← Cursor + Gonka AI — LLM economico per la codifica OpenClaw + Gonka AI — agenti AI accessibili →

Vuoi saperne di più?

Esplora altre sezioni o inizia a guadagnare GNK subito.

Ottieni token gratuiti →