Documentation 2026-11-12 23:02 UTC to 2026-11-13 00:00 UTC

315 {315 {

316 "matcher": "Edit|Write",316 "matcher": "Edit|Write",

317 "hooks": [317 "hooks": [

318 { "type": "command", "command": "npx prettier --write --ignore-unknown \"$(jq -r '.tool_input.file_path')\"" }318 { "type": "command", "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\"" }

319 ]319 ]

320 }320 }

321 ]321 ]

92 92 

93Au-delà du binaire, l'image a besoin de :93Au-delà du binaire, l'image a besoin de :

94 94 

95* **Une image basée sur glibc** : la seule dépendance dynamique de la version glibc est les bibliothèques glibc. Les images basées sur Musl ont besoin de la version `linux-x64-musl` ou `linux-arm64-musl` plus des packages supplémentaires ; consultez [Configuration Alpine Linux](https://code.claude.com/docs/fr/setup.md#alpine-linux-and-musl-based-distributions).95* **Une image basée sur glibc** : les seules dépendances dynamiques du build glibc sont les bibliothèques glibc. Les images basées sur Musl ont besoin du build `linux-x64-musl` ou `linux-arm64-musl`, dont la seule dépendance dynamique est musl.

96* **Un répertoire d'état inscriptible** : la passerelle s'exécute en tant qu'utilisateur quelconque, mais les images minimales n'ont pas de répertoire personnel inscriptible. Définissez `CLAUDE_CONFIG_DIR` sur un chemin inscriptible tel que `/tmp/.claude`.96* **Un répertoire d'état inscriptible** : la passerelle s'exécute en tant qu'utilisateur quelconque, mais les images minimales n'ont pas de répertoire personnel inscriptible. Définissez `CLAUDE_CONFIG_DIR` sur un chemin inscriptible tel que `/tmp/.claude`.

97* **La commande du conteneur** : `claude gateway --config /etc/claude/gateway.yaml`, avec le fichier de configuration monté en lecture seule et les secrets fournis en tant que variables d'environnement ; la passerelle écoute sur `listen.port`, par défaut `8080`.97* **La commande du conteneur** : `claude gateway --config /etc/claude/gateway.yaml`, avec le fichier de configuration monté en lecture seule et les secrets fournis en tant que variables d'environnement ; la passerelle écoute sur `listen.port`, par défaut `8080`.

98 98 

3335 "hooks": [3335 "hooks": [

3336 {3336 {

3337 "type": "command",3337 "type": "command",

3338 "command": "bash -c 'jq -r .worktree_path | xargs rm -rf'"3338 "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",

53 "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write" }]53 "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",

224 "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"224 "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\""

225 }225 }

226 ]226 ]

227 }227 }

36| `Esc` | Interrompre Claude ou fermer une boîte de dialogue | Arrêtez la réponse ou l'appel d'outil en cours en plein tour afin de pouvoir réorienter Claude. Claude conserve le travail effectué jusque-là. Si vous avez des [messages en file d'attente](#queue-messages-while-claude-works), Claude Code les envoie ensuite. Lorsqu'une boîte de dialogue est ouverte, `Esc` la ferme. Lorsqu'un élément du pied de page est sélectionné, comme une ligne du [panneau des sous-agents](https://code.claude.com/docs/fr/sub-agents.md#run-subagents-in-foreground-or-background) sous le prompt, `Esc` [le désélectionne](https://code.claude.com/docs/fr/keybindings.md#footer-actions) au lieu d'interrompre. Sur une demande de permission, `Esc` refuse l'action, comme [**No** sans commentaire](https://code.claude.com/docs/fr/permissions.md#add-a-comment-when-you-answer-a-permission-prompt) |36| `Esc` | Interrompre Claude ou fermer une boîte de dialogue | Arrêtez la réponse ou l'appel d'outil en cours en plein tour afin de pouvoir réorienter Claude. Claude conserve le travail effectué jusque-là. Si vous avez des [messages en file d'attente](#queue-messages-while-claude-works), Claude Code les envoie ensuite. Lorsqu'une boîte de dialogue est ouverte, `Esc` la ferme. Lorsqu'un élément du pied de page est sélectionné, comme une ligne du [panneau des sous-agents](https://code.claude.com/docs/fr/sub-agents.md#run-subagents-in-foreground-or-background) sous le prompt, `Esc` [le désélectionne](https://code.claude.com/docs/fr/keybindings.md#footer-actions) au lieu d'interrompre. Sur une demande de permission, `Esc` refuse l'action, comme [**No** sans commentaire](https://code.claude.com/docs/fr/permissions.md#add-a-comment-when-you-answer-a-permission-prompt) |

37| `Esc` + `Esc` | Effacer le brouillon de saisie ou revenir en arrière | Lorsque la saisie du prompt contient du texte, un double `Esc` l'efface et enregistre le brouillon dans l'historique pour que `Up` le rappelle. Lorsque la saisie est vide, un double `Esc` ouvre le [menu de retour en arrière](https://code.claude.com/docs/fr/checkpointing.md) pour restaurer ou résumer le code et la conversation à partir d'un point antérieur |37| `Esc` + `Esc` | Effacer le brouillon de saisie ou revenir en arrière | Lorsque la saisie du prompt contient du texte, un double `Esc` l'efface et enregistre le brouillon dans l'historique pour que `Up` le rappelle. Lorsque la saisie est vide, un double `Esc` ouvre le [menu de retour en arrière](https://code.claude.com/docs/fr/checkpointing.md) pour restaurer ou résumer le code et la conversation à partir d'un point antérieur |

38| `Ctrl+Enter` ou `Ctrl+X Ctrl+S` | Envoyer immédiatement les messages en file d'attente | Envoie immédiatement vos [messages en file d'attente](#queue-messages-while-claude-works), accompagnés de votre brouillon. [Quand Claude Code envoie ce que vous avez mis en file d'attente](#when-claude-code-sends-what-you-queued) explique ce qu'il advient du tour sur lequel Claude travaille. En [mode shell](#shell-mode-with-prefix), la touche met seulement votre commande en file d'attente. Dans les terminaux qui ne signalent pas les touches étendues, `Ctrl+Enter` arrive comme un simple `Enter` ; `Ctrl+X Ctrl+S` fonctionne dans n'importe quel terminal. Nécessite Claude Code v2.1.275 ou version ultérieure |38| `Ctrl+Enter` ou `Ctrl+X Ctrl+S` | Envoyer immédiatement les messages en file d'attente | Envoie immédiatement vos [messages en file d'attente](#queue-messages-while-claude-works), accompagnés de votre brouillon. [Quand Claude Code envoie ce que vous avez mis en file d'attente](#when-claude-code-sends-what-you-queued) explique ce qu'il advient du tour sur lequel Claude travaille. En [mode shell](#shell-mode-with-prefix), la touche met seulement votre commande en file d'attente. Dans les terminaux qui ne signalent pas les touches étendues, `Ctrl+Enter` arrive comme un simple `Enter` ; `Ctrl+X Ctrl+S` fonctionne dans n'importe quel terminal. Nécessite Claude Code v2.1.275 ou version ultérieure |

39| `Shift+Tab`, ou `Alt+M` sur Windows lorsque le runtime Node ou Bun n'active pas le mode de saisie VT | Parcourir les modes de permission | Parcourez `default` (indiqué Manual dans l'indicateur de mode), `acceptEdits`, `plan` et, lorsqu'ils sont disponibles, `bypassPermissions` puis `auto`. Depuis `auto`, le premier appui passe à `default`. Consultez [modes de permission](https://code.claude.com/docs/fr/permission-modes.md). Sur une demande de permission de fichier, la même touche ferme un [champ de commentaire](https://code.claude.com/docs/fr/permissions.md#add-a-comment-when-you-answer-a-permission-prompt) ouvert. Si aucun champ n'est ouvert, elle sélectionne l'option qui autorise l'action pour le reste de la session, lorsque la demande propose cette option |39| `Shift+Tab`, ou `Alt+M` sur Windows lorsque le runtime Node ou Bun n'active pas le mode de saisie VT | Parcourir les modes de permission | Parcourez `default` (indiqué Manual dans l'indicateur de mode), `acceptEdits` et `plan`, puis `bypassPermissions` et `auto` lorsqu'ils sont disponibles. Consultez [modes de permission](https://code.claude.com/docs/fr/permission-modes.md). Sur une demande de permission de fichier, la même touche ferme un [champ de commentaire](https://code.claude.com/docs/fr/permissions.md#add-a-comment-when-you-answer-a-permission-prompt) ouvert. Si aucun champ n'est ouvert, elle sélectionne l'option qui autorise l'action pour le reste de la session, lorsque la demande propose cette option. Sur la demande d'approbation du plan, elle approuve le plan |

40| `Option+P` (macOS) ou `Alt+P` (Windows/Linux) | Changer de modèle | Changez de modèle sans effacer votre prompt |40| `Option+P` (macOS) ou `Alt+P` (Windows/Linux) | Changer de modèle | Changez de modèle sans effacer votre prompt |

41| `Option+T` (macOS) ou `Alt+T` (Windows/Linux) | Activer/désactiver la réflexion étendue | Activez ou désactivez le mode réflexion étendue. Sans effet sur Opus 5.5, Sonnet 5.5, Haiku 5.5 ou les modèles Fable, qui utilisent toujours la réflexion étendue. Fonctionne sur macOS sans configurer Option comme Meta |41| `Option+T` (macOS) ou `Alt+T` (Windows/Linux) | Activer/désactiver la réflexion étendue | Activez ou désactivez le mode réflexion étendue. Sans effet sur Opus 5.5, Sonnet 5.5, Haiku 5.5 ou les modèles Fable, qui utilisent toujours la réflexion étendue. Fonctionne sur macOS sans configurer Option comme Meta |

42| `Option+O` (macOS) ou `Alt+O` (Windows/Linux) | Activer/désactiver le mode rapide | Activez ou désactivez le [mode rapide](https://code.claude.com/docs/fr/fast-mode.md) |42| `Option+O` (macOS) ou `Alt+O` (Windows/Linux) | Activer/désactiver le mode rapide | Activez ou désactivez le [mode rapide](https://code.claude.com/docs/fr/fast-mode.md) |

304claude --permission-mode plan304claude --permission-mode plan

305```305```

306 306 

307Appuyez de nouveau sur `Shift+Tab` pour quitter le mode plan sans approuver de plan.307Lorsqu'aucune demande d'approbation n'est ouverte, appuyez de nouveau sur `Shift+Tab` pour quitter le mode plan. Face à la demande d'approbation, appuyez d'abord sur `Esc`, car appuyer sur `Shift+Tab` à ce stade approuve le plan.

308 308 

309### Examiner et approuver un plan309### Examiner et approuver un plan

310 310 

344 "PostToolUse": [344 "PostToolUse": [

345 {345 {

346 "matcher": "Write|Edit",346 "matcher": "Write|Edit",

347 "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npm run lint:fix" }]347 "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>

43> ```bash theme={null}43> ```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>

51> ```powershell theme={null}51> ```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>

57> ```batch theme={null}57> ```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>

75> ```bash theme={null}75> ```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>

87> ```powershell theme={null}87> ```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>

118 118 

119Exécutez la [commande d'installation](#install-claude-code) à partir de PowerShell ou CMD. Vous n'avez pas besoin d'exécuter en tant qu'administrateur. L'installation de [Git for Windows](https://git-scm.com/downloads/win) est optionnelle. Elle fournit Git Bash, dont l'[outil Bash](https://code.claude.com/docs/fr/tools-reference.md#bash-tool-behavior) et l'[outil Monitor](https://code.claude.com/docs/fr/tools-reference.md#monitor-tool) ont besoin.119Exécutez la [commande d'installation](#install-claude-code) à partir de PowerShell ou CMD. Vous n'avez pas besoin d'exécuter en tant qu'administrateur. L'installation de [Git for Windows](https://git-scm.com/downloads/win) est optionnelle. Elle fournit Git Bash, dont l'[outil Bash](https://code.claude.com/docs/fr/tools-reference.md#bash-tool-behavior) et l'[outil Monitor](https://code.claude.com/docs/fr/tools-reference.md#monitor-tool) ont besoin.

120 120 

121Que vous installiez à partir de PowerShell ou CMD affecte uniquement la commande d'installation que vous exécutez. Votre invite affiche `PS C:\Users\VotreNom>` dans PowerShell et `C:\Users\VotreNom>` sans le `PS` dans CMD. Si vous êtes nouveau sur le terminal, le [guide du terminal](https://code.claude.com/docs/fr/terminal-guide#windows) vous guide à travers chaque étape.121Que vous installiez à partir de PowerShell ou CMD affecte uniquement la commande d'installation que vous exécutez. Votre invite affiche `PS C:\Users\YourName>` dans PowerShell et `C:\Users\YourName>` sans le `PS` dans CMD. Si vous êtes nouveau sur le terminal, le [guide du terminal](https://code.claude.com/docs/fr/terminal-guide#windows) vous guide à travers chaque étape.

122 122 

123Après l'installation, lancez `claude` à partir de n'importe quel terminal.123Après l'installation, lancez `claude` à partir de n'importe quel terminal.

124 124 

141 141 

142### Alpine Linux et distributions basées sur musl142### Alpine Linux et distributions basées sur musl

143 143 

144L'installation de Claude Code sur Alpine et autres distributions basées sur musl/uClibc nécessite `bash` et `curl` pour la commande d'installation, et `libgcc`, `libstdc++` et `ripgrep` à l'exécution. Alpine n'inclut pas `bash` ou `curl` par défaut, donc la commande d'installation documentée échoue avec une erreur `not found` jusqu'à ce que vous les installiez. Installez ces paquets à l'aide du gestionnaire de paquets de votre distribution, puis définissez `USE_BUILTIN_RIPGREP=0`.144Sur Alpine et les autres distributions basées sur musl, la [commande d'installation](#install-claude-code) nécessite `bash` et `curl`, et Claude Code lui-même nécessite `bash` ou `zsh`. Alpine n'inclut pas `bash` ou `curl` par défaut, donc la commande d'installation documentée échoue avec une erreur `not found` jusqu'à ce que vous les installiez.

145 145 

146Cet exemple installe les paquets requis sur Alpine :146Cet exemple installe les paquets requis sur Alpine :

147 147 

148```bash theme={null}148```bash theme={null}

149apk add bash curl libgcc libstdc++ ripgrep149apk add bash curl

150```

151 

152Sur Alpine, `ripgrep` se trouve dans le dépôt community. Si `apk` signale que le paquet est manquant, ajoutez le dépôt community à `/etc/apk/repositories`, en utilisant votre version d'Alpine :

153 

154```bash theme={null}

155echo "https://dl-cdn.alpinelinux.org/alpine/v3.22/community" >> /etc/apk/repositories

156```

157 

158Exécutez `apk update` pour actualiser l'index des paquets, et réessayez la commande `apk add`.

159 

160Ensuite, définissez `USE_BUILTIN_RIPGREP` à `0` dans votre fichier [`settings.json`](https://code.claude.com/docs/fr/settings-reference#all-settings) :

161 

162```json theme={null}

163{

164 "env": {

165 "USE_BUILTIN_RIPGREP": "0"

166 }

167}

168```150```

169 151 

170## Vérifier votre installation152## Vérifier votre installation

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

446> apk add claude-code428> apk add bash claude-code

447> ```429> ```

448>430>

449> Pour basculer vers le canal `latest`, supprimez la ligne du dépôt `stable` et ajoutez le dépôt `latest` :431> Pour basculer vers le canal `latest`, supprimez la ligne du dépôt `stable` et ajoutez le dépôt `latest` :

388> Get-Command claude | Select-Object Source388> Get-Command claude | Select-Object Source

389> ```389> ```

390 390 

391Sur Linux, vérifiez les bibliothèques partagées manquantes. Si `ldd` affiche des bibliothèques manquantes, vous devrez peut-être installer des paquets système. Sur Alpine Linux et autres distributions basées sur musl, consultez [Configuration Alpine Linux](https://code.claude.com/docs/fr/setup.md#alpine-linux-and-musl-based-distributions).391Sur Linux, vérifiez les bibliothèques partagées manquantes. Si `ldd` affiche des bibliothèques manquantes, vous devrez peut-être installer des paquets système. Sur Alpine Linux et autres distributions basées sur musl, consultez [Incompatibilité de binaire musl ou glibc sous Linux](#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### Incompatibilité binaire musl ou glibc Linux907### Incompatibilité binaire musl ou glibc Linux

908 908 

909Si vous voyez des erreurs concernant des bibliothèques partagées manquantes comme `libstdc++.so.6` ou `libgcc_s.so.1` après l'installation, le programme d'installation peut avoir téléchargé la mauvaise variante binaire pour votre système.909Si vous voyez des erreurs concernant des bibliothèques partagées manquantes comme `ld-linux-x86-64.so.2` ou `ld-linux-aarch64.so.1` après l'installation, le programme d'installation peut avoir téléchargé la mauvaise variante binaire pour votre système.

910 910 

911```text theme={null}911```text theme={null}

912Error loading shared library libstdc++.so.6: No such file or directory912Error loading shared library ld-linux-x86-64.so.2: No such file or directory

913```913```

914 914 

915Cela peut se produire sur les systèmes basés sur glibc qui ont des packages de compilation croisée musl installés, ce qui amène le programme d'installation à mal détecter le système comme musl.

916 

917**Solutions :**915**Solutions :**

918 916 

9191. **Vérifiez quelle libc votre système utilise** :9171. **Vérifiez quelle libc votre système utilise** :

924 922 

9252. **Si vous êtes sur glibc mais avez obtenu le binaire musl**, supprimez l'installation et réinstallez. Vous pouvez également télécharger manuellement le binaire correct en utilisant le manifeste à `https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json`. Déposez un [problème GitHub](https://github.com/anthropics/claude-code/issues) avec la sortie de `ldd --version` et `ls /lib/libc.musl*`.9232. **Si vous êtes sur glibc mais avez obtenu le binaire musl**, supprimez l'installation et réinstallez. Vous pouvez également télécharger manuellement le binaire correct en utilisant le manifeste à `https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json`. Déposez un [problème GitHub](https://github.com/anthropics/claude-code/issues) avec la sortie de `ldd --version` et `ls /lib/libc.musl*`.

926 924 

9273. **Si vous êtes réellement sur musl**, tel que Alpine Linux, installez les packages requis :9253. **Si vous êtes sur musl mais avez obtenu le binaire glibc**, [supprimez l'installation](https://code.claude.com/docs/fr/setup.md#uninstall-claude-code). Sur Alpine Linux, installez d'abord les packages indiqués dans [Configuration Alpine Linux](https://code.claude.com/docs/fr/setup.md#alpine-linux-and-musl-based-distributions). Ensuite, exécutez la [commande d'installation](https://code.claude.com/docs/fr/setup.md#install-claude-code), qui installe le binaire musl.

928 ```bash theme={null}

929 apk add libgcc libstdc++ ripgrep

930 ```

931 Sur Alpine, `ripgrep` se trouve dans le dépôt communautaire. Si `apk` signale que le package manque, consultez [Configuration Alpine Linux](https://code.claude.com/docs/fr/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>

155> `ripgrep` se trouve dans le référentiel communautaire d'Alpine. Si `apk` signale que le paquet est manquant, consultez [Configuration d'Alpine Linux](https://code.claude.com/docs/fr/setup.md#alpine-linux-and-musl-based-distributions).155> `ripgrep` se trouve dans le dépôt communautaire d'Alpine.

156 156 

157> [tab] Arch157> [tab] Arch

158>158>