# Riferimento Rapido Claude Code

*Comandi CLI, workflow, MCP, hook, configurazione*

> Source: Anthropic Claude Code Documentation (docs.anthropic.com) · MIT

## Per Iniziare

### Installazione e Avvio

```
npm install -g @anthropic-ai/claude-code
claude            # avvia sessione interattiva
claude --version  # controlla versione
claude update     # aggiorna all'ultima versione
```

### Autenticazione

```
claude login              # OAuth via browser
export ANTHROPIC_API_KEY="sk-ant-..."
claude logout             # cancella sessione
```

## Comandi Slash

### Comandi di Sessione

| Command | Description |
|---------|-------------|
| `/help` | Mostra i comandi disponibili |
| `/clear` | Cancella la cronologia della conversazione |
| `/compact` | Comprime il contesto per risparmiare token |
| `/cost` | Mostra utilizzo token e costo |
| `/status` | Mostra info sessione e modello |
| `/new` | Avvia una nuova conversazione |
| `/config` | Apre o visualizza la configurazione |
| `/doctor` | Diagnostica problemi di configurazione |
| `/init` | Crea un CLAUDE.md per il progetto |
| `/login` | Autentica con Anthropic |
| `/logout` | Cancella l'autenticazione |

### Comandi Workflow

| Command | Description |
|---------|-------------|
| `/bug` | Segnala un bug |
| `/review` | Richiede una revisione del codice |
| `/pr` | Crea o aggiorna una pull request |
| `/commit` | Esegue commit delle modifiche con messaggio |

## Scorciatoie da Tastiera

| Command | Description |
|---------|-------------|
| `Ctrl+C` | Annulla la generazione corrente |
| `Ctrl+D` | Esci da Claude Code (EOF) |
| `Escape` | Annulla input/modifica corrente |
| `Tab` | Completamento automatico percorsi file e comandi |
| `Su/Giù` | Naviga nella cronologia degli input |

## Flag CLI

### Flag Comuni

| Command | Description |
|---------|-------------|
| `-p, --print` | Modalità non interattiva (headless) |
| `--model` | Imposta modello: `opus`, `sonnet`, `haiku` |
| `--output-format` | Output come `text`, `json`, `stream-json` |
| `--allowedTools` | Limita gli strumenti: `Edit,Read,Bash` |
| `--max-turns N` | Limita i turni della conversazione |
| `--debug` | Abilita logging di debug |
| `-n, --name` | Assegna un nome alla sessione |

### Headless / Scripting

```
claude -p "explain this error" < log.txt
claude -p "list todos" --output-format json
echo "fix typos" | claude -p
```

## File di Configurazione

### Gerarchia CLAUDE.md

| Command | Description |
|---------|-------------|
| `./CLAUDE.md` | Istruzioni a livello progetto (versionato nel repo) |
| `./.claude/settings.json` | Impostazioni progetto (permessi, hook) |
| `~/.claude/CLAUDE.md` | Istruzioni globali utente (tutti i progetti) |
| `~/.claude/settings.json` | Impostazioni globali utente |
| `~/.claude/projects/*/CLAUDE.md` | Istruzioni utente per progetto (non nel repo) |

### Variabili d'Ambiente

| Command | Description |
|---------|-------------|
| `ANTHROPIC_API_KEY` | Chiave API per autenticazione diretta |
| `CLAUDE_MODEL` | Override del modello predefinito |
| `CLAUDE_CONFIG_DIR` | Percorso directory di configurazione personalizzata |

## Permessi

### settings.json

```
{
  "permissions": {
    "allow": ["Read", "Glob", "Grep"],
    "deny": ["Bash(rm *)"]
  }
}
```

### Modalità Permessi

| Command | Description |
|---------|-------------|
| `default` | Chiede conferma prima di strumenti rischiosi |
| `--dangerously-skip-permissions` | Consente tutti gli strumenti (solo CI/script) |
| `--allowedTools` | Flag CLI per limitare il set di strumenti |

## Server MCP

### Cosa Sono i Server MCP?

> I server Model Context Protocol estendono Claude Code con strumenti personalizzati — database, API, servizi. Gestiti via CLI o `.mcp.json`.

### Gestione via CLI

```
claude mcp add server-name -- cmd arg1 arg2
claude mcp list
claude mcp remove server-name
```

### Configurazione .mcp.json

```
{
  "mcpServers": {
    "my-db": {
      "command": "python",
      "args": ["-m", "mcp_server_db"],
      "env": { "DB_URL": "${DATABASE_URL}" }
    }
  }
}
```

### Scope

| Command | Description |
|---------|-------------|
| `.mcp.json` | Server MCP a livello progetto |
| `~/.claude/mcp.json` | Server MCP globali utente |
| `claude mcp add -s user` | Aggiunge allo scope utente |
| `claude mcp add -s project` | Aggiunge allo scope progetto |

## Hook

### Eventi Hook

| Command | Description |
|---------|-------------|
| `PreToolUse` | Eseguito prima che uno strumento venga avviato |
| `PostToolUse` | Eseguito dopo che uno strumento è completato |
| `Notification` | Eseguito quando Claude invia una notifica |
| `Stop` | Eseguito quando Claude termina una risposta |

### Esempio settings.json

```
{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Bash",
      "hooks": [{
        "type": "command",
        "command": "check-command.sh $INPUT"
      }]
    }]
  }
}
```

### Comportamento degli Hook

| Command | Description |
|---------|-------------|
| `exit 0` | Consente allo strumento di procedere |
| `exit 2` | Blocca l'esecuzione dello strumento |
| `stdout` | Feedback JSON a Claude |

## SDK e Automazione

### Scripting Headless

```
# Prompt singolo, output JSON
claude -p "summarize main.py" \
  --output-format json

# Input da pipe
git diff | claude -p "review this diff"
```

### CI / GitHub Actions

```
- uses: anthropics/claude-code-action@v1
  with:
    claude_args: >
      --max-turns 5
      --model claude-sonnet-4-6
```

### Consigli

> Usa `--max-turns` per limitare i costi nell'automazione. Usa `--output-format json` per elaborare i risultati a livello di codice. Combina con `--allowedTools` per sicurezza.

## Modelli

### Selezione Modello

```
claude --model opus     # più capace
claude --model sonnet   # bilanciato (predefinito)
claude --model haiku    # più veloce, meno costoso
```

### Scorciatoie Modello

| Command | Description |
|---------|-------------|
| `opus` | Claude Opus — massima capacità |
| `sonnet` | Claude Sonnet — predefinito, bilanciato |
| `haiku` | Claude Haiku — veloce ed economico |
| `--model full-name` | es. `claude-sonnet-4-6` |

## Best Practice

### Scrivere CLAUDE.md

> Inserisci in CLAUDE.md le convenzioni del progetto, lo stack tecnologico, i comandi di build e le istruzioni di test. Mantienilo conciso — Claude lo legge ad ogni sessione. Usa `/init` per generarne uno.

### Gestione dei Costi

| Command | Description |
|---------|-------------|
| `/cost` | Controlla l'utilizzo corrente dei token |
| `/compact` | Comprimi il contesto quando cresce |
| `--max-turns` | Limita i turni nell'automazione |
| `sonnet / haiku` | Usa modelli più economici per task semplici |

### Prompting Efficace

| Command | Description |
|---------|-------------|
| `Sii specifico` | "Correggi il null check in auth.ts:42" > "correggi bug" |
| `Fornisci contesto` | Cita file, funzioni, messaggi di errore |
| `Usa @file` | Riferisci file direttamente: `@src/main.ts` |
| `Usa immagini` | Trascina screenshot per contesto visuale |
| `Itera` | Fai follow-up per raffinare; usa `/clear` per azzerare |