315 {315 {
316 "matcher": "Edit|Write",316 "matcher": "Edit|Write",
317 "hooks": [317 "hooks": [
318318 { "type": "command", "command": "npx prettier --write --ignore-unknown \"$(jq -r '.tool_input.file_path')\"" } { "type": "command", "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\"" }
319 ]319 ]
320 }320 }
321 ]321 ]
92 92
93Oltre al binario, l'immagine ha bisogno di:93Oltre al binario, l'immagine ha bisogno di:
94 94
9595* **Un'immagine basata su glibc**: la build glibc ha solo dipendenze dinamiche dalle librerie glibc. Le immagini basate su Musl hanno bisogno della build `linux-x64-musl` o `linux-arm64-musl` più pacchetti aggiuntivi; consulta [Configurazione di Alpine Linux](https://code.claude.com/docs/it/setup.md#alpine-linux-and-musl-based-distributions).* **Un'immagine basata su glibc**: la build glibc ha solo dipendenze dinamiche dalle librerie glibc. Le immagini basate su Musl hanno bisogno della build `linux-x64-musl` o `linux-arm64-musl`, la cui unica dipendenza dinamica è musl.
96* **Una directory di stato scrivibile**: il gateway funziona come qualsiasi utente, ma le immagini minime non hanno home scrivibile. Imposta `CLAUDE_CONFIG_DIR` a un percorso scrivibile come `/tmp/.claude`.96* **Una directory di stato scrivibile**: il gateway funziona come qualsiasi utente, ma le immagini minime non hanno home scrivibile. Imposta `CLAUDE_CONFIG_DIR` a un percorso scrivibile come `/tmp/.claude`.
97* **Il comando del container**: `claude gateway --config /etc/claude/gateway.yaml`, con il file di configurazione montato in sola lettura e i segreti forniti come variabili di ambiente; il gateway ascolta su `listen.port`, predefinito `8080`.97* **Il comando del container**: `claude gateway --config /etc/claude/gateway.yaml`, con il file di configurazione montato in sola lettura e i segreti forniti come variabili di ambiente; il gateway ascolta su `listen.port`, predefinito `8080`.
98 98
3335 "hooks": [3335 "hooks": [
3336 {3336 {
3337 "type": "command",3337 "type": "command",
33383338 "command": "bash -c 'jq -r .worktree_path | xargs rm -rf'" "command": "bash -c 'p=$(jq -er .worktree_path) && rm -rf -- \"$p\"'"
3339 }3339 }
3340 ]3340 ]
3341 }3341 }
50 "PostToolUse": [50 "PostToolUse": [
51 {51 {
52 "matcher": "Edit|Write",52 "matcher": "Edit|Write",
5353 "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write" }] "hooks": [{ "type": "command", "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\"" }]
54 }54 }
55 ],55 ],
56 "Notification": [56 "Notification": [
221 "hooks": [221 "hooks": [
222 {222 {
223 "type": "command",223 "type": "command",
224224 "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write" "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\""
225 }225 }
226 ]226 ]
227 }227 }
32| `Ctrl+Z` | Sospendi Claude Code | Solo Unix. Sospende il processo alla tua shell; esegui `fg` per riprendere |32| `Ctrl+Z` | Sospendi Claude Code | Solo Unix. Sospende il processo alla tua shell; esegui `fg` per riprendere |
33| `Frecce sinistra/destra` | Cicla attraverso le schede della finestra di dialogo | Naviga tra le schede nelle finestre di dialogo dei permessi e nei menu. In una finestra di dialogo con schede, i tasti cambiano le schede mentre la riga delle schede ha il focus. Vedi [Azioni delle schede](https://code.claude.com/docs/it/keybindings.md#tabs-actions) per come si muove il focus |33| `Frecce sinistra/destra` | Cicla attraverso le schede della finestra di dialogo | Naviga tra le schede nelle finestre di dialogo dei permessi e nei menu. In una finestra di dialogo con schede, i tasti cambiano le schede mentre la riga delle schede ha il focus. Vedi [Azioni delle schede](https://code.claude.com/docs/it/keybindings.md#tabs-actions) per come si muove il focus |
34| `Tab` | Accetta un suggerimento di completamento automatico, o aggiungi un commento a una risposta di permesso | Mentre i suggerimenti di completamento automatico vengono visualizzati nell'input del prompt, accetta il suggerimento selezionato. Sulla maggior parte dei prompt di permesso, con **Sì** o **No** focalizzato, apre un campo di commento su quell'opzione e premendolo di nuovo chiude il campo. Vedi [aggiungi un commento quando rispondi a un prompt di permesso](https://code.claude.com/docs/it/permissions.md#add-a-comment-when-you-answer-a-permission-prompt) |34| `Tab` | Accetta un suggerimento di completamento automatico, o aggiungi un commento a una risposta di permesso | Mentre i suggerimenti di completamento automatico vengono visualizzati nell'input del prompt, accetta il suggerimento selezionato. Sulla maggior parte dei prompt di permesso, con **Sì** o **No** focalizzato, apre un campo di commento su quell'opzione e premendolo di nuovo chiude il campo. Vedi [aggiungi un commento quando rispondi a un prompt di permesso](https://code.claude.com/docs/it/permissions.md#add-a-comment-when-you-answer-a-permission-prompt) |
3535| `Frecce su/giù` o `Ctrl+P`/`Ctrl+N` | Sposta il cursore o naviga nella cronologia dei comandi | Quando l'input si estende su più di una riga visiva, sia avvolta che multilinea, prima sposta il cursore all'interno del prompt. Una volta che il cursore è sulla prima o ultima riga visiva, premendo di nuovo naviga nella cronologia dei comandi. Mentre hai messaggi in coda, `Su` dalla prima riga invece [li riporta indietro](#take-back-what-you-queued) || `Frecce su/giù` o `Ctrl+P`/`Ctrl+N` | Sposta il cursore o naviga nella cronologia dei comandi | Quando l'input si estende su più di una riga visiva, sia avvolta che multilinea, prima sposta il cursore all'interno del prompt. Una volta che il cursore è sulla prima o ultima riga visiva, premendo di nuovo naviga nella cronologia dei comandi. Mentre hai messaggi in coda, `Up` dalla prima riga invece [li riporta indietro](#take-back-what-you-queued) |
36| `Esc` | Interrompi Claude, o chiudi una finestra di dialogo | Arresta la risposta corrente o la chiamata dello strumento a metà turno in modo da poter reindirizzare. Claude mantiene il lavoro svolto finora. Se hai [messaggi in coda](#queue-messages-while-claude-works), Claude Code li invia dopo. Quando una finestra di dialogo è aperta, `Esc` chiude la finestra di dialogo. Mentre un elemento del footer è selezionato, come una riga nel [pannello subagent](https://code.claude.com/docs/it/sub-agents.md#run-subagents-in-foreground-or-background) sotto il prompt, `Esc` [lo deseleziona](https://code.claude.com/docs/it/keybindings.md#footer-actions) invece di interrompere. Su un prompt di permesso, `Esc` rifiuta l'azione, lo stesso di [**No** senza un commento](https://code.claude.com/docs/it/permissions.md#add-a-comment-when-you-answer-a-permission-prompt) |36| `Esc` | Interrompi Claude, o chiudi una finestra di dialogo | Arresta la risposta corrente o la chiamata dello strumento a metà turno in modo da poter reindirizzare. Claude mantiene il lavoro svolto finora. Se hai [messaggi in coda](#queue-messages-while-claude-works), Claude Code li invia dopo. Quando una finestra di dialogo è aperta, `Esc` chiude la finestra di dialogo. Mentre un elemento del footer è selezionato, come una riga nel [pannello subagent](https://code.claude.com/docs/it/sub-agents.md#run-subagents-in-foreground-or-background) sotto il prompt, `Esc` [lo deseleziona](https://code.claude.com/docs/it/keybindings.md#footer-actions) invece di interrompere. Su un prompt di permesso, `Esc` rifiuta l'azione, lo stesso di [**No** senza un commento](https://code.claude.com/docs/it/permissions.md#add-a-comment-when-you-answer-a-permission-prompt) |
3737| `Esc` + `Esc` | Cancella la bozza di input, o riavvolgi | Quando l'input del prompt contiene testo, doppio `Esc` lo cancella e salva la bozza nella cronologia in modo che `Su` la richiami. Quando l'input è vuoto, doppio `Esc` apre il [menu di riavvolgimento](https://code.claude.com/docs/it/checkpointing.md) per ripristinare o riassumere il codice e la conversazione da un punto precedente || `Esc` + `Esc` | Cancella la bozza di input, o riavvolgi | Quando l'input del prompt contiene testo, doppio `Esc` lo cancella e salva la bozza nella cronologia in modo che `Up` la richiami. Quando l'input è vuoto, doppio `Esc` apre il [menu di riavvolgimento](https://code.claude.com/docs/it/checkpointing.md) per ripristinare o riassumere il codice e la conversazione da un punto precedente |
38| `Ctrl+Enter` o `Ctrl+X Ctrl+S` | Invia i messaggi in coda adesso | Invia i tuoi [messaggi in coda](#queue-messages-while-claude-works), e la tua bozza con loro, subito. [Quando Claude Code invia quello che hai messo in coda](#when-claude-code-sends-what-you-queued) copre cosa succede al turno su cui Claude sta lavorando. Nella [modalità shell](#shell-mode-with-prefix), il tasto mette in coda il tuo comando. Nei terminali che non segnalano tasti estesi, `Ctrl+Enter` arriva come semplice `Enter`; `Ctrl+X Ctrl+S` funziona in qualsiasi terminale. Richiede Claude Code v2.1.275 o versione successiva |38| `Ctrl+Enter` o `Ctrl+X Ctrl+S` | Invia i messaggi in coda adesso | Invia i tuoi [messaggi in coda](#queue-messages-while-claude-works), e la tua bozza con loro, subito. [Quando Claude Code invia quello che hai messo in coda](#when-claude-code-sends-what-you-queued) copre cosa succede al turno su cui Claude sta lavorando. Nella [modalità shell](#shell-mode-with-prefix), il tasto mette in coda il tuo comando. Nei terminali che non segnalano tasti estesi, `Ctrl+Enter` arriva come semplice `Enter`; `Ctrl+X Ctrl+S` funziona in qualsiasi terminale. Richiede Claude Code v2.1.275 o versione successiva |
3939| `Shift+Tab`, o `Alt+M` su Windows quando il runtime Node o Bun non abilita la modalità di input VT | Cicla le modalità di permesso | Cicla attraverso `default` (etichettato Manual nell'indicatore di modalità), `acceptEdits`, `plan`, e, quando disponibile, `bypassPermissions` e poi `auto`. Da `auto`, il primo pressione passa a `default`. Vedi [modalità di permesso](https://code.claude.com/docs/it/permission-modes.md). Su un prompt di permesso del file, la stessa chiave chiude un [campo di commento](https://code.claude.com/docs/it/permissions.md#add-a-comment-when-you-answer-a-permission-prompt) aperto. Senza campo aperto, seleziona l'opzione che consente l'azione per il resto della sessione, quando il prompt offre quell'opzione || `Shift+Tab`, o `Alt+M` su Windows quando il runtime Node o Bun non abilita la modalità di input VT | Cicla le modalità di permesso | Cicla attraverso `default` (etichettato Manual nell'indicatore di modalità), `acceptEdits` e `plan`, poi `bypassPermissions` e `auto` dove disponibili. Vedi [modalità di permesso](https://code.claude.com/docs/it/permission-modes.md). Su una richiesta di permesso per un file, lo stesso tasto chiude un [campo di commento](https://code.claude.com/docs/it/permissions.md#add-a-comment-when-you-answer-a-permission-prompt) aperto. Senza campo aperto, seleziona l'opzione che consente l'azione per il resto della sessione, quando la richiesta offre quell'opzione. Alla richiesta di approvazione del piano, approva il piano |
40| `Option+P` (macOS) o `Alt+P` (Windows/Linux) | Cambia modello | Cambia modelli senza cancellare il tuo prompt |40| `Option+P` (macOS) o `Alt+P` (Windows/Linux) | Cambia modello | Cambia modelli senza cancellare il tuo prompt |
41| `Option+T` (macOS) o `Alt+T` (Windows/Linux) | Attiva/disattiva il ragionamento esteso | Abilita o disabilita la modalità di ragionamento esteso. Non ha effetto su Opus 5.5, Sonnet 5.5, Haiku 5.5 o i modelli Fable, che utilizzano sempre il ragionamento esteso. Funziona su macOS senza configurare Option come Meta |41| `Option+T` (macOS) o `Alt+T` (Windows/Linux) | Attiva/disattiva il ragionamento esteso | Abilita o disabilita la modalità di ragionamento esteso. Non ha effetto su Opus 5.5, Sonnet 5.5, Haiku 5.5 o i modelli Fable, che utilizzano sempre il ragionamento esteso. Funziona su macOS senza configurare Option come Meta |
42| `Option+O` (macOS) o `Alt+O` (Windows/Linux) | Attiva/disattiva la modalità veloce | Abilita o disabilita la [modalità veloce](https://code.claude.com/docs/it/fast-mode.md) |42| `Option+O` (macOS) o `Alt+O` (Windows/Linux) | Attiva/disattiva la modalità veloce | Abilita o disabilita la [modalità veloce](https://code.claude.com/docs/it/fast-mode.md) |
304claude --permission-mode plan304claude --permission-mode plan
305```305```
306 306
307307Premi di nuovo `Shift+Tab` per uscire dal plan mode senza approvare un piano.Quando non è aperta alcuna richiesta di approvazione, premi di nuovo `Shift+Tab` per uscire dal plan mode. Nella richiesta di approvazione, premi prima `Esc`, perché lì premere `Shift+Tab` approva il piano.
308 308
309### Rivedi e approva un piano309### Rivedi e approva un piano
310 310
344 "PostToolUse": [344 "PostToolUse": [
345 {345 {
346 "matcher": "Write|Edit",346 "matcher": "Write|Edit",
347347 "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npm run lint:fix" }] "hooks": [{ "type": "command", "command": "f=$(jq -r '.tool_input.file_path') && npm run lint:fix -- \"$f\"" }]
348 }348 }
349 ]349 ]
350 }350 }
40>40>
41> **macOS, Linux, WSL:**41> **macOS, Linux, WSL:**
42>42>
4343> ```bash theme={null}> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
44> curl -fsSL https://claude.ai/install.sh | bash44> curl -fsSL https://claude.ai/install.sh | bash
45> ```45> ```
46>46>
48>48>
49> **Windows PowerShell:**49> **Windows PowerShell:**
50>50>
5151> ```powershell theme={null}> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
52> irm https://claude.ai/install.ps1 | iex52> irm https://claude.ai/install.ps1 | iex
53> ```53> ```
54>54>
55> **Windows CMD:**55> **Windows CMD:**
56>56>
5757> ```batch theme={null}> ```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
58> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd58> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
59> ```59> ```
60>60>
72 72
73> [tab] Homebrew73> [tab] Homebrew
74>74>
7575> ```bash theme={null}> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
76> brew install --cask claude-code76> brew install --cask claude-code
77> ```77> ```
78>78>
84 84
85> [tab] WinGet85> [tab] WinGet
86>86>
8787> ```powershell theme={null}> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}
88> winget install Anthropic.ClaudeCode88> winget install Anthropic.ClaudeCode
89> ```89> ```
90>90>
141 141
142### Alpine Linux e distribuzioni basate su musl142### Alpine Linux e distribuzioni basate su musl
143 143
144144L'installazione di Claude Code su Alpine e altre distribuzioni basate su musl/uClibc richiede `bash` e `curl` per il comando di installazione, e `libgcc`, `libstdc++` e `ripgrep` al runtime. Alpine non include `bash` o `curl` per impostazione predefinita, quindi il comando di installazione documentato non riesce con un errore `not found` finché non li installate. Installate questi pacchetti utilizzando il gestore di pacchetti della vostra distribuzione, quindi impostate `USE_BUILTIN_RIPGREP=0`.Su Alpine e altre distribuzioni basate su musl, il [comando di installazione](#install-claude-code) richiede `bash` e `curl`, e Claude Code stesso richiede `bash` o `zsh`. Alpine non include `bash` o `curl` per impostazione predefinita, quindi il comando di installazione documentato non riesce con un errore `not found` finché non li installi.
145 145
146Questo esempio installa i pacchetti richiesti su Alpine:146Questo esempio installa i pacchetti richiesti su Alpine:
147 147
148```bash theme={null}148```bash theme={null}
149149apk add bash curl libgcc libstdc++ ripgrepapk add bash curl
150```
151
152Su Alpine, `ripgrep` si trova nel repository community. Se `apk` segnala che il pacchetto è mancante, aggiungete il repository community a `/etc/apk/repositories`, utilizzando la vostra versione di Alpine:
153
154```bash theme={null}
155echo "https://dl-cdn.alpinelinux.org/alpine/v3.22/community" >> /etc/apk/repositories
156```
157
158Eseguite `apk update` per aggiornare l'indice dei pacchetti e riprovate il comando `apk add`.
159
160Quindi impostate `USE_BUILTIN_RIPGREP` a `0` nel vostro file [`settings.json`](https://code.claude.com/docs/it/settings-reference#all-settings):
161
162```json theme={null}
163{
164 "env": {
165 "USE_BUILTIN_RIPGREP": "0"
166 }
167}
168```150```
169 151
170## Verificare l'installazione152## Verificare l'installazione
443> wget -O /etc/apk/keys/claude-code.rsa.pub \425> wget -O /etc/apk/keys/claude-code.rsa.pub \
444> https://downloads.claude.ai/keys/claude-code.rsa.pub426> https://downloads.claude.ai/keys/claude-code.rsa.pub
445> echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories427> echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories
446428> apk add claude-code> apk add bash claude-code
447> ```429> ```
448>430>
449> Per passare al canale `latest`, rimuovete la riga del repository `stable` e aggiungete il repository `latest`:431> Per passare al canale `latest`, rimuovete la riga del repository `stable` e aggiungete il repository `latest`:
388> Get-Command claude | Select-Object Source388> Get-Command claude | Select-Object Source
389> ```389> ```
390 390
391391Su Linux, controlla le librerie condivise mancanti. Se `ldd` mostra librerie mancanti, potrebbe essere necessario installare pacchetti di sistema. Su Alpine Linux e altre distribuzioni basate su musl, vedi [Configurazione di Alpine Linux](https://code.claude.com/docs/it/setup.md#alpine-linux-and-musl-based-distributions).Su Linux, controlla le librerie condivise mancanti. Se `ldd` mostra librerie mancanti, potrebbe essere necessario installare pacchetti di sistema. Su Alpine Linux e altre distribuzioni basate su musl, vedi [Mancata corrispondenza del binario Linux musl o glibc](#linux-musl-or-glibc-binary-mismatch).
392 392
393```bash theme={null}393```bash theme={null}
394ldd "$(command -v claude)" | grep "not found"394ldd "$(command -v claude)" | grep "not found"
906 906
907### Mancata corrispondenza del binario musl o glibc su Linux907### Mancata corrispondenza del binario musl o glibc su Linux
908 908
909909Se vedi errori relativi a librerie condivise mancanti come `libstdc++.so.6` o `libgcc_s.so.1` dopo l'installazione, il programma di installazione potrebbe aver scaricato la variante di binario sbagliata per il tuo sistema.Se vedi errori relativi a librerie condivise mancanti come `ld-linux-x86-64.so.2` o `ld-linux-aarch64.so.1` dopo l'installazione, il programma di installazione potrebbe aver scaricato la variante di binario sbagliata per il tuo sistema.
910 910
911```text theme={null}911```text theme={null}
912912Error loading shared library libstdc++.so.6: No such file or directoryError loading shared library ld-linux-x86-64.so.2: No such file or directory
913```913```
914 914
915Questo può accadere su sistemi basati su glibc che hanno installati pacchetti di cross-compilazione musl, inducendo il programma di installazione a rilevare erroneamente il sistema come musl.
916
917**Soluzioni:**915**Soluzioni:**
918 916
9191. **Verifica quale libc utilizza il tuo sistema**:9171. **Verifica quale libc utilizza il tuo sistema**:
924 922
9252. **Se sei su glibc ma hai ottenuto il binario musl**, rimuovi l'installazione e reinstalla. Puoi anche scaricare manualmente il binario corretto utilizzando il manifest in `https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json`. Apri una [issue su GitHub](https://github.com/anthropics/claude-code/issues) con l'output di `ldd --version` e `ls /lib/libc.musl*`.9232. **Se sei su glibc ma hai ottenuto il binario musl**, rimuovi l'installazione e reinstalla. Puoi anche scaricare manualmente il binario corretto utilizzando il manifest in `https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json`. Apri una [issue su GitHub](https://github.com/anthropics/claude-code/issues) con l'output di `ldd --version` e `ls /lib/libc.musl*`.
926 924
9279253. **Se sei effettivamente su musl**, come Alpine Linux, installa i pacchetti richiesti:3. **Se sei su musl ma hai ottenuto il binario glibc**, [rimuovi l'installazione](https://code.claude.com/docs/it/setup.md#uninstall-claude-code). Su Alpine Linux, installa prima i pacchetti indicati in [Configurazione di Alpine Linux](https://code.claude.com/docs/it/setup.md#alpine-linux-and-musl-based-distributions). Quindi esegui il [comando di installazione](https://code.claude.com/docs/it/setup.md#install-claude-code), che installa il binario musl.
928 ```bash theme={null}
929 apk add libgcc libstdc++ ripgrep
930 ```
931 Su Alpine, `ripgrep` si trova nel repository community. Se `apk` segnala che il pacchetto manca, consulta [Configurazione di Alpine Linux](https://code.claude.com/docs/it/setup.md#alpine-linux-and-musl-based-distributions).
932 926
933### `Illegal instruction`927### `Illegal instruction`
934 928
152> apk add ripgrep152> apk add ripgrep
153> ```153> ```
154>154>
155155> `ripgrep` è nel repository community di Alpine. Se `apk` segnala che il pacchetto è mancante, vedi [Alpine Linux setup](https://code.claude.com/docs/it/setup.md#alpine-linux-and-musl-based-distributions).> `ripgrep` è nel repository community di Alpine.
156 156
157> [tab] Arch157> [tab] Arch
158>158>
