Claude Code: la guida completa

Che cos'è davvero Claude Code

Claude Code non è una finestra di chat con un pulsante per il codice. È un ciclo agentico: descrivi un risultato, lo strumento esamina il repository, propone un piano, modifica i file, esegue i test, analizza gli errori e ripete il processo — chiedendo il permesso prima di qualsiasi operazione distruttiva. È distribuito come pacchetto npm (@anthropic-ai/claude-code, attualmente 2.1.296), installer nativo, estensione per VS Code / JetBrains, app desktop e versione web che viene eseguita in sandbox ospitate da Anthropic.

Dietro le quinte, ogni turno è una chiamata alla Messages API che contiene l'intera conversazione fino a quel momento. Questo singolo fatto spiega gran parte di ciò che le persone cercano sullo strumento: perché è potente, perché consuma tanti token, perché i limiti di richieste si fanno sentire e perché un backend API più economico o a tariffa fissa cambia così tanto l'esperienza.

Configuralo per usare il gateway in due righe

Claude Code legge le variabili d'ambiente standard di Anthropic. Imposta l'URL di base su questo gateway e usa una chiave dalla tua dashboard; il resto non cambia.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
claude

Esegui /status all'interno di Claude Code per verificare l'URL di base con cui comunica, e /model per scegliere un modello. Sono disponibili tutti i modelli offerti dal gateway — consulta la guida ai modelli per l'elenco aggiornato.

Le guide

• Installazione — npm, installer nativo, Windows/WSL e risoluzione dei problemi di installazione.
• riferimento della CLI — flag, comandi slash, modalità headless, formati di output.
• Prezzi e limiti — quanto costa con l'API, con Pro/Max e con questo gateway.
• Agent SDK — controllare Claude Code in modo programmatico da Python o TypeScript.
• Skill e plugin — che cosa sono le skill, il marketplace e come crearne di proprie.
• GitHub — GitHub App, Action e @claude nelle pull request.
• Web, desktop e IDE — dove viene eseguito Claude Code oltre al terminale.
• Modelli — il modello predefinito, come cambiarlo e come sovrascriverlo per ogni livello.
• Errori — 500, 400, 429, 529, errori di autenticazione e il significato di ciascuno.
• È open source? — che cosa è open source e che cosa non lo è, e le alternative aperte.
• Tutorial — una prima sessione reale: CLAUDE.md, modalità piano, autorizzazioni, compattazione.
• Per studenti — il modo legittimo più economico per usarlo mentre impari.
• Automazione QA — generazione di test, ciclo di esecuzione e correzione, esecuzioni headless in CI, Playwright.
• Subagenti, Hook, MCP — i tre punti di estensione, ciascuno con esempi funzionanti.
• Confronto con Cursor e Confronto con Codex e OpenCode — confronti onesti e come usarli insieme.
• Ecosistema — claude-code-router, SuperClaude, caveman, righe di stato, le liste awesome.
• VS Code, OpenRouter, Limiti di frequenza — l'estensione e i suoi errori, l'uso di altri backend e il significato di «limite di richieste raggiunto».

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Domande frequenti

AI Prime Tech è un gateway API indipendente e non è affiliato ad Anthropic, né approvato o sponsorizzato da Anthropic. «Claude» e «Claude Code» sono marchi di Anthropic. Le funzionalità di Claude Code descritte qui rispecchiano la documentazione pubblica di Anthropic al momento della stesura e cambiano frequentemente; i prezzi e gli elenchi dei modelli presenti in questa pagina vengono letti dalle impostazioni attuali di questo gateway.