Source: https://aiprimetech.io/it/claude-code/cli/

[Home](/it/) › [Claude Code](/it/claude-code/) › Guida di riferimento alla CLI

[Panoramica](/it/claude-code/)[Installazione](/it/claude-code/install/)[riferimento della CLI](/it/claude-code/cli/)[Prezzi e limiti](/it/claude-code/pricing/)[Agent SDK](/it/claude-code/sdk/)[Skill e plugin](/it/claude-code/skills/)[GitHub](/it/claude-code/github/)[Web, desktop e IDE](/it/claude-code/web-and-desktop/)[Modelli](/it/claude-code/models/)[Errori](/it/claude-code/errors/)[È open source?](/it/claude-code/open-source/)[Tutorial](/it/claude-code/tutorial/)[Per studenti](/it/claude-code/for-students/)[Automazione QA](/it/claude-code/qa-automation/)[Confronto con Cursor](/it/claude-code/vs-cursor/)[Confronto con Codex e OpenCode](/it/claude-code/vs-codex/)[Subagenti](/it/claude-code/subagents/)[Hook](/it/claude-code/hooks/)[MCP](/it/claude-code/mcp/)[Ecosistema](/it/claude-code/ecosystem/)[VS Code](/it/claude-code/vscode/)[OpenRouter](/it/claude-code/openrouter/)[Limiti di frequenza](/it/claude-code/rate-limits/)[Guida in cinese](/claude-code/zh/)

Ultimo aggiornamento: 11 ottobre 2026

# Documentazione della CLI di Claude Code: comandi e flag

Claude Code offre due modalità: la sessione interattiva avviata con claudee una modalità di stampa non interattiva per script e CI. Questa è la guida operativa di riferimento per entrambe.

## TLDR
- claude avvia una sessione interattiva nella directory corrente; claude -p "..." esegue un singolo prompt e termina.
- I comandi slash gestiscono la sessione: /init, /compact, /clear, /model, /cost, /status, /permissions, /mcp, /agents.
- --output-format json e --allowedTools ne consentono l'uso negli script; -c / -r riprendono le sessioni.

## Avvio 

```
claude                          # interactive session
claude "fix the failing test"   # start with a prompt
claude -p "summarise this repo"  # print mode: answer, then exit
claude -c                       # continue the most recent session
claude -r                       # pick a session to resume
claude --model claude-opus-5    # choose the model for this session
```

## Flag da conoscere 
- -p, --print — non interattivo; riceve l'input tramite pipe e restituisce l'output. La base di ogni utilizzo negli script e nella CI.
- --output-format text|json|stream-json — output strutturato per la modalità di stampa.
- --model <id> — qualsiasi modello offerto dall'endpoint (/v1/models su questo gateway ne mostra l'elenco).
- --allowedTools "Read,Edit,Bash(git *)" — autorizza preventivamente gli strumenti, affinché la modalità di stampa non si blocchi mai in attesa di una conferma.
- --dangerously-skip-permissions — nessuna richiesta di conferma. Solo all'interno di un container o di una sandbox che puoi eliminare.
- --max-turns N — limita il ciclo dell'agente nelle esecuzioni non interattive.
- --add-dir <path> — consente alla sessione di lavorare su più directory. 

## Comandi slash all'interno di una sessione 
- /init — scrive un file CLAUDE.md per il progetto (convenzioni, comandi di build, cosa evitare).
- /compact [focus] — riassume la conversazione per liberare spazio nel contesto; è il controllo dei costi più efficace in assoluto.
- /clear — ricomincia con un contesto vuoto.
- /model — cambia modello durante la sessione; /cost — token e spesa fino a questo momento; /status — endpoint, chiave, modello, versione.
- /permissions — ciò che l'agente può fare senza chiedere conferma; /config — impostazioni; /memory — modifica i file di memoria.
- /mcp — server MCP connessi; /agents — definisce e gestisce i subagenti; /hooks — hook di shell sugli eventi degli strumenti.
- /review — esamina una pull request; /doctor — esegue la diagnostica dell'installazione; /help — tutto il resto. 

## claude setup-token: autenticazione di lunga durata per la CI con un abbonamento 

claude setup-token effettua l'accesso una sola volta nel browser e restituisce un token OAuth di lunga durata per un abbonamento Claude Pro/Max, destinato agli ambienti non interattivi in cui /login è impossibile. Esportalo come CLAUDE_CODE_OAUTH_TOKEN nella CI e la modalità di stampa utilizzerà la quota dell'abbonamento. È riservato agli abbonamenti; con una chiave API (Anthropic o gateway) questo passaggio è superfluo: imposta invece ANTHROPIC_API_KEY. 

## Modalità di stampa per script e CI 

```
cat error.log | claude -p "explain the root cause in three lines"

claude -p "write a changelog entry for the staged diff" \
  --allowedTools "Read,Bash(git diff *)" \
  --output-format json
```

La modalità di stampa è il modo in cui GitHub Action, le integrazioni con gli editor e Agent SDK utilizzano Claude Code. Con ANTHROPIC_BASE_URL impostato sul gateway, queste esecuzioni vengono addebitate sul saldo del gateway o sul piano illimitato anziché su un account Anthropic. 

## Dove risiede la configurazione 
- CLAUDE.md nella radice del repository (e CLAUDE.local.md per le note personali) — memoria del progetto, letta a ogni sessione.
- .claude/settings.json — autorizzazioni, hook e variabili d'ambiente per progetto; ~/.claude/settings.json — globale.
- ~/.claude/skills/ e .claude/skills/ — skill; .claude/agents/ — definizioni dei subagenti.
- Ambiente: ANTHROPIC_BASE_URL, ANTHROPIC_API_KEY / ANTHROPIC_AUTH_TOKEN e le sostituzioni dei modelli per ciascun livello descritte nella guida ai modelli.

## Provalo prima gratuitamente

I nuovi account ricevono $5 di credito API gratuito con il codice CLAUDECODE — abbastanza per una serata con Claude Code su Sonnet — poi crediti pari a 7.69231× il valore nominale.

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

[Crea un account con il codice CLAUDECODE](/register?promo=CLAUDECODE)

## Domande frequenti

Come posso eseguire Claude Code senza il prompt interattivo?

Usa la modalità di stampa: claude -p "il tuo prompt". Combinala con --allowedTools e --output-format json per gli script e passa i file tramite pipe su stdin.Che cosa fa /compact?

Chiede al modello di riassumere la conversazione fino a quel momento e sostituisce la cronologia con il riepilogo. Il contesto si riduce, il costo per turno diminuisce e la sessione può continuare. Eseguilo ogni volta che un'attività cambia direzione.Posso usare Claude Code con un URL di base API diverso?

Sì: imposta ANTHROPIC_BASE_URL. /status conferma quale endpoint sta utilizzando la sessione.

## Esegui Claude Code sul gateway

Stessi modelli, due variabili d'ambiente, crediti pari a 7.69231× il valore nominale — oppure un piano illimitato a tariffa fissa. Nuovi account: $5 di credito API gratuito con il codice CLAUDECODE.[Ottieni una chiave API](/register?promo=CLAUDECODE) [Scopri i piani illimitati](/it/plans/)

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.

## Altre guide su Claude Code

[Claude Code: la guida completa](/it/claude-code/)[Come installare Claude Code](/it/claude-code/install/)[Prezzi e limiti di Claude Code, spiegati](/it/claude-code/pricing/)[L'SDK di Claude Code, ora Claude Agent SDK](/it/claude-code/sdk/)[Skill e plugin di Claude Code](/it/claude-code/skills/)[Claude Code in GitHub: App, Action e @claude](/it/claude-code/github/)[Claude Code ha un'interfaccia web? Le versioni web, desktop e per IDE spiegate](/it/claude-code/web-and-desktop/)[Quale modello usa Claude Code e come cambiarlo](/it/claude-code/models/)[Errori di Claude Code e come risolverli](/it/claude-code/errors/)[Claude Code è open source?](/it/claude-code/open-source/)[Tutorial di Claude Code: la tua prima sessione reale](/it/claude-code/tutorial/)[Claude per studenti: Claude Code, l'API e ciò che offre davvero il settore education](/it/claude-code/for-students/)[Come usare Claude Code per l'automazione QA](/it/claude-code/qa-automation/)[Claude Code e Cursor a confronto: quale scegliere, quando — e come usarli entrambi](/it/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode: confronto tra gli agenti da terminale](/it/claude-code/vs-codex/)[Subagenti di Claude Code: come funzionano, come definirli e team di agenti](/it/claude-code/subagents/)[Hook di Claude Code: controllo deterministico su ciò che fa l'agente](/it/claude-code/hooks/)[MCP in Claude Code: connessione ai server, ambiti, MCP remoto ed esempi concreti](/it/claude-code/mcp/)[L'ecosistema Claude Code: router, framework, plugin e gli elenchi che li raccolgono](/it/claude-code/ecosystem/)[Claude Code in VS Code: l'estensione, l'uso dal terminale e gli errori](/it/claude-code/vscode/)[Come usare OpenRouter in Claude Code (e quando evitarlo)](/it/claude-code/openrouter/)[Errore di limite di frequenza di Claude: cosa significa "Errore API: limite di frequenza raggiunto" e come risolverlo](/it/claude-code/rate-limits/)[Come usare Claude Code: dall'installazione all'uso quotidiano](/claude-code/zh/)