Documentazione della CLI di Claude Code — Comandi, flag, modalità non interattiva (2026)

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

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 Scopri i piani illimitati

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.

Documentazione della CLI di Claude Code: comandi e flag

TLDR