SpyBara
Go Premium

Documentation 2026-11-08 22:58 UTC to 2026-11-09 23:02 UTC

35 files changed +455 −123. View all changes and history on the product overview
2026
Thu 12 21:00 Wed 11 22:59 Tue 10 21:57 Mon 9 23:02 Sun 8 22:58 Sat 7 23:58 Fri 6 23:01 Thu 5 23:03 Wed 4 23:59 Tue 3 23:58 Mon 2 23:57 Sun 1 23:57

advisor.md +4 −3

Details

98| Opus 4.7 ou Opus 4.8 | Fable, Opus 4.7 ou ultérieur, Sonnet 5.5 |98| Opus 4.7 ou Opus 4.8 | Fable, Opus 4.7 ou ultérieur, Sonnet 5.5 |

99| Sonnet 5.5 | Fable, Opus 5 ou ultérieur, Sonnet 5.5 |99| Sonnet 5.5 | Fable, Opus 5 ou ultérieur, Sonnet 5.5 |

100| Opus 5 ou Opus 5.5 | Fable, Opus 5 ou ultérieur |100| Opus 5 ou Opus 5.5 | Fable, Opus 5 ou ultérieur |

101| Fable 5 | Fable 5.1 ou Fable 5 |101| Fable 5 | Fable 5.2, Fable 5.1 ou Fable 5 |

102| Fable 5.1 | Fable 5.1 |102| Fable 5.1 | Fable 5.2 ou Fable 5.1 |

103| Fable 5.2 | Fable 5.2 |

103 104 

104Fable 5.1 nécessite Claude Code v2.1.257 ou ultérieur. Les modèles Fable nécessitent [l'accès à Fable](https://code.claude.com/docs/fr/model-config.md#work-with-fable). Sonnet 5.5 en tant qu'advisor pour un modèle principal Opus 4.7 ou Opus 4.8 nécessite Claude Code v2.1.287 ou ultérieur. Haiku 5.5 en tant que modèle principal ou en tant qu'advisor nécessite Claude Code v2.1.293 ou ultérieur.105Fable 5.2 nécessite Claude Code v2.1.321 ou ultérieur, et Fable 5.1 nécessite v2.1.257 ou ultérieur. Les modèles Fable nécessitent [l'accès à Fable](https://code.claude.com/docs/fr/model-config.md#work-with-fable). Sonnet 5.5 en tant qu'advisor pour un modèle principal Opus 4.7 ou Opus 4.8 nécessite Claude Code v2.1.287 ou ultérieur. Haiku 5.5 en tant que modèle principal ou en tant qu'advisor nécessite Claude Code v2.1.293 ou ultérieur.

105 106 

106Définissez l'advisor comme `fable`, `opus`, ou `sonnet`. Ces alias se résolvent à la [version par défaut intégrée](https://code.claude.com/docs/fr/model-config.md#model-aliases) de Claude Code pour chaque famille de modèles, qui avance avec les nouvelles versions de Claude Code. Vous pouvez également passer un ID de modèle complet tel que `claude-opus-5-5` ou `claude-haiku-5-5`. Haiku 4.5 peut appeler l'advisor mais ne peut pas en être un.107Définissez l'advisor comme `fable`, `opus`, ou `sonnet`. Ces alias se résolvent à la [version par défaut intégrée](https://code.claude.com/docs/fr/model-config.md#model-aliases) de Claude Code pour chaque famille de modèles, qui avance avec les nouvelles versions de Claude Code. Vous pouvez également passer un ID de modèle complet tel que `claude-opus-5-5` ou `claude-haiku-5-5`. Haiku 4.5 peut appeler l'advisor mais ne peut pas en être un.

107 108 

Details

56 56 

57### Exemple d'outil météo57### Exemple d'outil météo

58 58 

59Cet exemple définit un outil `get_temperature` et l'enveloppe dans un serveur MCP, sans transmettre le serveur à `query`. Pour exécuter l'outil, voir [Appeler un outil personnalisé](#call-a-custom-tool) ci-dessous.59Cet exemple définit un outil `get_temperature` et l'enveloppe dans un serveur MCP, sans transmettre le serveur à `query`. Pour exécuter l'outil, voir [Appeler un outil personnalisé](#call-a-custom-tool).

60 60 

61```python Python theme={null}61```python Python theme={null}

62from typing import Annotated, Any62from typing import Annotated, Any


148* **TypeScript** : ajoutez `.optional()` au champ Zod.148* **TypeScript** : ajoutez `.optional()` au champ Zod.

149* **Python** : le schéma dict exige chaque clé. Utilisez la forme JSON Schema, omettez le paramètre de `required`, et lisez-le avec `args.get()`. Pour un schéma typé avec des clés optionnelles, voir [Classe TypedDict](https://code.claude.com/docs/fr/agent-sdk/python.md#input-schema-options).149* **Python** : le schéma dict exige chaque clé. Utilisez la forme JSON Schema, omettez le paramètre de `required`, et lisez-le avec `args.get()`. Pour un schéma typé avec des clés optionnelles, voir [Classe TypedDict](https://code.claude.com/docs/fr/agent-sdk/python.md#input-schema-options).

150 150 

151L'outil [`get_precipitation_chance` ci-dessous](#add-more-tools) montre les deux modèles.151L'[outil `get_precipitation_chance`](#add-more-tools) montre les deux modèles.

152 152 

153### Appeler un outil personnalisé153### Appeler un outil personnalisé

154 154 

155Transmettez le serveur MCP que vous avez créé à `query` via l'option `mcpServers`, et listez le [nom complètement qualifié](https://code.claude.com/docs/fr/agent-sdk/mcp.md#tool-naming-convention) de chaque outil dans `allowedTools` afin que l'outil s'exécute sans demande de permission. Ce nom est `mcp__{server_name}__{tool_name}`, où `{server_name}` est la clé que vous donnez au serveur dans `mcpServers`. Si la clé contient des caractères tels que `.` ou des espaces, remplacez-les par `_` lorsque vous écrivez `{server_name}`.155Pour appeler un outil personnalisé, suivez ces étapes :

156 

1571. Transmettez le serveur MCP que vous avez créé à `query` via l'option `mcpServers`.

1582. Listez le [nom complètement qualifié](https://code.claude.com/docs/fr/agent-sdk/mcp.md#tool-naming-convention) de l'outil dans `allowedTools` pour [pré-approuver](https://code.claude.com/docs/fr/agent-sdk/permissions.md#allow-and-deny-rules) ses appels. Ce nom suit la convention `mcp__{server_name}__{tool_name}`, où `{server_name}` est la clé que vous donnez au serveur dans `mcpServers`. Si la clé contient des caractères tels que `.` ou des espaces, remplacez-les par `_` lorsque vous écrivez `{server_name}`.

156 159 

157Ces extraits réutilisent le `weatherServer` de l'[exemple d'outil météo](#weather-tool-example) pour demander à Claude quelle est la météo dans un endroit spécifique.160Ces extraits réutilisent le `weatherServer` de l'[exemple d'outil météo](#weather-tool-example) pour demander à Claude quelle est la météo dans un endroit spécifique.

158 161 


329| :- | :- | :- |332| :- | :- | :- |

330| `readOnlyHint` | `false` | L'outil ne modifie pas son environnement. Contrôle si l'outil peut être appelé en parallèle avec d'autres outils en lecture seule. |333| `readOnlyHint` | `false` | L'outil ne modifie pas son environnement. Contrôle si l'outil peut être appelé en parallèle avec d'autres outils en lecture seule. |

331| `destructiveHint` | `true` | L'outil peut effectuer des mises à jour destructrices. Définissez-le explicitement à `true` sur tout outil que vous [marquez `always_ask`](#require-approval-for-specific-tools). |334| `destructiveHint` | `true` | L'outil peut effectuer des mises à jour destructrices. Définissez-le explicitement à `true` sur tout outil que vous [marquez `always_ask`](#require-approval-for-specific-tools). |

332| `idempotentHint` | `false` | Les appels répétés avec les mêmes arguments n'ont aucun effet supplémentaire. Informatif uniquement. |335| `idempotentHint` | `false` | Les appels répétés avec les mêmes arguments n'ont aucun effet supplémentaire. |

333| `openWorldHint` | `true` | L'outil atteint des systèmes en dehors de votre processus. Informatif uniquement. |336| `openWorldHint` | `true` | L'outil atteint des systèmes en dehors de votre processus. |

334 337 

335Les annotations sont des métadonnées, pas une application. Un outil marqué `readOnlyHint: true` peut toujours écrire sur le disque si c'est ce que fait le gestionnaire. Gardez l'annotation exacte au gestionnaire.338Les annotations sont des métadonnées, pas une application. Un outil marqué `readOnlyHint: true` peut toujours écrire sur le disque si c'est ce que fait le gestionnaire. Gardez l'annotation exacte au gestionnaire.

336 339 


373 376 

374### Configurer les outils autorisés377### Configurer les outils autorisés

375 378 

376L'option `tools` et les listes d'autorisation/interdiction affectent deux couches : la disponibilité, qui contrôle si un outil apparaît dans le contexte de Claude, et la permission, qui contrôle si un appel est approuvé une fois que Claude le tente. `tools` et les entrées `disallowedTools` avec nom simple changent la disponibilité. `allowedTools` et les règles `disallowedTools` délimitées changent la permission. Si vous nommez l'un des [outils de suivi des tâches](https://code.claude.com/docs/fr/agent-sdk/todo-tracking.md#model-availability) dans `allowedTools`, Claude Code active également ces outils pour la session.379Vous contrôlez deux couches avec les options `tools`, `allowedTools` et `disallowedTools` :

380 

381* **Disponibilité** : si un outil apparaît dans le contexte de Claude. Pour la modifier, utilisez l'option `tools` ou listez un nom d'outil intégré simple tel que `"Bash"` dans `disallowedTools`.

382* **Permission** : si Claude Code approuve un appel lorsque Claude l'effectue. Pour la modifier, utilisez `allowedTools` ou une règle `disallowedTools` délimitée telle que `"Bash(rm *)"`.

377 383 

378| Option | Couche | Effet |384| Option | Couche | Effet |

379| :- | :- | :- |385| :- | :- | :- |

380| `tools: ["Read", "Grep"]` | Disponibilité | Seuls les outils intégrés listés sont dans le contexte de Claude. Les outils intégrés non listés sont supprimés. Les outils MCP ne sont pas affectés. |386| `tools: ["Read", "Grep"]` | Disponibilité | Seuls les outils intégrés listés sont dans le contexte de Claude. Les outils intégrés non listés sont supprimés. Les outils MCP ne sont pas affectés. |

381| `tools: []` | Disponibilité | Tous les outils intégrés sont supprimés. Claude ne peut utiliser que vos outils MCP. |387| `tools: []` | Disponibilité | Tous les outils intégrés sont supprimés. Claude ne peut utiliser que vos outils MCP. |

382| outils autorisés | Permission | Les outils listés s'exécutent sans invite de permission. Les autres outils non listés restent disponibles ; les appels passent par le [flux de permission](https://code.claude.com/docs/fr/agent-sdk/permissions.md). |388| outils autorisés | Permission | Les outils listés sont pré-approuvés, à l'exception des [appels qu'aucune règle d'autorisation n'approuve](https://code.claude.com/docs/fr/agent-sdk/permissions.md#calls-an-allow-rule-never-approves). Les appels aux outils que vous omettez de la liste passent par le [flux de permission](https://code.claude.com/docs/fr/agent-sdk/permissions.md). |

383| outils interdits | Les deux | Un nom d'outil simple tel que `"Bash"` supprime l'outil du contexte de Claude, comme l'omission de `tools`. Une règle délimitée telle que `"Bash(rm *)"` laisse l'outil en contexte et refuse uniquement les appels correspondants [comme écrit](https://code.claude.com/docs/fr/permissions.md#bash-rule-limits). |389| outils interdits | Les deux | Un nom d'outil intégré simple tel que `"Bash"` supprime l'outil du contexte de Claude. Une règle délimitée telle que `"Bash(rm *)"` laisse l'outil en contexte et refuse les appels qui y correspondent [comme écrit](https://code.claude.com/docs/fr/permissions.md#bash-rule-limits). |

384 390 

385Pour supprimer complètement un outil intégré, omettez-le de `tools` ou listez son nom simple dans `disallowedTools` (Python : `disallowed_tools`) ; les deux gardent l'outil hors du contexte afin que Claude ne le tente jamais. Une règle `disallowedTools` délimitée bloque les appels correspondants mais laisse l'outil visible, donc Claude peut gaspiller un tour en le tentant. Consultez [Configurer les permissions](https://code.claude.com/docs/fr/agent-sdk/permissions.md) pour l'ordre d'évaluation complet.391Pour supprimer un outil intégré du contexte de Claude, omettez-le de `tools` ou listez son nom simple dans `disallowedTools` (TypeScript) ou `disallowed_tools` (Python). Pour l'ordre d'évaluation complet, consultez [Configurer les permissions](https://code.claude.com/docs/fr/agent-sdk/permissions.md#how-permissions-are-evaluated).

386 392 

387### Exiger une approbation pour des outils spécifiques393### Exiger une approbation pour des outils spécifiques

388 394 


637 643 

638## Retourner des données structurées644## Retourner des données structurées

639 645 

640`structuredContent` est un objet JSON optionnel sur le résultat, séparé du tableau `content`. Utilisez-le pour retourner des valeurs brutes que Claude peut lire comme des champs exacts au lieu de les analyser à partir d'une chaîne de texte ou d'une image.646`structuredContent` est un objet JSON optionnel sur le résultat, séparé du tableau `content`. Utilisez-le pour retourner des valeurs brutes que Claude peut lire comme des champs exacts au lieu de les analyser à partir d'une chaîne de texte ou d'une image. Pour les gestionnaires Python, consultez [Contenu structuré en Python](#structured-content-in-python).

641 647 

642Lorsque `structuredContent` est défini, Claude reçoit le JSON plus tous les blocs d'image ou de ressource de `content`. Les blocs de texte dans `content` ne sont pas transmis, car on suppose qu'ils dupliquent les données structurées. L'exemple ci-dessous affiche un graphique sous forme de bloc d'image et retourne les points de données derrière celui-ci dans `structuredContent` à partir du même gestionnaire. Dans l'extrait, `chartPngBuffer` est un `Buffer` contenant les octets PNG rendus.648Lorsqu'un gestionnaire TypeScript `tool()` définit `structuredContent`, Claude reçoit le JSON ainsi que les blocs d'image et de ressource de `content`, et les blocs de texte dans `content` ne sont pas transmis à Claude. L'exemple ci-dessous affiche un graphique sous forme de bloc d'image et retourne les points de données derrière celui-ci dans `structuredContent` à partir du même gestionnaire. Dans l'extrait, `chartPngBuffer` est un `Buffer` contenant les octets PNG rendus.

643 649 

644```typescript TypeScript theme={null}650```typescript TypeScript theme={null}

645return {651return {

Details

205 205 

206### Auto-approbation avec allowedTools206### Auto-approbation avec allowedTools

207 207 

208Utilisez `allowedTools` pour auto-approuver des outils MCP spécifiques afin que Claude puisse les utiliser sans invite de permission :208Utilisez `allowedTools` pour auto-approuver des outils MCP spécifiques :

209 209 

210```typescript TypeScript hidelines={1,-1} theme={null}210```typescript TypeScript hidelines={1,-1} theme={null}

211const _ = {211const _ = {

Details

18 18 

19**1. Hooks**19**1. Hooks**

20 20 

21Exécutez les [hooks](https://code.claude.com/docs/fr/agent-sdk/hooks.md). Un hook peut refuser l'appel catégoriquement ou le transmettre. Un hook qui retourne `allow` ne contourne pas les règles de refus et de demande ci-dessous ; celles-ci sont évaluées indépendamment du résultat du hook.21Exécutez les [hooks](https://code.claude.com/docs/fr/agent-sdk/hooks.md). Un hook peut refuser l'appel catégoriquement ou le transmettre. Un hook qui retourne `allow` ne contourne pas les étapes des règles de refus et de demande, qui sont évaluées indépendamment du résultat du hook.

22 22 

23Un hook `PreToolUse` qui retourne `allow` ne peut pas non plus approuver une commande `rm` ou `rmdir` dont Claude Code reconnaît la cible comme un [chemin critique](https://code.claude.com/docs/fr/permission-modes.md#critical-paths), par exemple `rm -rf ~`. Pour savoir ce que fait ce `allow` en mode plan, consultez [Approbations par hook en mode plan](https://code.claude.com/docs/fr/permissions.md#hook-approvals-in-plan-mode).23Un hook `PreToolUse` qui retourne `allow` ne peut pas non plus approuver une commande `rm` ou `rmdir` dont Claude Code reconnaît la cible comme un [chemin critique](https://code.claude.com/docs/fr/permission-modes.md#critical-paths), par exemple `rm -rf ~`. Pour savoir ce que fait ce `allow` en mode plan, consultez [Approbations par hook en mode plan](https://code.claude.com/docs/fr/permissions.md#hook-approvals-in-plan-mode).

24 24 


58 58 

59**6. Callback canUseTool**59**6. Callback canUseTool**

60 60 

61Si aucune des étapes ci-dessus ne l'a résolu, appelez votre callback [`canUseTool`](https://code.claude.com/docs/fr/agent-sdk/user-input) pour une décision. En mode `dontAsk`, cette étape est ignorée et l'outil est refusé, bien qu'un [mod](https://code.claude.com/docs/fr/plugins/mods/overview.md) que vous avez installé puisse toujours approuver [certains de ces appels](https://code.claude.com/docs/fr/permissions.md#precedence-among-rules-hooks-and-mods).61Si aucune étape antérieure ne résout la requête, appelez votre [callback `canUseTool`](https://code.claude.com/docs/fr/agent-sdk/user-input) pour une décision. En mode `dontAsk`, cette étape est ignorée et l'outil est refusé, bien qu'un [mod](https://code.claude.com/docs/fr/plugins/mods/overview.md) que vous avez installé puisse toujours approuver [certains de ces appels](https://code.claude.com/docs/fr/permissions.md#precedence-among-rules-hooks-and-mods).

62 62 

63Dans le SDK TypeScript, si vous définissez [`permissionPrompts: 'none'`](https://code.claude.com/docs/fr/agent-sdk/typescript#options), votre callback n'est pas appelé à cette étape. Un hook [`PermissionRequest`](https://code.claude.com/docs/fr/hooks#permissionrequest) a toujours une chance de décider, et s'il ne le fait pas, Claude Code refuse l'appel. L'option nécessite Claude Code v2.1.259 ou ultérieur.63Dans le SDK TypeScript, si vous définissez [`permissionPrompts: 'none'`](https://code.claude.com/docs/fr/agent-sdk/typescript#options), votre callback n'est pas appelé à cette étape. Un hook [`PermissionRequest`](https://code.claude.com/docs/fr/hooks#permissionrequest) a toujours une chance de décider, et s'il ne le fait pas, Claude Code refuse l'appel. L'option nécessite Claude Code v2.1.259 ou ultérieur.

64 64 


80 80 

81## Règles d'autorisation et de refus81## Règles d'autorisation et de refus

82 82 

83`allowed_tools` et `disallowed_tools` (TypeScript : `allowedTools` / `disallowedTools`) ajoutent des entrées aux listes de règles d'autorisation et de refus dans le flux d'évaluation ci-dessus. Si vous nommez l'un des [outils de suivi des tâches](https://code.claude.com/docs/fr/agent-sdk/todo-tracking.md#model-availability) dans `allowed_tools`, Claude Code active également ces outils pour la session. Tout autre outil non listé dans `allowed_tools` reste disponible pour Claude, et un appel à celui-ci qui nécessite une approbation tombe dans le mode de permission. Les règles de refus se comportent différemment selon qu'elles nomment un outil ou délimitent un motif au sein de celui-ci.83Lorsque vous définissez `allowedTools` et `disallowedTools` (TypeScript) ou `allowed_tools` et `disallowed_tools` (Python), Claude Code ajoute leurs entrées aux listes de règles d'autorisation et de refus dans le [flux d'évaluation des permissions](#how-permissions-are-evaluated). Tout autre outil non listé dans `allowed_tools` reste disponible pour Claude, et un appel à celui-ci qui nécessite une approbation tombe dans le mode de permission.

84 84 

85| Option | Effet |85| Option | Effet |

86| :- | :- |86| :- | :- |

87| `allowed_tools=["Read", "Grep"]` | `Read` et `Grep` sont approuvés automatiquement, à l'exception des [lectures depuis des chemins réseau](https://code.claude.com/docs/fr/permissions.md#network-paths). Les autres outils non listés ici existent toujours, et les appels à ceux-ci qui nécessitent une approbation tombent dans le mode de permission et `canUseTool`. |87| `allowed_tools=["Read", "Grep"]` | `Read` et `Grep` sont approuvés automatiquement, à l'exception des [lectures depuis des chemins réseau](https://code.claude.com/docs/fr/permissions.md#network-paths). Les autres outils non listés ici existent toujours, et les appels à ceux-ci qui nécessitent une approbation tombent dans le mode de permission et `canUseTool`. |

88| `disallowed_tools=["Bash"]` | La définition de l'outil `Bash` est supprimée de la requête. Claude ne voit pas l'outil et ne peut pas le tenter. |88| `disallowed_tools=["Bash"]` | La définition de l'outil `Bash` est supprimée de la requête. |

89| `disallowed_tools=["Bash(rm *)"]` | `Bash` reste disponible. Les appels correspondant à `rm *` [tel qu'écrit](https://code.claude.com/docs/fr/permissions.md#bash-rule-limits) sont refusés dans tous les modes de permission, y compris `bypassPermissions`. Les autres appels `Bash`, y compris `/bin/rm`, tombent dans le mode de permission. |89| `disallowed_tools=["Bash(rm *)"]` | `Bash` reste disponible. Les appels correspondant à `rm *` [tel qu'écrit](https://code.claude.com/docs/fr/permissions.md#bash-rule-limits) sont refusés dans tous les modes de permission, y compris `bypassPermissions`. Les autres appels `Bash`, y compris `/bin/rm`, tombent dans le mode de permission. |

90| `disallowed_tools=["*"]` | Chaque définition d'outil est supprimée de la requête. Les globs de noms d'outils sont pris en charge dans les règles de refus : `"*"` correspond à chaque outil et `"mcp__*"` correspond à chaque outil MCP sur tous les serveurs. |90| `disallowed_tools=["*"]` | Les globs de noms d'outils sont pris en charge dans les règles de refus : `"*"` correspond à chaque outil et `"mcp__*"` correspond à chaque outil MCP sur tous les serveurs. |

91 91 

92Les règles d'autorisation acceptent les globs de noms d'outils uniquement après un préfixe littéral `mcp__<server>__`. Le segment serveur doit être sans glob afin que la règle nomme un serveur spécifique que vous avez configuré : `mcp__puppeteer__*` correspond à chaque outil du serveur `puppeteer`, et `mcp__github__get_*` correspond à ses outils `get_`. Une entrée non ancrée comme `allowed_tools=["*"]` ou `allowed_tools=["mcp__*"]` est ignorée et n'approuve automatiquement rien.92Les règles d'autorisation acceptent les globs de noms d'outils uniquement après un préfixe littéral `mcp__<server>__`. Le segment serveur doit être sans glob afin que la règle nomme un serveur spécifique que vous avez configuré : `mcp__puppeteer__*` correspond à chaque outil du serveur `puppeteer`, et `mcp__github__get_*` correspond à ses outils `get_`. Une entrée non ancrée comme `allowed_tools=["*"]` ou `allowed_tools=["mcp__*"]` est ignorée et n'approuve automatiquement rien.

93 93 

Details

2787 2787 

2788Exécute une source de fond et livre chaque événement à Claude pour qu'il puisse réagir sans interrogation : `command` exécute un script et émet un événement par ligne stdout, et `ws` ouvre une WebSocket et émet un événement par trame texte. Fournissez exactement l'un de `command` ou `ws`.2788Exécute une source de fond et livre chaque événement à Claude pour qu'il puisse réagir sans interrogation : `command` exécute un script et émet un événement par ligne stdout, et `ws` ouvre une WebSocket et émet un événement par trame texte. Fournissez exactement l'un de `command` ou `ws`.

2789 2789 

2790Lorsque Monitor exécute une commande, il suit les mêmes règles de permission que Bash ; une surveillance WebSocket demande une approbation séparément. La source `ws` nécessite Claude Code v2.1.195 ou ultérieur. Voir la [référence de l'outil Monitor](https://code.claude.com/docs/fr/tools-reference.md#monitor-tool) pour le comportement et la disponibilité du fournisseur.2790La source `ws` nécessite Claude Code v2.1.195 ou ultérieur. Lorsque Monitor exécute une commande, il suit les mêmes règles de permission que Bash. Voir la [référence de l'outil Monitor](https://code.claude.com/docs/fr/tools-reference.md#monitor-tool) pour les permissions WebSocket, le comportement et la disponibilité du fournisseur.

2791 2791 

2792**Entrée :**2792**Entrée :**

2793 2793 

Details

3389 3389 

3390Exécute une source en arrière-plan et livre chaque événement à Claude pour qu'il puisse réagir sans interrogation : `command` exécute un script et émet un événement par ligne stdout, et `ws` ouvre une WebSocket et émet un événement par trame texte. Fournissez exactement l'un de `command` ou `ws`. La source `ws` nécessite Claude Code v2.1.195 ou version ultérieure.3390Exécute une source en arrière-plan et livre chaque événement à Claude pour qu'il puisse réagir sans interrogation : `command` exécute un script et émet un événement par ligne stdout, et `ws` ouvre une WebSocket et émet un événement par trame texte. Fournissez exactement l'un de `command` ou `ws`. La source `ws` nécessite Claude Code v2.1.195 ou version ultérieure.

3391 3391 

3392`timeout_ms` est la date limite de la surveillance en millisecondes. Elle est par défaut 300 000 et accepte les valeurs jusqu'à 3 600 000. La date limite effective est au maximum 1 800 000, soit 30 minutes, donc une valeur acceptée plus grande est raccourcie à cela. À la date limite, la surveillance se termine et Claude reçoit un avis pour qu'il puisse démarrer une nouvelle surveillance s'il en a toujours besoin.3392`timeout_ms` est la date limite de la surveillance en millisecondes :

3393 3393 

3394Le type exporté marque `timeout_ms` comme requis car le schéma remplit la valeur par défaut ; un appel qui l'omet valide.3394* **Valeur par défaut et limites** : elle vaut par défaut 300 000 et accepte les valeurs jusqu'à 3 600 000. La date limite effective est au maximum 1 800 000, soit 30 minutes, donc une valeur acceptée plus grande est raccourcie à cela

3395* **À la date limite** : la surveillance se termine et Claude reçoit un avis pour qu'il puisse démarrer une nouvelle surveillance s'il en a toujours besoin

3396* **Requis dans le type** : le type exporté marque `timeout_ms` comme requis car le schéma remplit la valeur par défaut ; un appel qui l'omet valide

3395 3397 

3396Lorsque Monitor exécute une commande, il suit les mêmes règles de permission que Bash ; une surveillance WebSocket demande une approbation séparément. Voir la [référence de l'outil Monitor](https://code.claude.com/docs/fr/tools-reference.md#monitor-tool) pour le comportement et la disponibilité du fournisseur.3398Lorsque Monitor exécute une commande, il suit les mêmes règles de permission que Bash. Voir la [référence de l'outil Monitor](https://code.claude.com/docs/fr/tools-reference.md#monitor-tool) pour les permissions WebSocket, le comportement et la disponibilité du fournisseur.

3397 3399 

3398### TaskOutput3400### TaskOutput

3399 3401 

Details

433 433 

434### Changez le modèle et l'effort434### Changez le modèle et l'effort

435 435 

436L'[effort](https://code.claude.com/docs/fr/model-config.md#adjust-effort-level) est le principal contrôle de la durée de réflexion de Claude, et il remplace la plupart de ce que l'on faisait autrefois avec la formulation des prompts. Claude Opus 5.5, Sonnet 5.5 et Haiku 5.5 utilisent `medium` par défaut, ce qui suffit largement pour le développement de fonctionnalités courantes avec un périmètre clair. Les moments où vous le modifieriez, avec `/effort` dans la session :436L'[effort](https://code.claude.com/docs/fr/model-config.md#adjust-effort-level) est le principal contrôle de la durée de réflexion de Claude, et il remplace la plupart de ce que l'on faisait autrefois avec la formulation des prompts. Claude Fable 5.2, Opus 5.5, Sonnet 5.5 et Haiku 5.5 utilisent `medium` par défaut, ce qui suffit largement pour le développement de fonctionnalités courantes avec un périmètre clair. Les moments où vous le modifieriez, avec `/effort` dans la session :

437 437 

438* Augmentez-le avec `/effort high` ou `/effort xhigh` lorsque la réussite dépend de cas faciles à négliger. Pensez à un bug dans du code que vous n'avez pas écrit, à un test instable ou à un changement de schéma où Claude doit trouver chaque lecteur de l'ancienne forme. Claude vérifie alors davantage de cas limites et une plus grande partie de son travail avant de répondre, et c'est là que passent le temps et les tokens supplémentaires.438* Augmentez-le avec `/effort high` ou `/effort xhigh` lorsque la réussite dépend de cas faciles à négliger. Pensez à un bug dans du code que vous n'avez pas écrit, à un test instable ou à un changement de schéma où Claude doit trouver chaque lecteur de l'ancienne forme. Claude vérifie alors davantage de cas limites et une plus grande partie de son travail avant de répondre, et c'est là que passent le temps et les tokens supplémentaires.

439* Réduisez-le avec `/effort low` lorsque vous faites des allers-retours rapides et examinez de toute façon chaque résultat : brainstorming, première ébauche, renommage dans quelques fichiers. Claude vous donne un point de départ plus tôt, et puisque vous pilotez chaque étape, la délibération supplémentaire n'aurait pas changé grand-chose à part l'attente.439* Réduisez-le avec `/effort low` lorsque vous faites des allers-retours rapides et examinez de toute façon chaque résultat : brainstorming, première ébauche, renommage dans quelques fichiers. Claude vous donne un point de départ plus tôt, et puisque vous pilotez chaque étape, la délibération supplémentaire n'aurait pas changé grand-chose à part l'attente.

440* Réservez `max` à un problème difficile que vous voulez que Claude résolve sans vous, comme la recherche d'une vulnérabilité de sécurité. Sur des tâches ordinaires, il a tendance à trop réfléchir, et vous payez donc davantage pour une réponse qui n'est peut-être pas meilleure que ce que `high` vous aurait donné.440* Réservez `max` à un problème difficile que vous voulez que Claude résolve sans vous, comme la recherche d'une vulnérabilité de sécurité. Sur des tâches ordinaires, il a tendance à trop réfléchir, et vous payez donc davantage pour une réponse qui n'est peut-être pas meilleure que ce que `high` vous aurait donné.

441* Lorsque seul le message suivant en a besoin, comme une question délicate au milieu d'un travail par ailleurs courant, mettez [`ultrathink`](https://code.claude.com/docs/fr/model-config#use-ultrathink-for-one-off-deep-reasoning) dans ce prompt au lieu de modifier le paramètre.441* Lorsque seul le message suivant en a besoin, comme une question délicate au milieu d'un travail par ailleurs courant, mettez [`ultrathink`](https://code.claude.com/docs/fr/model-config#use-ultrathink-for-one-off-deep-reasoning) dans ce prompt au lieu de modifier le paramètre.

442 442 

443Pour le modèle lui-même, Opus 5.5 par défaut gère bien la plupart des tâches de code et Sonnet coûte moins cher sur le travail courant. [Claude Fable 5.1](https://code.claude.com/docs/fr/model-config.md#work-with-fable) est disponible lorsque vous le sélectionnez explicitement avec `/model fable`, et Haiku convient bien aux sous-agents effectuant des tâches simples. [Configuration du modèle](https://code.claude.com/docs/fr/model-config.md) présente la liste complète par plan et fournisseur.443Pour le modèle lui-même, Opus 5.5 par défaut gère bien la plupart des tâches de code et Sonnet coûte moins cher sur le travail courant. Pour utiliser [Claude Fable 5.2](https://code.claude.com/docs/fr/model-config.md#work-with-fable), exécutez `/model fable`. Haiku convient bien aux sous-agents effectuant des tâches simples. [Configuration du modèle](https://code.claude.com/docs/fr/model-config.md) présente la liste complète par plan et fournisseur.

444 444 

445### Sachez ce que coûtent les sous-agents445### Sachez ce que coûtent les sous-agents

446 446 

Details

172 172 

173Un démarrage réussi ne valide pas le chemin d'inférence, car les identifiants d'instance d'Amazon Bedrock et d'Agent Platform de Google Cloud sont résolus lors de la première requête, et non au démarrage.173Un démarrage réussi ne valide pas le chemin d'inférence, car les identifiants d'instance d'Amazon Bedrock et d'Agent Platform de Google Cloud sont résolus lors de la première requête, et non au démarrage.

174 174 

175Surveillez stderr pour suivre la séquence de démarrage. Les lignes de log utilisent le format `[gateway] <timestamp> <level> <message>`, les événements d'audit sont du JSON sur une seule ligne avec un champ `evt`, et une bannière de démarrage, omise ci-dessous, s'affiche entre les lignes de migration et d'écoute. Une base de données vierge affiche une ligne `migration N applied` par migration de schéma ; une base de données déjà migrée n'en affiche aucune. Vous devriez voir, dans l'ordre :175Surveillez stderr pour suivre la séquence de démarrage. Par défaut, les lignes de log utilisent le format `[gateway] <timestamp> <level> <message>`, et une bannière de démarrage, omise ci-dessous, s'affiche entre les lignes de migration et d'écoute. Les événements d'audit sont du JSON sur une seule ligne avec un champ `evt`. Une base de données vierge affiche une ligne `migration N applied` par migration de schéma ; une base de données déjà migrée n'en affiche aucune. Vous devriez voir, dans l'ordre :

176 176 

177```text theme={null}177```text theme={null}

178{"ts":"2026-06-10T17:03:21.114Z","evt":"config.load","path":"/etc/claude/gateway.yaml","sha256":"…"}178{"ts":"2026-06-10T17:03:21.114Z","evt":"config.load","path":"/etc/claude/gateway.yaml","sha256":"…"}

Details

28 28 

29**Sections optionnelles :**29**Sections optionnelles :**

30 30 

31* [`login_notice`](#login_notice) : un avis que les développeurs voient lorsqu'ils se connectent

31* [`admin`](#admin) : authentification de l'API Admin et rétention pour les limites de dépenses32* [`admin`](#admin) : authentification de l'API Admin et rétention pour les limites de dépenses

32* [`enforcement`](#enforcement) : comportement de limite de dépenses fail-open ou fail-closed33* [`enforcement`](#enforcement) : comportement de limite de dépenses fail-open ou fail-closed

33* [`pricing`](#pricing) : tarifs contractuels et un multiplicateur pour le compteur de dépenses et pour les chiffres de coût que les développeurs voient34* [`pricing`](#pricing) : tarifs contractuels et un multiplicateur pour le compteur de dépenses et pour les chiffres de coût que les développeurs voient


847 848 

848## Sections optionnelles849## Sections optionnelles

849 850 

851### `login_notice`

852 

853Pour afficher un avis aux développeurs lorsqu'ils se connectent, définissez la clé de premier niveau `login_notice` sur le texte de l'avis, jusqu'à 500 caractères. Cet exemple indique à qui s'adresse la passerelle et où demander un accès :

854 

855```yaml theme={null}

856login_notice: This gateway is for Example Corp staff. For access questions, email it-help@example.com.

857```

858 

859Les développeurs voient le texte sous `Notice from <gateway hostname>` sur la page de vérification de la passerelle dans le navigateur et sur l'écran de connexion interactif dans le terminal. Les sauts de ligne du texte deviennent des espaces. L'avis s'affiche avant la connexion, donc toute personne pouvant atteindre la passerelle peut le lire.

860 

861Nécessite Claude Code v2.1.319 ou version ultérieure sur le serveur de la passerelle, ainsi que sur la machine du développeur pour l'écran du terminal. Une passerelle antérieure refuse de démarrer lorsqu'elle trouve la clé. Mettez à niveau chaque réplica avant d'ajouter la clé, et supprimez la clé avant de revenir à une version antérieure.

862 

850### `admin`863### `admin`

851 864 

852Optionnel. Active `/v1/organizations/spend_limits`, qui reflète l'API Admin publique d'Anthropic, et l'application des dépenses par développeur sur `/v1/messages`. Consultez [Limites de dépenses](https://code.claude.com/docs/fr/claude-apps-gateway-spend-limits.md) pour savoir comment les plafonds sont définis et appliqués ; cette section couvre les clés `gateway.yaml` qui activent la fonctionnalité et l'ajustent.865Optionnel. Active `/v1/organizations/spend_limits`, qui reflète l'API Admin publique d'Anthropic, et l'application des dépenses par développeur sur `/v1/messages`. Consultez [Limites de dépenses](https://code.claude.com/docs/fr/claude-apps-gateway-spend-limits.md) pour savoir comment les plafonds sont définis et appliqués ; cette section couvre les clés `gateway.yaml` qui activent la fonctionnalité et l'ajustent.


865 # IdP groups granted full admin via the normal gateway JWT (no API key).878 # IdP groups granted full admin via the normal gateway JWT (no API key).

866 admin_groups: [platform-finops]879 admin_groups: [platform-finops]

867 blocked_message: request an increase at https://go.example.com/claude-limits880 blocked_message: request an increase at https://go.example.com/claude-limits

881 # Try eng-platform's pooled budget first, then eng-all's, then any other group's.

882 pooled_conflict_rule: priority_list

883 pooled_priority_order: [eng-platform, eng-all]

868```884```

869 885 

870| Champ | Requis | Description |886| Champ | Requis | Description |


877| `spend_retention_months` | Non | Par défaut `13`. Les lignes du compteur `spend` plus anciennes que cela sont supprimées. La valeur par défaut conserve une année complète plus le mois partiel actuel pour les rapports d'une année sur l'autre. |893| `spend_retention_months` | Non | Par défaut `13`. Les lignes du compteur `spend` plus anciennes que cela sont supprimées. La valeur par défaut conserve une année complète plus le mois partiel actuel pour les rapports d'une année sur l'autre. |

878| `identity_retention_days` | Non | Par défaut `90`. TTL de dernière consultation pour les lignes `principal_emails`, qui contiennent l'e-mail, le nom d'affichage et les groupes de chaque développeur (PII). Délibérément plus court que la rétention des dépenses afin qu'une identité déprovisionnée expire tandis que ses compteurs de dépenses anonymes restent. |894| `identity_retention_days` | Non | Par défaut `90`. TTL de dernière consultation pour les lignes `principal_emails`, qui contiennent l'e-mail, le nom d'affichage et les groupes de chaque développeur (PII). Délibérément plus court que la rétention des dépenses afin qu'une identité déprovisionnée expire tandis que ses compteurs de dépenses anonymes restent. |

879| `group_limit_mode` | Non | `min` (par défaut) ou `max`. Lorsqu'un développeur se trouve dans plusieurs groupes avec des plafonds, `min` applique le plus restrictif et `max` le moins restrictif. Utilisé à la fois par l'application et par `/effective`. |895| `group_limit_mode` | Non | `min` (par défaut) ou `max`. Lorsqu'un développeur se trouve dans plusieurs groupes avec des plafonds, `min` applique le plus restrictif et `max` le moins restrictif. Utilisé à la fois par l'application et par `/effective`. |

896| `pooled_conflict_rule` | Non | `default_order` (par défaut) ou `priority_list`. L'ordre dans lequel la passerelle essaie les budgets mutualisés d'un développeur. Consultez [Ordre des budgets mutualisés](#pooled-budget-order). Nécessite v2.1.319 ou version ultérieure. |

897| `pooled_priority_order` | Avec `priority_list` | Jusqu'à 50 noms de groupes, chacun listé une seule fois et orthographié comme votre IdP l'envoie. Les groupes dont la passerelle essaie les budgets mutualisés en premier. Consultez [Ordre des budgets mutualisés](#pooled-budget-order). Nécessite v2.1.319 ou version ultérieure. |

898 

899#### Ordre des budgets mutualisés

900 

901Un budget mutualisé est une limite mensuelle unique sur laquelle dépense tout un groupe. Pour en définir un, ajoutez `pooled_budget` à la [requête qui définit le plafond mensuel du groupe](https://code.claude.com/docs/fr/claude-apps-gateway-spend-limits.md#set-a-cap), comme dans `"pooled_budget": {"amount": "500000"}` pour 5 000 \$. La requête prend également la `scope` du groupe, `"period": "monthly"` et `amount`, qui reste le plafond propre à chaque membre.

902 

903Pour un développeur appartenant à plusieurs de ces groupes, chaque requête est imputée au premier budget dont la dépense est inférieure à sa limite, et est refusée lorsque tous les budgets sont épuisés. `pooled_conflict_rule` définit l'ordre dans lequel la passerelle essaie les budgets :

904 

905* **`default_order`** : la limite la plus élevée en premier, et les limites égales par ordre alphabétique croissant du nom de groupe

906* **`priority_list`** : les budgets des groupes de `pooled_priority_order`, dans l'ordre de la liste, puis les budgets des autres groupes par nom de groupe

907 

908Si vous listez des groupes sans `pooled_conflict_rule: priority_list`, la passerelle ignore la liste et consigne un avertissement au démarrage.

909 

910Un serveur de passerelle antérieur à v2.1.319 refuse de démarrer lorsqu'il trouve `pooled_conflict_rule` ou `pooled_priority_order`. Mettez à niveau chaque réplica avant d'ajouter l'une ou l'autre clé, et supprimez les deux clés avant de revenir à une version antérieure.

880 911 

881### `enforcement`912### `enforcement`

882 913 


1674# La verbosité du journal opérationnel est contrôlée par la variable1705# La verbosité du journal opérationnel est contrôlée par la variable

1675# d'environnement CLAUDE_GATEWAY_LOG_LEVEL1706# d'environnement CLAUDE_GATEWAY_LOG_LEVEL

1676# (debug | info | warn | error ; par défaut info). debug1707# (debug | info | warn | error ; par défaut info). debug

1677# enregistre également les noms de réclamations dans chaque id_token, pour le diagnostic groups_claim.1708# journalise également les noms de réclamations dans chaque id_token, pour le diagnostic groups_claim.

1678# Cela n'affecte pas les événements d'audit, qui sont toujours émis.1709# Cela n'affecte pas les événements d'audit, qui sont toujours émis.

1710# Définissez CLAUDE_GATEWAY_LOG_FORMAT=json pour écrire les lignes du journal opérationnel

1711# sous forme d'objets JSON avec severity, time et message.

1679 1712 

1680listen:1713listen:

1681 host: 0.0.0.01714 host: 0.0.0.0


1698 # peuvent omettre l'e-mail et les groupes ; la passerelle les remplit à partir de /userinfo.1731 # peuvent omettre l'e-mail et les groupes ; la passerelle les remplit à partir de /userinfo.

1699 userinfo_fallback: true1732 userinfo_fallback: true

1700 # allowed_groups: [claude-code-users]1733 # allowed_groups: [claude-code-users]

1701 # Okta émet des groupes uniquement lorsque la portée `groups` est demandée et que1734 # Okta émet des groupes uniquement lorsque le scope `groups` est demandé et que

1702 # le filtre de réclamation de groupes de l'application les autorise. La politique1735 # le filtre de réclamation de groupes de l'application les autorise. La politique

1703 # des entrepreneurs ci-dessous correspond aux groupes, donc la portée est demandée ici.1736 # des entrepreneurs ci-dessous correspond aux groupes, donc le scope est demandé ici.

1704 scopes: [openid, profile, email, offline_access, groups]1737 scopes: [openid, profile, email, offline_access, groups]

1705 # extra_auth_params: { access_type: offline, prompt: consent } # Google1738 # extra_auth_params: { access_type: offline, prompt: consent } # Google

1706 # groups_claim: groups # Rôles d'application Entra : utilisez `roles`1739 # groups_claim: groups # Rôles d'application Entra : utilisez `roles`


1716 # connect_timeout_seconds: 51749 # connect_timeout_seconds: 5

1717 # readiness_grace_seconds: 300 # continuez à passer le contrôle de disponibilité lors d'un basculement de base de données1750 # readiness_grace_seconds: 300 # continuez à passer le contrôle de disponibilité lors d'un basculement de base de données

1718 1751 

1752# Notice affichée à la connexion. Toute personne pouvant atteindre la passerelle peut la lire.

1753# login_notice: This gateway is for Example Corp staff. For access questions, email it-help@example.com.

1754 

1719# Active /v1/organizations/spend_limits (reflète l'API Admin Anthropic)1755# Active /v1/organizations/spend_limits (reflète l'API Admin Anthropic)

1720# et l'application des limites de dépenses par développeur sur /v1/messages. Omettez pour désactiver.1756# et l'application des limites de dépenses par développeur sur /v1/messages. Omettez pour désactiver.

1721# Les plafonds eux-mêmes sont définis via l'API admin, pas ici.1757# Les plafonds eux-mêmes sont définis via l'API admin, pas ici.


1730# # spend_retention_months: 131766# # spend_retention_months: 13

1731# # identity_retention_days: 901767# # identity_retention_days: 90

1732# # group_limit_mode: min1768# # group_limit_mode: min

1769# # pooled_conflict_rule: priority_list

1770# # pooled_priority_order: [eng-platform, eng-all]

1733 1771 

1734# enforcement:1772# enforcement:

1735# fail_closed_on_error: false1773# fail_closed_on_error: false

1736 1774 

1737# Testez en charge ce déploiement sans appeler un fournisseur de modèle. Jamais sur une1775# Testez en charge ce déploiement sans appeler un fournisseur de modèle. Jamais sur une

1738# passerelle que les développeurs utilisent : chaque demande reçoit une réponse en conserve.1776# passerelle que les développeurs utilisent : chaque requête reçoit une réponse en conserve.

1739# load_test_mode:1777# load_test_mode:

1740# enabled: true1778# enabled: true

1741# # reply_tokens: 7501779# # reply_tokens: 750

Details

173 * `admin.denied` enregistre une tentative d'authentification d'API admin rejetée avec l'adresse IP du client, la méthode, le chemin et une raison, sans le matériel de clé présenté : `invalid_key` quand une `x-api-key` a été présentée mais ne correspondait à aucune clé configurée, `bearer_rejected` quand seul un en-tête `Authorization` a été présenté et il n'a pas vérifié comme une session de passerelle dans `admin.admin_groups`, ou `no_credentials` quand aucun en-tête n'a été présenté173 * `admin.denied` enregistre une tentative d'authentification d'API admin rejetée avec l'adresse IP du client, la méthode, le chemin et une raison, sans le matériel de clé présenté : `invalid_key` quand une `x-api-key` a été présentée mais ne correspondait à aucune clé configurée, `bearer_rejected` quand seul un en-tête `Authorization` a été présenté et il n'a pas vérifié comme une session de passerelle dans `admin.admin_groups`, ou `no_credentials` quand aucun en-tête n'a été présenté

174* **Journaux opérationnels** : lignes lisibles par l'homme avec préfixe `[gateway]` pour le démarrage, les avertissements et les erreurs en amont. La variable d'environnement `CLAUDE_GATEWAY_LOG_LEVEL` contrôle la verbosité et accepte `debug`, `info`, `warn` ou `error`, avec `info` par défaut. À `debug`, chaque connexion et actualisation enregistre également les noms, pas les valeurs, des revendications dans l'id\_token, plus les noms des revendications userinfo quand `userinfo_fallback` en a fourni, afin que vous puissiez diagnostiquer les paramètres `email_claim` et `groups_claim` sans enregistrer les PII. Cela n'affecte pas les événements d'audit, qui sont toujours émis.174* **Journaux opérationnels** : lignes lisibles par l'homme avec préfixe `[gateway]` pour le démarrage, les avertissements et les erreurs en amont. La variable d'environnement `CLAUDE_GATEWAY_LOG_LEVEL` contrôle la verbosité et accepte `debug`, `info`, `warn` ou `error`, avec `info` par défaut. À `debug`, chaque connexion et actualisation enregistre également les noms, pas les valeurs, des revendications dans l'id\_token, plus les noms des revendications userinfo quand `userinfo_fallback` en a fourni, afin que vous puissiez diagnostiquer les paramètres `email_claim` et `groups_claim` sans enregistrer les PII. Cela n'affecte pas les événements d'audit, qui sont toujours émis.

175 175 

176#### Écrire les journaux opérationnels au format JSON

177 

178Si votre collecteur de logs lit le niveau de chaque ligne depuis un champ JSON, définissez `CLAUDE_GATEWAY_LOG_FORMAT=json` dans l'environnement de la passerelle. Nécessite Claude Code v2.1.319 ou ultérieur sur le serveur de passerelle.

179 

180Chaque ligne de journal opérationnel est alors un objet avec `severity`, `time` et `message` :

181 

182```json theme={null}

183{"severity":"INFO","time":"2026-11-04T17:03:21.512Z","message":"claude gateway listening on http://0.0.0.0:8080"}

184```

185 

186`severity` est le niveau de log en majuscules, `warn` étant écrit `WARNING`. Un échec de démarrage produit une ligne `ERROR`.

187 

188Les événements d'audit, qui vont également sur stderr, ne changent pas. Ils portent `ts` et `evt`, et aucun `severity`.

189 

176### Santé190### Santé

177 191 

178La passerelle sert `GET /healthz` comme sonde de vivacité et `GET /readyz` comme sonde de disponibilité. `/readyz` vérifie que le magasin est accessible. Si vous définissez [`store.readiness_grace_seconds`](https://code.claude.com/docs/fr/claude-apps-gateway-config#store), `/readyz` continue de signaler prêt pendant jusqu'à ce nombre de secondes après que le magasin cesse de répondre.192La passerelle sert `GET /healthz` comme sonde de vivacité et `GET /readyz` comme sonde de disponibilité. `/readyz` vérifie que le magasin est accessible. Si vous définissez [`store.readiness_grace_seconds`](https://code.claude.com/docs/fr/claude-apps-gateway-config#store), `/readyz` continue de signaler prêt pendant jusqu'à ce nombre de secondes après que le magasin cesse de répondre.

Details

6 6 

7> Limitez les dépenses de chaque développeur via la passerelle Claude apps par jour, semaine ou mois. Définissez les limites avec une API Admin et la passerelle les applique en direct à chaque requête.7> Limitez les dépenses de chaque développeur via la passerelle Claude apps par jour, semaine ou mois. Définissez les limites avec une API Admin et la passerelle les applique en direct à chaque requête.

8 8 

9Les limites de dépenses limitent le montant que chaque développeur peut dépenser via votre [passerelle Claude apps](https://code.claude.com/docs/fr/claude-apps-gateway) au cours d'un jour, d'une semaine ou d'un mois donné. Lorsqu'un développeur dépasse sa limite, la passerelle retourne `429` à sa prochaine requête et le bloque jusqu'à ce que la période se réinitialise ou qu'un administrateur augmente la limite. Utilisez les limites de dépenses pour donner à chaque développeur, groupe ou l'ensemble de l'organisation un plafond sur une credential que tout le monde partage.9Les limites de dépenses limitent le montant que chaque développeur peut dépenser via votre [passerelle Claude apps](https://code.claude.com/docs/fr/claude-apps-gateway) au cours d'un jour, d'une semaine ou d'un mois donné. Lorsqu'un développeur dépasse sa limite, la passerelle retourne `429` à ses requêtes suivantes jusqu'à ce qu'un administrateur augmente la limite, ou jusqu'à ce que la limite se réinitialise si elle est supérieure à 0 \$. Utilisez les limites de dépenses pour donner à chaque développeur, groupe ou l'ensemble de l'organisation un plafond sur des identifiants que tout le monde partage.

10 10 

11Par défaut, une passerelle Claude apps transfère toutes les inférences via une credential amont partagée, de sorte que la facture de votre fournisseur attribue tout à cette credential, et non aux développeurs individuels. Sur Amazon Bedrock, [l'attribution des coûts AWS par développeur](https://code.claude.com/docs/fr/claude-apps-gateway-config.md#per-developer-aws-cost-attribution) change cela. Sans limites par développeur, une flotte d'agents incontrôlée peut dépenser l'engagement entier de l'organisation. Les limites de dépenses constituent la vue par développeur de la passerelle et le disjoncteur sur cette facture partagée.11Par défaut, une passerelle Claude apps transfère toutes les inférences via une credential amont partagée, de sorte que la facture de votre fournisseur attribue tout à cette credential, et non aux développeurs individuels. Sur Amazon Bedrock, [l'attribution des coûts AWS par développeur](https://code.claude.com/docs/fr/claude-apps-gateway-config.md#per-developer-aws-cost-attribution) change cela. Sans limites par développeur, une flotte d'agents incontrôlée peut dépenser l'engagement entier de l'organisation. Les limites de dépenses constituent la vue par développeur de la passerelle et le disjoncteur sur cette facture partagée.

12 12 


51 51 

52À chaque requête `/v1/messages`, la passerelle résout les limites du développeur et les dépenses à ce jour de la période en une seule requête Postgres. S'il dépasse une limite, la requête retourne `429` avec `error.type: billing_error` et l'en-tête `x-should-retry: false`.52À chaque requête `/v1/messages`, la passerelle résout les limites du développeur et les dépenses à ce jour de la période en une seule requête Postgres. S'il dépasse une limite, la requête retourne `429` avec `error.type: billing_error` et l'en-tête `x-should-retry: false`.

53 53 

54Le message nomme la période et l'heure de réinitialisation, par exemple `spend limit reached (daily; resets 2026-08-08 00:00 UTC)`, suivi de votre [`admin.blocked_message`](https://code.claude.com/docs/fr/claude-apps-gateway-config#admin) s'il est défini. Quand un développeur dépasse plusieurs limites à la fois, le message nomme la limite qui se réinitialise en dernier. La réponse porte également un en-tête `retry-after` avec les secondes restantes jusqu'à cette réinitialisation. Avant v2.1.225 sur le serveur de la passerelle, le message était `spend limit reached` sans période, heure de réinitialisation, ou en-tête `retry-after`.54Pour une limite supérieure à `"0"`, le message indique la date UTC à laquelle cette limite se réinitialise. Si vous définissez [`admin.blocked_message`](https://code.claude.com/docs/fr/claude-apps-gateway-config#admin), la passerelle l'ajoute à la suite, comme dans cet exemple :

55 

56```text theme={null}

57spend limit reached · resets Dec 1 · request an increase at https://go.example.com/claude-limits

58```

59 

60Pour une limite à `"0"`, qu'une réinitialisation ne lève pas, le message ne comporte pas de date. Quand un développeur dépasse plusieurs limites à la fois, le message décrit la limite qui se réinitialise en dernier. La réponse porte également un en-tête `retry-after` avec les secondes restantes jusqu'à la fin de la période de cette limite.

61 

62Avant v2.1.319 sur le serveur de la passerelle, le message nommait la période et l'heure de réinitialisation, par exemple `spend limit reached (daily; resets 2026-08-08 00:00 UTC)`. Avant v2.1.225, le message était `spend limit reached` sans période, heure de réinitialisation, ou en-tête `retry-after`.

55 63 

56Sur v2.1.227 ou ultérieur, la référence de protocole à `<public_url>/protocol` liste également les en-têtes de réponse de limite d'utilisation exacts et le corps `429`.64Sur v2.1.227 ou ultérieur, la référence de protocole à `<public_url>/protocol` liste également les en-têtes de réponse de limite d'utilisation exacts et le corps `429`.

57 65 


95| Avertissements d'utilisation à 75 % et 95 % | v2.1.225 ou ultérieur | v2.1.225 ou ultérieur |103| Avertissements d'utilisation à 75 % et 95 % | v2.1.225 ou ultérieur | v2.1.225 ou ultérieur |

96| Une barre **Spend limit** dans `/usage` avec le pourcentage de sa limite utilisé et le moment de sa réinitialisation, et un objet `rate_limits.spend_limit` dans l'entrée de la barre de statut | v2.1.251 ou ultérieur | v2.1.225 ou ultérieur |104| Une barre **Spend limit** dans `/usage` avec le pourcentage de sa limite utilisé et le moment de sa réinitialisation, et un objet `rate_limits.spend_limit` dans l'entrée de la barre de statut | v2.1.251 ou ultérieur | v2.1.225 ou ultérieur |

97| Ses dépenses estimées et la limite en dollars américains dans la barre **Spend limit**, par exemple « \$271.40 / \$500.00 spent this month », et les mêmes montants ainsi que la période de la limite dans l'entrée de la barre de statut | v2.1.284 ou ultérieur | v2.1.284 ou ultérieur |105| Ses dépenses estimées et la limite en dollars américains dans la barre **Spend limit**, par exemple « \$271.40 / \$500.00 spent this month », et les mêmes montants ainsi que la période de la limite dans l'entrée de la barre de statut | v2.1.284 ou ultérieur | v2.1.284 ou ultérieur |

106| Sur une passerelle dotée d'un bloc [`admin:`](https://code.claude.com/docs/fr/claude-apps-gateway-config#admin), lorsqu'aucune limite ne s'applique à lui, ses dépenses estimées sous **Spend (UTC)** dans `/usage`, par exemple « \$13.06 today · \$80.76 this week · \$272.06 this month » | v2.1.319 ou ultérieur | v2.1.319 ou ultérieur |

98 107 

99Les avertissements et le pourcentage proviennent des en-têtes `anthropic-ratelimit-unified-*`, que la passerelle ajoute à chaque réponse `/v1/messages` réussie pour un développeur qui a une limite. Les en-têtes décrivent toujours la limite propre du développeur : la passerelle supprime les en-têtes de limite de débit du fournisseur amont, qui décrivent votre quota partagé, et ne les transmet jamais.108Les avertissements et le pourcentage proviennent des en-têtes `anthropic-ratelimit-unified-*`, que la passerelle ajoute à chaque réponse `/v1/messages` réussie pour un développeur qui a une limite. Les en-têtes décrivent toujours la limite propre du développeur : la passerelle supprime les en-têtes de limite de débit du fournisseur amont, qui décrivent votre quota partagé, et ne les transmet jamais.

100 109 

Details

41| `claude mcp logout <name>` | Effacer les identifiants OAuth stockés pour un serveur MCP | `claude mcp logout sentry` |41| `claude mcp logout <name>` | Effacer les identifiants OAuth stockés pour un serveur MCP | `claude mcp logout sentry` |

42| `claude plugin` | Gérer les [plugins](https://code.claude.com/docs/fr/plugins/overview.md) Claude Code. Alias : `claude plugins`. Voir la [référence des plugins](https://code.claude.com/docs/fr/plugins/cli-reference.md#claude-plugin-commands) pour les sous-commandes | `claude plugin install code-review@claude-plugins-official` |42| `claude plugin` | Gérer les [plugins](https://code.claude.com/docs/fr/plugins/overview.md) Claude Code. Alias : `claude plugins`. Voir la [référence des plugins](https://code.claude.com/docs/fr/plugins/cli-reference.md#claude-plugin-commands) pour les sous-commandes | `claude plugin install code-review@claude-plugins-official` |

43| `claude purge [path]` | Supprimer tout l'état local de Claude Code pour un projet : transcriptions, listes de tâches, journaux de débogage, historique des modifications de fichiers, lignes d'historique des prompts, et l'entrée du projet dans `~/.claude.json`. Omettez `[path]` pour choisir dans une liste interactive. Flags : `--dry-run` pour prévisualiser, `-y`/`--yes` pour ignorer la confirmation, `-i`/`--interactive` pour confirmer chaque élément, `--all` pour chaque projet. Voir [Effacer les données locales](https://code.claude.com/docs/fr/claude-directory.md#clear-local-data) | `claude purge ~/work/repo --dry-run` |43| `claude purge [path]` | Supprimer tout l'état local de Claude Code pour un projet : transcriptions, listes de tâches, journaux de débogage, historique des modifications de fichiers, lignes d'historique des prompts, et l'entrée du projet dans `~/.claude.json`. Omettez `[path]` pour choisir dans une liste interactive. Flags : `--dry-run` pour prévisualiser, `-y`/`--yes` pour ignorer la confirmation, `-i`/`--interactive` pour confirmer chaque élément, `--all` pour chaque projet. Voir [Effacer les données locales](https://code.claude.com/docs/fr/claude-directory.md#clear-local-data) | `claude purge ~/work/repo --dry-run` |

44| `claude remote-control` | Démarrer un serveur [Remote Control](https://code.claude.com/docs/fr/remote-control.md) pour contrôler Claude Code depuis Claude.ai ou l'application Claude. S'exécute en mode serveur (pas de session interactive locale). Voir [Flags du mode serveur](https://code.claude.com/docs/fr/remote-control.md#start-a-remote-control-session). Après avoir arrêté le serveur, vous pouvez ramener les sessions qu'il servait. Voir [Reprendre les sessions après l'arrêt du serveur](https://code.claude.com/docs/fr/remote-control.md#resume-sessions-after-stopping-the-server) | `claude remote-control --name "My Project"` |44| `claude remote-control` | Démarrer un serveur [Remote Control](https://code.claude.com/docs/fr/remote-control.md) pour contrôler Claude Code depuis claude.ai ou l'application Claude. Alias : `claude rc`. S'exécute en mode serveur (pas de session interactive locale). Voir [Flags du mode serveur](https://code.claude.com/docs/fr/remote-control.md#start-a-remote-control-session). Après avoir arrêté le serveur, vous pouvez ramener les sessions qu'il servait. Voir [Reprendre les sessions après l'arrêt du serveur](https://code.claude.com/docs/fr/remote-control.md#resume-sessions-after-stopping-the-server) | `claude remote-control --name "My Project"` |

45| `claude respawn <id>` | Redémarrer une [session d'arrière-plan](https://code.claude.com/docs/fr/agent-view.md#manage-sessions-from-the-shell), en cours d'exécution ou arrêtée, avec sa conversation intacte. Utilisez `--all` pour redémarrer chaque session en cours d'exécution, par exemple pour récupérer un binaire Claude Code mis à jour | `claude respawn 7c5dcf5d` |45| `claude respawn <id>` | Redémarrer une [session d'arrière-plan](https://code.claude.com/docs/fr/agent-view.md#manage-sessions-from-the-shell), en cours d'exécution ou arrêtée, avec sa conversation intacte. Utilisez `--all` pour redémarrer chaque session en cours d'exécution, par exemple pour récupérer un binaire Claude Code mis à jour | `claude respawn 7c5dcf5d` |

46| `claude rm <id>` | Supprimer une [session d'arrière-plan](https://code.claude.com/docs/fr/agent-view.md#manage-sessions-from-the-shell) de la liste. Quand la suppression est [refusée sur le worktree de la session](https://code.claude.com/docs/fr/agent-view.md#what-deleting-a-session-removes) et qu'une deuxième `claude rm` peut la résoudre, le refus imprime le flag exact et la valeur à passer : `--discard-unpushed <commit>@<worktree-id>` abandonne un worktree qui a des commits non poussés ainsi que ces commits, et `--force-remove-worktree <worktree-id>` supprime un répertoire worktree que git ou le hook `WorktreeRemove` n'a pas pu supprimer. `--discard-unpushed` nécessite Claude Code v2.1.260 ou ultérieur, et `--force-remove-worktree` nécessite v2.1.268 ou ultérieur. La transcription de la conversation reste sur votre machine locale, disponible via `claude --resume` | `claude rm 7c5dcf5d` |46| `claude rm <id>` | Supprimer une [session d'arrière-plan](https://code.claude.com/docs/fr/agent-view.md#manage-sessions-from-the-shell) de la liste. Quand la suppression est [refusée sur le worktree de la session](https://code.claude.com/docs/fr/agent-view.md#what-deleting-a-session-removes) et qu'une deuxième `claude rm` peut la résoudre, le refus imprime le flag exact et la valeur à passer : `--discard-unpushed <commit>@<worktree-id>` abandonne un worktree qui a des commits non poussés ainsi que ces commits, et `--force-remove-worktree <worktree-id>` supprime un répertoire worktree que git ou le hook `WorktreeRemove` n'a pas pu supprimer. `--discard-unpushed` nécessite Claude Code v2.1.260 ou ultérieur, et `--force-remove-worktree` nécessite v2.1.268 ou ultérieur. La transcription de la conversation reste sur votre machine locale, disponible via `claude --resume` | `claude rm 7c5dcf5d` |

47| `claude self-hosted-runner` | Démarrer un processus runner qui enregistre cette machine ou ce conteneur auprès d'un [environnement auto-hébergé](https://code.claude.com/docs/fr/self-hosted-environments) et héberge les sessions cloud Claude Code sur votre infrastructure. Exécutez `claude self-hosted-runner setup` pour une procédure pas à pas guidée de l'opérateur, `claude self-hosted-runner doctor` pour [diagnostiquer un runner déployé](https://code.claude.com/docs/fr/self-hosted-environments-deploy.md#troubleshooting), et `claude self-hosted-runner orchestrator` pour générer des [runners à la demande](https://code.claude.com/docs/fr/self-hosted-environments-configuration.md#on-demand-runners). Nécessite Claude Code v2.1.224 ou ultérieur | `claude self-hosted-runner setup` |47| `claude self-hosted-runner` | Démarrer un processus runner qui enregistre cette machine ou ce conteneur auprès d'un [environnement auto-hébergé](https://code.claude.com/docs/fr/self-hosted-environments) et héberge les sessions cloud Claude Code sur votre infrastructure. Exécutez `claude self-hosted-runner setup` pour une procédure pas à pas guidée de l'opérateur, `claude self-hosted-runner doctor` pour [diagnostiquer un runner déployé](https://code.claude.com/docs/fr/self-hosted-environments-deploy.md#troubleshooting), et `claude self-hosted-runner orchestrator` pour générer des [runners à la demande](https://code.claude.com/docs/fr/self-hosted-environments-configuration.md#on-demand-runners). Nécessite Claude Code v2.1.224 ou ultérieur | `claude self-hosted-runner setup` |


111| `--no-session-persistence` | Désactiver la persistance de session afin que les sessions ne soient pas enregistrées sur le disque et ne puissent pas être reprises. Mode impression uniquement. La variable d'environnement [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](https://code.claude.com/docs/fr/env-vars) fait la même chose dans n'importe quel mode | `claude -p --no-session-persistence "query"` |111| `--no-session-persistence` | Désactiver la persistance de session afin que les sessions ne soient pas enregistrées sur le disque et ne puissent pas être reprises. Mode impression uniquement. La variable d'environnement [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](https://code.claude.com/docs/fr/env-vars) fait la même chose dans n'importe quel mode | `claude -p --no-session-persistence "query"` |

112| `--output-format` | Spécifier le format de sortie pour le mode impression (options : `text`, `json`, `stream-json`) | `claude -p "query" --output-format json` |112| `--output-format` | Spécifier le format de sortie pour le mode impression (options : `text`, `json`, `stream-json`) | `claude -p "query" --output-format json` |

113| `--permission-mode` | Commencer dans un [mode de permission](https://code.claude.com/docs/fr/permission-modes.md) spécifié. Accepte `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions`, ou `manual` comme alias pour `default`. L'alias `manual` sélectionne le mode de permission que l'interface utilisateur étiquette Manuel et nécessite Claude Code v2.1.200 ou ultérieur ; `claude --help` le répertorie à la place de `default`, et les deux valeurs fonctionnent. Remplace `defaultMode` des fichiers de paramètres. Sans ce drapeau ou `--dangerously-skip-permissions`, une nouvelle session démarre dans le mode de permission décrit dans [quel mode de permission une session démarre](https://code.claude.com/docs/fr/permission-modes.md#which-mode-a-session-starts-in), qui couvre également ce qu'une exécution `-p` démarre | `claude --permission-mode plan` |113| `--permission-mode` | Commencer dans un [mode de permission](https://code.claude.com/docs/fr/permission-modes.md) spécifié. Accepte `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions`, ou `manual` comme alias pour `default`. L'alias `manual` sélectionne le mode de permission que l'interface utilisateur étiquette Manuel et nécessite Claude Code v2.1.200 ou ultérieur ; `claude --help` le répertorie à la place de `default`, et les deux valeurs fonctionnent. Remplace `defaultMode` des fichiers de paramètres. Sans ce drapeau ou `--dangerously-skip-permissions`, une nouvelle session démarre dans le mode de permission décrit dans [quel mode de permission une session démarre](https://code.claude.com/docs/fr/permission-modes.md#which-mode-a-session-starts-in), qui couvre également ce qu'une exécution `-p` démarre | `claude --permission-mode plan` |

114| `--permission-prompt-tool` | Spécifier un outil MCP pour gérer les demandes de permission en mode non interactif. Passez le nom complet, tel que `mcp__<server>__<tool>`, d'un outil sur un serveur MCP que l'exécution charge. Claude Code attend que le serveur MCP de cet outil se connecte avant d'exécuter le premier tour, jusqu'au délai d'expiration de démarrage [`MCP_TIMEOUT`](https://code.claude.com/docs/fr/env-vars), 30 secondes par défaut. L'outil de demande ne peut pas approuver un outil MCP marqué comme [nécessitant une interaction utilisateur](https://code.claude.com/docs/fr/mcp.md#require-approval-for-a-specific-tool) : Claude Code convertit un résultat `allow` pour celui-ci en refus. Cette restriction nécessite Claude Code v2.1.199 ou ultérieur | `claude -p --mcp-config ./mcp.json --permission-prompt-tool mcp__permissions__approve "query"` |114| `--permission-prompt-tool` | Spécifier un outil MCP pour gérer les demandes de permission en mode non interactif. Passez le nom complet, tel que `mcp__<server>__<tool>`, d'un outil sur un serveur MCP que l'exécution charge. Claude Code attend que le serveur MCP de cet outil se connecte avant d'exécuter le premier tour, jusqu'au délai d'expiration de démarrage [`MCP_TIMEOUT`](https://code.claude.com/docs/fr/env-vars), 30 secondes par défaut. Voir [ce que l'outil doit renvoyer](https://code.claude.com/docs/fr/errors.md#permission-prompt-tool-returned-an-invalid-result). L'outil de demande ne peut pas approuver un outil MCP marqué comme [nécessitant une interaction utilisateur](https://code.claude.com/docs/fr/mcp.md#require-approval-for-a-specific-tool) : Claude Code convertit un résultat `allow` pour celui-ci en refus. Cette restriction nécessite Claude Code v2.1.199 ou ultérieur | `claude -p --mcp-config ./mcp.json --permission-prompt-tool mcp__permissions__approve "query"` |

115| `--permission-prompts` | Définir qui répond aux invites de permission en mode impression. Avec le `host` par défaut, Claude Code les envoie à l'hôte du SDK Agent ou à l'outil `--permission-prompt-tool`. Passez `none` lorsque personne ne peut répondre, et Claude Code les refuse à la place. Voir [Désactiver les invites de permission dans les exécutions sans surveillance](https://code.claude.com/docs/fr/headless.md#turn-off-permission-prompts-in-unattended-runs). Nécessite Claude Code v2.1.259 ou ultérieur | `claude -p --permission-prompts none "query"` |115| `--permission-prompts` | Définir qui répond aux invites de permission en mode impression. Avec le `host` par défaut, Claude Code les envoie à l'hôte du SDK Agent ou à l'outil `--permission-prompt-tool`. Passez `none` lorsque personne ne peut répondre, et Claude Code les refuse à la place. Voir [Désactiver les invites de permission dans les exécutions sans surveillance](https://code.claude.com/docs/fr/headless.md#turn-off-permission-prompts-in-unattended-runs). Nécessite Claude Code v2.1.259 ou ultérieur | `claude -p --permission-prompts none "query"` |

116| `--plugin-dir` | Charger un plugin à partir d'un répertoire ou d'une archive `.zip`, ou plusieurs à partir d'un [dossier de plugins](https://code.claude.com/docs/fr/plugins/create.md#load-a-directory-or-archive-for-one-session), pour cette session uniquement. Chaque drapeau prend un chemin. Répétez le drapeau pour plus de chemins : `--plugin-dir A --plugin-dir B.zip`. Passer un dossier de plugins nécessite Claude Code v2.1.265 ou ultérieur | `claude --plugin-dir ./my-plugin` |116| `--plugin-dir` | Charger un plugin à partir d'un répertoire ou d'une archive `.zip`, ou plusieurs à partir d'un [dossier de plugins](https://code.claude.com/docs/fr/plugins/create.md#load-a-directory-or-archive-for-one-session), pour cette session uniquement. Chaque drapeau prend un chemin. Répétez le drapeau pour plus de chemins : `--plugin-dir A --plugin-dir B.zip`. Passer un dossier de plugins nécessite Claude Code v2.1.265 ou ultérieur | `claude --plugin-dir ./my-plugin` |

117| `--plugin-url` | Récupérer une archive `.zip` de plugin à partir d'une URL pour cette session uniquement. Répétez le drapeau pour plusieurs plugins, ou passez des URL séparées par des espaces dans une seule valeur entre guillemets | `claude --plugin-url https://example.com/plugin.zip` |117| `--plugin-url` | Récupérer une archive `.zip` de plugin à partir d'une URL pour cette session uniquement. Répétez le drapeau pour plusieurs plugins, ou passez des URL séparées par des espaces dans une seule valeur entre guillemets | `claude --plugin-url https://example.com/plugin.zip` |

commands.md +1 −1

Details

162| `/ultrareview [PR or branch]` | Lancer une revue de code approfondie et multi-agents dans un sandbox cloud avec [ultrareview](https://code.claude.com/docs/fr/ultrareview.md). Passez une référence de PR pour examiner cette pull request, ou une branche de base ou un commit pour changer la base de comparaison. L'invocation recommandée est `/code-review ultra`, et `/ultrareview` en est un alias. Inclut 3 exécutions gratuites sur Pro, Max et Ultra, puis nécessite des [crédits d'utilisation](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |162| `/ultrareview [PR or branch]` | Lancer une revue de code approfondie et multi-agents dans un sandbox cloud avec [ultrareview](https://code.claude.com/docs/fr/ultrareview.md). Passez une référence de PR pour examiner cette pull request, ou une branche de base ou un commit pour changer la base de comparaison. L'invocation recommandée est `/code-review ultra`, et `/ultrareview` en est un alias. Inclut 3 exécutions gratuites sur Pro, Max et Ultra, puis nécessite des [crédits d'utilisation](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) |

163| `/update-config [request]` | **[Skill](https://code.claude.com/docs/fr/skills.md#bundled-skills).** Décrire une modification de paramètres, comme autoriser une commande, définir une variable d'environnement ou ajouter un [hook](https://code.claude.com/docs/fr/hooks.md), et Claude modifie le fichier [`settings.json`](https://code.claude.com/docs/fr/settings) correspondant. Pour des options comme le thème et le modèle, utilisez plutôt `/config` |163| `/update-config [request]` | **[Skill](https://code.claude.com/docs/fr/skills.md#bundled-skills).** Décrire une modification de paramètres, comme autoriser une commande, définir une variable d'environnement ou ajouter un [hook](https://code.claude.com/docs/fr/hooks.md), et Claude modifie le fichier [`settings.json`](https://code.claude.com/docs/fr/settings) correspondant. Pour des options comme le thème et le modèle, utilisez plutôt `/config` |

164| `/upgrade` | Ouvrir la page de mise à niveau dans votre navigateur pour passer à un forfait supérieur. Lorsque le navigateur ne s'ouvre pas, la commande affiche une invite de connexion sans afficher l'URL |164| `/upgrade` | Ouvrir la page de mise à niveau dans votre navigateur pour passer à un forfait supérieur. Lorsque le navigateur ne s'ouvre pas, la commande affiche une invite de connexion sans afficher l'URL |

165| `/usage` | Afficher le coût de la session, les limites d'utilisation du forfait et les statistiques d'activité. Sur un forfait Pro, Max, Ultra, Team ou Enterprise, inclut une [répartition de ce qui est décompté de vos limites de forfait](https://code.claude.com/docs/fr/costs.md#plan-usage-breakdown). `/cost` et `/stats` en sont des alias |165| `/usage` | Afficher le coût de la session, les limites d'utilisation du forfait et les statistiques d'activité. Sur un forfait Pro, Max, Ultra, Team ou Enterprise, inclut une [répartition de ce qui est décompté de vos limites de forfait](https://code.claude.com/docs/fr/costs.md#plan-usage-breakdown). Derrière une passerelle Claude apps qui suit les dépenses, affiche [vos dépenses via la passerelle](https://code.claude.com/docs/fr/claude-apps-gateway-spend-limits.md#usage-warnings-in-claude-code). `/cost` et `/stats` en sont des alias |

166| `/usage-credits` | Configurer les crédits d'utilisation, ou en demander à votre administrateur, lorsque vous atteignez une limite. Ouvre vos [paramètres de facturation des crédits d'utilisation](https://code.claude.com/docs/fr/costs.md#add-usage-credits-to-your-subscription) dans le navigateur, sauf pour les membres Team et Enterprise sans accès à la facturation, qui envoient plutôt une demande de crédits d'utilisation à leur administrateur depuis la CLI, après avoir confirmé dans une boîte de dialogue que la demande avertit leurs administrateurs. Lorsqu'aucun navigateur ne peut ouvrir la page de facturation, par exemple via SSH, la commande affiche à la place l'URL à consulter ; cela nécessite Claude Code v2.1.205 ou ultérieure, et les versions antérieures n'affichaient rien dans ce cas. Anciennement `/extra-usage` |166| `/usage-credits` | Configurer les crédits d'utilisation, ou en demander à votre administrateur, lorsque vous atteignez une limite. Ouvre vos [paramètres de facturation des crédits d'utilisation](https://code.claude.com/docs/fr/costs.md#add-usage-credits-to-your-subscription) dans le navigateur, sauf pour les membres Team et Enterprise sans accès à la facturation, qui envoient plutôt une demande de crédits d'utilisation à leur administrateur depuis la CLI, après avoir confirmé dans une boîte de dialogue que la demande avertit leurs administrateurs. Lorsqu'aucun navigateur ne peut ouvrir la page de facturation, par exemple via SSH, la commande affiche à la place l'URL à consulter ; cela nécessite Claude Code v2.1.205 ou ultérieure, et les versions antérieures n'affichaient rien dans ce cas. Anciennement `/extra-usage` |

167| `/verify` | **[Skill](https://code.claude.com/docs/fr/skills.md#bundled-skills).** Confirmer qu'une modification de code fait ce qu'elle doit faire en compilant l'application de votre projet, en l'exécutant et en observant le résultat, plutôt qu'en se fiant aux tests ou aux vérifications de types. Consultez [Exécuter et vérifier votre application](https://code.claude.com/docs/fr/skills.md#run-and-verify-your-app) |167| `/verify` | **[Skill](https://code.claude.com/docs/fr/skills.md#bundled-skills).** Confirmer qu'une modification de code fait ce qu'elle doit faire en compilant l'application de votre projet, en l'exécutant et en observant le résultat, plutôt qu'en se fiant aux tests ou aux vérifications de types. Consultez [Exécuter et vérifier votre application](https://code.claude.com/docs/fr/skills.md#run-and-verify-your-app) |

168| `/vim` | Supprimée en v2.1.92. Pour basculer entre les modes d'édition Vim et Normal, utilisez `/config` → Editor mode |168| `/vim` | Supprimée en v2.1.92. Pour basculer entre les modes d'édition Vim et Normal, utilisez `/config` → Editor mode |

costs.md +1 −1

Details

236 * Exécutez `/usage-credits` pour demander une utilisation au-delà de l'allocation, si vous avez activé les [crédits d'utilisation](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans).236 * Exécutez `/usage-credits` pour demander une utilisation au-delà de l'allocation, si vous avez activé les [crédits d'utilisation](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans).

237 * Sur Claude Code v2.1.234 ou ultérieur, [attendez et continuez la tâche interrompue automatiquement après la réinitialisation](https://code.claude.com/docs/fr/interactive-mode.md#wait-for-a-usage-limit-to-reset) ; cette section énumère quand Claude Code démarre l'attente de lui-même et quand le développeur la choisit dans `/rate-limit-options`. Pour contrôler pour votre flotte si Claude Code démarre cette attente de lui-même, définissez [`autoContinueAtUsageLimit`](https://code.claude.com/docs/fr/settings-reference#autocontinueatusagelimit) dans les [paramètres gérés](https://code.claude.com/docs/fr/settings.md#settings-precedence).237 * Sur Claude Code v2.1.234 ou ultérieur, [attendez et continuez la tâche interrompue automatiquement après la réinitialisation](https://code.claude.com/docs/fr/interactive-mode.md#wait-for-a-usage-limit-to-reset) ; cette section énumère quand Claude Code démarre l'attente de lui-même et quand le développeur la choisit dans `/rate-limit-options`. Pour contrôler pour votre flotte si Claude Code démarre cette attente de lui-même, définissez [`autoContinueAtUsageLimit`](https://code.claude.com/docs/fr/settings-reference#autocontinueatusagelimit) dans les [paramètres gérés](https://code.claude.com/docs/fr/settings.md#settings-precedence).

238* **« Vous avez atteint votre limite de dépenses individuelle », « limite de dépenses mensuelle de l'organisation » ou « budget partagé de l'équipe »** : la requête du développeur serait facturée aux crédits d'utilisation, et ces crédits ont atteint une limite de dépenses que vous avez définie. Pour permettre au développeur de continuer, allez à [**Paramètres de l'organisation > Utilisation**](https://claude.ai/admin-settings/usage) et augmentez la limite que le message nomme. Lorsque le message nomme également une heure de réinitialisation du plan, le développeur peut plutôt attendre jusqu'à ce moment. Voir [la référence d'erreur](https://code.claude.com/docs/fr/errors.md#youve-hit-your-monthly-spend-limit) pour chaque variante.238* **« Vous avez atteint votre limite de dépenses individuelle », « limite de dépenses mensuelle de l'organisation » ou « budget partagé de l'équipe »** : la requête du développeur serait facturée aux crédits d'utilisation, et ces crédits ont atteint une limite de dépenses que vous avez définie. Pour permettre au développeur de continuer, allez à [**Paramètres de l'organisation > Utilisation**](https://claude.ai/admin-settings/usage) et augmentez la limite que le message nomme. Lorsque le message nomme également une heure de réinitialisation du plan, le développeur peut plutôt attendre jusqu'à ce moment. Voir [la référence d'erreur](https://code.claude.com/docs/fr/errors.md#youve-hit-your-monthly-spend-limit) pour chaque variante.

239* **Un message de limite de dépenses d'une [passerelle d'applications Claude](https://code.claude.com/docs/fr/claude-apps-gateway)** : le développeur a dépassé un plafond de dépenses que vous avez défini sur votre passerelle auto-hébergée, et la passerelle bloque ses demandes jusqu'à ce que la période se réinitialise ou que vous augmentiez le plafond. Voir [limites de dépenses de la passerelle](https://code.claude.com/docs/fr/claude-apps-gateway-spend-limits.md) pour les plafonds, les calendriers de réinitialisation et le message que le développeur voit.239* **Un message de limite de dépenses d'une [passerelle d'applications Claude](https://code.claude.com/docs/fr/claude-apps-gateway)** : le développeur a dépassé un plafond de dépenses que vous avez défini sur votre passerelle auto-hébergée. La passerelle bloque ses requêtes jusqu'à ce que vous augmentiez le plafond, ou jusqu'à ce que le plafond se réinitialise s'il est supérieur à 0 \$. Voir [limites de dépenses de la passerelle](https://code.claude.com/docs/fr/claude-apps-gateway-spend-limits.md) pour les plafonds, les calendriers de réinitialisation et le message que le développeur voit.

240* **Un avertissement de contexte ou d'auto-compactage** : pas une limite d'utilisation. La conversation s'est rapprochée de la [fenêtre d'auto-compactage](https://code.claude.com/docs/fr/model-config.md#set-the-auto-compact-window) de la session, le seuil où Claude Code résume l'historique plus ancien pour libérer de l'espace. Pointez le développeur vers [réduire l'utilisation des tokens](#reduce-token-usage).240* **Un avertissement de contexte ou d'auto-compactage** : pas une limite d'utilisation. La conversation s'est rapprochée de la [fenêtre d'auto-compactage](https://code.claude.com/docs/fr/model-config.md#set-the-auto-compact-window) de la session, le seuil où Claude Code résume l'historique plus ancien pour libérer de l'espace. Pointez le développeur vers [réduire l'utilisation des tokens](#reduce-token-usage).

241* **Des dépenses inhabituellement élevées sur un plan API ou fournisseur cloud** : généralement tracées jusqu'à des sessions longues qui n'ont jamais été effacées ou à Opus laissé comme modèle par défaut. Les habitudes à impact le plus élevé à partager sont l'effacement entre les tâches non liées et l'adaptation du modèle au travail, tous deux couverts dans [réduire l'utilisation des tokens](#reduce-token-usage).241* **Des dépenses inhabituellement élevées sur un plan API ou fournisseur cloud** : généralement tracées jusqu'à des sessions longues qui n'ont jamais été effacées ou à Opus laissé comme modèle par défaut. Les habitudes à impact le plus élevé à partager sont l'effacement entre les tâches non liées et l'adaptation du modèle au travail, tous deux couverts dans [réduire l'utilisation des tokens](#reduce-token-usage).

242 242 

env-vars.md +2 −1

Details

365| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Définissez `5m` ou `1h`, les seules valeurs acceptées par Claude Code, pour choisir le [TTL du cache de prompts](https://code.claude.com/docs/fr/prompt-caching.md#cache-lifetime) pour la conversation principale : vos tours interactifs, `-p` et SDK, ainsi que les assistants qui s'exécutent en ligne avec eux. A priorité sur le paramètre `promptCacheTtl` et sur `ENABLE_PROMPT_CACHING_1H`, et `FORCE_PROMPT_CACHING_5M` la remplace. L'API facture les écritures en cache d'une heure à un tarif plus élevé. Nécessite Claude Code v2.1.242 ou ultérieur |365| `CLAUDE_CODE_PROMPT_CACHE_TTL` | Définissez `5m` ou `1h`, les seules valeurs acceptées par Claude Code, pour choisir le [TTL du cache de prompts](https://code.claude.com/docs/fr/prompt-caching.md#cache-lifetime) pour la conversation principale : vos tours interactifs, `-p` et SDK, ainsi que les assistants qui s'exécutent en ligne avec eux. A priorité sur le paramètre `promptCacheTtl` et sur `ENABLE_PROMPT_CACHING_1H`, et `FORCE_PROMPT_CACHING_5M` la remplace. L'API facture les écritures en cache d'une heure à un tarif plus élevé. Nécessite Claude Code v2.1.242 ou ultérieur |

366| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Définissez sur `1` pour propager le contexte de trace W3C lorsque `ANTHROPIC_BASE_URL` pointe vers un proxy personnalisé. La propagation couvre l'en-tête `traceparent` des requêtes au modèle et des requêtes MCP HTTP, ainsi que la variable d'environnement `TRACEPARENT` pour les sous-processus Bash, PowerShell et de hooks. Par défaut, la propagation n'est activée qu'en cas de connexion directe à l'API Anthropic. Ajoutée dans la v2.1.152. Consultez [Traces (bêta)](https://code.claude.com/docs/fr/monitoring-usage.md#traces-beta) |366| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | Définissez sur `1` pour propager le contexte de trace W3C lorsque `ANTHROPIC_BASE_URL` pointe vers un proxy personnalisé. La propagation couvre l'en-tête `traceparent` des requêtes au modèle et des requêtes MCP HTTP, ainsi que la variable d'environnement `TRACEPARENT` pour les sous-processus Bash, PowerShell et de hooks. Par défaut, la propagation n'est activée qu'en cas de connexion directe à l'API Anthropic. Ajoutée dans la v2.1.152. Consultez [Traces (bêta)](https://code.claude.com/docs/fr/monitoring-usage.md#traces-beta) |

367| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Définie par les plateformes hôtes qui intègrent Claude Code et gèrent le routage vers le fournisseur de modèles à sa place. Lorsqu'elle est définie, Claude Code ignore les variables de sélection du fournisseur, d'endpoint et d'authentification, telles que `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` et `ANTHROPIC_API_KEY`, dans les fichiers de paramètres, de sorte que les paramètres utilisateur ne peuvent pas remplacer le routage de l'hôte. Claude Code ignore également les clés de sélection du modèle, telles que `model`, `fallbackModel` et `modelOverrides`, dans les [paramètres gérés](https://code.claude.com/docs/fr/managed-settings.md), quelle que soit la source gérée qui les fournit, de sorte que la configuration de modèle de l'hôte a priorité sur un épinglage de modèle géré obsolète. Claude Code ignore aussi les variables de sélection du modèle, telles que `ANTHROPIC_MODEL` et la famille `ANTHROPIC_DEFAULT_*_MODEL`, dans un bloc `env` géré ; une liste d'autorisation [`availableModels`](https://code.claude.com/docs/fr/model-config#restrict-model-selection) dans les paramètres gérés s'applique toujours, sauf si l'hôte fournit la sienne. Claude Code ignore en outre la désactivation automatique de la télémétrie qu'il applique sinon chez les fournisseurs tiers comme Amazon Bedrock, Claude Platform on AWS, Agent Platform de Google Cloud et Microsoft Foundry, de sorte que la télémétrie suit la désactivation standard `DISABLE_TELEMETRY`. Consultez [Comportements par défaut selon le fournisseur d'API](https://code.claude.com/docs/fr/data-usage.md#default-behaviors-by-api-provider) |367| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Définie par les plateformes hôtes qui intègrent Claude Code et gèrent le routage vers le fournisseur de modèles à sa place. Lorsqu'elle est définie, Claude Code ignore les variables de sélection du fournisseur, d'endpoint et d'authentification, telles que `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` et `ANTHROPIC_API_KEY`, dans les fichiers de paramètres, de sorte que les paramètres utilisateur ne peuvent pas remplacer le routage de l'hôte. Claude Code ignore également les clés de sélection du modèle, telles que `model`, `fallbackModel` et `modelOverrides`, dans les [paramètres gérés](https://code.claude.com/docs/fr/managed-settings.md), quelle que soit la source gérée qui les fournit, de sorte que la configuration de modèle de l'hôte a priorité sur un épinglage de modèle géré obsolète. Claude Code ignore aussi les variables de sélection du modèle, telles que `ANTHROPIC_MODEL` et la famille `ANTHROPIC_DEFAULT_*_MODEL`, dans un bloc `env` géré ; une liste d'autorisation [`availableModels`](https://code.claude.com/docs/fr/model-config#restrict-model-selection) dans les paramètres gérés s'applique toujours, sauf si l'hôte fournit la sienne. Claude Code ignore en outre la désactivation automatique de la télémétrie qu'il applique sinon chez les fournisseurs tiers comme Amazon Bedrock, Claude Platform on AWS, Agent Platform de Google Cloud et Microsoft Foundry, de sorte que la télémétrie suit la désactivation standard `DISABLE_TELEMETRY`. Consultez [Comportements par défaut selon le fournisseur d'API](https://code.claude.com/docs/fr/data-usage.md#default-behaviors-by-api-provider) |

368| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Définissez sur `1` pour permettre au proxy d'effectuer la résolution DNS à la place de l'appelant. Option à activer dans les environnements où le proxy doit gérer la résolution des noms d'hôtes |368| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Définissez sur `1` pour permettre au proxy d'effectuer la résolution DNS à la place de l'appelant. Option à activer pour les environnements où le proxy doit gérer la résolution des noms d'hôte. Lorsque `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` est définie, définissez celle-ci dans l'environnement du processus qui démarre Claude Code |

369| `CLAUDE_CODE_REMOTE` | Définie automatiquement sur `true` lorsque Claude Code s'exécute en tant que [session cloud](https://code.claude.com/docs/fr/claude-code-on-the-web.md). Lisez-la depuis un hook ou un script de configuration pour détecter si vous êtes dans une session cloud |369| `CLAUDE_CODE_REMOTE` | Définie automatiquement sur `true` lorsque Claude Code s'exécute en tant que [session cloud](https://code.claude.com/docs/fr/claude-code-on-the-web.md). Lisez-la depuis un hook ou un script de configuration pour détecter si vous êtes dans une session cloud |

370| `CLAUDE_CODE_REMOTE_SESSION_ID` | Définie automatiquement dans les [sessions cloud](https://code.claude.com/docs/fr/claude-code-on-the-web.md) sur l'identifiant de la session en cours. Lisez-la pour construire un lien vers la transcription de la session. Consultez [Relier la sortie à la session](https://code.claude.com/docs/fr/cloud-environments.md#link-output-back-to-the-session) |370| `CLAUDE_CODE_REMOTE_SESSION_ID` | Définie automatiquement dans les [sessions cloud](https://code.claude.com/docs/fr/claude-code-on-the-web.md) sur l'identifiant de la session en cours. Lisez-la pour construire un lien vers la transcription de la session. Consultez [Relier la sortie à la session](https://code.claude.com/docs/fr/cloud-environments.md#link-output-back-to-the-session) |

371| `CLAUDE_CODE_RESTRICTED` | Définissez sur `1` pour démarrer la session en mode restreint, comme en transmettant [`--restricted`](https://code.claude.com/docs/fr/cli-reference#cli-flags). Claude Code ignore cette variable dans le bloc `env` d'un fichier de paramètres. Nécessite Claude Code v2.1.248 ou ultérieur |371| `CLAUDE_CODE_RESTRICTED` | Définissez sur `1` pour démarrer la session en mode restreint, comme en transmettant [`--restricted`](https://code.claude.com/docs/fr/cli-reference#cli-flags). Claude Code ignore cette variable dans le bloc `env` d'un fichier de paramètres. Nécessite Claude Code v2.1.248 ou ultérieur |


529| `VERTEX_REGION_CLAUDE_5_SONNET` | Remplace la région pour Claude Sonnet 5 lors de l'utilisation de Google Cloud's Agent Platform. Ajoutée en v2.1.197 |529| `VERTEX_REGION_CLAUDE_5_SONNET` | Remplace la région pour Claude Sonnet 5 lors de l'utilisation de Google Cloud's Agent Platform. Ajoutée en v2.1.197 |

530| `VERTEX_REGION_CLAUDE_FABLE_5` | Remplace la région pour Claude Fable 5 lors de l'utilisation de Google Cloud's Agent Platform. Ajoutée en v2.1.170 |530| `VERTEX_REGION_CLAUDE_FABLE_5` | Remplace la région pour Claude Fable 5 lors de l'utilisation de Google Cloud's Agent Platform. Ajoutée en v2.1.170 |

531| `VERTEX_REGION_CLAUDE_FABLE_5_1` | Remplace la région pour Claude Fable 5.1 lors de l'utilisation de Google Cloud's Agent Platform. Ajoutée en v2.1.257 |531| `VERTEX_REGION_CLAUDE_FABLE_5_1` | Remplace la région pour Claude Fable 5.1 lors de l'utilisation de Google Cloud's Agent Platform. Ajoutée en v2.1.257 |

532| `VERTEX_REGION_CLAUDE_FABLE_5_2` | Remplace la région pour Claude Fable 5.2 lors de l'utilisation de Google Cloud's Agent Platform. Ajoutée dans la v2.1.321 |

532| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Remplace la région pour Claude Haiku 4.5 lors de l'utilisation de Google Cloud's Agent Platform |533| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Remplace la région pour Claude Haiku 4.5 lors de l'utilisation de Google Cloud's Agent Platform |

533| `VERTEX_REGION_CLAUDE_HAIKU_5_5` | Remplace la région pour Claude Haiku 5.5 lors de l'utilisation de Google Cloud's Agent Platform. Ajoutée en v2.1.293 |534| `VERTEX_REGION_CLAUDE_HAIKU_5_5` | Remplace la région pour Claude Haiku 5.5 lors de l'utilisation de Google Cloud's Agent Platform. Ajoutée en v2.1.293 |

534 535 

errors.md +92 −15

Details

52| `Credit balance is too low` | [Limites d'utilisation](#credit-balance-is-too-low) |52| `Credit balance is too low` | [Limites d'utilisation](#credit-balance-is-too-low) |

53| `You've hit your monthly spend limit` / `You've hit your individual spend limit` / `You've hit your org's monthly spend limit` / `You've hit your channel's monthly spend limit` / `You've hit your team's shared budget` / `You've hit your individual usage limit` | [Limites d'utilisation](#youve-hit-your-monthly-spend-limit) |53| `You've hit your monthly spend limit` / `You've hit your individual spend limit` / `You've hit your org's monthly spend limit` / `You've hit your channel's monthly spend limit` / `You've hit your team's shared budget` / `You've hit your individual usage limit` | [Limites d'utilisation](#youve-hit-your-monthly-spend-limit) |

54| `Could not update your spend limit` | [Limites d'utilisation](#could-not-update-your-spend-limit) |54| `Could not update your spend limit` | [Limites d'utilisation](#could-not-update-your-spend-limit) |

55| `spend limit reached` / `spend limit unavailable` | [Limites d'utilisation](#spend-limit-reached) |55| `spend limit reached` / `spend limit unavailable` / `This request exceeds your group's budget` | [Limites d'utilisation](#spend-limit-reached) |

56| `Not logged in · Please run /login` | [Authentification](#not-logged-in) |56| `Not logged in · Please run /login` | [Authentification](#not-logged-in) |

57| `Couldn't save your login` | [Authentification](#couldnt-save-your-login) |57| `Couldn't save your login` | [Authentification](#couldnt-save-your-login) |

58| `Sign in again to take your previous account or API key off the config file.` | [Authentification](#sign-in-again-to-take-your-previous-account-or-api-key-off-the-config-file) |58| `Sign in again to take your previous account or API key off the config file.` | [Authentification](#sign-in-again-to-take-your-previous-account-or-api-key-off-the-config-file) |


336| `MCP server "<name>" connection closed before the tool call was answered` | [Erreurs d'outil](#connection-closed-before-the-tool-call-was-answered) |336| `MCP server "<name>" connection closed before the tool call was answered` | [Erreurs d'outil](#connection-closed-before-the-tool-call-was-answered) |

337| `MCP server "<name>" is disabled — re-enable it via /mcp to use its tools` | [Erreurs d'outil](#mcp-server-is-disabled) |337| `MCP server "<name>" is disabled — re-enable it via /mcp to use its tools` | [Erreurs d'outil](#mcp-server-is-disabled) |

338| `MCP server "<name>" tool "<tool>" timed out after <N>s. The server asked the user a question, and no answer came before the time limit.` | [Erreurs d'outil](#mcp-tool-call-timed-out-with-the-servers-question-unanswered) |338| `MCP server "<name>" tool "<tool>" timed out after <N>s. The server asked the user a question, and no answer came before the time limit.` | [Erreurs d'outil](#mcp-tool-call-timed-out-with-the-servers-question-unanswered) |

339| `Permission prompt tool returned an invalid result` | [Erreurs d'outil](#permission-prompt-tool-returned-an-invalid-result) |

339| `would be spawned with zero tools — refusing` | [Erreurs d'outil](#agent-would-be-spawned-with-zero-tools) |340| `would be spawned with zero tools — refusing` | [Erreurs d'outil](#agent-would-be-spawned-with-zero-tools) |

340| `File is covered by a Read deny rule in your permission settings` | [Erreurs d'outil](#file-is-covered-by-a-read-deny-rule) |341| `File is covered by a Read deny rule in your permission settings` | [Erreurs d'outil](#file-is-covered-by-a-read-deny-rule) |

341| `<path> is outside <dirs>; the permissions.blockWritesOutsideWorkingDirectories setting blocks writes outside the working directories` | [Erreurs d'outil](#setting-blocks-writes-outside-the-working-directories) |342| `<path> is outside <dirs>; the permissions.blockWritesOutsideWorkingDirectories setting blocks writes outside the working directories` | [Erreurs d'outil](#setting-blocks-writes-outside-the-working-directories) |


420| `The Claude Code program for this computer, the <build> build, could not be found` | [Erreurs de wrapper et d'IDE](#the-claude-code-program-for-this-computer-could-not-be-found) |421| `The Claude Code program for this computer, the <build> build, could not be found` | [Erreurs de wrapper et d'IDE](#the-claude-code-program-for-this-computer-could-not-be-found) |

421| `Restored the code, but skipped N files` | [Avertissements et erreurs de rembobinage](#restored-the-code-but-skipped-files) |422| `Restored the code, but skipped N files` | [Avertissements et erreurs de rembobinage](#restored-the-code-but-skipped-files) |

422| `No files were restored: N files failed (backup missing, or the file could not be updated)` | [Avertissements et erreurs de rembobinage](#no-files-were-restored) |423| `No files were restored: N files failed (backup missing, or the file could not be updated)` | [Avertissements et erreurs de rembobinage](#no-files-were-restored) |

424| `The file backups are still being copied. Nothing was changed. Try again in a moment.` | Sélectionnez à nouveau le même point dans [`/rewind`](https://code.claude.com/docs/fr/checkpointing). Lorsque vous restaurez du code peu après [`/branch`](https://code.claude.com/docs/fr/sessions#branch-a-session), Claude Code peut encore être en train de copier les sauvegardes de fichiers vers la nouvelle session. |

423| `Transcript writes are failing (...)` | [Avertissements d'enregistrement de session](#transcript-writes-are-failing) |425| `Transcript writes are failing (...)` | [Avertissements d'enregistrement de session](#transcript-writes-are-failing) |

424| `Transcript saving is off — CLAUDE_CODE_SKIP_PROMPT_HISTORY is set` | [Avertissements d'enregistrement de session](#transcript-saving-is-off-skip-prompt-history) |426| `Transcript saving is off — CLAUDE_CODE_SKIP_PROMPT_HISTORY is set` | [Avertissements d'enregistrement de session](#transcript-saving-is-off-skip-prompt-history) |

425| `Transcript saving is off — inherited CLAUDE_CODE_CHILD_SESSION marker` | [Avertissements d'enregistrement de session](#transcript-saving-is-off-child-session-marker) |427| `Transcript saving is off — inherited CLAUDE_CODE_CHILD_SESSION marker` | [Avertissements d'enregistrement de session](#transcript-saving-is-off-child-session-marker) |


431| `Not loaded: rename <path>, then restart — its name uses "<name>", a name reserved for the skills synced from your claude.ai account` | [Avertissements de configuration](#a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved) |433| `Not loaded: rename <path>, then restart — its name uses "<name>", a name reserved for the skills synced from your claude.ai account` | [Avertissements de configuration](#a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved) |

432| `N skill or command names refused: run with --debug to see which ([names]), rename, then restart` | [Avertissements de configuration](#skill-or-command-name-refused) |434| `N skill or command names refused: run with --debug to see which ([names]), rename, then restart` | [Avertissements de configuration](#skill-or-command-name-refused) |

433| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Avertissements de configuration](#workspace-has-not-been-trusted) |435| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Avertissements de configuration](#workspace-has-not-been-trusted) |

436| `Two Claude Code config files exist: this run uses <path>, not <path>` | [Avertissements de configuration](#two-claude-code-config-files-exist) |

434| `Make this change again later: <path> could not be updated, so it applies to this session only` | [Avertissements de configuration](#make-this-change-again-later) |437| `Make this change again later: <path> could not be updated, so it applies to this session only` | [Avertissements de configuration](#make-this-change-again-later) |

435| `is a network path, which cannot be added as a working directory` | [Avertissements de configuration](#working-directory-is-a-network-path) |438| `is a network path, which cannot be added as a working directory` | [Avertissements de configuration](#working-directory-is-a-network-path) |

436| `Remote managed settings failed to load (<cause>)` | [Avertissements de configuration](#remote-managed-settings-failed-to-load) |439| `Remote managed settings failed to load (<cause>)` | [Avertissements de configuration](#remote-managed-settings-failed-to-load) |


468| `CLAUDE_CODE_AUTO_COMPACT_WINDOW="<value>" isn't a usable size, so Claude Code ignores it` | [Valeurs et avertissements pour `CLAUDE_CODE_AUTO_COMPACT_WINDOW`](https://code.claude.com/docs/fr/model-config#claude_code_auto_compact_window-values) |471| `CLAUDE_CODE_AUTO_COMPACT_WINDOW="<value>" isn't a usable size, so Claude Code ignores it` | [Valeurs et avertissements pour `CLAUDE_CODE_AUTO_COMPACT_WINDOW`](https://code.claude.com/docs/fr/model-config#claude_code_auto_compact_window-values) |

469| `Model "<model>" isn't recognized · context assumed to be 200k tokens` | [Corriger la fenêtre pour une passerelle ou un ID de modèle personnalisé](https://code.claude.com/docs/fr/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id) |472| `Model "<model>" isn't recognized · context assumed to be 200k tokens` | [Corriger la fenêtre pour une passerelle ou un ID de modèle personnalisé](https://code.claude.com/docs/fr/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id) |

470| `Claude Code doesn't recognize the model "<model>", so it assumes a context window of 200k tokens` | [Corriger la fenêtre pour une passerelle ou un ID de modèle personnalisé](https://code.claude.com/docs/fr/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id) |473| `Claude Code doesn't recognize the model "<model>", so it assumes a context window of 200k tokens` | [Corriger la fenêtre pour une passerelle ou un ID de modèle personnalisé](https://code.claude.com/docs/fr/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id) |

474| `Model "<model>" isn't recognized · did you mean "<suggestion>"?` / `Claude Code doesn't recognize the model "<model>". Did you mean "<suggestion>"?` | [Corriger un nom de modèle mal saisi](https://code.claude.com/docs/fr/model-config.md#fix-a-mistyped-model-name) |

471| `[claude-code:unrecognized_model]` | [Avertissements de configuration](#unrecognized-model-id-on-a-request) |475| `[claude-code:unrecognized_model]` | [Avertissements de configuration](#unrecognized-model-id-on-a-request) |

472| `is ignored — managed settings set allowManagedReadPathsOnly` / `is ignored — managed settings set allowManagedDomainsOnly` | [Avertissements de configuration](#sandbox-allow-entries-are-ignored-under-a-managed-lock) |476| `is ignored — managed settings set allowManagedReadPathsOnly` / `is ignored — managed settings set allowManagedDomainsOnly` | [Avertissements de configuration](#sandbox-allow-entries-are-ignored-under-a-managed-lock) |

473| `Sandbox mask files left behind at write-deny paths` | [Avertissements de configuration](#stale-sandbox-mask-files-left-by-a-killed-session) |477| `Sandbox mask files left behind at write-deny paths` | [Avertissements de configuration](#stale-sandbox-mask-files-left-by-a-killed-session) |


909Fable 5.1 now uses usage credits · the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change913Fable 5.1 now uses usage credits · the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change

910```914```

911 915 

912Les messages nomment le modèle Fable de la session, donc sur Fable 5, ils indiquent `continuing on Fable 5` et `Fable 5 now uses usage credits`. Avant v2.1.257, le premier message commençait par `Fable 5 limit reached`.916Les messages nomment le modèle Fable de la session, donc sur Fable 5.2, ils indiquent `continuing on Fable 5.2` et `Fable 5.2 now uses usage credits`. Avant v2.1.257, le premier message commençait par `Fable 5 limit reached`.

913 917 

914Cela se produit dans les sessions [Remote Control](https://code.claude.com/docs/fr/remote-control.md), les [sessions en arrière-plan](https://code.claude.com/docs/fr/agent-view.md), les sessions de coéquipiers d'une [équipe d'agents](https://code.claude.com/docs/fr/agent-teams.md), et les sessions qu'une autre application héberge via l'Agent SDK. Pour savoir quand Claude Code ferme l'invite, consultez [Fable et crédits d'utilisation](https://code.claude.com/docs/fr/model-config.md#fable-and-usage-credits).918Cela se produit dans les sessions [Remote Control](https://code.claude.com/docs/fr/remote-control.md), les [sessions en arrière-plan](https://code.claude.com/docs/fr/agent-view.md), les sessions de coéquipiers d'une [équipe d'agents](https://code.claude.com/docs/fr/agent-teams.md), et les sessions qu'une autre application héberge via l'Agent SDK. Pour savoir quand Claude Code ferme l'invite, consultez [Fable et crédits d'utilisation](https://code.claude.com/docs/fr/model-config.md#fable-and-usage-credits).

915 919 


983 987 

984### Spend limit reached988### Spend limit reached

985 989 

986Vous vous connectez via une [passerelle d'applications Claude](https://code.claude.com/docs/fr/claude-apps-gateway) et avez dépassé un [plafond de dépenses](https://code.claude.com/docs/fr/claude-apps-gateway-spend-limits.md) que votre opérateur de passerelle a défini. La passerelle bloque vos requêtes jusqu'à ce que la période nommée se réinitialise ou que l'opérateur augmente le plafond. Elle marque chaque réponse `429` bloquée `x-should-retry: false`, donc Claude Code affiche ce message sans réessayer.990Vous vous connectez via une [passerelle d'applications Claude](https://code.claude.com/docs/fr/claude-apps-gateway) et avez atteint un [plafond de dépenses](https://code.claude.com/docs/fr/claude-apps-gateway-spend-limits.md) que votre opérateur de passerelle a défini. La passerelle bloque vos requêtes jusqu'à ce que l'opérateur augmente le plafond, ou jusqu'à ce que le plafond se réinitialise s'il est supérieur à \$0. Elle marque chaque réponse `429` bloquée `x-should-retry: false`, donc dans le terminal, Claude Code affiche ce message sans réessayer.

987 991 

988```text theme={null}992```text theme={null}

989spend limit reached (daily; resets 2026-08-09 00:00 UTC)993spend limit reached · resets Dec 1

990```994```

991 995 

992Le message nomme la période du plafond et l'heure de réinitialisation, et quand l'opérateur a configuré un `blocked_message`, ses instructions le suivent. Avant v2.1.225, le message indiquait seulement `spend limit reached` ; une passerelle sur une version plus ancienne envoie toujours cette forme plus courte.996Vérifiez si le message contient une date :

997 

998* **Avec une date** : le plafond se réinitialise à 00:00 UTC à cette date

999* **Sans date** : votre plafond est de \$0, ou votre passerelle exécute une version antérieure à v2.1.225

1000 

1001Tout texte supplémentaire dans le message est une note de votre opérateur de passerelle.

1002 

1003De v2.1.225 jusqu'à v2.1.319 sur le serveur de la passerelle, le message nommait la période du plafond et l'heure de réinitialisation, comme dans `spend limit reached (daily; resets 2026-08-09 00:00 UTC)`.

993 1004 

994**Ce qu'il faut faire :**1005**Ce qu'il faut faire :**

995 1006 

996* Attendez l'heure de réinitialisation que le message nomme, ou suivez les instructions de l'opérateur si le message les porte1007* Si le message contient une date, attendez la réinitialisation, ou suivez la note de l'opérateur si le message en porte une

997* Demandez à votre opérateur de passerelle d'augmenter le plafond si vous le dépassez régulièrement1008* Demandez à votre opérateur de passerelle d'augmenter le plafond si le message ne contient pas de date, si vous êtes toujours bloqué après la date, ou si vous atteignez régulièrement le plafond

1009 

1010Un second message de la passerelle, `This request exceeds your group's budget`, signifie que le [budget groupé](https://code.claude.com/docs/fr/claude-apps-gateway-config.md#pooled-budget-order) de votre groupe est épuisé. Suivez les étapes qu'il indique :

1011 

1012```text theme={null}

1013This request exceeds your group's budget. Ask your organization's admins to raise it, or try again after it resets on November 1 at 00:00 UTC.

1014```

998 1015 

999Un message connexe, `spend limit unavailable`, signifie que la passerelle n'a pas pu lire ses enregistrements de dépenses et a bloqué la requête par précaution plutôt que sur votre plafond. Cela s'efface généralement de lui-même ; si cela persiste, informez votre opérateur de passerelle.1016Un message connexe, `spend limit unavailable`, signifie que la passerelle n'a pas pu lire ses enregistrements de dépenses et a bloqué la requête par précaution plutôt que sur votre plafond. Cela s'efface généralement de lui-même ; si cela persiste, informez votre opérateur de passerelle.

1000 1017 


2287 2304 

2288### Couldn't send feedback2305### Couldn't send feedback

2289 2306 

2290Un message commençant par `Couldn't send feedback` signifie que le service de commentaires n'a pas confirmé le rapport que vous avez soumis à partir de la [boîte de dialogue `/feedback`, `/bug` ou `/share`](https://code.claude.com/docs/fr/commands#all-commands), ou un [brouillon de commentaires](https://code.claude.com/docs/fr/tools-reference.md#sendfeedback-tool-behavior) en file d'attente. Considérez-le comme non reçu. Lorsqu'une phrase concernant votre organisation suit les deux-points, votre organisation refuse les commentaires et le même rapport obtiendra la même réponse.2307Un message commençant par `Couldn't send feedback` signifie que le service de commentaires n'a pas confirmé le rapport que vous avez soumis à partir de la [boîte de dialogue `/feedback`, `/bug` ou `/share`](https://code.claude.com/docs/fr/commands#all-commands), ou un [brouillon de commentaires](https://code.claude.com/docs/fr/tools-reference.md#sendfeedback-tool-behavior) en file d'attente. Considérez-le comme non reçu. Lorsqu'une phrase concernant votre organisation suit les deux-points, votre organisation refuse les commentaires.

2291 2308 

2292Le second de ces deux exemples est un refus de l'organisation :2309Le deuxième exemple est un refus d'une organisation :

2293 2310 

2294```text wrap theme={null}2311```text wrap theme={null}

2295Couldn't send feedback (couldn't reach the service). If it keeps failing, you can file at https://github.com/anthropics/claude-code/issues instead.2312Couldn't send feedback (couldn't reach the service). If it keeps failing, you can file at https://github.com/anthropics/claude-code/issues instead.


2300**À faire :**2317**À faire :**

2301 2318 

2302* **Non connecté** : le message continue par `: not signed in. Run /login, then retry.` Exécutez `/login`, puis envoyez à nouveau2319* **Non connecté** : le message continue par `: not signed in. Run /login, then retry.` Exécutez `/login`, puis envoyez à nouveau

2303* **Refus de votre organisation** : par exemple `: Feedback has not been enabled for your organization.` ou `: Feedback collection is not available for organizations with custom data retention policies.` Si le message ajoute `To report a bug, open an issue`, faites-le sur [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues). Un brouillon en file d'attente y reste, et vous pouvez [le supprimer](https://code.claude.com/docs/fr/tools-reference.md#discard-or-keep-a-draft)2320* **Refus de votre organisation** : par exemple `: Feedback has not been enabled for your organization.` ou `: Feedback collection is not available for organizations with custom data retention policies.` Si le message ajoute `To report a bug, open an issue`, faites-le sur [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues). `/feedback` peut ensuite répondre qu'il est [désactivé par la politique de votre organisation](#feedback-is-disabled-by-your-organizations-policy) pendant sept jours. Un brouillon en file d'attente y reste et [expire toujours selon le calendrier prévu](https://code.claude.com/docs/fr/tools-reference.md#discard-or-keep-a-draft)

2304* **Identifiants refusés** : le message continue par `: the sign-in this session uses is not allowed to send feedback` ou `: the server did not accept the credentials this session uses`. Exécutez `/status` à l'invite de Claude Code pour voir quelle connexion, quel jeton ou quelle clé API cette session envoie2321* **Identifiants refusés** : le message continue par `: the sign-in this session uses is not allowed to send feedback` ou `: the server did not accept the credentials this session uses`. Exécutez `/status` à l'invite de Claude Code pour voir quelle connexion, quel jeton ou quelle clé API cette session envoie

2305* **`(request timed out)` ou `(couldn't reach the service)` juste après `Couldn't send feedback`** : envoyez à nouveau le rapport ou le brouillon en file d'attente. La boîte de dialogue conserve votre texte, et le message d'un brouillon en file d'attente indique `The draft is still queued.` Si d'autres requêtes échouent aussi, vérifiez votre connexion réseau et consultez [Impossible de se connecter à l'API](#unable-to-connect-to-api). Si cela continue d'échouer, déposez le rapport sur [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)2322* **`(request timed out)` ou `(couldn't reach the service)` juste après `Couldn't send feedback`** : envoyez à nouveau le rapport ou le brouillon en file d'attente. La boîte de dialogue conserve votre texte, et le message d'un brouillon en file d'attente indique `The draft is still queued.` Si d'autres requêtes échouent aussi, vérifiez votre connexion réseau et consultez [Impossible de se connecter à l'API](#unable-to-connect-to-api). Si cela continue d'échouer, déposez le rapport sur [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)

2306* **`(server returned <status>)`, ou aucune raison, juste après `Couldn't send feedback`** : le statut est le code de réponse du service. Le message propre du service le suit lorsqu'il en a envoyé un, comme dans `(server returned 403: Access Forbidden)`. Si cela continue d'échouer, déposez le rapport sur [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)2323* **`(server returned <status>)`, ou aucune raison, juste après `Couldn't send feedback`** : le statut est le code de réponse du service. Le message propre du service le suit lorsqu'il en a envoyé un, comme dans `(server returned 403: Access Forbidden)`. Si cela continue d'échouer, déposez le rapport sur [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues)


3431* **`Error: Workspace not trusted. <folder> is your home directory`** : comme la confiance pour votre répertoire personnel n'est jamais enregistrée, exécuter d'abord `claude` à cet endroit ne peut pas aider. Exécutez plutôt `claude ultrareview` depuis un répertoire de projet, après y avoir exécuté `claude` une fois pour accepter la boîte de dialogue de confiance, ou ajoutez `--trust-workspace`.3448* **`Error: Workspace not trusted. <folder> is your home directory`** : comme la confiance pour votre répertoire personnel n'est jamais enregistrée, exécuter d'abord `claude` à cet endroit ne peut pas aider. Exécutez plutôt `claude ultrareview` depuis un répertoire de projet, après y avoir exécuté `claude` une fois pour accepter la boîte de dialogue de confiance, ou ajoutez `--trust-workspace`.

3432* **`No answer in time.` suivi de `Error: Workspace not trusted`** : la question `Trust <folder>? [y/N]` est restée sans réponse pendant 5 minutes. Exécutez de nouveau `claude ultrareview` et répondez-y.3449* **`No answer in time.` suivi de `Error: Workspace not trusted`** : la question `Trust <folder>? [y/N]` est restée sans réponse pendant 5 minutes. Exécutez de nouveau `claude ultrareview` et répondez-y.

3433* **`Ultrareview did not start: <folder> is not trusted`** : vous avez refusé à la question `Trust <folder>? [y/N]`, par exemple en répondant `n` ou en appuyant sur Enter. Pour démarrer la revue, exécutez de nouveau `claude ultrareview` et répondez `y`.3450* **`Ultrareview did not start: <folder> is not trusted`** : vous avez refusé à la question `Trust <folder>? [y/N]`, par exemple en répondant `n` ou en appuyant sur Enter. Pour démarrer la revue, exécutez de nouveau `claude ultrareview` et répondez `y`.

3434* **``Ultrareview did not start: `--trust-workspace` takes no value``** : autre chose qu'un flag suit `--trust-workspace`, comme un numéro de PR ou `false`. Si vous ne faites pas confiance au dossier, omettez le flag. Pour lui faire confiance pour cette exécution, placez le numéro de PR ou la branche de base avant le flag : `claude ultrareview 1234 --trust-workspace`.3451* **``Ultrareview did not start: `--trust-workspace` takes no value``** : quelque chose d'autre qu'un flag suit `--trust-workspace`, comme un numéro de PR ou `false`. Si vous ne faites pas confiance au dossier, omettez le flag. Pour l'approuver pour cette exécution, placez le numéro de PR ou la branche de base avant le flag : `claude ultrareview 1234 --trust-workspace`.

3435 3452 

3436Avant la v2.1.309, `claude ultrareview` n'acceptait pas `--trust-workspace`.3453Avant la v2.1.309, `claude ultrareview` n'acceptait pas `--trust-workspace`.

3437 3454 


3724 3741 

3725Des messages apparentés surviennent avant même l'exécution de la commande :3742Des messages apparentés surviennent avant même l'exécution de la commande :

3726 3743 

3727* `Shell command permission check failed for pattern "..."` : la vérification de permission de la commande ne l'a pas autorisée. [Vérifications de permission sur les commandes injectées](https://code.claude.com/docs/fr/skills.md#permission-checks-on-injected-commands) indique quels résultats interrompent l'exécution dans chaque mode de permission et comment pré-approuver une commande avec `allowed-tools`3744* `Shell command permission check failed for pattern "..."` : la vérification de permission de la commande ne l'a pas autorisée. [Vérifications de permission sur les commandes injectées](https://code.claude.com/docs/fr/skills.md#permission-checks-on-injected-commands) décrit quels résultats interrompent l'invocation dans chaque mode de permission et comment pré-approuver une commande avec `allowed-tools`

3728* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found`` : le frontmatter du skill exige bash sur une machine qui ne l'a pas. Installez Git for Windows ou modifiez le frontmatter en `shell: powershell`. Consultez [Comment s'exécutent les commandes injectées](https://code.claude.com/docs/fr/skills.md#how-injected-commands-run)3745* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found`` : le frontmatter du skill exige bash sur une machine qui n'en dispose pas. Installez Git for Windows ou modifiez le frontmatter en `shell: powershell`. Consultez [Comment s'exécutent les commandes injectées](https://code.claude.com/docs/fr/skills.md#how-injected-commands-run)

3729 3746 

3730**Marche à suivre :**3747**Marche à suivre :**

3731 3748 


4227 4244 

4228### /feedback is disabled by your organization's policy4245### /feedback is disabled by your organization's policy

4229 4246 

4230Ce message signifie que la politique de votre organisation n'autorise pas les retours sur le produit depuis Claude Code ; `/feedback`, `/bug` et `/share` n'ouvrent donc pas la boîte de dialogue de retour. Le message indique la commande que vous avez saisie dans le prompt de Claude Code :4247Ce message signifie que les retours sur le produit sont désactivés : la commande que vous avez saisie n'ouvre donc pas la boîte de dialogue de retour. Une politique d'organisation comme un refus antérieur produisent ce message :

4248 

4249* **Politique d'organisation** : la politique de votre organisation n'autorise pas les retours sur le produit depuis Claude Code. `/feedback`, `/bug` et `/share` répondent tous par ce message.

4250* **Refus antérieur** : le service de retours a refusé un rapport que vous avez envoyé, par exemple avec [`Couldn't send feedback: Feedback has not been enabled for your organization.`](#couldnt-send-feedback) `/feedback` et `/bug` peuvent alors répondre par ce message. Cela dure sept jours à compter de ce refus sur cette machine. Cela s'applique à tous les forfaits, y compris Pro et Max.

4251 

4252Le message nomme la commande que vous avez saisie dans le prompt de Claude Code :

4231 4253 

4232```text wrap theme={null}4254```text wrap theme={null}

4233/feedback is disabled by your organization's policy. To report a bug, open an issue at https://github.com/anthropics/claude-code/issues. Issues are public, so leave out anything confidential.4255/feedback is disabled by your organization's policy. To report a bug, open an issue at https://github.com/anthropics/claude-code/issues. Issues are public, so leave out anything confidential.


4238**Que faire :**4260**Que faire :**

4239 4261 

4240* Pour signaler un bug, ouvrez une issue sur [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues). Tout le monde peut y lire les issues : n'y incluez donc ni code, ni transcriptions, ni aucune autre information confidentielle.4262* Pour signaler un bug, ouvrez une issue sur [github.com/anthropics/claude-code/issues](https://github.com/anthropics/claude-code/issues). Tout le monde peut y lire les issues : n'y incluez donc ni code, ni transcriptions, ni aucune autre information confidentielle.

4263* Après un refus antérieur, attendez que les sept jours soient écoulés, puis envoyez à nouveau un rapport pour voir si le service le refuse toujours

4264 

4265Avant la v2.1.319, un refus antérieur ne produisait pas ce message.

4241 4266 

4242Avant la v2.1.302, le message complet était `/feedback is disabled by your organization's policy. Contact your organization admin to enable it.`4267Avant la v2.1.302, le message complet était `/feedback is disabled by your organization's policy. Contact your organization admin to enable it.`

4243 4268 


4654* Pour laisser plus de temps à une réponse, définissez un [`timeout`](https://code.claude.com/docs/fr/mcp#time-limits-on-mcp-tool-calls) plus long en millisecondes dans l'entrée de configuration du serveur, par exemple `"timeout": 600000` pour 10 minutes4679* Pour laisser plus de temps à une réponse, définissez un [`timeout`](https://code.claude.com/docs/fr/mcp#time-limits-on-mcp-tool-calls) plus long en millisecondes dans l'entrée de configuration du serveur, par exemple `"timeout": 600000` pour 10 minutes

4655* Exécutez plutôt la tâche dans une session interactive et répondez vous-même à la [boîte de dialogue](https://code.claude.com/docs/fr/mcp.md#respond-to-mcp-elicitation-requests) du serveur4680* Exécutez plutôt la tâche dans une session interactive et répondez vous-même à la [boîte de dialogue](https://code.claude.com/docs/fr/mcp.md#respond-to-mcp-elicitation-requests) du serveur

4656 4681 

4682### Permission prompt tool returned an invalid result

4683 

4684L'outil que vous avez passé à [`--permission-prompt-tool`](https://code.claude.com/docs/fr/cli-reference#cli-flags) a renvoyé une réponse que Claude Code n'a pas pu lire, donc l'appel d'outil qui l'attendait ne s'est pas exécuté, même si la réponse autorisait l'appel :

4685 

4686```text wrap theme={null}

4687Permission prompt tool returned an invalid result. Expected a single text block param with type="text" and a string text value.

4688```

4689 

4690**Que faire :**

4691 

4692* Renvoyez un seul bloc de texte dont le texte est `{"behavior": "allow"}` ou `{"behavior": "deny", "message": "<reason>"}`. Pour modifier l'entrée, ajoutez `updatedInput` à l'objet `allow`. De la v2.1.86 à la v2.1.206, un `allow` nécessitait `"updatedInput": {}` pour conserver l'entrée.

4693* Ne renvoyez aucun [`structuredContent`](https://code.claude.com/docs/fr/agent-sdk/custom-tools#return-structured-data), que votre SDK MCP peut ajouter de lui-même. Par exemple, enregistrez l'outil :

4694 * **`FastMCP` ou `MCPServer` de `mcp.server`** : avec `structured_output=False`

4695 * **`FastMCP` de `fastmcp`** : avec `output_schema=None`, et renvoyez une chaîne

4696 * **SDK MCP TypeScript** : sans `outputSchema`

4697* Si l'erreur ne survient qu'avec des entrées d'environ 40 Ko ou plus, ne copiez pas l'entrée dans `updatedInput` ni dans le `message` d'un refus. Pour modifier une entrée aussi volumineuse, [augmentez la limite de sortie de votre outil de demande de permission](https://code.claude.com/docs/fr/mcp.md#raise-the-limit-for-a-specific-tool).

4698 

4657### Agent would be spawned with zero tools4699### Agent would be spawned with zero tools

4658 4700 

4659Chaque entrée de la liste [`tools` du sous-agent](https://code.claude.com/docs/fr/sub-agents#supported-frontmatter-fields) n'a pas correspondu à un outil utilisable, donc Claude Code a refusé de lancer le sous-agent : sans outils, il ne pouvait pas agir. Le message regroupe vos entrées par ce qui s'est mal passé :4701Chaque entrée de la liste [`tools` du sous-agent](https://code.claude.com/docs/fr/sub-agents#supported-frontmatter-fields) n'a pas correspondu à un outil utilisable, donc Claude Code a refusé de lancer le sous-agent : sans outils, il ne pouvait pas agir. Le message regroupe vos entrées par ce qui s'est mal passé :


6432 6474 

6433Avant la v2.1.257, `claude doctor` ne signalait pas ces fichiers ; les versions antérieures laissent les mêmes espaces réservés derrière elles quand une session est tuée.6475Avant la v2.1.257, `claude doctor` ne signalait pas ces fichiers ; les versions antérieures laissent les mêmes espaces réservés derrière elles quand une session est tuée.

6434 6476 

6477### Two Claude Code config files exist

6478 

6479Claude Code utilise le premier fichier que ce message nomme, donc le contenu du second fichier n'est pas en vigueur. Le premier est `.config.json`, un ancien nom de [`.claude.json`](https://code.claude.com/docs/fr/claude-directory#ce-claude-json). Le message inclut une vérification pour savoir quel fichier contient votre configuration :

6480 

6481```text wrap theme={null}

6482Two Claude Code config files exist: this run uses /home/you/.claude/.config.json, not /home/you/.claude.json. The file with the higher count here is usually yours, and this prints nothing else from them: grep -c -E '"(hasCompletedOnboarding|mcpServers)"' "/home/you/.claude/.config.json" "/home/you/.claude.json". To end this: if several hosts share this home, first get every host to version 2.1.319 or later, since an older one can write a moved .config.json back. Then stop your Claude processes on every host, move aside the one you do not want, and start none until no host lists it.

6483```

6484 

6485Sur Windows, `The one with hasCompletedOnboarding or mcpServers in it is usually yours.` remplace la phrase contenant la commande `grep`.

6486 

6487**À faire :**

6488 

6489**1. Trouver le fichier qui contient votre configuration**

6490 

6491* **Sur Windows** : ouvrez les deux fichiers et regardez lequel contient `hasCompletedOnboarding` ou `mcpServers`

6492* **Sur les autres plateformes** : dans votre shell, exécutez la commande `grep` du message et regardez quel fichier a le nombre le plus élevé

6493 

6494**2. Mettre à jour chaque hôte qui partage le répertoire personnel**

6495 

6496Si plusieurs hôtes partagent ce répertoire personnel, mettez d'abord à jour Claude Code sur chaque hôte vers la version que le message nomme ou une version ultérieure. Une version plus ancienne peut réécrire un `.config.json` déplacé.

6497 

6498**3. Arrêter Claude Code**

6499 

6500Arrêtez vos processus Claude Code sur chaque hôte.

6501 

6502**4. Déplacer le fichier dont vous ne voulez pas**

6503 

6504Déplacez le fichier dont vous ne voulez pas hors de son dossier. Déplacez-le plutôt que de le supprimer, afin de pouvoir le remettre en place.

6505 

6506**5. Attendre avant de redémarrer Claude Code**

6507 

6508Ne démarrez Claude Code sur aucun hôte tant qu'un hôte répertorie encore le fichier déplacé à son ancien chemin.

6509 

6510Le message disparaît dès que l'un des deux fichiers n'existe plus.

6511 

6435### Make this change again later: \~/.claude.json could not be updated6512### Make this change again later: \~/.claude.json could not be updated

6436 6513 

6437Cet avis sur stderr signifie qu'une modification de [`~/.claude.json`](https://code.claude.com/docs/fr/claude-directory#ce-claude-json), comme une connexion ou une réponse à une demande d'approbation, n'a pas été enregistrée dans le fichier :6514Cet avis sur stderr signifie qu'une modification de [`~/.claude.json`](https://code.claude.com/docs/fr/claude-directory#ce-claude-json), comme une connexion ou une réponse à une demande d'approbation, n'a pas été enregistrée dans le fichier :


6450 6527 

6451* Un [`--fallback-model`](https://code.claude.com/docs/fr/cli-reference#cli-flags) configuré prend le relais après une erreur de disponibilité, pour ce tour uniquement, avec une notification dans la transcription6528* Un [`--fallback-model`](https://code.claude.com/docs/fr/cli-reference#cli-flags) configuré prend le relais après une erreur de disponibilité, pour ce tour uniquement, avec une notification dans la transcription

6452* Une vérification au démarrage d'Amazon Bedrock ou de Google Cloud's Agent Platform constate que votre modèle par défaut n'est pas disponible, ou votre compte [perd l'accès à celui-ci en cours de session](https://code.claude.com/docs/fr/amazon-bedrock.md#when-a-model-is-disabled-mid-session)6529* Une vérification au démarrage d'Amazon Bedrock ou de Google Cloud's Agent Platform constate que votre modèle par défaut n'est pas disponible, ou votre compte [perd l'accès à celui-ci en cours de session](https://code.claude.com/docs/fr/amazon-bedrock.md#when-a-model-is-disabled-mid-session)

6453* Le [basculement automatique de modèle](https://code.claude.com/docs/fr/model-config.md#automatic-model-fallback) sur Fable 5.1, Fable 5, Opus 5.5, Sonnet 5.5 et Opus 5 fait passer la session au modèle de secours de la catégorie signalée, lorsque cette catégorie en possède un, et affiche une notification dans la transcription6530* Le [basculement automatique de modèle](https://code.claude.com/docs/fr/model-config.md#automatic-model-fallback) sur les modèles Fable, Opus 5.5, Sonnet 5.5 et Opus 5 fait passer la session au modèle de secours de la catégorie signalée, lorsque cette catégorie en possède un. Une notification s'affiche dans la transcription

6454 6531 

6455La vérification de la sélection du modèle ci-dessous détecte le deuxième et le troisième cas ; le premier apparaît sous forme de notification dans la transcription plutôt que comme un changement de `/model`. La [configuration du modèle](https://code.claude.com/docs/fr/model-config.md) explique quand chaque solution de repli s'applique.6532La vérification de la sélection du modèle ci-dessous détecte le deuxième et le troisième cas ; le premier apparaît sous forme de notification dans la transcription plutôt que comme un changement de `/model`. La [configuration du modèle](https://code.claude.com/docs/fr/model-config.md) explique quand chaque solution de repli s'applique.

6456 6533 

fast-mode.md +21 −16

Details

4 4 

5# Accélérez les réponses avec le mode rapide5# Accélérez les réponses avec le mode rapide

6 6 

7> Obtenez des réponses Opus plus rapides dans Claude Code en activant le mode rapide.7> Obtenez des réponses Opus et Fable plus rapides dans Claude Code en activant le mode rapide avec `/fast`.

8 8 

9> [!NOTE]9> [!NOTE]

10>10>

11> Le mode rapide pour Claude Opus 5.5 est disponible, et le mode rapide pour Claude Opus 5 et Claude Opus 4.8 est en [research preview](#research-preview).11> Le mode rapide pour Claude Fable 5.2 et Claude Opus 5.5 est disponible. Le mode rapide pour Claude Opus 5 et Claude Opus 4.8 est en [research preview](#research-preview).

12 12 

13Le mode rapide est une configuration haute vitesse pour Claude Opus, rendant le modèle jusqu'à 2,5 fois plus rapide à un coût par jeton plus élevé. Activez-le avec `/fast` quand vous avez besoin de vitesse pour un travail interactif comme l'itération rapide ou le débogage en direct, et désactivez-le quand le coût importe plus que la latence.13Le mode rapide est une configuration haute vitesse pour les modèles pris en charge, rendant le modèle jusqu'à 2,5 fois plus rapide à un coût par token plus élevé. Activez-le avec `/fast` quand vous avez besoin de vitesse pour un travail interactif comme l'itération rapide ou le débogage en direct, et désactivez-le quand le coût importe plus que la latence.

14 14 

15Le mode rapide n'est pas un modèle différent. Il utilise Claude Opus avec une configuration API différente qui priorise la vitesse plutôt que l'efficacité des coûts. Vous obtenez une qualité et des capacités identiques avec des réponses plus rapides. Le mode rapide est pris en charge sur Opus 5.5, Opus 5 et Opus 4.8. Il n'est pas disponible sur Sonnet, Haiku ou d'autres modèles.15Le mode rapide utilise le même modèle avec une configuration API différente qui priorise la vitesse plutôt que l'efficacité des coûts, de sorte que la qualité et les capacités restent identiques. Le mode rapide est pris en charge sur Fable 5.2, Opus 5.5, Opus 5 et Opus 4.8. Il n'est pas disponible sur Sonnet, Haiku ou d'autres modèles.

16 16 

17> [!WARNING]17> [!WARNING]

18>18>


26Ce qu'il faut savoir :26Ce qu'il faut savoir :

27 27 

28* Utilisez `/fast` pour activer/désactiver le mode rapide dans Claude Code CLI. L'extension [VS Code](https://code.claude.com/docs/fr/vs-code.md) offre une commande **Toggle fast mode** quand le modèle sélectionné supporte le mode rapide. Claude Code enregistre ce paramètre dans votre paramètre [`fastMode`](#toggle-fast-mode).28* Utilisez `/fast` pour activer/désactiver le mode rapide dans Claude Code CLI. L'extension [VS Code](https://code.claude.com/docs/fr/vs-code.md) offre une commande **Toggle fast mode** quand le modèle sélectionné supporte le mode rapide. Claude Code enregistre ce paramètre dans votre paramètre [`fastMode`](#toggle-fast-mode).

29* La tarification du mode rapide par MTok entrée/sortie est de 8 $/40 $ sur Opus 5.5 et de 10 $/50 $ sur Opus 5 et Opus 4.8.29* La tarification du mode rapide par MTok entrée/sortie est de 16 $/80 $ sur Fable 5.2, de 8 $/40 $ sur Opus 5.5 et de 10 $/50 $ sur Opus 5 et Opus 4.8.

30* Disponible pour les utilisateurs de Claude Code sur les plans d'abonnement (Pro/Max/Ultra/Team/Enterprise) et sur Claude Console. Les organisations Team et Enterprise ont besoin qu'un propriétaire l'active d'abord, et les organisations Console ont besoin d'un accès provisionné d'abord pour l'utiliser avec Opus 5 ou Opus 4.8. La section [Exigences](#requirements) décrit ces deux cas.30* Disponible pour les utilisateurs de Claude Code sur les plans d'abonnement (Pro/Max/Ultra/Team/Enterprise) et sur Claude Console. Les organisations Team et Enterprise ont besoin qu'un propriétaire l'active d'abord, et les organisations Console ont besoin d'un accès provisionné d'abord pour l'utiliser avec Opus 5 ou Opus 4.8. La section [Exigences](#requirements) décrit ces deux cas.

31* Pour les utilisateurs de Claude Code sur les plans d'abonnement (Pro/Max/Ultra/Team/Enterprise), le mode rapide est disponible via les crédits d'utilisation uniquement et n'est pas inclus dans les limites de débit de l'abonnement.31* Pour les utilisateurs de Claude Code sur les plans d'abonnement (Pro/Max/Ultra/Team/Enterprise), le mode rapide est disponible via les crédits d'utilisation uniquement et n'est pas inclus dans les limites de débit de l'abonnement.

32 32 


35Dans la CLI, activez ou désactivez le mode rapide de l'une des manières suivantes :35Dans la CLI, activez ou désactivez le mode rapide de l'une des manières suivantes :

36 36 

37* Exécutez `/fast`, appuyez sur Space pour activer ou désactiver, puis appuyez sur Enter pour confirmer37* Exécutez `/fast`, appuyez sur Space pour activer ou désactiver, puis appuyez sur Enter pour confirmer

38* Sur un modèle qui prend en charge le mode rapide, définissez `"fastMode": true` dans votre [fichier de paramètres utilisateur](https://code.claude.com/docs/fr/settings.md). Si vous le définissez sur un autre modèle, vous restez sur ce modèle avec le mode rapide désactivé.38* Sur un modèle qui prend en charge le mode rapide, définissez `"fastMode": true` dans votre [fichier de paramètres utilisateur](https://code.claude.com/docs/fr/settings.md). Si vous le définissez sur un autre modèle, vous restez sur ce modèle avec le mode rapide désactivé. Sur Fable 5.2, ce paramètre seul n'a aucun effet tant que vous n'exécutez pas `/fast` en utilisant Fable 5.2.

39 39 

40Par défaut, le mode rapide que vous activez dans une session interactive persiste d'une session à l'autre sur un modèle compatible. Vous pouvez configurer le mode rapide pour qu'il se réinitialise à chaque session. Consultez [exiger une activation par session](#require-per-session-opt-in) pour plus de détails.40Par défaut, le mode rapide que vous activez dans une session interactive persiste d'une session à l'autre sur un modèle compatible. Sur Fable 5.2, il ne persiste que si vous l'avez [activé en utilisant Fable 5.2](#switch-models-while-fast-mode-is-on). Vous pouvez configurer le mode rapide pour qu'il se réinitialise à chaque session. Consultez [exiger une activation par session](#require-per-session-opt-in) pour plus de détails.

41 41 

42En dehors d'une [session cloud](#use-fast-mode-in-cloud-sessions), en [mode non interactif](https://code.claude.com/docs/fr/headless.md) avec le flag `-p`, `/fast` ne fonctionne que dans une session lancée avec le mode rapide dans sa valeur [`--settings`](https://code.claude.com/docs/fr/cli-reference#cli-flags), par exemple `claude -p --settings '{"fastMode": true}'` ; le basculement s'applique alors uniquement à cette session et n'est pas enregistré comme valeur par défaut. La forme `-p` nécessite Claude Code v2.1.205 ou une version ultérieure. Ailleurs en mode non interactif, la commande indique que le mode rapide n'est pas disponible.42En dehors d'une [session cloud](#use-fast-mode-in-cloud-sessions), en [mode non interactif](https://code.claude.com/docs/fr/headless.md) avec le flag `-p`, `/fast` ne fonctionne que dans une session lancée avec le mode rapide dans sa valeur [`--settings`](https://code.claude.com/docs/fr/cli-reference#cli-flags), par exemple `claude -p --settings '{"fastMode": true}'` ; le basculement s'applique alors uniquement à cette session et n'est pas enregistré comme valeur par défaut. La forme `-p` nécessite Claude Code v2.1.205 ou une version ultérieure. Ailleurs en mode non interactif, la commande indique que le mode rapide n'est pas disponible.

43 43 


48Lorsque vous activez le mode rapide avec `/fast` :48Lorsque vous activez le mode rapide avec `/fast` :

49 49 

50* Si votre modèle actuel ne prend pas en charge le mode rapide, Claude Code passe à Opus50* Si votre modèle actuel ne prend pas en charge le mode rapide, Claude Code passe à Opus

51* Le mode rapide sur Fable 5.2 nécessite Claude Code v2.1.321 ou une version ultérieure

51* Vous verrez un message de confirmation : « Fast mode ON »52* Vous verrez un message de confirmation : « Fast mode ON »

52* Une petite icône `↯` apparaît à côté du prompt tant que le mode rapide est actif53* Une petite icône `↯` apparaît à côté du prompt tant que le mode rapide est actif

53* Exécutez `/fast` à nouveau à tout moment pour vérifier si le mode rapide est activé ou désactivé54* Exécutez `/fast` à nouveau à tout moment pour vérifier si le mode rapide est activé ou désactivé

54 55 

55Opus 5.5 est le modèle par défaut du mode rapide dans Claude Code v2.1.280 et versions ultérieures. Avant la v2.1.280, le mode rapide utilisait Opus 5 par défaut à partir de la v2.1.219.56Opus 5.5 est le modèle par défaut du mode rapide dans Claude Code v2.1.280 et versions ultérieures. Avant la v2.1.280, le mode rapide utilisait Opus 5 par défaut à partir de la v2.1.219.

56 57 

57Lorsque vous désactivez le mode rapide avec `/fast` à nouveau, vous restez sur Opus. Pour passer à un autre modèle, utilisez `/model`.58Lorsque vous désactivez le mode rapide avec `/fast` à nouveau, vous restez sur votre modèle actuel. Pour passer à un autre modèle, utilisez `/model`.

58 59 

59### Changer de modèle lorsque le mode rapide est activé60### Changer de modèle lorsque le mode rapide est activé

60 61 

61Le mode rapide suit vos changements de modèle dans les deux sens :62Le mode rapide suit vos changements de modèle :

62 63 

63* **Quitter** : lorsque vous passez à un modèle qui ne prend pas en charge le mode rapide, Claude Code désactive le mode rapide. Cela inclut Opus 4.7 ; avant la v2.1.221, le mode rapide restait activé après un passage à Opus 4.7 et l'API rejetait les requêtes.64* **Quitter** : lorsque vous passez à un modèle qui ne prend pas en charge le mode rapide, Claude Code désactive le mode rapide. Cela inclut Opus 4.7 ; avant la v2.1.221, le mode rapide restait activé après un passage à Opus 4.7 et l'API rejetait les requêtes.

64* **Revenir** : revenir à un modèle Opus compatible réactive le mode rapide lorsque votre préférence de mode rapide enregistrée est activée, la même préférence à partir de laquelle une nouvelle session démarre par défaut. Un changement de modèle n'active jamais le mode rapide pour une session dont la préférence enregistrée est désactivée, et lorsque l'[activation par session](#require-per-session-opt-in) est configurée, revenir au modèle ne l'active pas non plus ; exécutez `/fast` pour le réactiver.65* **Revenir** : le mode rapide se réactive sur un modèle Opus compatible lorsque votre préférence enregistrée est activée. Avec l'[activation par session](#require-per-session-opt-in), exécutez plutôt `/fast`.

66* **Passer à Fable 5.2** : le mode rapide se désactive, sauf si vous l'avez activé en utilisant Fable 5.2. Pour l'activer, exécutez `/fast` sur Fable 5.2. Sauf si vous avez configuré l'[activation par session](#require-per-session-opt-in), ce réglage persiste d'une session à l'autre jusqu'à ce que vous le désactiviez ou que vous l'activiez avec un autre modèle.

65 67 

66Chaque fois qu'un changement de modèle active ou désactive le mode rapide, Claude Code affiche une confirmation `Fast mode ON` ou `Fast mode OFF`, et l'icône `↯` apparaît tant que le mode rapide est activé. Cela s'applique que vous changiez de modèle avec `/model`, avec [`/config model=<model>`](https://code.claude.com/docs/fr/settings), ou depuis un appareil connecté via [Remote Control](https://code.claude.com/docs/fr/remote-control.md).68Chaque fois qu'un changement de modèle active ou désactive le mode rapide, Claude Code affiche une confirmation `Fast mode ON` ou `Fast mode OFF`, et l'icône `↯` apparaît tant que le mode rapide est activé. Cela s'applique que vous changiez de modèle avec `/model`, avec [`/config model=<model>`](https://code.claude.com/docs/fr/settings), ou depuis un appareil connecté via [Remote Control](https://code.claude.com/docs/fr/remote-control.md).

67 69 


77 79 

78## Comprendre le compromis de coût80## Comprendre le compromis de coût

79 81 

80Le mode rapide a une tarification par jeton plus élevée que l'Opus standard :82Le mode rapide a une tarification par token plus élevée que la vitesse standard :

81 83 

82| Modèle | Entrée (MTok) | Sortie (MTok) |84| Modèle | Entrée (MTok) | Sortie (MTok) |

83| - | - | - |85| - | - | - |

86| Fable 5.2 | \$16 | \$80 |

84| Opus 5.5 | \$8 | \$40 |87| Opus 5.5 | \$8 | \$40 |

85| Opus 5 | \$10 | \$50 |88| Opus 5 | \$10 | \$50 |

86| Opus 4.8 | \$10 | \$50 |89| Opus 4.8 | \$10 | \$50 |

87 90 

88La tarification du mode rapide est forfaitaire sur toute la fenêtre de contexte de 1 M de jetons. Pour le taux Opus standard à comparer, consultez la [référence de tarification Claude](https://platform.claude.com/docs/en/about-claude/pricing).91La tarification du mode rapide est forfaitaire sur toute la fenêtre de contexte de 1 M de tokens. Pour le tarif standard à comparer, consultez la [référence de tarification Claude](https://platform.claude.com/docs/en/about-claude/pricing).

89 92 

90La première fois que vous activez le mode rapide dans une conversation, vous payez le prix complet du token d'entrée non mis en cache du mode rapide pour tout le contexte de la conversation. Plus vous êtes avancé dans une conversation, plus cela coûte cher, donc le coût est le plus faible lorsque vous activez le mode rapide dès le départ. Le mode rapide et la vitesse standard conservent des [caches séparés](https://code.claude.com/docs/fr/prompt-caching.md#turning-on-fast-mode), donc chaque changement ultérieur relit une partie ou la totalité de la conversation sans cache.93La première fois que vous activez le mode rapide dans une conversation, vous payez le prix complet du token d'entrée non mis en cache du mode rapide pour tout le contexte de la conversation. Plus vous êtes avancé dans une conversation, plus cela coûte cher, donc le coût est le plus faible lorsque vous activez le mode rapide dès le départ. Le mode rapide et la vitesse standard conservent des [caches séparés](https://code.claude.com/docs/fr/prompt-caching.md#turning-on-fast-mode), donc chaque changement ultérieur relit une partie ou la totalité de la conversation sans cache.

91 94 


137 140 

138* **Organisation Console payante** : les comptes Claude Console n'utilisent pas de crédits d'utilisation, et votre organisation paie le mode rapide par jeton avec le reste de son utilisation API. Sur le plan Evaluation gratuit de la Console, `/fast` affiche « Le mode rapide n'est pas disponible pendant l'évaluation. Veuillez acheter des crédits. » Pour l'effacer, achetez des crédits dans vos [paramètres de facturation Console](https://platform.claude.com/settings/billing).141* **Organisation Console payante** : les comptes Claude Console n'utilisent pas de crédits d'utilisation, et votre organisation paie le mode rapide par jeton avec le reste de son utilisation API. Sur le plan Evaluation gratuit de la Console, `/fast` affiche « Le mode rapide n'est pas disponible pendant l'évaluation. Veuillez acheter des crédits. » Pour l'effacer, achetez des crédits dans vos [paramètres de facturation Console](https://platform.claude.com/settings/billing).

139 142 

140 Le mode rapide avec Opus 5.5 dépend également du [niveau d'utilisation](https://platform.claude.com/docs/en/api/rate-limits) de votre organisation.143 Le mode rapide avec Fable 5.2 ou Opus 5.5 dépend également du [niveau d'utilisation](https://platform.claude.com/docs/en/api/rate-limits) de votre organisation.

141* **Activation par le propriétaire pour Team et Enterprise** : le mode rapide est désactivé par défaut pour les organisations Team et Enterprise. Un propriétaire doit explicitement [activer le mode rapide](#enable-fast-mode-for-your-organization) avant que les utilisateurs puissent y accéder.144* **Activation par le propriétaire pour Team et Enterprise** : le mode rapide est désactivé par défaut pour les organisations Team et Enterprise. Un propriétaire doit explicitement [activer le mode rapide](#enable-fast-mode-for-your-organization) avant que les utilisateurs puissent y accéder.

142 145 

143> [!NOTE]146> [!NOTE]


147> * **Mode rapide non activé** : si le mode rapide n'a pas été activé pour votre organisation, l'activation du mode rapide avec `/fast` affiche « Le mode rapide a été désactivé par votre organisation. »150> * **Mode rapide non activé** : si le mode rapide n'a pas été activé pour votre organisation, l'activation du mode rapide avec `/fast` affiche « Le mode rapide a été désactivé par votre organisation. »

148> * **Mode rapide désactivé par les paramètres gérés** : si votre organisation déploie les [paramètres gérés](https://code.claude.com/docs/fr/managed-settings.md) qui définissent [`fastMode: false`](https://code.claude.com/docs/fr/settings-reference#fastmode), l'activation du mode rapide avec `/fast` affiche le même message « Le mode rapide a été désactivé par votre organisation ».151> * **Mode rapide désactivé par les paramètres gérés** : si votre organisation déploie les [paramètres gérés](https://code.claude.com/docs/fr/managed-settings.md) qui définissent [`fastMode: false`](https://code.claude.com/docs/fr/settings-reference#fastmode), l'activation du mode rapide avec `/fast` affiche le même message « Le mode rapide a été désactivé par votre organisation ».

149> * **Opt-in par session requis** : les paramètres gérés qui définissent [`fastModePerSessionOptIn: true`](#require-per-session-opt-in) refusent `/fast on` avec le même message partout sauf dans une session de terminal interactive.152> * **Opt-in par session requis** : les paramètres gérés qui définissent [`fastModePerSessionOptIn: true`](#require-per-session-opt-in) refusent `/fast on` avec le même message partout sauf dans une session de terminal interactive.

150> * **Modèle de mode rapide non autorisé** : si la liste d'autorisation [`availableModels`](https://code.claude.com/docs/fr/model-config#restrict-model-selection) de votre organisation exclut le modèle Opus du mode rapide, l'activation est refusée avec « n'est pas dans les modèles autorisés de votre organisation ». Dans une session déjà en cours d'exécution sur un modèle Opus autorisé qui prend en charge le mode rapide, `/fast` active le mode rapide sur votre modèle actuel au lieu de changer de modèle.153> * **Modèle de mode rapide non autorisé** : si la liste d'autorisation [`availableModels`](https://code.claude.com/docs/fr/model-config#restrict-model-selection) de votre organisation exclut le modèle Opus du mode rapide, l'activation est refusée avec « n'est pas dans les modèles autorisés de votre organisation ». Dans une session déjà en cours d'exécution sur un modèle autorisé qui prend en charge le mode rapide, `/fast` active le mode rapide sur votre modèle actuel au lieu de changer de modèle.

151 154 

152### Activer le mode rapide pour votre organisation155### Activer le mode rapide pour votre organisation

153 156 


196 199 

197### Opt-in par session200### Opt-in par session

198 201 

199Par défaut, le mode rapide qu'un utilisateur active dans une session interactive persiste entre les sessions sur un modèle pris en charge. Pour modifier ceci, définissez `fastModePerSessionOptIn` à `true` dans n'importe quel [fichier de paramètres](https://code.claude.com/docs/fr/settings.md#where-settings-live), ce qui fait que chaque session commence avec le mode rapide désactivé et oblige les utilisateurs à l'activer explicitement avec `/fast`. Les propriétaires sur les plans [Team](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_teams#team-&-enterprise) ou [Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_enterprise) peuvent le déployer à l'échelle de l'organisation via les [paramètres gérés par le serveur](https://code.claude.com/docs/fr/server-managed-settings.md).202Par défaut, le mode rapide qu'un utilisateur active dans une session interactive persiste entre les sessions sur un modèle pris en charge. Sur Fable 5.2, il persiste uniquement si l'utilisateur [l'a activé en utilisant Fable 5.2](#switch-models-while-fast-mode-is-on).

203 

204Pour que chaque session commence avec le mode rapide désactivé, définissez `fastModePerSessionOptIn` à `true` dans n'importe quel [fichier de paramètres](https://code.claude.com/docs/fr/settings.md#where-settings-live). Les utilisateurs l'activent alors avec `/fast` dans chaque session. Les propriétaires sur les plans [Team](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_teams#team-&-enterprise) ou [Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_enterprise) peuvent le déployer à l'échelle de l'organisation via les [paramètres gérés par le serveur](https://code.claude.com/docs/fr/server-managed-settings.md).

200 205 

201```json theme={null}206```json theme={null}

202{207{


210 215 

211## Gérer les limites de taux216## Gérer les limites de taux

212 217 

213Le mode rapide a des limites de débit séparées de l'Opus standard ; pour les organisations Console, la page [limites de débit](https://platform.claude.com/docs/en/api/rate-limits) de la Claude Platform les décrit. Quand vous atteignez la limite de débit du mode rapide :218Le mode rapide a des limites de débit distinctes de celles de la vitesse standard ; pour les organisations Console, la page [limites de débit](https://platform.claude.com/docs/en/api/rate-limits) de la Claude Platform les décrit. Quand vous atteignez la limite de débit du mode rapide :

214 219 

2151. Le mode rapide bascule automatiquement vers la vitesse standard2201. Le mode rapide bascule automatiquement vers la vitesse standard

2162. L'icône `↯` devient grise pour indiquer le refroidissement2212. L'icône `↯` devient grise pour indiquer le refroidissement

hooks.md +12 −4

Details

1089 1089 

1090#### Émettre des notifications de terminal1090#### Émettre des notifications de terminal

1091 1091 

1092Les hooks s'exécutent sans terminal de contrôle, donc écrire des séquences d'échappement directement sur `/dev/tty` échoue. À la place, retournez la séquence d'échappement dans le champ `terminalSequence` et Claude Code l'émet pour vous via son propre chemin d'écriture de terminal. C'est sans situation de concurrence, fonctionne à l'intérieur de tmux et GNU screen, et fonctionne sur Windows où il n'y a pas de `/dev/tty`.1092Les hooks s'exécutent sans terminal de contrôle, donc écrire des séquences d'échappement directement sur `/dev/tty` échoue. À la place, retournez la séquence d'échappement dans le champ `terminalSequence` et Claude Code l'émet pour vous via son propre chemin d'écriture de terminal. C'est sans situation de concurrence et fonctionne sur Windows où il n'y a pas de `/dev/tty`.

1093 1093 

1094Le champ accepte une chaîne d'une ou plusieurs séquences d'échappement figurant dans la liste d'autorisation :1094Le champ accepte une chaîne d'une ou plusieurs séquences d'échappement figurant dans la liste d'autorisation :

1095 1095 


1101 1101 

1102Les séquences peuvent être terminées avec BEL ou avec ST. Tout ce qui est en dehors de la liste d'autorisation, y compris les séquences de curseur CSI et les séquences de couleur, les séquences de palette OSC, les hyperliens OSC 8, les écritures de presse-papiers OSC 52 et OSC 1337, est rejeté et le champ est ignoré.1102Les séquences peuvent être terminées avec BEL ou avec ST. Tout ce qui est en dehors de la liste d'autorisation, y compris les séquences de curseur CSI et les séquences de couleur, les séquences de palette OSC, les hyperliens OSC 8, les écritures de presse-papiers OSC 52 et OSC 1337, est rejeté et le champ est ignoré.

1103 1103 

1104Claude Code écrit la séquence lui-même lorsqu'il traite la sortie de votre hook, donc le champ fonctionne sur les événements qui rejettent `systemMessage` et `continue`, tels que `Notification` et `StopFailure`. Il a deux limites :1104Claude Code écrit la séquence lui-même lorsqu'il traite la sortie de votre hook, donc le champ fonctionne sur les événements qui rejettent `systemMessage` et `continue`, tels que `Notification` et `StopFailure`. Il a quelques limites :

1105 1105 

1106* Claude Code écrit la séquence uniquement dans une session interactive, et uniquement tandis que son interface est à l'écran. En mode non interactif avec le flag `-p` et dans l'Agent SDK, il ignore le champ.1106* Claude Code écrit la séquence uniquement dans une session interactive, et uniquement tant que son interface est ouverte. En mode non interactif avec le flag `-p` et dans l'Agent SDK, il ignore le champ.

1107* Le champ fonctionne uniquement à partir d'un hook qui ne s'exécute pas en [arrière-plan](#run-hooks-in-the-background), donc laissez `async` et `asyncRewake` désactivés.

1107* Un hook de commande `WorktreeCreate` ne peut pas retourner JSON, car Claude Code lit son stdout comme le chemin du worktree. Un hook HTTP `WorktreeCreate` retourne JSON et peut inclure le champ.1108* Un hook de commande `WorktreeCreate` ne peut pas retourner JSON, car Claude Code lit son stdout comme le chemin du worktree. Un hook HTTP `WorktreeCreate` retourne JSON et peut inclure le champ.

1108 1109 

1109L'exemple ci-dessous déclenche une notification de bureau à partir d'un hook `Notification`. La séquence d'échappement est construite avec des échappements octaux `printf` afin que les octets de contrôle n'apparaissent jamais sur la ligne de commande shell, et `jq -n --arg` construit la sortie JSON afin que les guillemets, les barres obliques inverses et les sauts de ligne dans le message de notification soient correctement échappés :1110Si vous utilisez tmux ou GNU screen, effectuez d'abord [la configuration correspondante](#get-terminal-notifications-inside-tmux-or-gnu-screen). L'exemple ci-dessous déclenche une notification de bureau à partir d'un hook `Notification` dans un terminal qui lit OSC `777`, comme Ghostty ou Warp. L'appel `jq -nc --arg` du script construit la sortie JSON et échappe les guillemets, barres obliques inverses et sauts de ligne présents dans le message de notification :

1110 1111 

1111```bash theme={null}1112```bash theme={null}

1112#!/bin/bash1113#!/bin/bash


1120 1121 

1121La forme `{ "terminalSequence": "..." }` est la même à partir de n'importe quel shell ou langage.1122La forme `{ "terminalSequence": "..." }` est la même à partir de n'importe quel shell ou langage.

1122 1123 

1124#### Recevoir des notifications de terminal dans tmux ou GNU screen

1125 

1126Lorsque Claude Code s'exécute dans tmux ou GNU screen, les séquences OSC ont besoin de ce qui suit pour parvenir à votre application de terminal :

1127 

1128* **tmux 3.3 ou ultérieur** : ajoutez `set -g allow-passthrough on` à `~/.tmux.conf`, puis exécutez `tmux source-file ~/.tmux.conf` depuis un shell. L'option s'applique à chaque programme de ces volets, pas seulement à Claude Code. Avec `on`, seuls les volets que tmux affiche peuvent les envoyer. Pour permettre également aux autres volets d'une session à laquelle vous êtes attaché de les envoyer, utilisez `all` à la place de `on`, sur tmux 3.4 ou ultérieur.

1129* **GNU screen** : gardez la fenêtre de Claude Code affichée dans screen, car les séquences provenant d'une fenêtre en arrière-plan ne parviennent pas à votre application de terminal

1130 

1123#### Ajouter du contexte pour Claude1131#### Ajouter du contexte pour Claude

1124 1132 

1125Le champ `additionalContext` transmet une chaîne de votre hook dans la fenêtre de contexte de Claude. Claude Code enveloppe la chaîne dans un [rappel système](https://code.claude.com/docs/fr/glossary.md#system-reminder) et l'insère dans la conversation au point où le hook s'est déclenché. Claude lit le rappel lors de la prochaine requête au modèle, mais il n'apparaît pas comme un message de chat dans l'interface.1133Le champ `additionalContext` transmet une chaîne de votre hook dans la fenêtre de contexte de Claude. Claude Code enveloppe la chaîne dans un [rappel système](https://code.claude.com/docs/fr/glossary.md#system-reminder) et l'insère dans la conversation au point où le hook s'est déclenché. Claude lit le rappel lors de la prochaine requête au modèle, mais il n'apparaît pas comme un message de chat dans l'interface.

Details

223| Champs d'outil [bêta](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview) | Les en-têtes bêta liés aux outils s'associent aux champs de schéma d'outil tels que `strict` et `defer_loading` | `400` nommant le champ de schéma d'outil non reconnu lorsque le corps passe sans son en-tête. Pour `defer_loading`, consultez [Réessayer sans la recherche d'outils](#retry-without-tool-search) | Transmettez les deux, ou [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) |223| Champs d'outil [bêta](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview) | Les en-têtes bêta liés aux outils s'associent aux champs de schéma d'outil tels que `strict` et `defer_loading` | `400` nommant le champ de schéma d'outil non reconnu lorsque le corps passe sans son en-tête. Pour `defer_loading`, consultez [Réessayer sans la recherche d'outils](#retry-without-tool-search) | Transmettez les deux, ou [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) |

224| [Effort](https://platform.claude.com/docs/en/build-with-claude/effort) et [sorties structurées](https://platform.claude.com/docs/en/build-with-claude/structured-outputs) | Le champ de corps `output_config` porte les paramètres d'effort, de format de sortie structurée et de budget de tâche ; chacun s'associe à son propre en-tête bêta | `400` nommant `output_config`, souvent `Extra inputs are not permitted`, sur les amonts Amazon Bedrock et Agent Platform de Google Cloud | Transmettez le champ et ses en-têtes ensemble, ou demandez aux développeurs de définir [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities), qui supprime les paramètres de format et de budget de tâche mais pas l'effort. Pour supprimer uniquement le format, ils peuvent définir [`CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS=1`](https://code.claude.com/docs/fr/env-vars) à la place, ce qui nécessite v2.1.288 ou ultérieur |224| [Effort](https://platform.claude.com/docs/en/build-with-claude/effort) et [sorties structurées](https://platform.claude.com/docs/en/build-with-claude/structured-outputs) | Le champ de corps `output_config` porte les paramètres d'effort, de format de sortie structurée et de budget de tâche ; chacun s'associe à son propre en-tête bêta | `400` nommant `output_config`, souvent `Extra inputs are not permitted`, sur les amonts Amazon Bedrock et Agent Platform de Google Cloud | Transmettez le champ et ses en-têtes ensemble, ou demandez aux développeurs de définir [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities), qui supprime les paramètres de format et de budget de tâche mais pas l'effort. Pour supprimer uniquement le format, ils peuvent définir [`CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS=1`](https://code.claude.com/docs/fr/env-vars) à la place, ce qui nécessite v2.1.288 ou ultérieur |

225| Messages système en milieu de conversation | Pas d'en-tête bêta. Claude Code envoie une partie du texte de rappel et de pièce jointe sous forme d'entrées `role: "system"` dans `messages` pour Claude Opus 4.8, les modèles publiés après lui et les ID de modèle non reconnus | `400` tel que `Unexpected role "system"` | Claude Code [réessaie sans les messages système](#automatic-retry-and-error-forwarding). Pour arrêter les messages système sur un alias d'un modèle publié avant Claude Opus 4.8, ajoutez une [entrée `modelOverrides`](#settings-for-unrecognized-model-ids) aux paramètres que vous distribuez |225| Messages système en milieu de conversation | Pas d'en-tête bêta. Claude Code envoie une partie du texte de rappel et de pièce jointe sous forme d'entrées `role: "system"` dans `messages` pour Claude Opus 4.8, les modèles publiés après lui et les ID de modèle non reconnus | `400` tel que `Unexpected role "system"` | Claude Code [réessaie sans les messages système](#automatic-retry-and-error-forwarding). Pour arrêter les messages système sur un alias d'un modèle publié avant Claude Opus 4.8, ajoutez une [entrée `modelOverrides`](#settings-for-unrecognized-model-ids) aux paramètres que vous distribuez |

226| [Effort défini par tour](https://code.claude.com/docs/fr/prompt-caching.md#changing-effort-level) | Sur Opus 5.5, Sonnet 5.5, Haiku 5.5 et Fable 5.1, un en-tête bêta s'associe à `output_config.effort` sur les entrées `role: "system"`, qu'il s'agisse d'un message système ou d'une entrée au contenu vide | `400` avec `messages.N: system content must contain at least one block` lorsque votre passerelle supprime le champ d'une entrée vide | Transmettez les deux, ou demandez aux développeurs de définir [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) pour arrêter l'envoi du champ et des entrées vides |226| [Effort défini par tour](https://code.claude.com/docs/fr/prompt-caching.md#changing-effort-level) | Sur Opus 5.5, Sonnet 5.5, Haiku 5.5, Fable 5.2 et Fable 5.1, un en-tête bêta s'associe à `output_config.effort` sur les entrées `role: "system"`. Une entrée est un message système ou une entrée au contenu vide | `400` avec `messages.N: system content must contain at least one block` lorsque votre passerelle supprime le champ d'une entrée vide | Transmettez les deux, ou demandez aux développeurs de définir [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](#disable-pre-release-capabilities) pour arrêter l'envoi du champ et des entrées vides |

227| [Mise en cache des invites](https://code.claude.com/docs/fr/prompt-caching.md) | Pas d'appairage bêta. Claude Code attache les marqueurs `cache_control` aux blocs `system` et aux entrées `messages`, y compris les entrées `role: "system"` ajoutées en milieu de conversation | Pas d'erreur : la conversation est facturée comme entrée non mise en cache à chaque tour, visible comme `input_tokens` élevé avec peu ou pas d'activité de cache dans `usage` | Transmettez `cache_control` inchangé partout où il apparaît, et ne convertissez pas le formulaire de bloc `system` ou le contenu du message en chaînes simples |227| [Mise en cache des invites](https://code.claude.com/docs/fr/prompt-caching.md) | Pas d'appairage bêta. Claude Code attache les marqueurs `cache_control` aux blocs `system` et aux entrées `messages`, y compris les entrées `role: "system"` ajoutées en milieu de conversation | Pas d'erreur : la conversation est facturée comme entrée non mise en cache à chaque tour, visible comme `input_tokens` élevé avec peu ou pas d'activité de cache dans `usage` | Transmettez `cache_control` inchangé partout où il apparaît, et ne convertissez pas le formulaire de bloc `system` ou le contenu du message en chaînes simples |

228| [Comptage des jetons](https://platform.claude.com/docs/en/build-with-claude/token-counting) | Pas d'appairage bêta ; utilise le point de terminaison `count_tokens` | Pas d'erreur : Claude Code revient à une estimation basée sur les caractères, donc `/context` affiche les comptages approximatifs | Exposez le point de terminaison pour les comptages de jetons exacts |228| [Comptage des jetons](https://platform.claude.com/docs/en/build-with-claude/token-counting) | Pas d'appairage bêta ; utilise le point de terminaison `count_tokens` | Pas d'erreur : Claude Code revient à une estimation basée sur les caractères, donc `/context` affiche les comptages approximatifs | Exposez le point de terminaison pour les comptages de jetons exacts |

229 229 

model-config.md +52 −23

Details

30| Alias de modèle | Comportement |30| Alias de modèle | Comportement |

31| - | - |31| - | - |

32| **`default`** | Valeur spéciale qui efface tout remplacement de modèle et revient à la [valeur par défaut du runtime pour votre compte](#default-model-setting). N'est pas en soi un alias de modèle |32| **`default`** | Valeur spéciale qui efface tout remplacement de modèle et revient à la [valeur par défaut du runtime pour votre compte](#default-model-setting). N'est pas en soi un alias de modèle |

33| **`best`** | Utilise le modèle auquel l'alias [`fable` se résout](#fable-alias-resolution) où Fable est disponible pour vous, sinon le même modèle que `opus` |33| **`best`** | Utilise le même modèle que `opus` |

34| **`fable`** | Utilise le [modèle Fable pour votre fournisseur](#fable-alias-resolution) pour vos tâches les plus difficiles et les plus longues |34| **`fable`** | Utilise le [modèle Fable pour votre fournisseur](#fable-alias-resolution) pour vos tâches les plus difficiles et les plus longues |

35| **`sonnet`** | Utilise le dernier modèle Sonnet pour les tâches de codage quotidiennes |35| **`sonnet`** | Utilise le dernier modèle Sonnet pour les tâches de codage quotidiennes |

36| **`opus`** | Utilise le dernier modèle Opus pour les tâches de raisonnement complexe |36| **`opus`** | Utilise le dernier modèle Opus pour les tâches de raisonnement complexe |


48| Amazon Bedrock, Agent Platform de Google Cloud | Opus 5.5 | Sonnet 4.5 | Haiku 4.5 |48| Amazon Bedrock, Agent Platform de Google Cloud | Opus 5.5 | Sonnet 4.5 | Haiku 4.5 |

49| Microsoft Foundry | Opus 4.6 | Sonnet 4.5 | Haiku 4.5 |49| Microsoft Foundry | Opus 4.6 | Sonnet 4.5 | Haiku 4.5 |

50 50 

51Sauf si vous définissez `ANTHROPIC_DEFAULT_FABLE_MODEL`, l'alias `fable` se résout à Fable 5.1, sauf dans les sessions de [passerelle d'applications Claude](https://code.claude.com/docs/fr/claude-apps-gateway), où `fable` et `best` se résolvent à Fable 5.51Sauf si vous définissez `ANTHROPIC_DEFAULT_FABLE_MODEL`, l'alias `fable` se résout à Fable 5 dans les sessions de [passerelle d'applications Claude](https://code.claude.com/docs/fr/claude-apps-gateway) et à Fable 5.2 partout ailleurs.

52 52 

53Une passerelle qui n'est pas configurée pour servir `claude-fable-5-1` rejette les requêtes pour ce modèle. Pour utiliser Fable 5.1 via une passerelle qui le sert, sélectionnez-le avec `/model claude-fable-5-1`.53Une passerelle qui n'est pas configurée pour servir `claude-fable-5-2` rejette les requêtes pour ce modèle. Pour utiliser Fable 5.2 via une passerelle qui le sert, sélectionnez-le avec `/model claude-fable-5-2`.

54 54 

55Lorsque `opus` ou `sonnet` se résout à un modèle plus ancien, les modèles plus récents sont disponibles en sélectionnant explicitement le nom de modèle complet ou en définissant `ANTHROPIC_DEFAULT_OPUS_MODEL` ou `ANTHROPIC_DEFAULT_SONNET_MODEL`.55Lorsque `opus` ou `sonnet` se résout à un modèle plus ancien, les modèles plus récents sont disponibles en sélectionnant explicitement le nom de modèle complet ou en définissant `ANTHROPIC_DEFAULT_OPUS_MODEL` ou `ANTHROPIC_DEFAULT_SONNET_MODEL`.

56 56 


64 64 

65### Travailler avec Fable65### Travailler avec Fable

66 66 

67[Claude Fable 5.1](https://platform.claude.com/docs/en/about-claude/models/overview) et Claude Fable 5 sont les modèles les plus puissants de Claude Code, adaptés aux tâches plus importantes qu'une seule séance. Ils maintiennent de longues sessions autonomes, enquêtent avant d'agir et vérifient leur travail plus souvent que les modèles plus petits. Fable 5.1 est la version plus récente.67Les [modèles Claude Fable](https://platform.claude.com/docs/en/about-claude/models/overview) sont les modèles les plus puissants de Claude Code, adaptés aux tâches plus importantes qu'une seule séance. Ils maintiennent de longues sessions autonomes, enquêtent avant d'agir et vérifient leur travail plus souvent que les modèles plus petits.

68 68 

69Aucun modèle Fable n'est la valeur par défaut du type de compte sur aucun plan ou fournisseur. Sélectionnez-en un explicitement :69Aucun modèle Fable n'est la valeur par défaut du type de compte sur aucun plan ou fournisseur. Sélectionnez-en un explicitement :

70 70 

71* **Fable 5.1** : exécutez `/model fable`, ou lancez avec `claude --model fable`. Dans les sessions de [passerelle d'applications Claude](https://code.claude.com/docs/fr/claude-apps-gateway), où l'alias se résout à Fable 5, exécutez `/model claude-fable-5-1` à la place.71* **Fable 5.2** : exécutez `/model fable`, ou lancez avec `claude --model fable`. Dans les sessions de [passerelle d'applications Claude](https://code.claude.com/docs/fr/claude-apps-gateway), exécutez plutôt `/model claude-fable-5-2`.

72* **Fable 5** : sélectionnez-le par ID de modèle. Sur l'API Anthropic, exécutez `/model claude-fable-5` ou lancez avec `claude --model claude-fable-5`. Sur d'autres fournisseurs, utilisez l'ID de modèle Fable 5 de votre fournisseur ou [épinglez-le](#pin-models-for-third-party-deployments) avec `ANTHROPIC_DEFAULT_FABLE_MODEL`.72* **Fable 5.1 ou Fable 5** : sélectionnez-le par ID de modèle. Sur l'API Anthropic, exécutez `/model claude-fable-5-1` ou `/model claude-fable-5`, ou lancez avec `claude --model claude-fable-5-1`. Sur d'autres fournisseurs, utilisez l'ID de modèle de votre fournisseur ou [épinglez-le](#pin-models-for-third-party-deployments) avec `ANTHROPIC_DEFAULT_FABLE_MODEL`.

73 73 

74Si vous vous connectez directement à l'API Anthropic et que vos paramètres utilisateur contiennent `claude-fable-5` ou `claude-fable-5[1m]` comme modèle, par exemple parce que vous avez sélectionné Fable dans le sélecteur `/model` avant v2.1.257, Claude Code change cette valeur enregistrée en alias `fable` ou `fable[1m]` la première fois que vous exécutez v2.1.257 ou ultérieur. La ligne de modèle de démarrage affiche `(auto-updated)` une fois. Une valeur `claude-fable-5` dans les paramètres de projet, locaux ou gérés reste telle quelle.74Sur les plans Pro, Max, Team et Enterprise, un modèle `claude-fable-5-1` enregistré dans vos paramètres utilisateur passe à l'alias `fable` :

75 

76* **Plan Pro ou Max** : le changement a lieu la première fois que vous exécutez v2.1.321 ou ultérieur. Dans le terminal, la ligne de modèle de démarrage peut afficher `(auto-updated)` une fois.

77* **Plan Team ou Enterprise** : le changement attend les paramètres de votre organisation ; il peut donc intervenir lors d'un démarrage ultérieur, ou ne jamais intervenir. Il s'applique à partir de la session suivante, sans ligne `(auto-updated)`. Pour vérifier votre modèle, exécutez `/model`.

78 

79Après le changement, les sessions démarrent au niveau d'effort par défaut de Fable 5.2, sauf si vous avez [défini un niveau](#adjust-effort-level) pour celui-ci. Les comptes Console, les fournisseurs tiers et les paramètres de projet, locaux ou gérés conservent `claude-fable-5-1`.

75 80 

76Les requêtes que les classifieurs de sécurité d'un modèle Fable signalent, le plus souvent dans les domaines de la cybersécurité et de la biologie, déclenchent un [basculement automatique vers un modèle de secours](#automatic-model-fallback).81Les requêtes que les classifieurs de sécurité d'un modèle Fable signalent, le plus souvent dans les domaines de la cybersécurité et de la biologie, déclenchent un [basculement automatique vers un modèle de secours](#automatic-model-fallback).

77 82 


84 89 

85> [!NOTE]90> [!NOTE]

86>91>

87> Fable 5.1 nécessite Claude Code v2.1.257 ou ultérieur. Si une requête pour celui-ci à partir d'une version plus ancienne échoue, consultez [Claude Code ne supporte pas ce modèle](https://code.claude.com/docs/fr/errors.md#claude-code-does-not-support-this-model). Exécutez `claude update` pour mettre à jour. Pour la disponibilité en vertu de la rétention zéro de données, consultez [Disponibilité des modèles en vertu de ZDR](https://code.claude.com/docs/fr/zero-data-retention.md#model-availability-under-zdr).92> Fable 5.2 nécessite Claude Code v2.1.321 ou ultérieur, et Fable 5.1 nécessite v2.1.257 ou ultérieur. Si une requête pour l'un d'eux à partir d'une version plus ancienne échoue, consultez [Claude Code ne supporte pas ce modèle](https://code.claude.com/docs/fr/errors.md#claude-code-does-not-support-this-model). Exécutez `claude update` pour mettre à jour. Pour la disponibilité en vertu de la rétention zéro de données, consultez [Disponibilité des modèles en vertu de ZDR](https://code.claude.com/docs/fr/zero-data-retention.md#model-availability-under-zdr).

88 93 

89Sur l'API Anthropic, un modèle Fable apparaît dans le sélecteur `/model` sauf si [`availableModels`](#restrict-model-selection) ou [les restrictions de modèle de l'organisation](#organization-model-restrictions) l'excluent. Lorsque votre organisation ne peut pas utiliser Fable du tout, par exemple en vertu de la [rétention zéro de données](https://code.claude.com/docs/fr/zero-data-retention.md#model-availability-under-zdr), la ligne reste dans le sélecteur grisée, avec une note sur la raison.94Sur l'API Anthropic, un modèle Fable apparaît dans le sélecteur `/model` sauf si [`availableModels`](#restrict-model-selection) ou [les restrictions de modèle de l'organisation](#organization-model-restrictions) l'excluent. Lorsque votre organisation ne peut pas utiliser Fable du tout, par exemple en vertu de la [rétention zéro de données](https://code.claude.com/docs/fr/zero-data-retention.md#model-availability-under-zdr), la ligne reste dans le sélecteur grisée, avec une note sur la raison.

90 95 


163 168 

164Consultez [Model is not a recognized model id](https://code.claude.com/docs/fr/errors.md#model-is-not-a-recognized-model-id) et [Model not found](https://code.claude.com/docs/fr/errors.md#model-not-found) pour les messages.169Consultez [Model is not a recognized model id](https://code.claude.com/docs/fr/errors.md#model-is-not-a-recognized-model-id) et [Model not found](https://code.claude.com/docs/fr/errors.md#model-not-found) pour les messages.

165 170 

166Si vous définissez le modèle avec le flag `--model`, la variable d'environnement `ANTHROPIC_MODEL`, ou le paramètre `model`, Claude Code ne le vérifie pas à l'avance, et une valeur mal orthographiée produit [There's an issue with the selected model](https://code.claude.com/docs/fr/errors.md#theres-an-issue-with-the-selected-model) à la première requête.171Si vous définissez le modèle avec le flag `--model`, la variable d'environnement `ANTHROPIC_MODEL`, ou le paramètre `model`, Claude Code ne rejette pas à l'avance une valeur mal orthographiée. La session démarre, et la première requête produit [There's an issue with the selected model](https://code.claude.com/docs/fr/errors.md#theres-an-issue-with-the-selected-model). Sur l'API Anthropic, une valeur qui ne commence pas par `claude-` et dont l'orthographe est proche d'un nom ou d'un alias de modèle peut également produire un [avertissement au démarrage qui le suggère](#fix-a-mistyped-model-name).

167 172 

168Lorsque le modèle demandé a une date de retrait programmée ou est automatiquement remappé à une version plus récente, Claude Code affiche un avertissement qui nomme le modèle demandé. Les sessions interactives l'affichent comme un avis de démarrage. À partir de v2.1.182, le même avertissement est écrit sur stderr en [mode non interactif](https://code.claude.com/docs/fr/headless.md) lors de l'utilisation du format de sortie texte par défaut. La vérification couvre également un `model` défini dans [frontmatter de sous-agent](https://code.claude.com/docs/fr/sub-agents.md). L'avertissement stderr est supprimé pour `--output-format json` et `stream-json` ; lisez le modèle réel à partir du champ `modelUsage` du [message de résultat](https://code.claude.com/docs/fr/headless.md#get-structured-output) à la place.173Lorsque le modèle demandé a une date de retrait programmée ou est automatiquement remappé à une version plus récente, Claude Code affiche un avertissement qui nomme le modèle demandé. Les sessions interactives l'affichent comme un avis de démarrage. À partir de v2.1.182, le même avertissement est écrit sur stderr en [mode non interactif](https://code.claude.com/docs/fr/headless.md) lors de l'utilisation du format de sortie texte par défaut. La vérification couvre également un `model` défini dans [frontmatter de sous-agent](https://code.claude.com/docs/fr/sub-agents.md). L'avertissement stderr est supprimé pour `--output-format json` et `stream-json` ; lisez le modèle réel à partir du champ `modelUsage` du [message de résultat](https://code.claude.com/docs/fr/headless.md#get-structured-output) à la place.

169 174 


225 230 

226## Restreindre la sélection de modèle231## Restreindre la sélection de modèle

227 232 

228Les administrateurs peuvent utiliser `availableModels` dans les [paramètres gérés ou de politique](https://code.claude.com/docs/fr/managed-settings.md) pour restreindre les modèles que les utilisateurs peuvent sélectionner. Les entrées correspondent à une famille de modèles telle que `sonnet`, un préfixe de version tel que `claude-sonnet-4-5`, ou un ID de modèle complet tel que `claude-sonnet-4-5-20250929`. Un préfixe de version correspond également aux ID de modèles ultérieurs qui l'étendent avec un autre segment, donc `claude-fable-5` permet à la fois Fable 5 et Fable 5.1, tandis que `claude-fable-5-1` permet uniquement Fable 5.1. Pour bloquer un modèle que la liste permet, ou pour faire en sorte que chaque entrée d'ID de modèle ne permette que la version qu'elle nomme, voir [Bloquer des modèles ou des versions spécifiques](#block-specific-models-or-versions).233Les administrateurs peuvent utiliser `availableModels` dans les [paramètres gérés ou de politique](https://code.claude.com/docs/fr/managed-settings.md) pour restreindre les modèles que les utilisateurs peuvent sélectionner. Chaque entrée correspond à l'un des éléments suivants :

234 

235* Une famille de modèles telle que `sonnet`

236* Un préfixe de version tel que `claude-sonnet-4-5`. Il correspond également aux ID de modèles ultérieurs qui l'étendent avec un autre segment. Par exemple, `claude-fable-5` permet Fable 5, Fable 5.1 et Fable 5.2, tandis que `claude-fable-5-1` permet uniquement Fable 5.1

237* Un ID de modèle complet tel que `claude-sonnet-4-5-20250929`

238 

239Pour bloquer un modèle que la liste permet, ou pour faire en sorte que chaque entrée d'ID de modèle ne permette que la version qu'elle nomme, voir [Bloquer des modèles ou des versions spécifiques](#block-specific-models-or-versions).

229 240 

230Sur les plateformes qui intègrent Claude Code et définissent [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](https://code.claude.com/docs/fr/env-vars), la configuration de modèle de l'hôte a priorité sur les paramètres de modèle gérés, tandis qu'une liste d'autorisation `availableModels` gérée reste en vigueur sauf si l'hôte fournit la sienne ; [Exceptions à la priorité des paramètres gérés](https://code.claude.com/docs/fr/settings.md#exceptions-to-managed-settings-precedence) indique quelles clés et variables l'hôte remplace.241Sur les plateformes qui intègrent Claude Code et définissent [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](https://code.claude.com/docs/fr/env-vars), la configuration de modèle de l'hôte a priorité sur les paramètres de modèle gérés, tandis qu'une liste d'autorisation `availableModels` gérée reste en vigueur sauf si l'hôte fournit la sienne ; [Exceptions à la priorité des paramètres gérés](https://code.claude.com/docs/fr/settings.md#exceptions-to-managed-settings-precedence) indique quelles clés et variables l'hôte remplace.

231 242 


465 476 

466Lorsque rien n'est enregistré sur votre compte, que les paramètres gérés [imposent la liste d'autorisation pour le modèle Default](#enforce-the-allowlist-for-the-default-model) et que le modèle par défaut du type de compte ne figure pas dans `availableModels`, `default` correspond au Default imposé plutôt qu'au modèle par défaut du type de compte indiqué ci-dessus. Lorsqu'un modèle par défaut de l'organisation et l'application de la liste s'appliquent tous les deux, le modèle par défaut de l'organisation remplace d'abord le modèle par défaut du type de compte, puis l'application de la liste s'y applique : un modèle par défaut de l'organisation figurant dans la liste d'autorisation est conservé, tandis qu'un modèle hors de la liste correspond au Default imposé.477Lorsque rien n'est enregistré sur votre compte, que les paramètres gérés [imposent la liste d'autorisation pour le modèle Default](#enforce-the-allowlist-for-the-default-model) et que le modèle par défaut du type de compte ne figure pas dans `availableModels`, `default` correspond au Default imposé plutôt qu'au modèle par défaut du type de compte indiqué ci-dessus. Lorsqu'un modèle par défaut de l'organisation et l'application de la liste s'appliquent tous les deux, le modèle par défaut de l'organisation remplace d'abord le modèle par défaut du type de compte, puis l'application de la liste s'y applique : un modèle par défaut de l'organisation figurant dans la liste d'autorisation est conservé, tandis qu'un modèle hors de la liste correspond au Default imposé.

467 478 

468Les modèles Fable ne sont le modèle par défaut du type de compte sur aucun forfait ni fournisseur. En choisir un avec `/model` l'enregistre comme modèle sélectionné dans vos paramètres utilisateur, de sorte que les sessions suivantes démarrent avec lui. Pour la modification ponctuelle que Claude Code apporte à une sélection Fable 5 enregistrée dans la v2.1.257, consultez [Travailler avec Fable](#work-with-fable).479> [!NOTE]

480>

481> Les modèles Fable ne sont le modèle par défaut du type de compte sur aucun forfait ni fournisseur. En choisir un avec `/model` l'enregistre comme modèle sélectionné dans vos paramètres utilisateur, de sorte que les sessions suivantes démarrent avec lui, à l'exception de la [modification ponctuelle apportée à une sélection Fable 5.1 enregistrée](#work-with-fable).

469 482 

470### Paramètre de modèle `opusplan`483### Paramètre de modèle `opusplan`

471 484 


521 534 

522Les modèles Fable, Opus 5.5, Sonnet 5.5 et Opus 5 fonctionnent avec des classifieurs de sécurité, qui signalent le plus souvent des contenus liés à la cybersécurité et à la biologie. Pour ces deux catégories, le modèle de secours dépend du modèle qui a refusé :535Les modèles Fable, Opus 5.5, Sonnet 5.5 et Opus 5 fonctionnent avec des classifieurs de sécurité, qui signalent le plus souvent des contenus liés à la cybersécurité et à la biologie. Pour ces deux catégories, le modèle de secours dépend du modèle qui a refusé :

523 536 

524* **Fable 5.1, Fable 5 et Opus 5.5** : les requêtes signalées pour la biologie sont réexécutées sur Opus 5, et celles signalées pour la cybersécurité sur Opus 4.8.537* **Modèles Fable et Opus 5.5** : les requêtes signalées pour la biologie sont réexécutées sur Opus 5, et celles signalées pour la cybersécurité sur Opus 4.8.

525* **Sonnet 5.5** : les requêtes signalées pour la cybersécurité sont réexécutées sur Sonnet 5. Les requêtes signalées pour la biologie se terminent plutôt par un refus, car Sonnet 5.5 n'a pas de modèle de secours pour la biologie.538* **Sonnet 5.5** : les requêtes signalées pour la cybersécurité sont réexécutées sur Sonnet 5. Les requêtes signalées pour la biologie se terminent plutôt par un refus, car Sonnet 5.5 n'a pas de modèle de secours pour la biologie.

526* **Opus 5** : les requêtes signalées pour la cybersécurité sont réexécutées sur Opus 4.8. Les requêtes signalées pour la biologie se terminent plutôt par un refus, car Opus 5 exécute ses propres classifieurs de biologie sans modèle de secours.539* **Opus 5** : les requêtes signalées pour la cybersécurité sont réexécutées sur Opus 4.8. Les requêtes signalées pour la biologie se terminent plutôt par un refus, car Opus 5 exécute ses propres classifieurs de biologie sans modèle de secours.

527 540 


582 595 

583Sur [Amazon Bedrock](https://code.claude.com/docs/fr/amazon-bedrock.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/fr/google-vertex-ai.md) et [Microsoft Foundry](https://code.claude.com/docs/fr/microsoft-foundry.md), les identifiants de modèle sont propres au fournisseur ; la bascule automatique ne fonctionne donc que lorsque Claude Code peut identifier chaque modèle concerné :596Sur [Amazon Bedrock](https://code.claude.com/docs/fr/amazon-bedrock.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/fr/google-vertex-ai.md) et [Microsoft Foundry](https://code.claude.com/docs/fr/microsoft-foundry.md), les identifiants de modèle sont propres au fournisseur ; la bascule automatique ne fonctionne donc que lorsque Claude Code peut identifier chaque modèle concerné :

584 597 

585* Claude Code doit reconnaître le modèle actuel comme modèle source de bascule. Fable 5.1 et Fable 5 sont reconnus lorsque l'identifiant du modèle contient `claude-fable-5`, correspond à la valeur de `ANTHROPIC_DEFAULT_FABLE_MODEL`, ou est mappé avec [`modelOverrides`](#override-model-ids-per-version). Opus 5.5, Sonnet 5.5 et Opus 5 sont reconnus par leur identifiant de modèle chez le fournisseur ou par un mappage [`modelOverrides`](#override-model-ids-per-version).598* Claude Code doit reconnaître le modèle actuel comme modèle source de bascule. Les modèles Fable sont reconnus lorsque l'identifiant du modèle contient `claude-fable-5`, correspond à la valeur de `ANTHROPIC_DEFAULT_FABLE_MODEL`, ou est mappé avec [`modelOverrides`](#override-model-ids-per-version). Opus 5.5, Sonnet 5.5 et Opus 5 sont reconnus par leur identifiant de modèle chez le fournisseur ou par un mappage [`modelOverrides`](#override-model-ids-per-version).

586* Une cible Opus doit être résolue dans votre déploiement, quel que soit le modèle qui a refusé : définissez `ANTHROPIC_DEFAULT_OPUS_MODEL`, ou conservez une entrée Opus 4.8 dans la liste des modèles du fournisseur. Sans cela, la bascule reste désactivée pour tous les modèles sources, y compris Sonnet 5.5, et les requêtes signalées se terminent par un refus.599* Une cible Opus doit être résolue dans votre déploiement, quel que soit le modèle qui a refusé : définissez `ANTHROPIC_DEFAULT_OPUS_MODEL`, ou conservez une entrée Opus 4.8 dans la liste des modèles du fournisseur. Sans cela, la bascule reste désactivée pour tous les modèles sources, y compris Sonnet 5.5, et les requêtes signalées se terminent par un refus.

587* Le modèle de secours de la catégorie signalée doit être résolu dans votre déploiement. Depuis un modèle Fable, Opus 5.5 ou Opus 5, si vous définissez `ANTHROPIC_DEFAULT_OPUS_MODEL`, les requêtes signalées sont réexécutées sur ce modèle pour chaque catégorie disposant d'un modèle de secours ; un signalement pour la biologie sur Opus 5 se termine toujours par un refus. Si vous ne le définissez pas, les requêtes signalées pour la cybersécurité sont réexécutées sur l'entrée Opus 4.8, et les requêtes signalées pour la biologie depuis un modèle Fable ou Opus 5.5 sur une entrée Opus 5. Depuis Sonnet 5.5, les requêtes signalées pour la cybersécurité sont réexécutées sur le modèle que vous définissez dans `ANTHROPIC_DEFAULT_SONNET_MODEL`, ou sur une entrée Sonnet 5 de la liste des modèles du fournisseur si vous ne le définissez pas.600* Le modèle de secours de la catégorie signalée doit être résolu dans votre déploiement. Depuis un modèle Fable, Opus 5.5 ou Opus 5, si vous définissez `ANTHROPIC_DEFAULT_OPUS_MODEL`, les requêtes signalées sont réexécutées sur ce modèle pour chaque catégorie disposant d'un modèle de secours ; un signalement pour la biologie sur Opus 5 se termine toujours par un refus. Si vous ne le définissez pas, les requêtes signalées pour la cybersécurité sont réexécutées sur l'entrée Opus 4.8, et les requêtes signalées pour la biologie depuis un modèle Fable ou Opus 5.5 sur une entrée Opus 5. Depuis Sonnet 5.5, les requêtes signalées pour la cybersécurité sont réexécutées sur le modèle que vous définissez dans `ANTHROPIC_DEFAULT_SONNET_MODEL`, ou sur une entrée Sonnet 5 de la liste des modèles du fournisseur si vous ne le définissez pas.

588 601 


596 609 

597#### Recherche en sécurité et charges de travail en biologie610#### Recherche en sécurité et charges de travail en biologie

598 611 

599Les charges de travail en sécurité offensive ou en biologie, notamment les tests d'intrusion, les exercices Capture the Flag (CTF) et les bases de code liées à la biologie, déclenchent fréquemment la bascule, souvent dès la première requête. Pour un travail substantiel en biologie sur Fable 5.1, Fable 5 ou Opus 5.5, la première requête signalée qui change de modèle fait passer la session sur Opus 5, et les requêtes ultérieures signalées pour la biologie s'y terminent par des refus, car Opus 5 n'a pas de modèle de secours pour la biologie. Sur Opus 5 et Sonnet 5.5, vous obtenez ces refus dès la première requête signalée.612Les charges de travail en sécurité offensive ou en biologie, notamment les tests d'intrusion, les exercices Capture the Flag (CTF) et les bases de code liées à la biologie, déclenchent fréquemment la bascule, souvent dès la première requête. Il s'agit d'un routage attendu pour ces domaines, et non d'un signalement de votre compte. Si votre organisation a besoin de capacités de classe Fable pour ce travail, renseignez-vous auprès de votre équipe de compte Anthropic sur les programmes d'accès de confiance.

600 613 

601Il s'agit d'un routage attendu pour ces domaines, et non d'un signalement de votre compte. Si votre organisation a besoin de capacités de classe Fable pour ce travail, renseignez-vous auprès de votre équipe de compte Anthropic sur les programmes d'accès de confiance.614Pour un travail substantiel en biologie sur un modèle Fable ou Opus 5.5, la première requête signalée qui change de modèle fait passer la session sur Opus 5. Les requêtes ultérieures signalées pour la biologie s'y terminent par des refus, car Opus 5 n'a pas de modèle de secours pour la biologie. Sur Opus 5 et Sonnet 5.5, ces refus commencent dès la première requête signalée.

602 615 

603### Ajuster le niveau d'effort616### Ajuster le niveau d'effort

604 617 


608 621 

609| Modèle | Niveaux |622| Modèle | Niveaux |

610| :- | :- |623| :- | :- |

611| Fable 5.1 et Fable 5 | `low`, `medium`, `high`, `xhigh`, `max` |624| Modèles Fable | `low`, `medium`, `high`, `xhigh`, `max` |

612| Opus 5.5, Sonnet 5.5, Haiku 5.5, Opus 5, Sonnet 5, Opus 4.8 et Opus 4.7 | `low`, `medium`, `high`, `xhigh`, `max` |625| Opus 5.5, Sonnet 5.5, Haiku 5.5, Opus 5, Sonnet 5, Opus 4.8 et Opus 4.7 | `low`, `medium`, `high`, `xhigh`, `max` |

613| Opus 4.6 et Sonnet 4.6 | `low`, `medium`, `high`, `max` |626| Opus 4.6 et Sonnet 4.6 | `low`, `medium`, `high`, `max` |

614 627 


6202. Un niveau que vous choisissez dans la session, par exemple avec `/effort`, le sélecteur `/model` ou [`applyFlagSettings()`](https://code.claude.com/docs/fr/agent-sdk/typescript#applyflagsettings)6332. Un niveau que vous choisissez dans la session, par exemple avec `/effort`, le sélecteur `/model` ou [`applyFlagSettings()`](https://code.claude.com/docs/fr/agent-sdk/typescript#applyflagsettings)

6213. Un lancement avec `--effort`6343. Un lancement avec `--effort`

6224. Vos paramètres : le niveau que vous avez enregistré pour le modèle ou une clé [`effortLevel`](https://code.claude.com/docs/fr/settings-reference#effortlevel), avec la priorité entre eux et entre fichiers de paramètres indiquée à [`modelSettings`](https://code.claude.com/docs/fr/settings-reference#modelsettings)6354. Vos paramètres : le niveau que vous avez enregistré pour le modèle ou une clé [`effortLevel`](https://code.claude.com/docs/fr/settings-reference#effortlevel), avec la priorité entre eux et entre fichiers de paramètres indiquée à [`modelSettings`](https://code.claude.com/docs/fr/settings-reference#modelsettings)

6235. L'effort par défaut du modèle : `high` sur tous les modèles qui prennent en charge l'effort, sauf qu'Opus 5.5, Sonnet 5.5 et Haiku 5.5 sont à `medium` par défaut et qu'Opus 4.7 est à `xhigh` par défaut. Si votre organisation définit un niveau d'effort par défaut pour son [modèle par défaut de l'organisation](#organization-default-model), ce niveau est la valeur par défaut lorsque vous exécutez ce modèle.6365. L'effort par défaut du modèle : Fable 5.2, Opus 5.5, Sonnet 5.5 et Haiku 5.5 sont à `medium` par défaut, et Opus 4.7 est à `xhigh` par défaut. Les autres modèles du [tableau des niveaux d'effort](#adjust-effort-level) sont à `high` par défaut. Si votre organisation définit un niveau d'effort par défaut pour son [modèle par défaut de l'organisation](#organization-default-model), ce niveau est la valeur par défaut lorsque vous exécutez ce modèle.

624 637 

625Après une bascule automatique de modèle, consultez [Niveau d'effort après une bascule](#effort-level-after-a-fallback) pour connaître le niveau qui s'applique. Pour les sous-agents et les coéquipiers, consultez [Niveau d'effort des sous-agents et des coéquipiers](#effort-level-of-subagents-and-teammates).638Après une bascule automatique de modèle, consultez [Niveau d'effort après une bascule](#effort-level-after-a-fallback) pour connaître le niveau qui s'applique. Pour les sous-agents et les coéquipiers, consultez [Niveau d'effort des sous-agents et des coéquipiers](#effort-level-of-subagents-and-teammates).

626 639 


671| Niveau | Quand l'utiliser |684| Niveau | Quand l'utiliser |

672| :- | :- |685| :- | :- |

673| `low` | Échanges rapides où vous examinez chaque résultat, comme un brainstorming, une première ébauche ou une petite modification comme un renommage |686| `low` | Échanges rapides où vous examinez chaque résultat, comme un brainstorming, une première ébauche ou une petite modification comme un renommage |

674| `medium` | La valeur par défaut sur Opus 5.5, Sonnet 5.5 et Haiku 5.5. Sur Opus 5.5 et Sonnet 5.5, il convient au travail d'ingénierie quotidien au périmètre clair, comme l'implémentation d'une nouvelle fonctionnalité. Sur les modèles dont la valeur par défaut est plus élevée, réduit la consommation de tokens pour un travail sensible aux coûts qui peut sacrifier un peu d'intelligence |687| `medium` | La valeur par défaut sur les modèles Fable 5.2, Opus 5.5, Sonnet 5.5 et Haiku 5.5. Sur Opus 5.5 et Sonnet 5.5, il convient au travail d'ingénierie quotidien au périmètre clair, comme l'implémentation d'une nouvelle fonctionnalité. Sur les modèles dont la valeur par défaut est plus élevée, réduit la consommation de tokens pour un travail sensible aux coûts qui peut sacrifier un peu d'intelligence |

675| `high` | Travail où la vérification compte ou où des cas limites sont probables, comme la correction d'un bug dans une base de code existante. La valeur par défaut sur tous les modèles sauf Opus 5.5, Sonnet 5.5, Haiku 5.5 et Opus 4.7 |688| `high` | Travail où la vérification compte ou où des cas limites sont probables, comme la correction d'un bug dans une base de code existante. La valeur par défaut sur les autres modèles du tableau des niveaux d'effort |

676| `xhigh` | Raisonnement plus approfondi pour une dépense de tokens plus élevée. La valeur par défaut sur Opus 4.7 |689| `xhigh` | Raisonnement plus approfondi pour une dépense de tokens plus élevée. La valeur par défaut sur Opus 4.7 |

677| `max` | Problèmes difficiles que vous voulez que Claude résolve sans vous, comme la recherche de vulnérabilités de sécurité. `max` peut présenter des rendements décroissants et tend à trop réfléchir ; testez-le donc avant de l'adopter largement |690| `max` | Problèmes difficiles que vous voulez que Claude résolve sans vous, comme la recherche de vulnérabilités de sécurité. `max` peut présenter des rendements décroissants et tend à trop réfléchir ; testez-le donc avant de l'adopter largement |

678| `ultracode` | Un paramètre de Claude Code plutôt qu'un niveau : planifie un [workflow dynamique](https://code.claude.com/docs/fr/workflows.md) pour chaque tâche substantielle, quel que soit le niveau d'effort |691| `ultracode` | Un paramètre de Claude Code plutôt qu'un niveau : planifie un [workflow dynamique](https://code.claude.com/docs/fr/workflows.md) pour chaque tâche substantielle, quel que soit le niveau d'effort |


691 704 

692* Saisissez-le de nouveau en dehors de tout élément comme des guillemets, des crochets, un chemin ou une commande, dans un prompt qui ne commence pas par `/`705* Saisissez-le de nouveau en dehors de tout élément comme des guillemets, des crochets, un chemin ou une commande, dans un prompt qui ne commence pas par `/`

693* Supprimez `CLAUDE_CODE_EFFORT_LEVEL` s'il est défini en dessous de `xhigh`, augmentez votre propre [`maxEffortLevel`](https://code.claude.com/docs/fr/settings-reference#maxeffortlevel) à `xhigh` ou plus, ou demandez à un administrateur de l'organisation d'augmenter la [limite de votre organisation](#organization-effort-limits)706* Supprimez `CLAUDE_CODE_EFFORT_LEVEL` s'il est défini en dessous de `xhigh`, augmentez votre propre [`maxEffortLevel`](https://code.claude.com/docs/fr/settings-reference#maxeffortlevel) à `xhigh` ou plus, ou demandez à un administrateur de l'organisation d'augmenter la [limite de votre organisation](#organization-effort-limits)

694* Exécutez `/model` dans votre session pour passer à un modèle Opus 5.5, Sonnet 5.5, Haiku 5.5 ou Fable 5.1. Là où le mot ne peut pas augmenter un tour, comme sur Amazon Bedrock, [définissez plutôt le niveau d'effort](#set-the-effort-level)707* Exécutez `/model` dans votre session pour passer à un modèle Opus 5.5, Sonnet 5.5, Haiku 5.5, Fable 5.2 ou Fable 5.1. Là où le mot ne peut pas augmenter un tour, comme sur Amazon Bedrock, [définissez plutôt le niveau d'effort](#set-the-effort-level)

695 708 

696#### Définir le niveau d'effort709#### Définir le niveau d'effort

697 710 


767 780 

768### Contexte étendu781### Contexte étendu

769 782 

770Fable 5.1, Fable 5, Sonnet 5 et versions ultérieures, Haiku 5.5, Opus 4.6 et versions ultérieures, et Sonnet 4.6 prennent en charge une [fenêtre de contexte de 1 million de tokens](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) pour les longues sessions sur de grandes bases de code.783Les longues sessions sur de grandes bases de code peuvent utiliser une [fenêtre de contexte de 1 million de tokens](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model). Les modèles Fable, Sonnet 5 et versions ultérieures, Haiku 5.5, Opus 4.6 et versions ultérieures, et Sonnet 4.6 la prennent en charge.

771 784 

772Fable 5.1, Fable 5, Sonnet 5 et versions ultérieures, Haiku 5.5, et Opus 4.7 et versions ultérieures fonctionnent par défaut avec la fenêtre de 1M, sans suffixe `[1m]` nécessaire. Cela inclut les sessions sur Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry, ainsi que les sessions [Claude apps gateway](https://code.claude.com/docs/fr/claude-apps-gateway). Pour les exécuter plutôt avec une fenêtre de 200K, consultez [Désactiver le contexte de 1M](#turn-off-1m-context).785Les modèles Fable, Sonnet 5 et versions ultérieures, Haiku 5.5, et Opus 4.7 et versions ultérieures fonctionnent par défaut avec la fenêtre de 1M, sans suffixe `[1m]` nécessaire. Cela inclut les sessions sur Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry, ainsi que les sessions [Claude apps gateway](https://code.claude.com/docs/fr/claude-apps-gateway). Pour les exécuter plutôt avec une fenêtre de 200K, consultez [Désactiver le contexte de 1M](#turn-off-1m-context).

773 786 

774Opus 4.6 et Sonnet 4.6 n'atteignent 1M que via leur variante `[1m]`, et l'accès à cette variante dépend de votre forfait. Sur les forfaits Max, Ultra, Team et Enterprise, y compris pour les sièges Team Standard et Team Premium, Opus 4.6 avec un contexte de 1M est inclus dans votre abonnement. Sonnet 4.6 avec un contexte de 1M nécessite des [crédits d'utilisation](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) sur tous les forfaits d'abonnement, y compris Max et Ultra.787Opus 4.6 et Sonnet 4.6 n'atteignent 1M que via leur variante `[1m]`, et l'accès à cette variante dépend de votre forfait. Sur les forfaits Max, Ultra, Team et Enterprise, y compris pour les sièges Team Standard et Team Premium, Opus 4.6 avec un contexte de 1M est inclus dans votre abonnement. Sonnet 4.6 avec un contexte de 1M nécessite des [crédits d'utilisation](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) sur tous les forfaits d'abonnement, y compris Max et Ultra.

775 788 


798 811 

799#### Fenêtre de contexte derrière une passerelle LLM812#### Fenêtre de contexte derrière une passerelle LLM

800 813 

801Si vous définissez `ANTHROPIC_BASE_URL` sur une [passerelle LLM](https://code.claude.com/docs/fr/llm-gateway) ou un autre proxy, Claude Code attribue à chaque modèle qu'il reconnaît la même fenêtre de contexte que celle dont le modèle dispose sur l'API Anthropic. Fable 5.1, Fable 5, Sonnet 5 et versions ultérieures, Haiku 5.5, et Opus 4.7 et versions ultérieures obtiennent la fenêtre de 1M sans variante `[1m]` à sélectionner, et un modèle qui n'atteint 1M que via sa variante `[1m]`, comme Opus 4.6, fonctionne à 200K sans elle. Claude Code ne peut pas détecter une limite inférieure imposée par la passerelle ou par le serveur situé derrière. Si votre passerelle rejette les requêtes au-delà de 200K tokens, définissez [`CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000`](https://code.claude.com/docs/fr/env-vars) dans l'environnement qui démarre Claude Code, afin que les sessions sur tous les modèles [se compactent à cette limite](#set-the-auto-compact-window).814Si vous définissez `ANTHROPIC_BASE_URL` sur une [passerelle LLM](https://code.claude.com/docs/fr/llm-gateway) ou un autre proxy, Claude Code attribue à chaque modèle qu'il reconnaît la même fenêtre de contexte que celle dont le modèle dispose sur l'API Anthropic. Les modèles Fable, Sonnet 5 et versions ultérieures, Haiku 5.5, et Opus 4.7 et versions ultérieures obtiennent la fenêtre de 1M sans variante `[1m]`. Un modèle qui n'atteint 1M que via sa variante `[1m]`, comme Opus 4.6, fonctionne à 200K sans elle.

815 

816Claude Code ne peut pas détecter une limite inférieure imposée par la passerelle ou par le serveur situé derrière. Si votre passerelle rejette les requêtes au-delà de 200K tokens, définissez [`CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000`](https://code.claude.com/docs/fr/env-vars) dans l'environnement qui démarre Claude Code, afin que les sessions sur tous les modèles [se compactent à cette limite](#set-the-auto-compact-window).

802 817 

803#### Désactiver le contexte de 1M818#### Désactiver le contexte de 1M

804 819 


885 900 

886Une fois que Claude Code reconnaît l'ID ou utilise la fenêtre que vous lui avez indiquée, l'avertissement n'apparaît plus lorsque vous démarrez une session sur cet ID.901Une fois que Claude Code reconnaît l'ID ou utilise la fenêtre que vous lui avez indiquée, l'avertissement n'apparaît plus lorsque vous démarrez une session sur cet ID.

887 902 

903#### Corriger un nom de modèle mal saisi

904 

905L'un ou l'autre de ces avertissements signifie que Claude Code ne reconnaît pas l'ID de modèle que vous avez défini, et que cet ID est très proche d'un nom ou d'un alias de modèle qu'il reconnaît :

906 

907```text theme={null}

908⚠ Model "<model>" isn't recognized · did you mean "<suggestion>"?

909Claude Code doesn't recognize the model "<model>". Did you mean "<suggestion>"?

910```

911 

912* **Vous avez mal saisi l'ID** : remplacez-le par la suggestion [là où vous définissez le modèle](#setting-your-model)

913* **L'ID est intentionnel** : laissez-le tel quel. La session l'envoie tel que vous l'avez écrit. Si la fenêtre de contexte que Claude Code suppose pour celui-ci est incorrecte, [corrigez la fenêtre](#correct-the-window-for-a-gateway-or-custom-model-id)

914 

888#### À quels ID s'applique `CLAUDE_CODE_MAX_CONTEXT_TOKENS`915#### À quels ID s'applique `CLAUDE_CODE_MAX_CONTEXT_TOKENS`

889 916 

890Sur une [passerelle LLM](https://code.claude.com/docs/fr/llm-gateway) ou un autre déploiement personnalisé, Claude Code peut supposer une fenêtre de contexte pour l'ID de modèle qui diffère de la fenêtre réelle du modèle, qu'il résolve ou non l'ID en un modèle Claude. Définissez [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](https://code.claude.com/docs/fr/env-vars) à la fenêtre que Claude Code devrait supposer à la place.917Sur une [passerelle LLM](https://code.claude.com/docs/fr/llm-gateway) ou un autre déploiement personnalisé, Claude Code peut supposer une fenêtre de contexte pour l'ID de modèle qui diffère de la fenêtre réelle du modèle, qu'il résolve ou non l'ID en un modèle Claude. Définissez [`CLAUDE_CODE_MAX_CONTEXT_TOKENS`](https://code.claude.com/docs/fr/env-vars) à la fenêtre que Claude Code devrait supposer à la place.


1099 1126 

1100| Version | Modification |1127| Version | Modification |

1101| :- | :- |1128| :- | :- |

1129| v2.1.321 | `fable` résout vers Fable 5.2, sauf dans les sessions de passerelle des applications Claude |

1130| v2.1.321 | `best` résout vers le même modèle que `opus`. Les versions antérieures utilisent le modèle vers lequel `fable` résout, là où Fable est disponible |

1102| v2.1.293 | `haiku` résout vers Haiku 5.5 sur l'API Anthropic |1131| v2.1.293 | `haiku` résout vers Haiku 5.5 sur l'API Anthropic |

1103| v2.1.284 | `sonnet` résout vers Sonnet 5.5 sur l'API Anthropic |1132| v2.1.284 | `sonnet` résout vers Sonnet 5.5 sur l'API Anthropic |

1104| v2.1.280 | `opus` résout vers Opus 5.5 sur l'API Anthropic, Claude Platform sur AWS, Amazon Bedrock et Agent Platform de Google Cloud |1133| v2.1.280 | `opus` résout vers Opus 5.5 sur l'API Anthropic, Claude Platform sur AWS, Amazon Bedrock et Agent Platform de Google Cloud |

permissions.md +2 −1

Details

253| :- | :- | :- |253| :- | :- | :- |

254| `Bash(curl *)` | `curl https://example.com` | `/usr/bin/curl https://example.com`, `sh -c 'curl https://example.com'` |254| `Bash(curl *)` | `curl https://example.com` | `/usr/bin/curl https://example.com`, `sh -c 'curl https://example.com'` |

255| `Bash(rm *)` | `rm -rf build/` | `/bin/rm -rf build/`, `bash -c 'rm -rf build/'` |255| `Bash(rm *)` | `rm -rf build/` | `/bin/rm -rf build/`, `bash -c 'rm -rf build/'` |

256| `Bash(git push *)` | `git push origin main` | `git -C . push origin main`, `git -c push.default=current push origin main`, `git 'push' origin main` |256| `Bash(git push *)` | `git push origin main` | `git -C . push origin main`, `git -c push.default=current push origin main` |

257 257 

258Vos autres règles et le mode de permission décident du sort des commandes de la dernière colonne.258Vos autres règles et le mode de permission décident du sort des commandes de la dernière colonne.

259 259 


273* **`docker` pointant vers un autre daemon** : les formes en lecture seule de `docker` déclenchent une demande lorsque la commande comporte un flag qui sélectionne un autre daemon, comme `-H`, `--context`, ou `--url` et `--connection` de Podman.273* **`docker` pointant vers un autre daemon** : les formes en lecture seule de `docker` déclenchent une demande lorsque la commande comporte un flag qui sélectionne un autre daemon, comme `-H`, `--context`, ou `--url` et `--connection` de Podman.

274* **`file` avec des flags qui ouvrent des chemins** : `file` déclenche une demande lorsqu'il reçoit `-m`/`--magic-file` ou `-f`/`--files-from`, car ces flags font ouvrir à `file` les chemins nommés dans la valeur du flag.274* **`file` avec des flags qui ouvrent des chemins** : `file` déclenche une demande lorsqu'il reçoit `-m`/`--magic-file` ou `-f`/`--files-from`, car ces flags font ouvrir à `file` les chemins nommés dans la valeur du flag.

275* **`ps` susceptible d'afficher des variables d'environnement** : `ps` déclenche une demande lorsque l'un de ses arguments pourrait agir comme l'option `e`, comme dans `ps auxe` ou `ps aux -e`, car cette option affiche les variables d'environnement des processus. `ps aux` et `ps -ef` s'exécutent sans demande. La vérification des formes avec tiret comme `ps aux -e` nécessite Claude Code v2.1.290 ou ultérieur.275* **`ps` susceptible d'afficher des variables d'environnement** : `ps` déclenche une demande lorsque l'un de ses arguments pourrait agir comme l'option `e`, comme dans `ps auxe` ou `ps aux -e`, car cette option affiche les variables d'environnement des processus. `ps aux` et `ps -ef` s'exécutent sans demande. La vérification des formes avec tiret comme `ps aux -e` nécessite Claude Code v2.1.290 ou ultérieur.

276* **`which` avec des flags allant au-delà de la recherche et de l'affichage** : `which` déclenche une demande lorsqu'il reçoit un flag comme `-i`/`--read-alias` ou `--read-functions`. `which node` et `which -a node` s'exécutent sans demande.

276* **Chemins réseau sous Windows** : une commande dont les arguments incluent un chemin réseau (UNC), comme `\\server\share\file`, déclenche une demande, car l'accès à un chemin réseau peut envoyer vos identifiants Windows à l'hôte qu'il désigne. La même vérification s'applique aux commandes de l'[outil PowerShell](https://code.claude.com/docs/fr/tools-reference.md#powershell-tool).277* **Chemins réseau sous Windows** : une commande dont les arguments incluent un chemin réseau (UNC), comme `\\server\share\file`, déclenche une demande, car l'accès à un chemin réseau peut envoyer vos identifiants Windows à l'hôte qu'il désigne. La même vérification s'applique aux commandes de l'[outil PowerShell](https://code.claude.com/docs/fr/tools-reference.md#powershell-tool).

277* **Écritures dans des variables spéciales du shell** : une commande qui définit, supprime ou parcourt certaines variables spéciales du shell, comme `PATH` ou `IFS`, déclenche une demande même lorsque le reste de la commande est en lecture seule.278* **Écritures dans des variables spéciales du shell** : une commande qui définit, supprime ou parcourt certaines variables spéciales du shell, comme `PATH` ou `IFS`, déclenche une demande même lorsque le reste de la commande est en lecture seule.

278* **Commandes que l'analyse ne peut pas interpréter** : lorsque Claude Code ne parvient pas à analyser entièrement une commande, il demande une approbation au lieu de considérer la commande comme étant en lecture seule. Les commandes de plus de 10 000 caractères déclenchent toujours une demande, car elles dépassent ce que l'analyse prend en charge.279* **Commandes que l'analyse ne peut pas interpréter** : lorsque Claude Code ne parvient pas à analyser entièrement une commande, il demande une approbation au lieu de considérer la commande comme étant en lecture seule. Les commandes de plus de 10 000 caractères déclenchent toujours une demande, car elles dépassent ce que l'analyse prend en charge.

Details

279* **Votre hook renvoie un `drop` après que son appel `next(e)` a laissé passer le prompt** : le tour s'exécute quand même, et le hook [échoue](#handle-a-hook-that-fails) avec un message qui inclut `a drop after its next() was answered`279* **Votre hook renvoie un `drop` après que son appel `next(e)` a laissé passer le prompt** : le tour s'exécute quand même, et le hook [échoue](#handle-a-hook-that-fails) avec un message qui inclut `a drop after its next() was answered`

280* **Votre hook lève une exception ou dépasse le délai** : Claude Code l'ignore et envoie le prompt. [Ajoutez un gestionnaire `.catch`](#handle-a-hook-that-fails) afin qu'un échec n'envoie pas un prompt que le hook aurait arrêté.280* **Votre hook lève une exception ou dépasse le délai** : Claude Code l'ignore et envoie le prompt. [Ajoutez un gestionnaire `.catch`](#handle-a-hook-that-fails) afin qu'un échec n'envoie pas un prompt que le hook aurait arrêté.

281 281 

282[D'autres événements](https://code.claude.com/docs/fr/plugins/mods/reference.md#prompts-and-what-claude-reads) couvrent le reste de ce que lit Claude : `prompt.section` pour chaque section du prompt système, `prompt.context` pour le contexte envoyé avec le premier message, et `skill.prompt` pour le texte d'un skill. Un texte issu de ces hooks qui change d'une requête à l'autre [invalide le cache des prompts](https://code.claude.com/docs/fr/prompt-caching.md). Dans un hook `skill.prompt`, vous pouvez également lire [le plugin ou le fichier dont provient le skill](https://code.claude.com/docs/fr/plugins/mods/reference.md#skill-prompt-fields).282[D'autres événements](https://code.claude.com/docs/fr/plugins/mods/reference.md#prompts-and-what-claude-reads) couvrent le reste de ce que lit Claude : `prompt.section` pour chaque section du prompt système, `prompt.context` pour le contexte envoyé avec le premier message, et `skill.prompt` pour le texte d'un skill. Pour modifier une section après le début d'une conversation, consultez [Envoyer une section de prompt système ou une description d'outil modifiée](https://code.claude.com/docs/fr/plugins/mods/reference.md#break-prompt-cache). Dans un hook `skill.prompt`, vous pouvez également lire [le plugin ou le fichier dont provient le skill](https://code.claude.com/docs/fr/plugins/mods/reference.md#skill-prompt-fields).

283 283 

284### Suivre un tour284### Suivre un tour

285 285 

Details

197>197>

198> Pour dessiner dans la bande, filtrez sur `{ component: 'AbovePrompt' }`.198> Pour dessiner dans la bande, filtrez sur `{ component: 'AbovePrompt' }`.

199 199 

200Un mod peut aussi [placer sa propre ligne dans la transcription](#place-a-row-in-the-transcript).

201 

200### Modifier ce que Claude Code dessine déjà202### Modifier ce que Claude Code dessine déjà

201 203 

202Claude Code dessine lui-même la plupart de son interface : les messages, les lignes d'appels d'outils, le spinner, et plus encore. Chacune de ces parties est aussi un point de rendu, qu'un mod peut donc restyler ou remplacer. Pour en modifier une, filtrez votre hook `ui.render` sur son nom tiré de ce tableau :204Claude Code dessine lui-même la plupart de son interface : les messages, les lignes d'appels d'outils, le spinner, et plus encore. Chacune de ces parties est aussi un point de rendu, qu'un mod peut donc restyler ou remplacer. Pour en modifier une, filtrez votre hook `ui.render` sur son nom tiré de ce tableau :


349* **Suggestions de prompt** : `$.prompt.suggest` se résout avec `isShown: false` et n'affiche rien, car le panneau réserve le texte de suggestion estompé de la zone de prompt aux propres suggestions de Claude.351* **Suggestions de prompt** : `$.prompt.suggest` se résout avec `isShown: false` et n'affiche rien, car le panneau réserve le texte de suggestion estompé de la zone de prompt aux propres suggestions de Claude.

350* **Limites de texte** : le panneau coupe une barre de statut à 200 caractères ou deux lignes, et un toast à 500 caractères.352* **Limites de texte** : le panneau coupe une barre de statut à 200 caractères ou deux lignes, et un toast à 500 caractères.

351 353 

354### Placer une ligne dans la transcription

355 

356Une ligne est un élément que votre mod ajoute à la transcription dans le terminal, après le dernier message. Elle reste à cet endroit au fil de la conversation, et Claude ne la voit pas. `$.ui.place` nécessite Claude Code v2.1.314 ou ultérieur.

357 

358**1. Placer la ligne**

359 

360Appelez [`$.ui.place`](https://code.claude.com/docs/fr/plugins/mods/reference#mods-api-methods) avec un `id`. L'`id` est un nom que vous inventez pour la ligne, comme `build-status`. Il peut comporter de 1 à 64 lettres, chiffres, `_` ou `-`, et chaque ligne que votre mod a dans la transcription a besoin du sien.

361 

362**2. Dessiner la ligne**

363 

364Dessinez la ligne sur le point de rendu [`Placed`](https://code.claude.com/docs/fr/plugins/mods/reference#render-sites).

365 

366Cet exemple ajoute une commande `/build-status`. Lorsque l'utilisateur exécute la commande, le mod ajoute une ligne qui affiche `Build: passing`. Le texte est fixe pour que l'exemple reste court ; un vrai mod dessinerait son propre résultat :

367 

368```javascript theme={null}

369export function register(on) {

370 on('session.start', async ($, e, next) => {

371 await $.command.register({ name: 'build-status', description: 'Show the build status' })

372 return next(e)

373 })

374 

375 on('command.run', { command: 'build-status' }, async ($) => {

376 const placed = await $.ui.place({ id: 'build-status' })

377 // Where nothing draws the row, reply with text instead

378 return placed.isPlaced ? {} : { text: 'Build: passing' }

379 })

380 

381 on('ui.render', { component: 'Placed' }, async ($, e, next) => {

382 // This hook runs for every mod's rows, and another mod can use the same id

383 if (e.props.plugin !== $.plugin.name || e.props.id !== 'build-status') return next(e)

384 const { Text } = $.ui.resolve(e)

385 return Text({ children: ['Build: passing'] })

386 })

387}

388```

389 

390Pour essayer l'exemple, placez ce code dans un [mod](https://code.claude.com/docs/fr/plugins/mods/create.md). Dans une session de terminal, exécutez `/build-status` dans le prompt de Claude Code. `Build: passing` apparaît sous forme de ligne à la fin de la transcription.

391 

392L'appel n'affiche pas toujours de ligne, et une ligne peut disparaître plus tard ; gérez donc ces cas dans votre mod :

393 

394* **Le résultat** : `{ isPlaced: true, requestId }` lorsque le terminal dessine la ligne. Sinon, `isPlaced` vaut `false` et `reason` en indique la raison, comme dans `no attached surface draws placed rows yet`. L'une des raisons possibles est la [limite du nombre de lignes](https://code.claude.com/docs/fr/plugins/mods/reference.md#limits) qu'un mod peut avoir en même temps.

395* **Un second appel avec le même `id`** : tant que la première ligne est encore dans la transcription, l'appel n'ajoute aucune ligne et se résout avec le `requestId` de cette ligne. Pour modifier ce qu'affiche la ligne, [redessinez la ligne](#redraw-when-something-changes).

396* **Quand la ligne disparaît** : lorsque la conversation se termine, lorsque l'utilisateur revient en arrière au-delà de la ligne, ou, en dehors du [rendu plein écran](https://code.claude.com/docs/fr/fullscreen.md), lorsque la conversation est compactée. `--resume` ne rétablit pas la ligne. Pour afficher à nouveau la ligne, appelez de nouveau `$.ui.place`.

397 

398### Placer un arrière-plan derrière la conversation

399 

400> [!NOTE]

401>

402> `$.theme.set` et `$.theme.clear` remplacent `$.ui.backdrop`, que Claude Code v2.1.319 a supprimé. Remplacez `$.ui.backdrop({ id: 'your-backdrop' })` par `$.theme.set({ backdrop: { id: 'your-backdrop' } })`, et `$.ui.backdrop(undefined)` par `$.theme.clear()`, qui supprime l'arrière-plan de n'importe quel mod.

403 

404Pour placer un arrière-plan derrière la conversation dans l'application Desktop ou l'application mobile, appelez [`$.theme.set`](https://code.claude.com/docs/fr/plugins/mods/reference#mods-api-methods) avec un `backdrop`, puis dessinez l'arrière-plan sur le point de rendu [`Backdrop`](https://code.claude.com/docs/fr/plugins/mods/reference#render-sites). Pour retirer l'arrière-plan, appelez `$.theme.clear()`. Le terminal ne dessine aucun arrière-plan. `$.theme.set` et `$.theme.clear` nécessitent Claude Code v2.1.319 ou ultérieur.

405 

406Ce mod définit un arrière-plan au démarrage de la session, dessine l'arrière-plan et ajoute une commande `/plain` qui retire l'arrière-plan :

407 

408```javascript theme={null}

409export function register(on) {

410 // Neither a reload of this mod nor --resume keeps the backdrop, so set it here

411 on('session.start', async ($, e, next) => {

412 await $.theme.set({ backdrop: { id: 'night-sky', colorScheme: 'dark' } })

413 await $.command.register({ name: 'plain', description: 'Take the backdrop off' })

414 return next(e)

415 })

416 

417 on('ui.render', { component: 'Backdrop' }, async ($, e, next) => {

418 // This hook runs for every mod's backdrop, and another mod can use the same id

419 if (e.props.plugin !== $.plugin.name || e.props.id !== 'night-sky') return next(e)

420 const { Box, Text } = $.ui.resolve(e)

421 return Box({ backgroundColor: 'blue', children: [Text({ children: ['Night sky'] })] })

422 })

423 

424 on('command.run', { command: 'plain' }, async ($) => {

425 const cleared = await $.theme.clear()

426 return { text: cleared.reason }

427 })

428}

429```

430 

431Pour essayer l'exemple, placez ce code dans un [mod](https://code.claude.com/docs/fr/plugins/mods/create.md) et démarrez une session dans l'application Desktop ou l'application mobile. Pour retirer l'arrière-plan, exécutez `/plain` dans le prompt de Claude Code. La transcription affiche `the theme is cleared` après le nom du mod, comme dans `night-sky: the theme is cleared` pour un mod nommé `night-sky`.

432 

433Vérifiez ce qu'accepte `backdrop`, ce que vous indique le résultat de l'appel, et ce que les autres mods peuvent modifier :

434 

435* **Les champs de `backdrop`** : `id`, un [nom](https://code.claude.com/docs/fr/plugins/mods/reference.md#limits) de votre choix, est obligatoire, et les autres champs sont facultatifs. `colorScheme` vaut `'light'` ou `'dark'` et indique si votre dessin est clair ou sombre. Pour `glass`, consultez [les types de votre build](https://code.claude.com/docs/fr/plugins/mods/create.md#get-the-types-for-your-build).

436* **Si l'arrière-plan est dessiné** : `$.theme.set` se résout avec `isDrawn: true` lorsqu'une application Desktop ou mobile connectée à la session indique qu'elle dessine les arrière-plans. Sinon, `isDrawn` vaut `false` et `reason` en indique la raison.

437* **Un seul arrière-plan par session** : un appel à `$.theme.set` remplace l'arrière-plan de la session et `$.theme.clear()` supprime cet arrière-plan, quel que soit le mod qui l'a défini. N'appelez `$.theme.clear()` que lorsque l'utilisateur le demande.

438 

352## Créer un arbre à partir d'éléments439## Créer un arbre à partir d'éléments

353 440 

354Ce que renvoie un hook `ui.render` est un arbre d'éléments : une description de ce qu'il faut dessiner, composée de boîtes, de texte et de contrôles imbriqués les uns dans les autres. Vous décrivez le dessin, et Claude Code l'affiche dans l'application que l'utilisateur a ouverte : le terminal, l'application Desktop ou l'extension VS Code.441Ce que renvoie un hook `ui.render` est un arbre d'éléments : une description de ce qu'il faut dessiner, composée de boîtes, de texte et de contrôles imbriqués les uns dans les autres. Vous décrivez le dessin, et Claude Code l'affiche dans l'application que l'utilisateur a ouverte : le terminal, l'application Desktop ou l'extension VS Code.

Details

57| :- | :- | :- |57| :- | :- | :- |

58| [`tool.call`](https://code.claude.com/docs/fr/plugins/mods/events#guard-or-change-a-tool-call) | Un outil est sur le point de s'exécuter | `next(e)`, `{ deny: reason }` ou `{ result }` |58| [`tool.call`](https://code.claude.com/docs/fr/plugins/mods/events#guard-or-change-a-tool-call) | Un outil est sur le point de s'exécuter | `next(e)`, `{ deny: reason }` ou `{ result }` |

59| [`tool.check`](https://code.claude.com/docs/fr/plugins/mods/events#where-settings-hooks-run-in-the-order) | Claude Code décide si un appel d'outil peut s'exécuter, après les hooks `tool.call` et `PreToolUse`. `next(e)` se résout avec la décision à laquelle ont abouti les règles, le mode de permission et ces hooks. | `next(e)` ou `{ decision }`, avec `decision` défini sur `allow`, `ask` ou `deny` et un `reason` facultatif |59| [`tool.check`](https://code.claude.com/docs/fr/plugins/mods/events#where-settings-hooks-run-in-the-order) | Claude Code décide si un appel d'outil peut s'exécuter, après les hooks `tool.call` et `PreToolUse`. `next(e)` se résout avec la décision à laquelle ont abouti les règles, le mode de permission et ces hooks. | `next(e)` ou `{ decision }`, avec `decision` défini sur `allow`, `ask` ou `deny` et un `reason` facultatif |

60| `tool.describe` | Une fois pour chaque outil, lorsque sa description est envoyée à Claude pour la première fois. Une seconde fois pour un outil MCP lorsque Claude le charge via la [recherche d'outils](https://code.claude.com/docs/fr/mcp.md#scale-with-mcp-tool-search), avec `e.description` défini sur le texte que Claude lit pour l'outil chargé. | `{ description }`, avec éventuellement `isDeferred` défini sur `true` pour placer l'outil derrière la recherche d'outils ou sur `false` pour le charger dès le départ |60| `tool.describe` | Une fois pour chaque outil, lorsque sa description est envoyée à Claude pour la première fois. Une seconde fois pour un outil MCP lorsque Claude le charge via la [recherche d'outils](https://code.claude.com/docs/fr/mcp.md#scale-with-mcp-tool-search), avec `e.description` défini sur le texte que Claude lit pour l'outil chargé. | `{ description }`, avec éventuellement `isDeferred` défini sur `true` pour placer l'outil derrière la recherche d'outils ou sur `false` pour le charger dès le départ. Ajoutez [`breakPromptCache: true`](#break-prompt-cache) pour envoyer une description modifiée au tour suivant. |

61 61 

62#### Champs d'agent et d'organisation sur `tool.check`62#### Champs d'agent et d'organisation sur `tool.check`

63 63 


85| `prompt.edit` | L'utilisateur modifie la zone de prompt | `next(e)` |85| `prompt.edit` | L'utilisateur modifie la zone de prompt | `next(e)` |

86| `prompt.autocomplete` | L'utilisateur saisit du texte dans la zone de prompt et un mot se termine au niveau du curseur. `e.token` est ce mot. Claude Code n'attend pas le hook : ses propres lignes d'autocomplétion s'affichent en premier. | `{ suggestions }`, une liste de lignes `{ text, label, description }` affichées sous celles de Claude Code. Choisir une ligne remplace le mot par son `text`. |86| `prompt.autocomplete` | L'utilisateur saisit du texte dans la zone de prompt et un mot se termine au niveau du curseur. `e.token` est ce mot. Claude Code n'attend pas le hook : ses propres lignes d'autocomplétion s'affichent en premier. | `{ suggestions }`, une liste de lignes `{ text, label, description }` affichées sous celles de Claude Code. Choisir une ligne remplace le mot par son `text`. |

87| `prompt.compose` | Claude Code génère un prompt système | `{ sections }`, une liste de `{ id, text, scope }` dans l'ordre d'envoi |87| `prompt.compose` | Claude Code génère un prompt système | `{ sections }`, une liste de `{ id, text, scope }` dans l'ordre d'envoi |

88| [`prompt.section`](https://code.claude.com/docs/fr/plugins/mods/events#rewrite-or-add-to-a-prompt) | Une fois pour chaque section nommée du prompt système. `e.name` est l'`id` de la section dans `prompt.compose`. | `{ text }`, ou `{ text: null }` pour omettre la section |88| [`prompt.section`](https://code.claude.com/docs/fr/plugins/mods/events#rewrite-or-add-to-a-prompt) | Une fois pour chaque section nommée du prompt système. `e.name` est l'`id` de la section dans `prompt.compose`. | `{ text }`, ou `{ text: null }` pour omettre la section. Ajoutez [`breakPromptCache: true`](#break-prompt-cache) pour envoyer une section modifiée au tour suivant. |

89| [`prompt.context`](https://code.claude.com/docs/fr/plugins/mods/events#rewrite-or-add-to-a-prompt) | Une fois pour chaque conversation, pour le contexte envoyé avec le premier message | `{ blocks }` |89| [`prompt.context`](https://code.claude.com/docs/fr/plugins/mods/events#rewrite-or-add-to-a-prompt) | Une fois pour chaque conversation, pour le contexte envoyé avec le premier message | `{ blocks }` |

90| `prompt.attachment` | Claude Code ajoute un message de sa propre initiative pour Claude, tel qu'un rappel. `e.type` nomme le type, et pour les types que déclarent les déclarations de types, `e.detail` contient les informations à partir desquelles le texte a été rédigé. | `{ text }`, ou `{ text: null }` pour l'omettre |90| `prompt.attachment` | Claude Code ajoute un message de sa propre initiative pour Claude, tel qu'un rappel. `e.type` nomme le type, et pour les types que déclarent les déclarations de types, `e.detail` contient les informations à partir desquelles le texte a été rédigé. | `{ text }`, ou `{ text: null }` pour l'omettre |

91| `prompt.mention` | Claude Code est sur le point de lire un fichier qu'un prompt mentionne avec @. Nécessite Claude Code v2.1.290 ou une version ultérieure. | `next({ ...e, path })` pour lire un autre fichier, ou `{ deny: reason }` |91| `prompt.mention` | Claude Code est sur le point de lire un fichier qu'un prompt mentionne avec @. Nécessite Claude Code v2.1.290 ou une version ultérieure. | `next({ ...e, path })` pour lire un autre fichier, ou `{ deny: reason }` |


108 108 

109Sur `skill.prompt`, `e.source`, `e.pluginName`, `e.path`, `e.frontmatter` et `e.frontmatterProblem` nécessitent Claude Code v2.1.299 ou une version ultérieure.109Sur `skill.prompt`, `e.source`, `e.pluginName`, `e.path`, `e.frontmatter` et `e.frontmatterProblem` nécessitent Claude Code v2.1.299 ou une version ultérieure.

110 110 

111#### Envoyer une section de prompt système ou une description d'outil modifiée avec `breakPromptCache`

112 

113Pour modifier une section ou une description d'outil dans une conversation en cours, appelez `$.ui.invalidate('prompt.section')` ou `$.ui.invalidate('tool.describe')` afin que votre hook s'exécute à nouveau. Renvoyez `{ text, breakPromptCache: true }` ou `{ description, breakPromptCache: true }` depuis celui-ci. Sans ce champ, Claude continue de lire le texte [enregistré avec la conversation](https://code.claude.com/docs/fr/cli-reference.md#system-prompt-flags-in-resumed-conversations) pour une section ou un outil chargé dès le départ, jusqu'à une nouvelle conversation ou une [compaction](https://code.claude.com/docs/fr/prompt-caching.md#compacting-the-conversation).

114 

115Le texte modifié parvient à Claude au tour suivant, et le [cache de prompts](https://code.claude.com/docs/fr/prompt-caching.md) repart de zéro : ce tour est donc plus lent et plus coûteux. Le champ nécessite Claude Code v2.1.321 ou une version ultérieure. De la v2.1.299 jusqu'à la v2.1.321, une conversation en cours recevait le texte modifié au tour suivant.

116 

111### Commandes et configuration117### Commandes et configuration

112 118 

113| Événement | Se déclenche lorsque | Un hook peut renvoyer |119| Événement | Se déclenche lorsque | Un hook peut renvoyer |


212| Namespace | Méthodes |218| Namespace | Méthodes |

213| :- | :- |219| :- | :- |

214| `$.plugin` | `name`, `root` : le nom et le répertoire de ce plugin |220| `$.plugin` | `name`, `root` : le nom et le répertoire de ce plugin |

215| [`$.ui`](https://code.claude.com/docs/fr/plugins/mods/interface#pick-where-to-draw) | `resolve`, `invalidate`, `open`, `close`, `panes`, `focus`, `scroll`, `toast`, `notify`, `status`, `log`, `notice`, `ask`, `copy`, `selection`, `blit` |221| [`$.ui`](https://code.claude.com/docs/fr/plugins/mods/interface#pick-where-to-draw) | `resolve`, `invalidate`, `open`, `close`, `panes`, [`place`](https://code.claude.com/docs/fr/plugins/mods/interface#place-a-row-in-the-transcript), `focus`, `scroll`, `toast`, `notify`, `status`, `log`, `notice`, `ask`, `copy`, `selection`, `blit`, `view`. `view` nécessite Claude Code v2.1.300 ou une version ultérieure et `place` v2.1.314 ou une version ultérieure. |

222| [`$.theme`](https://code.claude.com/docs/fr/plugins/mods/interface#put-a-backdrop-behind-the-conversation) | `set`, `clear` : définir un arrière-plan que l'application Desktop ou mobile dessine, et retirer cet arrière-plan. Nécessite Claude Code v2.1.319 ou une version ultérieure. |

216| [`$.command`](https://code.claude.com/docs/fr/plugins/mods/api#add-a-command) | `register`, `run`, `list` |223| [`$.command`](https://code.claude.com/docs/fr/plugins/mods/api#add-a-command) | `register`, `run`, `list` |

217| [`$.tool`](https://code.claude.com/docs/fr/plugins/mods/api#add-a-tool) | `register`, `call`, `check`, `list` |224| [`$.tool`](https://code.claude.com/docs/fr/plugins/mods/api#add-a-tool) | `register`, `call`, `check`, `list` |

218| `$.agent` | `register`, `spawn`, `list`. `list()` renvoie les sous-agents et coéquipiers de cette session, chacun avec un `status` parmi `pending`, `running`, `waiting`, `idle`, `completed`, `failed` ou `killed`, où `idle` et `waiting` nécessitent Claude Code v2.1.289 ou une version ultérieure. |225| `$.agent` | `register`, `spawn`, `list`. `list()` renvoie les sous-agents et coéquipiers de cette session, chacun avec un `status` parmi `pending`, `running`, `waiting`, `idle`, `completed`, `failed` ou `killed`, où `idle` et `waiting` nécessitent Claude Code v2.1.289 ou une version ultérieure. |


243| :- | :- | :- | :- |250| :- | :- | :- | :- |

244| [`Pane`](https://code.claude.com/docs/fr/plugins/mods/interface#pick-where-to-draw) | `title`, `isFocused`, `bodyColumns`, `placement`, `scroll`, `view` | L'`id` du volet | Terminal, Desktop, VS Code |251| [`Pane`](https://code.claude.com/docs/fr/plugins/mods/interface#pick-where-to-draw) | `title`, `isFocused`, `bodyColumns`, `placement`, `scroll`, `view` | L'`id` du volet | Terminal, Desktop, VS Code |

245| [`AbovePrompt`](https://code.claude.com/docs/fr/plugins/mods/interface#pick-where-to-draw) | `hasSurvey`, `isWorking`, `maxRows`, `bodyColumns`, `scroll`, `view` | Une seule instance | Terminal, Desktop |252| [`AbovePrompt`](https://code.claude.com/docs/fr/plugins/mods/interface#pick-where-to-draw) | `hasSurvey`, `isWorking`, `maxRows`, `bodyColumns`, `scroll`, `view` | Une seule instance | Terminal, Desktop |

253| [`Placed`](https://code.claude.com/docs/fr/plugins/mods/interface#place-a-row-in-the-transcript) | `id`, `plugin`, `onScreen` | Le `requestId` renvoyé par `$.ui.place` | Terminal |

254| [`Backdrop`](https://code.claude.com/docs/fr/plugins/mods/interface#put-a-backdrop-behind-the-conversation) | `id`, `plugin`, `glass`, `colorScheme` | `backdrop` | Surfaces `desktop` et `mobile`. Votre hook s'exécute lorsque l'application Desktop ou mobile demande à dessiner un arrière-plan. |

246| `UserMessage` | `text`, `origin`, `isExpanded`, et `task` ou `from` selon l'origine | L'id du message | Terminal, Desktop, VS Code |255| `UserMessage` | `text`, `origin`, `isExpanded`, et `task` ou `from` selon l'origine | L'id du message | Terminal, Desktop, VS Code |

247| `AssistantMessage` | Le texte de la réponse | L'id du message | Terminal, Desktop, VS Code |256| `AssistantMessage` | Le texte de la réponse | L'id du message | Terminal, Desktop, VS Code |

248| `ToolUse`, `ToolResult`, `ToolGroup` | Le nom, l'entrée et le résultat de l'outil | L'id de l'appel d'outil | Terminal, Desktop, VS Code |257| `ToolUse`, `ToolResult`, `ToolGroup` | Le nom, l'entrée et le résultat de l'outil | L'id de l'appel d'outil | Terminal, Desktop, VS Code |


399| Redessins `$.ui.invalidate('ui.render')` | Limités à 10 par seconde, ou 30 dans le terminal pour le volet visible, le bandeau déployé et la ligne d'indication sous le prompt. Les appels plus rapprochés sont regroupés. |408| Redessins `$.ui.invalidate('ui.render')` | Limités à 10 par seconde, ou 30 dans le terminal pour le volet visible, le bandeau déployé et la ligne d'indication sous le prompt. Les appels plus rapprochés sont regroupés. |

400| `$.ui.toast` | Affiché pendant 4 secondes sauf si vous passez `{ timeoutMs }`. Dans le [moteur de rendu classique](https://code.claude.com/docs/fr/fullscreen.md#enable-fullscreen-rendering), un toast plus récent d'un mod peut [prendre la place de son toast plus ancien](https://code.claude.com/docs/fr/plugins/mods/troubleshoot.md#a-toast-doesn’t-appear) en cours d'affichage ou en attente d'affichage. |409| `$.ui.toast` | Affiché pendant 4 secondes sauf si vous passez `{ timeoutMs }`. Dans le [moteur de rendu classique](https://code.claude.com/docs/fr/fullscreen.md#enable-fullscreen-rendering), un toast plus récent d'un mod peut [prendre la place de son toast plus ancien](https://code.claude.com/docs/fr/plugins/mods/troubleshoot.md#a-toast-doesn’t-appear) en cours d'affichage ou en attente d'affichage. |

401| Un volet ouvert sans que l'utilisateur l'ait demandé | Placé à partir de 144 colonnes de terminal, 110 une fois que l'utilisateur l'a ouvert une fois |410| Un volet ouvert sans que l'utilisateur l'ait demandé | Placé à partir de 144 colonnes de terminal, 110 une fois que l'utilisateur l'a ouvert une fois |

411| Lignes issues de `$.ui.place` qu'un même mod possède dans une conversation à un instant donné | 500. À la limite, un appel avec un nouvel `id` se résout en `{ isPlaced: false, reason: 'a plugin holds at most 500 placed rows' }`. |

402| Profondeur d'imbrication des arguments d'un appel à l'API des mods | 28 000 niveaux. Au-delà, l'appel est rejeté avec un message se terminant par `nesting deeper than 28000 levels is not supported`. Nécessite Claude Code v2.1.299 ou une version ultérieure. |412| Profondeur d'imbrication des arguments d'un appel à l'API des mods | 28 000 niveaux. Au-delà, l'appel est rejeté avec un message se terminant par `nesting deeper than 28000 levels is not supported`. Nécessite Claude Code v2.1.299 ou une version ultérieure. |

403| Profondeur d'imbrication d'un événement modifié passé à `next`, en dehors des [hooks générateurs asynchrones](#events) tels qu'un hook sur `turn.step` | 28 000 niveaux. Au-delà, `next` est rejeté avec un message se terminant par `nesting deeper than 28000 levels is not supported`. Nécessite Claude Code v2.1.299 ou une version ultérieure. |413| Profondeur d'imbrication d'un événement modifié passé à `next`, en dehors des [hooks générateurs asynchrones](#events) tels qu'un hook sur `turn.step` | 28 000 niveaux. Au-delà, `next` est rejeté avec un message se terminant par `nesting deeper than 28000 levels is not supported`. Nécessite Claude Code v2.1.299 ou une version ultérieure. |

404| Profondeur d'imbrication de la valeur de retour d'un hook, en dehors de `ui.render`, `ui.resolve` et des hooks générateurs asynchrones | 28 000 niveaux. Au-delà, le résultat du hook est refusé, et [l'avis qui le signale](https://code.claude.com/docs/fr/plugins/mods/troubleshoot.md#find-out-why-a-mod-does-nothing) inclut `nesting deeper than 28000 levels is not supported`. Nécessite Claude Code v2.1.299 ou une version ultérieure. |414| Profondeur d'imbrication de la valeur de retour d'un hook, en dehors de `ui.render`, `ui.resolve` et des hooks générateurs asynchrones | 28 000 niveaux. Au-delà, le résultat du hook est refusé, et [l'avis qui le signale](https://code.claude.com/docs/fr/plugins/mods/troubleshoot.md#find-out-why-a-mod-does-nothing) inclut `nesting deeper than 28000 levels is not supported`. Nécessite Claude Code v2.1.299 ou une version ultérieure. |

405| Portées, telles que les fonctions, les blocs et les boucles, imbriquées les unes dans les autres dans un même fichier d'un module de hooks | 2 000 |415| Portées, telles que les fonctions, les blocs et les boucles, imbriquées les unes dans les autres dans un même fichier d'un module de hooks | 2 000 |

406| Noms de commandes, d'outils, de types de sous-agents et de volets | Lettres, chiffres, `_` et `-`, jusqu'à 64 caractères |416| Noms de commandes, d'outils, de types de sous-agents et de volets, ainsi que l'`id` d'une ligne placée ou d'un arrière-plan | Lettres, chiffres, `_` et `-`, jusqu'à 64 caractères |

407| Un test `claude plugin test` | 5 secondes sauf si le test définit `timeoutMs` |417| Un test `claude plugin test` | 5 secondes sauf si le test définit `timeoutMs` |

408 418 

409## Paramètres et variables d'environnement419## Paramètres et variables d'environnement

Details

33Deux paramètres n'apparaissent pas dans le tableau des couches mais affectent toujours ce qui reste en cache :33Deux paramètres n'apparaissent pas dans le tableau des couches mais affectent toujours ce qui reste en cache :

34 34 

35* **Modèle** : chaque modèle a son propre cache. Changer de modèle recalcule la requête entière même lorsque le contenu est identique. Consultez [Changer de modèle](#switching-models) ci-dessous.35* **Modèle** : chaque modèle a son propre cache. Changer de modèle recalcule la requête entière même lorsque le contenu est identique. Consultez [Changer de modèle](#switching-models) ci-dessous.

36* **Niveau d'effort** : sur la plupart des modèles, chaque niveau d'effort a son propre cache, donc changer d'effort en cours de session recalcule la requête entière. Sur Opus 5.5, Sonnet 5.5, Haiku 5.5 et Fable 5.1 avec une clé API ou un abonnement Claude, le cache reste intact par défaut. Consultez [Changer le niveau d'effort](#changing-effort-level) ci-dessous.36* **Niveau d'effort** : sur la plupart des modèles, chaque niveau d'effort a son propre cache, donc changer d'effort en cours de session recalcule la requête entière. Avec une clé API ou un abonnement Claude, le cache reste intact par défaut sur Fable 5.1 et versions ultérieures, Opus 5.5, Sonnet 5.5 et Haiku 5.5. Consultez [Changer le niveau d'effort](#changing-effort-level) ci-dessous.

37 37 

38> [!TIP]38> [!TIP]

39>39>


94 94 

95Sur la plupart des modèles, modifier le [niveau d'effort](https://code.claude.com/docs/fr/model-config.md#adjust-effort-level) en cours de session signifie que la prochaine requête lit l'intégralité de l'historique de conversation sans aucun cache hit. Tant que le cache est encore chaud, Claude Code vous demande de confirmer le changement d'abord.95Sur la plupart des modèles, modifier le [niveau d'effort](https://code.claude.com/docs/fr/model-config.md#adjust-effort-level) en cours de session signifie que la prochaine requête lit l'intégralité de l'historique de conversation sans aucun cache hit. Tant que le cache est encore chaud, Claude Code vous demande de confirmer le changement d'abord.

96 96 

97Sur Opus 5.5, Sonnet 5.5, Haiku 5.5 et Fable 5.1 avec une clé API ou un abonnement Claude, vous conservez le cache lorsque vous modifiez l'effort. Claude Code [applique le nouveau niveau](https://code.claude.com/docs/fr/model-config.md#when-a-new-effort-level-starts) sans demander. Sur Amazon Bedrock, sur la plateforme Agent de Google Cloud ou sur une [passerelle d'applications Claude](https://code.claude.com/docs/fr/claude-apps-gateway), ou lorsque vous définissez [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](https://code.claude.com/docs/fr/llm-gateway-protocol#disable-pre-release-capabilities) ou que votre organisation a une configuration HIPAA, le fonctionnement est le même que sur la plupart des modèles.97Avec une clé API ou un abonnement Claude, vous conservez le cache lorsque vous modifiez l'effort sur Fable 5.1 et ultérieur, Opus 5.5, Sonnet 5.5 et Haiku 5.5. Claude Code [applique le nouveau niveau](https://code.claude.com/docs/fr/model-config.md#when-a-new-effort-level-starts) sans demander. Sur Amazon Bedrock, sur la plateforme Agent de Google Cloud ou sur une [passerelle d'applications Claude](https://code.claude.com/docs/fr/claude-apps-gateway), ou lorsque vous définissez [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](https://code.claude.com/docs/fr/llm-gateway-protocol#disable-pre-release-capabilities) ou que votre organisation a une configuration HIPAA, le fonctionnement est le même que sur la plupart des modèles.

98 98 

99Avant la v2.1.260, modifier l'effort sur Fable 5.1 avec une clé API ou un abonnement Claude invalidait également le cache.99Avant la v2.1.260, modifier l'effort sur Fable 5.1 avec une clé API ou un abonnement Claude invalidait également le cache.

100 100 

Details

49> claude remote-control49> claude remote-control

50> ```50> ```

51>51>

52> `claude rc` est un alias de cette commande.

53>

52> Tant que vous n'avez pas accepté la confirmation unique de Remote Control, `claude remote-control` explique ce qu'il fait et demande `Enable Remote Control? (y/n)` avant de démarrer le serveur. Répondez `y` pour accepter et démarrer le serveur. Si vous refusez, Claude Code se ferme sans démarrer le serveur et vous pose à nouveau la question la prochaine fois que vous exécutez la commande.54> Tant que vous n'avez pas accepté la confirmation unique de Remote Control, `claude remote-control` explique ce qu'il fait et demande `Enable Remote Control? (y/n)` avant de démarrer le serveur. Répondez `y` pour accepter et démarrer le serveur. Si vous refusez, Claude Code se ferme sans démarrer le serveur et vous pose à nouveau la question la prochaine fois que vous exécutez la commande.

53>55>

54> En mode serveur, le processus reste actif dans votre terminal, en attente de connexions à distance. Il affiche une URL que vous pouvez utiliser pour [vous connecter depuis un autre appareil](#connect-from-another-device), et vous pouvez appuyer sur la barre d'espace pour afficher un QR code permettant un accès rapide depuis votre téléphone. Tant qu'une session à distance est active, le terminal affiche l'état de la connexion et l'activité des outils.56> En mode serveur, le processus reste actif dans votre terminal, en attente de connexions à distance. Il affiche une URL que vous pouvez utiliser pour [vous connecter depuis un autre appareil](#connect-from-another-device), et vous pouvez appuyer sur la barre d'espace pour afficher un QR code permettant un accès rapide depuis votre téléphone. Tant qu'une session à distance est active, le terminal affiche l'état de la connexion et l'activité des outils.


462* **Votre plan claude.ai est Pro, Max ou Ultra** : Claude Code est toujours connecté sous une organisation Team ou Enterprise d'une connexion antérieure, il vérifie donc la politique Remote Control de cette organisation. Exécutez `/status` pour voir quel plan et quelle organisation votre connexion utilise. Exécutez `claude auth logout` puis `claude auth login` pour vous reconnecter sous votre plan actuel.464* **Votre plan claude.ai est Pro, Max ou Ultra** : Claude Code est toujours connecté sous une organisation Team ou Enterprise d'une connexion antérieure, il vérifie donc la politique Remote Control de cette organisation. Exécutez `/status` pour voir quel plan et quelle organisation votre connexion utilise. Exécutez `claude auth logout` puis `claude auth login` pour vous reconnecter sous votre plan actuel.

463* **Le message ne dit pas de contacter votre administrateur d'organisation** : la [configuration HIPAA](https://code.claude.com/docs/fr/hipaa-setup.md) est appliquée à votre organisation, ce qui désactive Remote Control. Pour le confirmer, exécutez `/status` et recherchez `HIPAA` sur la ligne `Organization configuration`. Un propriétaire voit le bouton bascule **Remote Control** grisé dans les [paramètres d'administration](https://claude.ai/admin-settings/claude-code) et ne peut pas l'activer. Si vous avez des questions sur la configuration, adressez-vous à un propriétaire, qui peut contacter l'équipe de compte Anthropic de votre organisation. Avant la v2.1.267, ce cas affichait « Remote Control isn't available for your organization due to its compliance policy » à la place.465* **Le message ne dit pas de contacter votre administrateur d'organisation** : la [configuration HIPAA](https://code.claude.com/docs/fr/hipaa-setup.md) est appliquée à votre organisation, ce qui désactive Remote Control. Pour le confirmer, exécutez `/status` et recherchez `HIPAA` sur la ligne `Organization configuration`. Un propriétaire voit le bouton bascule **Remote Control** grisé dans les [paramètres d'administration](https://claude.ai/admin-settings/claude-code) et ne peut pas l'activer. Si vous avez des questions sur la configuration, adressez-vous à un propriétaire, qui peut contacter l'équipe de compte Anthropic de votre organisation. Avant la v2.1.267, ce cas affichait « Remote Control isn't available for your organization due to its compliance policy » à la place.

464* **Remote Control fonctionne pour d'autres membres de votre organisation, mais pas pour vous** : si votre organisation Enterprise gère votre accès avec des [rôles personnalisés](https://support.claude.com/en/articles/13930452), vos rôles peuvent en être la cause. Remote Control nécessite à la fois la permission des sessions cloud et la permission **Claude Code remote control**. Demandez à un propriétaire de vérifier si vos rôles incluent les deux et d'ajouter ce qui manque dans [**Organization settings > Roles**](https://claude.ai/admin-settings/roles).466* **Remote Control fonctionne pour d'autres membres de votre organisation, mais pas pour vous** : si votre organisation Enterprise gère votre accès avec des [rôles personnalisés](https://support.claude.com/en/articles/13930452), vos rôles peuvent en être la cause. Remote Control nécessite à la fois la permission des sessions cloud et la permission **Claude Code remote control**. Demandez à un propriétaire de vérifier si vos rôles incluent les deux et d'ajouter ce qui manque dans [**Organization settings > Roles**](https://claude.ai/admin-settings/roles).

467* **Un propriétaire voit une bannière [Zero Data Retention](https://code.claude.com/docs/fr/zero-data-retention.md) dans les [paramètres d'administration](https://claude.ai/admin-settings/claude-code)** : Remote Control n'est pas disponible pour votre organisation, et un propriétaire ne peut pas l'activer.

465* **Sinon, un propriétaire ne l'a pas activé pour votre organisation** : Remote Control est désactivé par défaut sur les plans Team et Enterprise. Un propriétaire peut l'activer sur [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) en activant le bouton bascule **Remote Control**. Ce bouton bascule est un paramètre d'organisation côté serveur.468* **Sinon, un propriétaire ne l'a pas activé pour votre organisation** : Remote Control est désactivé par défaut sur les plans Team et Enterprise. Un propriétaire peut l'activer sur [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) en activant le bouton bascule **Remote Control**. Ce bouton bascule est un paramètre d'organisation côté serveur.

466 469 

467Avant la v2.1.281, ce message apparaissait également lorsque Claude Code n'avait pas chargé la politique de votre organisation sur cette machine, par exemple après un démarrage hors ligne. Les versions ultérieures signalent cet état comme [`Couldn't verify your organization's policy for remote control`](#couldnt-verify-your-organizations-policy-for-remote-control) à la place.470Avant la v2.1.281, ce message apparaissait également lorsque Claude Code n'avait pas chargé la politique de votre organisation sur cette machine, par exemple après un démarrage hors ligne. Les versions ultérieures signalent cet état comme [`Couldn't verify your organization's policy for remote control`](#couldnt-verify-your-organizations-policy-for-remote-control) à la place.

Details

154| :- | :- |154| :- | :- |

155| `CLAUDE_RUNNER_REPO_URL` | URL du référentiel à cloner, après que tout `--git-host-rewrite` et `--git-ssh-rewrite` aient été appliqués |155| `CLAUDE_RUNNER_REPO_URL` | URL du référentiel à cloner, après que tout `--git-host-rewrite` et `--git-ssh-rewrite` aient été appliqués |

156| `CLAUDE_RUNNER_REPO_REF` | Révision à extraire, telle que la session l'a demandée : une branche, un tag, un SHA de commit ou un nom de référence complet comme `refs/heads/<branch>` ou `refs/pull/<number>/head`. Vide signifie la branche par défaut du dépôt. |156| `CLAUDE_RUNNER_REPO_REF` | Révision à extraire, telle que la session l'a demandée : une branche, un tag, un SHA de commit ou un nom de référence complet comme `refs/heads/<branch>` ou `refs/pull/<number>/head`. Vide signifie la branche par défaut du dépôt. |

157| `CLAUDE_RUNNER_CHECKOUT_PATH` | Chemin absolu où l'arbre de travail doit être laissé |157| `CLAUDE_RUNNER_CHECKOUT_PATH` | Chemin absolu où l'arbre de travail doit être laissé. Voir [Noms des dossiers de checkout](#checkout-folder-names). |

158| `CLAUDE_RUNNER_SESSION_ID` | ID de session sous la forme balisée `session_...`, pour la journalisation et la corrélation |158| `CLAUDE_RUNNER_SESSION_ID` | ID de session sous la forme balisée `session_...`, pour la journalisation et la corrélation |

159| `CLAUDE_RUNNER_SESSION_UUID` | Le même ID de session sous la forme UUID canonique |159| `CLAUDE_RUNNER_SESSION_UUID` | Le même ID de session sous la forme UUID canonique |

160| `CLAUDE_RUNNER_API_BASE_URL` | URL de base de l'API Anthropic pour les appels limités à la session |160| `CLAUDE_RUNNER_API_BASE_URL` | URL de base de l'API Anthropic pour les appels limités à la session |


166 166 

167Après le retour de votre hook, le runner vérifie que `CLAUDE_RUNNER_CHECKOUT_PATH` contient un `.git`. Si votre hook matérialise une source non-git comme Perforce ou une archive tarball dépaquetée, définissez `CLAUDE_RUNNER_SKIP_GIT_VERIFY=1` dans l'environnement du runner pour ignorer cette vérification. Les flux basés sur git comme la création de branche de travail et l'envoi des résultats nécessitent un checkout git, donc exportez les résultats des arbres non-git avec un [hook `post-session`](#post-session).167Après le retour de votre hook, le runner vérifie que `CLAUDE_RUNNER_CHECKOUT_PATH` contient un `.git`. Si votre hook matérialise une source non-git comme Perforce ou une archive tarball dépaquetée, définissez `CLAUDE_RUNNER_SKIP_GIT_VERIFY=1` dans l'environnement du runner pour ignorer cette vérification. Les flux basés sur git comme la création de branche de travail et l'envoi des résultats nécessitent un checkout git, donc exportez les résultats des arbres non-git avec un [hook `post-session`](#post-session).

168 168 

169#### Noms des dossiers de checkout

170 

171`CLAUDE_RUNNER_CHECKOUT_PATH` se termine par un dossier nommé `<repo-owner>-<repo>`, comme `acme-api`. Deux dépôts d'une même session ne peuvent pas partager un dossier, même lorsque leurs noms ne diffèrent que par la casse. Par exemple, si une session liste `acme/api` puis `Acme/API`, le premier obtient `acme-api` et le second `Acme-API-2`.

172 

169#### Obtenir des identifiants git dans le hook173#### Obtenir des identifiants git dans le hook

170 174 

171Le runner ne transmet pas d'identifiants git au hook. La sous-commande `decode-token` n'est pas non plus disponible ici, car `CLAUDE_RUNNER_CLAUDE_BIN` n'est pas défini dans l'environnement du hook de checkout. Générez plutôt des identifiants de clone par session à partir de l'identité de la session, ou revenez à l'authentification git propre à l'hôte :175Le runner ne transmet pas d'identifiants git au hook. La sous-commande `decode-token` n'est pas non plus disponible ici, car `CLAUDE_RUNNER_CLAUDE_BIN` n'est pas défini dans l'environnement du hook de checkout. Générez plutôt des identifiants de clone par session à partir de l'identité de la session, ou revenez à l'authentification git propre à l'hôte :

Details

23 * **Avec [git géré par Anthropic](#use-the-anthropic-git-proxy)** : avec un tel identifiant, Claude atteint GitHub directement au lieu de passer par git géré par Anthropic.23 * **Avec [git géré par Anthropic](#use-the-anthropic-git-proxy)** : avec un tel identifiant, Claude atteint GitHub directement au lieu de passer par git géré par Anthropic.

24 * **Sans git géré par Anthropic** : un identifiant de clone peut rester dans l'image si vous limitez sa portée aussi strictement que le décrit [Intégrer la configuration git dans votre image](#ship-git-config-in-your-image).24 * **Sans git géré par Anthropic** : un identifiant de clone peut rester dans l'image si vous limitez sa portée aussi strictement que le décrit [Intégrer la configuration git dans votre image](#ship-git-config-in-your-image).

25* **Gardez le secret de l'environnement loin des hôtes exécutant les sessions** : le secret de l'environnement peut enregistrer des runners et récupérer toute session mise en file d'attente sur l'environnement. Sur une flotte fixe, il réside sur chaque hôte runner, où le code de toute session peut lire le fichier secret. Préférez les [runners à la demande](https://code.claude.com/docs/fr/self-hosted-environments-configuration.md#on-demand-runners), où le secret reste sur l'hôte orchestrateur, qui n'exécute jamais de code utilisateur, et chaque runner reçoit un bon de travail à usage unique qui enregistre exactement un runner. Sur une flotte fixe, traitez le fichier secret-environnement comme lisible par toute session et faites tourner le secret après tout compromis de session suspecté.25* **Gardez le secret de l'environnement loin des hôtes exécutant les sessions** : le secret de l'environnement peut enregistrer des runners et récupérer toute session mise en file d'attente sur l'environnement. Sur une flotte fixe, il réside sur chaque hôte runner, où le code de toute session peut lire le fichier secret. Préférez les [runners à la demande](https://code.claude.com/docs/fr/self-hosted-environments-configuration.md#on-demand-runners), où le secret reste sur l'hôte orchestrateur, qui n'exécute jamais de code utilisateur, et chaque runner reçoit un bon de travail à usage unique qui enregistre exactement un runner. Sur une flotte fixe, traitez le fichier secret-environnement comme lisible par toute session et faites tourner le secret après tout compromis de session suspecté.

26 * **Après un compromis suspecté** : demandez à un [propriétaire](https://code.claude.com/docs/fr/cloud-environments.md#organization-shared-environments) de créer un nouveau secret et de révoquer l'ancien depuis l'onglet **Configuration** de l'environnement, puis déployez le nouveau. Anthropic refuse tout orchestrateur et tout runner utilisant l'ancien secret, y compris les runners à la demande issus de ses bons de travail. Vos runners se terminent, ce qui interrompt leurs sessions.

26* **Sortie réseau par défaut-refuser** : limitez le trafic sortant du conteneur runner et session à votre propre limite réseau sur chaque environnement ; [Sortie par défaut-refuser](#default-deny-egress) couvre ce qu'il faut autoriser et pourquoi.27* **Sortie réseau par défaut-refuser** : limitez le trafic sortant du conteneur runner et session à votre propre limite réseau sur chaque environnement ; [Sortie par défaut-refuser](#default-deny-egress) couvre ce qu'il faut autoriser et pourquoi.

27* **IAM hôte avec privilèges minimaux** : l'identité de calcul attachée à l'hôte runner, telle qu'un profil d'instance ou un compte de service de nœud, ne devrait accorder que ce dont le runner lui-même a besoin. Les sessions devraient obtenir leurs propres identifiants via votre script wrapper plutôt que d'hériter de ceux de l'hôte.28* **IAM hôte avec privilèges minimaux** : l'identité de calcul attachée à l'hôte runner, telle qu'un profil d'instance ou un compte de service de nœud, ne devrait accorder que ce dont le runner lui-même a besoin. Les sessions devraient obtenir leurs propres identifiants via votre script wrapper plutôt que d'hériter de ceux de l'hôte.

28* **Bloquez le point de terminaison des métadonnées cloud des sessions** : garder les sessions hors de l'identité hôte nécessite de bloquer leur accès au point de terminaison des métadonnées, et les politiques de sortie au niveau du sous-réseau n'interceptent pas le trafic de métadonnées link-local, donc bloquez-le dans le conteneur lui-même :29* **Bloquez le point de terminaison des métadonnées cloud des sessions** : garder les sessions hors de l'identité hôte nécessite de bloquer leur accès au point de terminaison des métadonnées, et les politiques de sortie au niveau du sous-réseau n'interceptent pas le trafic de métadonnées link-local, donc bloquez-le dans le conteneur lui-même :


203> [!WARNING]204> [!WARNING]

204>205>

205> Lorsque `--use-anthropic-git-proxy` est défini, le runner supprime et remplace la configuration git globale de l'utilisateur sous lequel il s'exécute, sans conserver de sauvegarde. Il le fait au démarrage et avant chaque session. Un identifiant de connexion ou un credential helper que vous y conserviez est perdu. Les paramètres écrits par [`--configure-git`](#let-the-runner-configure-git) sont conservés. Exécutez le runner en tant qu'utilisateur dédié ou dans un conteneur, jamais sous votre propre utilisateur.206> Lorsque `--use-anthropic-git-proxy` est défini, le runner supprime et remplace la configuration git globale de l'utilisateur sous lequel il s'exécute, sans conserver de sauvegarde. Il le fait au démarrage et avant chaque session. Un identifiant de connexion ou un credential helper que vous y conserviez est perdu. Les paramètres écrits par [`--configure-git`](#let-the-runner-configure-git) sont conservés. Exécutez le runner en tant qu'utilisateur dédié ou dans un conteneur, jamais sous votre propre utilisateur.

207>

208> La configuration git globale comprend à la fois `~/.gitconfig`, le fichier désigné par `GIT_CONFIG_GLOBAL` si vous la définissez, et l'ensemble du répertoire `$XDG_CONFIG_HOME/git`, par défaut `~/.config/git`.

206 209 

207Conservez les paramètres git qui ne sont pas secrets, comme l'identité et `safe.directory`, dans la configuration git système.210Conservez les paramètres git qui ne sont pas secrets, comme l'identité et `safe.directory`, dans la configuration git système.

208 211 


247* **Une ligne contenant `remote: access denied by the git proxy`** : une session qu'Anthropic sert peut tout de même être refusée, par exemple lorsque la politique de l'organisation refuse l'accès git pour la session, ou que la session n'est pas autorisée pour le dépôt. Le log du runner affiche alors une ligne contenant `remote: access denied by the git proxy`, et le reste de cette ligne en indique la raison.250* **Une ligne contenant `remote: access denied by the git proxy`** : une session qu'Anthropic sert peut tout de même être refusée, par exemple lorsque la politique de l'organisation refuse l'accès git pour la session, ou que la session n'est pas autorisée pour le dépôt. Le log du runner affiche alors une ligne contenant `remote: access denied by the git proxy`, et le reste de cette ligne en indique la raison.

248* **`GitHub authentication required`** : ce message apparaît lorsque le créateur de la session n'a pas de connexion GitHub fonctionnelle sur claude.ai. Le clone de la session échoue, et l'erreur git indique `GitHub authentication required. Please reconnect your GitHub account.` Demandez à cette personne de connecter ou reconnecter GitHub dans ses paramètres claude.ai.251* **`GitHub authentication required`** : ce message apparaît lorsque le créateur de la session n'a pas de connexion GitHub fonctionnelle sur claude.ai. Le clone de la session échoue, et l'erreur git indique `GitHub authentication required. Please reconnect your GitHub account.` Demandez à cette personne de connecter ou reconnecter GitHub dans ses paramètres claude.ai.

249 252 

250Après avoir corrigé la cause, redémarrez les sessions qui ont échoué.253Après avoir corrigé la cause, redémarrez les runners sur lesquels les sessions ont échoué, puis demandez à chaque créateur d'envoyer un message dans sa session, ou à un Owner de sélectionner **Retry**.

251 254 

252#### Désactiver le proxy git Anthropic255#### Désactiver le proxy git Anthropic

253 256 


265 268 

266Fournissez des identifiants qui fonctionnent sans invite pour chaque hôte git utilisé par les sessions des runners, github.com compris. Tout identifiant qui se trouvait dans la configuration git globale de l'utilisateur du runner a disparu, car le runner a supprimé cette configuration tant que `--use-anthropic-git-proxy` était défini. [Livrez les identifiants dans votre image](#ship-git-config-in-your-image) ou utilisez un [hook de cycle de vie `checkout`](https://code.claude.com/docs/fr/self-hosted-environments-configuration#checkout).269Fournissez des identifiants qui fonctionnent sans invite pour chaque hôte git utilisé par les sessions des runners, github.com compris. Tout identifiant qui se trouvait dans la configuration git globale de l'utilisateur du runner a disparu, car le runner a supprimé cette configuration tant que `--use-anthropic-git-proxy` était défini. [Livrez les identifiants dans votre image](#ship-git-config-in-your-image) ou utilisez un [hook de cycle de vie `checkout`](https://code.claude.com/docs/fr/self-hosted-environments-configuration#checkout).

267 270 

271Pour conserver plutôt les identifiants dans la [configuration git globale](#git-proxy-replaces-global-git-config), [arrêtez d'abord les runners](#shutdown-timing), car un runner démarré avec le flag la réécrit avant chaque session. Supprimez ensuite `$XDG_CONFIG_HOME/git`, par défaut `~/.config/git`, et remplacez `~/.gitconfig`, ou le fichier désigné par `GIT_CONFIG_GLOBAL`, par le vôtre.

272 

268**3. Ouvrir le chemin réseau**273**3. Ouvrir le chemin réseau**

269 274 

270Autorisez le runner à atteindre chaque hôte git utilisé par les sessions des runners sur le port 443 ou 22. Consultez la ligne relative à l'hôte git dans [Exigences réseau](#network-requirements).275Autorisez le runner à atteindre chaque hôte git utilisé par les sessions des runners sur le port 443 ou 22. Consultez la ligne relative à l'hôte git dans [Exigences réseau](#network-requirements).


507 512 

508## Kubernetes513## Kubernetes

509 514 

510Le runner sert `GET /healthz` sur le port 8080 par défaut, configurable avec `--health-port`, de sorte que les sondes Kubernetes fonctionnent sans configuration supplémentaire. L'endpoint renvoie `200` tant que le processus est actif ; les sondes ci-dessous détectent donc un processus mort, et non un processus bloqué. Pour repérer un runner qui a cessé d'interroger le serveur, configurez une alerte sur la série `last_poll_age_seconds` de [`/metrics`](https://code.claude.com/docs/fr/self-hosted-environments-reference#prometheus-metrics). Le Deployment ci-dessous monte le secret d'environnement à partir d'un Secret Kubernetes, dirige les sondes de liveness et de readiness vers `/healthz` et définit un délai de grâce de terminaison de 90 secondes. Consultez [Délai d'arrêt](#shutdown-timing) pour comprendre l'importance de ce délai de grâce.515Le runner sert `GET /healthz` sur le port 8080 par défaut, configurable avec `--health-port`. Après le démarrage, l'endpoint renvoie `200` tant que le processus est actif ; les sondes ci-dessous détectent donc un processus mort, et non un processus bloqué. Pour repérer un runner qui a cessé d'interroger le serveur, configurez une alerte sur la série `last_poll_age_seconds` de [`/metrics`](https://code.claude.com/docs/fr/self-hosted-environments-reference#prometheus-metrics).

516 

517Le Deployment ci-dessous monte le secret d'environnement à partir d'un Secret Kubernetes, dirige les sondes de liveness et de readiness vers `/healthz` et définit un délai de grâce de terminaison de 90 secondes. Consultez [Délai d'arrêt](#shutdown-timing) pour comprendre l'importance de ce délai de grâce.

511 518 

512Le manifeste ne définit aucune `resources` de CPU ni de mémoire vive sur le conteneur du runner. Ajoutez un bloc dimensionné en fonction de la capacité que vous exécutez, comme le décrit [Dimensionner le CPU et la mémoire vive pour les sessions](#size-cpu-and-memory-for-sessions).519Le manifeste ne définit aucune `resources` de CPU ni de mémoire vive sur le conteneur du runner. Ajoutez un bloc dimensionné en fonction de la capacité que vous exécutez, comme le décrit [Dimensionner le CPU et la mémoire vive pour les sessions](#size-cpu-and-memory-for-sessions).

513 520 


565 secretName: claude-runner-environment-secret572 secretName: claude-runner-environment-secret

566```573```

567 574 

575> [!NOTE]

576>

577> Si les événements du pod indiquent que la sonde de liveness échoue pendant le démarrage, augmentez son `initialDelaySeconds` ou ajoutez une `startupProbe`. Rien ne répond sur le port de santé tant que le runner ne s'est pas enregistré et n'a pas terminé ses vérifications de démarrage. Avec les paramètres ci-dessus, Kubernetes redémarre un runner qui ne sert pas de réponse dans un délai d'environ 90 secondes.

578 

568Le Deployment ci-dessus réside dans un namespace `claude-runners`. Créez d'abord le namespace :579Le Deployment ci-dessus réside dans un namespace `claude-runners`. Créez d'abord le namespace :

569 580 

570```bash theme={null}581```bash theme={null}


942 Si tous les appels commencent à échouer environ 30 minutes après le début d'une session, un script wrapper a probablement coupé le stdin de la session, de sorte que les renouvellements de jeton ne peuvent pas l'atteindre ; consultez [Conserver stdin et le descripteur de fichier 3 attachés](https://code.claude.com/docs/fr/self-hosted-environments-configuration.md#keep-stdin-and-file-descriptor-3-attached).953 Si tous les appels commencent à échouer environ 30 minutes après le début d'une session, un script wrapper a probablement coupé le stdin de la session, de sorte que les renouvellements de jeton ne peuvent pas l'atteindre ; consultez [Conserver stdin et le descripteur de fichier 3 attachés](https://code.claude.com/docs/fr/self-hosted-environments-configuration.md#keep-stdin-and-file-descriptor-3-attached).

943 954 

944 Avant la v2.1.274, le runner cessait de réessayer une récupération échouée après quelques tentatives et attendait la suivante prévue. Un tour échoué ne déclenchait pas de récupération, si bien que chaque tour échouait avec une erreur 401 jusqu'à la récupération planifiée suivante.955 Avant la v2.1.274, le runner cessait de réessayer une récupération échouée après quelques tentatives et attendait la suivante prévue. Un tour échoué ne déclenchait pas de récupération, si bien que chaque tour échouait avec une erreur 401 jusqu'à la récupération planifiée suivante.

956* **Une session affiche `The server has refused to renew this session's access to the model`** : le [`CLAUDE_CODE_OAUTH_TOKEN`](https://code.claude.com/docs/fr/self-hosted-environments-configuration#wrapper-scripts) de la session a expiré, et le runner a reçu une réponse HTTP 400 à ses requêtes de nouveau jeton. Le runner journalise `the server has refused to renew the inference_token`. Les tours de cette session échouent. Le runner continue de demander un nouveau jeton tant que le processus de la session s'exécute :

957 

958 * **Une requête réussit** : une session qui affichait l'avertissement affiche alors `The server renewed this session's access to the model`

959 * **Les tours continuent d'échouer** : le processus finit par s'arrêter, et la session affiche un échec tel que `The session process exited with code 1`

960 

961 Pour continuer à travailler sans attendre un nouveau jeton, démarrez une nouvelle session. Si une nouvelle session échoue également, vérifiez si l'un de vos proxys ou de vos passerelles a renvoyé la réponse HTTP 400. Si ce n'est pas le cas, [contactez l'équipe de votre compte Anthropic](#report-an-issue) en indiquant l'identifiant de la première session.

945* **Un tour échoue dans claude.ai/code avec `This model needs a newer version of Claude Code`** : la version de Claude Code avec laquelle vos runners démarrent les sessions est plus ancienne que celle requise par le modèle de la session, si bien que l'API [rejette la requête](https://code.claude.com/docs/fr/errors.md#claude-code-does-not-support-this-model). Mettez à niveau les runners vers la version demandée par le message, ou une version ultérieure, comme décrit dans [Épingler la version](#pin-the-version). D'ici là, les utilisateurs peuvent choisir un autre modèle dans la session.962* **Un tour échoue dans claude.ai/code avec `This model needs a newer version of Claude Code`** : la version de Claude Code avec laquelle vos runners démarrent les sessions est plus ancienne que celle requise par le modèle de la session, si bien que l'API [rejette la requête](https://code.claude.com/docs/fr/errors.md#claude-code-does-not-support-this-model). Mettez à niveau les runners vers la version demandée par le message, ou une version ultérieure, comme décrit dans [Épingler la version](#pin-the-version). D'ici là, les utilisateurs peuvent choisir un autre modèle dans la session.

946* **Le pod est tué en cours de vidage** : augmentez `terminationGracePeriodSeconds` à au moins la valeur que le runner journalise au démarrage. Consultez [Délais d'arrêt](#shutdown-timing).963* **Le pod est tué en cours de vidage** : augmentez `terminationGracePeriodSeconds` à au moins la valeur que le runner journalise au démarrage. Consultez [Délais d'arrêt](#shutdown-timing).

947* **Le runner journalise une ligne `[runner:log]` se terminant par `was paused or too slow`** : le runner a continué de s'exécuter et n'a pas besoin d'être redémarré. Jusqu'à ce que le flux stdout ou stderr nommé dans la ligne soit de nouveau lu, le runner a supprimé toutes les lignes de ce flux à l'exception des 256 Kio les plus récentes. Si vous avez passé [`--log-file`](https://code.claude.com/docs/fr/self-hosted-environments-reference#runner-cli-flags), cherchez-y les lignes supprimées.964* **Le runner journalise une ligne `[runner:log]` se terminant par `was paused or too slow`** : le runner a continué de s'exécuter et n'a pas besoin d'être redémarré. Jusqu'à ce que le flux stdout ou stderr nommé dans la ligne soit de nouveau lu, le runner a supprimé toutes les lignes de ce flux à l'exception des 256 Kio les plus récentes. Si vous avez passé [`--log-file`](https://code.claude.com/docs/fr/self-hosted-environments-reference#runner-cli-flags), cherchez-y les lignes supprimées.

Details

73 73 

74Accédez à la [page **Cloud environments**](https://claude.ai/admin-settings/cloud-environments) dans les paramètres d'administration. Sous **Self-hosted environments**, sélectionnez **New**, nommez l'environnement et sélectionnez **Create**. À la deuxième étape de l'assistant, sélectionnez **Copy environment key** pour copier le secret de l'environnement, que l'interface d'administration appelle une clé d'environnement. claude.ai n'affiche le secret qu'une seule fois et vous ne pourrez pas le récupérer plus tard ; il expire 365 jours après sa création. L'identifiant `ccpool_...` de l'environnement reste visible dans sa boîte de dialogue de détails ; vous en aurez besoin pour la vérification `aud` dans la [vérification des jetons](https://code.claude.com/docs/fr/self-hosted-environments-identity.md) et pour lancer des [sessions de test depuis la CI](https://code.claude.com/docs/fr/self-hosted-environments-testing.md#run-the-test-loop).74Accédez à la [page **Cloud environments**](https://claude.ai/admin-settings/cloud-environments) dans les paramètres d'administration. Sous **Self-hosted environments**, sélectionnez **New**, nommez l'environnement et sélectionnez **Create**. À la deuxième étape de l'assistant, sélectionnez **Copy environment key** pour copier le secret de l'environnement, que l'interface d'administration appelle une clé d'environnement. claude.ai n'affiche le secret qu'une seule fois et vous ne pourrez pas le récupérer plus tard ; il expire 365 jours après sa création. L'identifiant `ccpool_...` de l'environnement reste visible dans sa boîte de dialogue de détails ; vous en aurez besoin pour la vérification `aud` dans la [vérification des jetons](https://code.claude.com/docs/fr/self-hosted-environments-identity.md) et pour lancer des [sessions de test depuis la CI](https://code.claude.com/docs/fr/self-hosted-environments-testing.md#run-the-test-loop).

75 75 

76Si vous perdez le secret ou devez le renouveler, créez un nouveau secret depuis l'onglet **Configuration** de l'environnement, déployez le nouveau secret sur vos runners, puis révoquez l'ancien. Les runners détenant un secret révoqué échouent lors de leur prochain polling authentifié et s'arrêtent en journalisant `poll auth failed`, et votre orchestrateur les redémarre avec le nouveau secret.76Si le secret a pu fuiter, suivez [les étapes de la page de déploiement en cas de compromission suspectée](https://code.claude.com/docs/fr/self-hosted-environments-deploy.md#after-a-suspected-compromise), et non le renouvellement ci-dessous.

77 

78Si vous perdez le secret ou prévoyez de le renouveler, créez un nouveau secret depuis l'onglet **Configuration** de l'environnement. Déployez le nouveau secret sur vos runners, puis révoquez l'ancien. Les runners détenant un secret révoqué échouent lors de leur prochain polling authentifié et s'arrêtent en journalisant `poll auth failed`, et votre orchestrateur les redémarre avec le nouveau secret.

77 79 

78**2. Démarrer un runner**80**2. Démarrer un runner**

79 81 

Details

141 141 

142## Point de terminaison de santé142## Point de terminaison de santé

143 143 

144Le runner sert `GET /healthz` sur le port de santé configuré. La réponse est `200 OK` chaque fois que le processus est actif, quel que soit l'état de la boucle d'interrogation, donc une sonde HTTP sur ce point de terminaison détecte uniquement un processus mort. Le corps JSON décrit l'état actuel :144Le runner sert `GET /healthz` sur le port de santé configuré une fois qu'il s'est enregistré et a terminé ses vérifications de démarrage. À partir de ce moment, la réponse est `200 OK` chaque fois que le processus est actif, quel que soit l'état de la boucle d'interrogation, donc une sonde HTTP sur cet endpoint détecte uniquement un processus mort. Le corps JSON décrit l'état actuel :

145 145 

146```json theme={null}146```json theme={null}

147{147{

settings.md +1 −0

Details

310| [`isolatePeerMachines`](https://code.claude.com/docs/fr/settings-reference#isolatepeermachines) | `true` depuis n'importe quelle portée | Respectée même lorsqu'une source gérée définit `false` |310| [`isolatePeerMachines`](https://code.claude.com/docs/fr/settings-reference#isolatepeermachines) | `true` depuis n'importe quelle portée | Respectée même lorsqu'une source gérée définit `false` |

311| [`permissions.blockReadsOutsideWorkingDirectories`](https://code.claude.com/docs/fr/settings-reference#permissions-blockreadsoutsideworkingdirectories) | `true` depuis n'importe quelle portée | Respectée même lorsqu'une source gérée définit `false`. Nécessite Claude Code v2.1.257 ou une version ultérieure |311| [`permissions.blockReadsOutsideWorkingDirectories`](https://code.claude.com/docs/fr/settings-reference#permissions-blockreadsoutsideworkingdirectories) | `true` depuis n'importe quelle portée | Respectée même lorsqu'une source gérée définit `false`. Nécessite Claude Code v2.1.257 ou une version ultérieure |

312| [`permissions.blockWritesOutsideWorkingDirectories`](https://code.claude.com/docs/fr/settings-reference#permissions-blockwritesoutsideworkingdirectories) | `true` depuis n'importe quelle portée | Respectée même lorsqu'une source gérée définit `false`. Nécessite Claude Code v2.1.314 ou une version ultérieure |312| [`permissions.blockWritesOutsideWorkingDirectories`](https://code.claude.com/docs/fr/settings-reference#permissions-blockwritesoutsideworkingdirectories) | `true` depuis n'importe quelle portée | Respectée même lorsqu'une source gérée définit `false`. Nécessite Claude Code v2.1.314 ou une version ultérieure |

313| [`permissions.denyInsteadOfPrompting`](https://code.claude.com/docs/fr/settings-reference#permissions-denyinsteadofprompting) | `true` depuis `~/.claude/settings.json` ou `--settings` | Respectée même lorsqu'une source gérée définit `false`. Nécessite Claude Code v2.1.319 ou une version ultérieure |

313| [`autoMode.classifyAllShell`](https://code.claude.com/docs/fr/settings-reference#automode-classifyallshell) | `true` depuis `~/.claude/settings.json` ou `--settings` | Respectée même lorsqu'une source gérée définit `false` |314| [`autoMode.classifyAllShell`](https://code.claude.com/docs/fr/settings-reference#automode-classifyallshell) | `true` depuis `~/.claude/settings.json` ou `--settings` | Respectée même lorsqu'une source gérée définit `false` |

314| [`remoteControlAtStartup`](https://code.claude.com/docs/fr/settings-reference#remotecontrolatstartup) | `false` depuis `.claude/settings.json` ou `.claude/settings.local.json` | Respectée même lorsqu'une source gérée définit `true` ; un `true` de projet ou local est ignoré |315| [`remoteControlAtStartup`](https://code.claude.com/docs/fr/settings-reference#remotecontrolatstartup) | `false` depuis `.claude/settings.json` ou `.claude/settings.local.json` | Respectée même lorsqu'une source gérée définit `true` ; un `true` de projet ou local est ignoré |

315| [`crossSessionInbound`](https://code.claude.com/docs/fr/settings-reference#crosssessioninbound) | Une valeur plus stricte depuis `.claude/settings.json` ou `.claude/settings.local.json`, sur l'échelle `accept` \< `hold` \< `refuse` | Respectée par rapport aux valeurs gérées, `--settings` et utilisateur ; une valeur de projet ou locale qui n'est pas plus stricte est ignorée |316| [`crossSessionInbound`](https://code.claude.com/docs/fr/settings-reference#crosssessioninbound) | Une valeur plus stricte depuis `.claude/settings.json` ou `.claude/settings.local.json`, sur l'échelle `accept` \< `hold` \< `refuse` | Respectée par rapport aux valeurs gérées, `--settings` et utilisateur ; une valeur de projet ou locale qui n'est pas plus stricte est ignorée |

Details

448 448 

449Activez le [mode rapide](https://code.claude.com/docs/fr/fast-mode.md) pour les sessions où il est disponible, pour un travail interactif comme l'itération rapide ou le débogage en direct, lorsque vous privilégiez la vitesse au prix d'un coût par token plus élevé. En général, vous ne modifiez pas cette clé vous-même. Exécuter `/fast` écrit `fastMode: true` dans `~/.claude/settings.json`, et l'exécuter à nouveau pour désactiver le mode rapide supprime la clé.449Activez le [mode rapide](https://code.claude.com/docs/fr/fast-mode.md) pour les sessions où il est disponible, pour un travail interactif comme l'itération rapide ou le débogage en direct, lorsque vous privilégiez la vitesse au prix d'un coût par token plus élevé. En général, vous ne modifiez pas cette clé vous-même. Exécuter `/fast` écrit `fastMode: true` dans `~/.claude/settings.json`, et l'exécuter à nouveau pour désactiver le mode rapide supprime la clé.

450 450 

451Seuls Opus 5.5, Opus 5 et Opus 4.8 prennent en charge le mode rapide. Exécuter `/fast` depuis un autre modèle vous fait basculer sur Opus, et passer à un modèle non pris en charge désactive le mode rapide. Consultez [Changer de modèle lorsque le mode rapide est activé](https://code.claude.com/docs/fr/fast-mode.md#switch-models-while-fast-mode-is-on).451Seuls Fable 5.2, Opus 5.5, Opus 5 et Opus 4.8 prennent en charge le mode rapide. Exécuter `/fast` depuis un autre modèle vous fait basculer sur Opus, et passer à un modèle non pris en charge désactive le mode rapide. Consultez [Changer de modèle lorsque le mode rapide est activé](https://code.claude.com/docs/fr/fast-mode.md#switch-models-while-fast-mode-is-on).

452 452 

453* **Portée** : [`Any file`](#scopes)453* **Portée** : [`Any file`](#scopes)

454* **Type** : booléen454* **Type** : booléen

455 * `true` : Claude Code active le mode rapide pour les sessions où il est disponible455 * `true` : Claude Code active le mode rapide pour les sessions où il est disponible. Sur Fable 5.2, vous devez également [exécuter `/fast` lorsque vous utilisez Fable 5.2](https://code.claude.com/docs/fr/fast-mode#switch-models-while-fast-mode-is-on)

456 * `false` : le mode rapide reste désactivé456 * `false` : le mode rapide reste désactivé

457* **Valeur par défaut** : non définie, le mode rapide est donc désactivé457* **Valeur par défaut** : non définie, le mode rapide est donc désactivé

458* **Remplacements par session** : [`CLAUDE_CODE_DISABLE_FAST_MODE`](https://code.claude.com/docs/fr/env-vars) désactive le mode rapide pour une session, et cette clé ne peut pas le réactiver458* **Remplacements par session** : [`CLAUDE_CODE_DISABLE_FAST_MODE`](https://code.claude.com/docs/fr/env-vars) désactive le mode rapide pour une session, et cette clé ne peut pas le réactiver


465 465 

466### `fastModePerSessionOptIn`466### `fastModePerSessionOptIn`

467 467 

468Normalement, exécuter `/fast` enregistre [`fastMode`](#fastmode) dans les paramètres utilisateur de la personne, de sorte que les nouvelles sessions sur un modèle pris en charge démarrent avec le mode rapide activé. Définissez cette clé sur `true` pour l'empêcher : un `fastMode: true` enregistré n'active plus le mode rapide au démarrage de la session, et chaque personne doit exécuter `/fast` dans chaque session où elle le souhaite. Claude Code laisse la clé `fastMode` dans son fichier, si bien que désactiver cette clé rétablit l'ancien comportement.468Normalement, exécuter `/fast` enregistre [`fastMode`](#fastmode) dans les paramètres utilisateur de la personne, de sorte que les nouvelles sessions sur un modèle pris en charge démarrent avec le mode rapide activé. Sur Fable 5.2, cela ne se produit que si elle l'a [activé en utilisant Fable 5.2](https://code.claude.com/docs/fr/fast-mode.md#switch-models-while-fast-mode-is-on). Pour que chaque personne doive exécuter `/fast` dans chaque session où elle le souhaite, définissez cette clé sur `true`. Claude Code laisse la clé `fastMode` dans son fichier, si bien que désactiver cette clé rétablit l'ancien comportement.

469 469 

470Les propriétaires des forfaits Team ou Enterprise peuvent la déployer à l'échelle de l'organisation via les [paramètres gérés par le serveur](https://code.claude.com/docs/fr/server-managed-settings.md). Lorsque les paramètres gérés définissent la clé, `/fast on` est refusé en dehors des sessions de terminal interactives et indique que votre organisation a désactivé le mode rapide. Cela concerne le [mode non interactif](https://code.claude.com/docs/fr/headless.md), l'[extension VS Code](https://code.claude.com/docs/fr/vs-code.md) et les [sessions cloud](https://code.claude.com/docs/fr/claude-code-on-the-web.md).470Les propriétaires des forfaits Team ou Enterprise peuvent la déployer à l'échelle de l'organisation via les [paramètres gérés par le serveur](https://code.claude.com/docs/fr/server-managed-settings.md). Lorsque les paramètres gérés définissent la clé, `/fast on` est refusé en dehors des sessions de terminal interactives et indique que votre organisation a désactivé le mode rapide. Cela concerne le [mode non interactif](https://code.claude.com/docs/fr/headless.md), l'[extension VS Code](https://code.claude.com/docs/fr/vs-code.md) et les [sessions cloud](https://code.claude.com/docs/fr/claude-code-on-the-web.md).

471 471 

472* **Portée** : [`Any file`](#scopes)472* **Portée** : [`Any file`](#scopes)

473* **Type** : booléen473* **Type** : booléen

474 * `true` : un `fastMode: true` enregistré n'active plus le mode rapide au démarrage de la session, donc chaque personne exécute `/fast` dans chaque session où elle le souhaite ; un `fastMode: true` transmis avec `--settings` compte toujours pour cette session, sauf si les paramètres gérés définissent cette clé474 * `true` : un `fastMode: true` enregistré n'active plus le mode rapide au démarrage de la session, donc chaque personne exécute `/fast` dans chaque session où elle le souhaite ; un `fastMode: true` transmis avec `--settings` compte toujours pour cette session, sauf si les paramètres gérés définissent cette clé

475 * `false` : un `fastMode: true` enregistré active le mode rapide au démarrage de chaque nouvelle session sur un modèle pris en charge475 * `false` : un `fastMode: true` enregistré fonctionne comme le décrit [`fastMode`](#fastmode)

476* **Valeur par défaut** : `false`476* **Valeur par défaut** : `false`

477 477 

478```json settings.json theme={null}478```json settings.json theme={null}

sub-agents.md +2 −0

Details

592Le mode de permission de la conversation principale décide si Claude Code utilise la valeur que vous définissez :592Le mode de permission de la conversation principale décide si Claude Code utilise la valeur que vous définissez :

593 593 

594* Lorsque la conversation principale est en `bypassPermissions`, `acceptEdits` ou [mode auto](https://code.claude.com/docs/fr/permission-modes.md#eliminate-prompts-with-auto-mode), le sous-agent s'exécute dans ce même mode et Claude Code ignore le `permissionMode` que vous définissez. En mode auto, le classifieur évalue les appels d'outils du sous-agent avec les règles de blocage et d'autorisation de la conversation principale. Lorsque le sous-agent se termine, le classifieur examine également son travail et son rapport final avant que le rapport soit livré, comme [Comment le mode auto gère les sous-agents](https://code.claude.com/docs/fr/permission-modes.md#eliminate-prompts-with-auto-mode) le décrit.594* Lorsque la conversation principale est en `bypassPermissions`, `acceptEdits` ou [mode auto](https://code.claude.com/docs/fr/permission-modes.md#eliminate-prompts-with-auto-mode), le sous-agent s'exécute dans ce même mode et Claude Code ignore le `permissionMode` que vous définissez. En mode auto, le classifieur évalue les appels d'outils du sous-agent avec les règles de blocage et d'autorisation de la conversation principale. Lorsque le sous-agent se termine, le classifieur examine également son travail et son rapport final avant que le rapport soit livré, comme [Comment le mode auto gère les sous-agents](https://code.claude.com/docs/fr/permission-modes.md#eliminate-prompts-with-auto-mode) le décrit.

595 

596 Si un sous-agent demande une permission alors que la conversation principale est en `bypassPermissions`, vérifiez si son appel d'outil fait partie des [actions qu'aucun mode n'approuve automatiquement](https://code.claude.com/docs/fr/permission-modes.md#actions-no-mode-auto-approves).

595* Lorsque la conversation principale est en mode `plan`, le sous-agent reste en mode plan quel que soit le `permissionMode` que vous définissez, sauf s'il s'exécute en tant que [coéquipier d'une équipe d'agents](#subagent-names) selon les [règles des équipes d'agents](https://code.claude.com/docs/fr/agent-teams.md#have-teammates-plan-before-implementing). Si vous définissez `dontAsk`, le sous-agent ne vous sollicite pas non plus : une action que le mode plan vous demanderait d'approuver est refusée à la place.597* Lorsque la conversation principale est en mode `plan`, le sous-agent reste en mode plan quel que soit le `permissionMode` que vous définissez, sauf s'il s'exécute en tant que [coéquipier d'une équipe d'agents](#subagent-names) selon les [règles des équipes d'agents](https://code.claude.com/docs/fr/agent-teams.md#have-teammates-plan-before-implementing). Si vous définissez `dontAsk`, le sous-agent ne vous sollicite pas non plus : une action que le mode plan vous demanderait d'approuver est refusée à la place.

596* Lorsque la conversation principale est en mode `default` ou `dontAsk`, le sous-agent s'exécute dans le mode de permission que vous définissez. Il conserve plutôt le mode de permission de la conversation principale dans les cas suivants :598* Lorsque la conversation principale est en mode `default` ou `dontAsk`, le sous-agent s'exécute dans le mode de permission que vous définissez. Il conserve plutôt le mode de permission de la conversation principale dans les cas suivants :

597 * Vous définissez `bypassPermissions`. L'exception `bypassPermissions` nécessite Claude Code v2.1.267 ou ultérieur.599 * Vous définissez `bypassPermissions`. L'exception `bypassPermissions` nécessite Claude Code v2.1.267 ou ultérieur.

Details

26| `CronDelete` | Annule une tâche planifiée limitée à la session par ID | Non |26| `CronDelete` | Annule une tâche planifiée limitée à la session par ID | Non |

27| `CronList` | Liste toutes les tâches planifiées limitées à la session | Non |27| `CronList` | Liste toutes les tâches planifiées limitées à la session | Non |

28| `Edit` | Effectue des modifications ciblées sur des fichiers spécifiques. Consultez [Comportement de l'outil Edit](#edit-tool-behavior) | Oui |28| `Edit` | Effectue des modifications ciblées sur des fichiers spécifiques. Consultez [Comportement de l'outil Edit](#edit-tool-behavior) | Oui |

29| `EndConversation` | Termine la session, dans les rares cas d'entrée abusive soutenue ou quand vous demandez à Claude de démontrer l'outil. Consultez [Comportement de l'outil EndConversation](#endconversation-tool-behavior) | Non |29| `EndConversation` | Termine la session, dans les rares cas d'entrée abusive soutenue ou quand vous demandez à Claude de mettre fin à la session puis confirmez. Consultez [Comportement de l'outil EndConversation](#endconversation-tool-behavior) | Non |

30| `EnterPlanMode` | Bascule en mode plan pour concevoir une approche avant de coder | Non |30| `EnterPlanMode` | Bascule en mode plan pour concevoir une approche avant de coder | Non |

31| `EnterWorktree` | Crée un [git worktree](https://code.claude.com/docs/fr/worktrees.md) isolé et y bascule, ou bascule dans un worktree existant. Consultez [Comportement de l'outil EnterWorktree](#enterworktree-tool-behavior) | Oui |31| `EnterWorktree` | Crée un [git worktree](https://code.claude.com/docs/fr/worktrees.md) isolé et y bascule, ou bascule dans un worktree existant. Consultez [Comportement de l'outil EnterWorktree](#enterworktree-tool-behavior) | Oui |

32| `ExitPlanMode` | Présente un plan pour approbation et quitte le mode plan | Oui |32| `ExitPlanMode` | Présente un plan pour approbation et quitte le mode plan | Oui |


274 274 

275L'outil EndConversation termine la session actuelle. Claude l'utilise uniquement dans deux situations :275L'outil EndConversation termine la session actuelle. Claude l'utilise uniquement dans deux situations :

276 276 

277* en dernier recours contre une entrée abusive soutenue, après des tentatives de redirection de la conversation qui ont échoué et après un avertissement clair dans un message antérieur277* lorsque vous continuez à envoyer des messages abusifs après que Claude a donné un avertissement clair et n'a pas réussi à rediriger la conversation

278* lorsque vous demandez explicitement de voir l'outil démontré et confirmez que vous souhaitez terminer la session278* lorsque vous demandez explicitement à Claude de terminer la session, puis confirmez lorsque Claude vous demande si vous souhaitez toujours continuer

279 279 

280La frustration générale, les jurons ou une tâche qui se déroule mal ne sont pas qualifiants, tout comme les demandes de contenu nuisible, que Claude refuse au lieu de terminer la session. Claude Code suit la même approche que claude.ai, qui peut [terminer un sous-ensemble rare de conversations](https://www.anthropic.com/research/end-subset-conversations).280La frustration générale, les jurons ou une tâche qui se déroule mal ne sont pas qualifiants, tout comme les demandes de contenu nuisible, que Claude refuse au lieu de terminer la session. Claude Code suit la même approche que claude.ai, qui peut [terminer un sous-ensemble rare de conversations](https://www.anthropic.com/research/end-subset-conversations).

281 281 


390 390 

391Quand Monitor exécute une commande, il utilise les mêmes [règles de permission que Bash](https://code.claude.com/docs/fr/permissions.md#tool-specific-permission-rules), donc les motifs `allow` et `deny` que vous avez définis pour Bash s'appliquent ici aussi. Tandis que le [mode auto](https://code.claude.com/docs/fr/permission-modes.md#eliminate-prompts-with-auto-mode) est actif, Claude Code met de côté les règles d'autorisation qui nomment `Monitor` lui-même, ainsi que les autres [règles d'autorisation larges qu'il abandonne](https://code.claude.com/docs/fr/permission-modes.md#how-the-classifier-evaluates-actions), donc le classificateur examine les commandes Monitor de la même manière qu'il examine les commandes Bash.391Quand Monitor exécute une commande, il utilise les mêmes [règles de permission que Bash](https://code.claude.com/docs/fr/permissions.md#tool-specific-permission-rules), donc les motifs `allow` et `deny` que vous avez définis pour Bash s'appliquent ici aussi. Tandis que le [mode auto](https://code.claude.com/docs/fr/permission-modes.md#eliminate-prompts-with-auto-mode) est actif, Claude Code met de côté les règles d'autorisation qui nomment `Monitor` lui-même, ainsi que les autres [règles d'autorisation larges qu'il abandonne](https://code.claude.com/docs/fr/permission-modes.md#how-the-classifier-evaluates-actions), donc le classificateur examine les commandes Monitor de la même manière qu'il examine les commandes Bash.

392 392 

393La [source WebSocket](#websocket-source) a sa propre demande d'approbation, que le classificateur décide également en mode auto.

394 

395Monitor nécessite une version minimale ou Git Bash dans les cas suivants :393Monitor nécessite une version minimale ou Git Bash dans les cas suivants :

396 394 

397* **Version minimale** : sur Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform ou Microsoft Foundry, ou lorsque `DISABLE_TELEMETRY` ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` est défini, Monitor nécessite Claude Code v2.1.310 ou une version ultérieure. Cette exigence s'applique lorsque la [récupération des feature flags](https://code.claude.com/docs/fr/env-vars.md#features-that-need-feature-flag-fetching) est désactivée395* **Version minimale** : sur Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform ou Microsoft Foundry, ou lorsque `DISABLE_TELEMETRY` ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` est défini, Monitor nécessite Claude Code v2.1.310 ou une version ultérieure. Cette exigence s'applique lorsque la [récupération des feature flags](https://code.claude.com/docs/fr/env-vars.md#features-that-need-feature-flag-fetching) est désactivée


417 415 

418L'échéance `timeout_ms` s'applique également à une surveillance WebSocket : la surveillance se termine à l'échéance, et `TaskStop` l'annule plus tôt.416L'échéance `timeout_ms` s'applique également à une surveillance WebSocket : la surveillance se termine à l'échéance, et `TaskStop` l'annule plus tôt.

419 417 

420L'ouverture d'un WebSocket demande une approbation ; en [mode auto](https://code.claude.com/docs/fr/permission-modes.md#eliminate-prompts-with-auto-mode) le classificateur décide à la place. La demande n'offre pas d'option pour ignorer les futures demandes pour le même hôte.418Sans règle d'autorisation `Monitor`, une demande de permission vous est présentée avant que Claude ouvre un WebSocket ; en [mode auto](https://code.claude.com/docs/fr/permission-modes.md#eliminate-prompts-with-auto-mode), le classificateur décide à la place, sauf si une [règle de demande](#bash-rules-that-deny-or-prompt-for-websocket-watches) s'applique. La demande n'offre pas d'option pour ignorer les futures demandes pour le même hôte.

419 

420#### Adresses et hôtes refusés aux surveillances WebSocket

421 

422Claude Code refuse les URL qui pointent vers une adresse privée, link-local, ou de métadonnées cloud, y compris les noms d'hôte que votre machine résout en une telle adresse. Derrière un [proxy](https://code.claude.com/docs/fr/network-config.md#proxy-configuration), une surveillance peut atteindre une adresse privée, link-local ou de métadonnées cloud, sauf si le proxy la bloque, car Claude Code ne vérifie pas l'adresse trouvée par le proxy. Claude Code refuse également les hôtes dans `sandbox.network.deniedDomains`, et quand [`allowManagedDomainsOnly`](https://code.claude.com/docs/fr/settings-reference#sandbox-network-allowmanageddomainsonly) est défini dans les paramètres gérés, tout hôte en dehors de la liste d'autorisation gérée.

423 

424Si une surveillance derrière un proxy échoue avec `could not resolve <host>`, redémarrez Claude Code v2.1.319 ou une version ultérieure avec [`CLAUDE_CODE_PROXY_RESOLVES_HOSTS`](https://code.claude.com/docs/fr/env-vars#variables) défini sur `1` afin que le proxy résolve le nom d'hôte.

425 

426#### Règles Bash qui refusent ou demandent une confirmation pour les surveillances WebSocket

427 

428Si Claude Code refuse un appel `Monitor` qui ouvre un WebSocket, recherchez une [règle de refus ou de demande](https://code.claude.com/docs/fr/permissions.md#manage-permissions) écrite `Bash` ou `Bash(*)`. Faites de même s'il vous demande une confirmation pour cet appel malgré votre règle d'autorisation `Monitor`. Une règle portant sur toutes les commandes Bash couvre également ces surveillances WebSocket :

429 

430* **Règle de refus** : si la règle est en place au démarrage de la session, Claude ne dispose pas de l'outil Monitor et ne peut donc pas démarrer la surveillance. Si vous ajoutez la règle en cours de session, le prochain appel `Monitor` de Claude est refusé. Le message de refus est `Permission to use Monitor has been denied: it runs code as Bash does, and a rule denies Bash.`

431* **Règle de demande** : il vous est demandé d'approuver la surveillance. Ni une règle d'autorisation, ni un hook `PreToolUse`, ni le mode `bypassPermissions`, ni le classificateur du mode auto ne peuvent l'approuver à votre place. Vous pouvez l'approuver depuis un [hook `PermissionRequest`](https://code.claude.com/docs/fr/hooks#permissionrequest). Lorsque personne ne peut répondre, comme en mode `dontAsk`, Claude Code refuse la surveillance.

432 

433Pour permettre à ces surveillances de s'exécuter, restreignez la règle aux commandes que vous visez, comme `Bash(rm *)`.

421 434 

422Claude Code refuse les URL qui pointent vers une adresse privée, link-local, ou de métadonnées cloud, y compris les noms d'hôte qui se résolvent en une. Il refuse également les hôtes dans `sandbox.network.deniedDomains`, et quand [`allowManagedDomainsOnly`](https://code.claude.com/docs/fr/settings-reference#sandbox-network-allowmanageddomainsonly) est défini dans les paramètres gérés, tout hôte en dehors de la liste d'autorisation gérée.435La règle de demande, ainsi qu'une règle de refus ajoutée en cours de session, couvrent ces surveillances dans Claude Code v2.1.319 ou une version ultérieure.

423 436 

424## Comportement de l'outil NotebookEdit437## Comportement de l'outil NotebookEdit

425 438 


594* Les exécutions non interactives `-p` et les sessions [Agent SDK](https://code.claude.com/docs/fr/agent-sdk/overview.md), qui n'ont pas d'écran pour examiner la file d'attente607* Les exécutions non interactives `-p` et les sessions [Agent SDK](https://code.claude.com/docs/fr/agent-sdk/overview.md), qui n'ont pas d'écran pour examiner la file d'attente

595* Les [sessions cloud](https://code.claude.com/docs/fr/claude-code-on-the-web.md), qui ne peuvent pas écrire dans la file d'attente sur votre machine608* Les [sessions cloud](https://code.claude.com/docs/fr/claude-code-on-the-web.md), qui ne peuvent pas écrire dans la file d'attente sur votre machine

596* Les sessions sur [Amazon Bedrock](https://code.claude.com/docs/fr/amazon-bedrock.md), [Claude Platform on AWS](https://code.claude.com/docs/fr/claude-platform-on-aws.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/fr/google-vertex-ai.md), ou [Microsoft Foundry](https://code.claude.com/docs/fr/microsoft-foundry.md)609* Les sessions sur [Amazon Bedrock](https://code.claude.com/docs/fr/amazon-bedrock.md), [Claude Platform on AWS](https://code.claude.com/docs/fr/claude-platform-on-aws.md), [Google Cloud's Agent Platform](https://code.claude.com/docs/fr/google-vertex-ai.md), ou [Microsoft Foundry](https://code.claude.com/docs/fr/microsoft-foundry.md)

610* Les sessions qui accèdent à Claude via une [passerelle LLM](https://code.claude.com/docs/fr/llm-gateway) avec la clé ou le jeton propre à la passerelle

597* Les sessions où vous avez défini [`CLAUDE_CODE_SEND_FEEDBACK=0`](https://code.claude.com/docs/fr/env-vars) ou [`DISABLE_FEEDBACK_COMMAND=1`](https://code.claude.com/docs/fr/env-vars), défini `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` sur une valeur non vide, ou désactivé [feature-flag fetching](https://code.claude.com/docs/fr/env-vars.md#features-that-need-feature-flag-fetching)611* Les sessions où vous avez défini [`CLAUDE_CODE_SEND_FEEDBACK=0`](https://code.claude.com/docs/fr/env-vars) ou [`DISABLE_FEEDBACK_COMMAND=1`](https://code.claude.com/docs/fr/env-vars), défini `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` sur une valeur non vide, ou désactivé [feature-flag fetching](https://code.claude.com/docs/fr/env-vars.md#features-that-need-feature-flag-fetching)

598* Les organisations qui ont désactivé les commentaires sur les produits, les [organisations avec rétention zéro des données](https://code.claude.com/docs/fr/zero-data-retention.md#features-disabled-under-zdr), et les organisations où la [configuration HIPAA](https://code.claude.com/docs/fr/hipaa-setup.md) est appliquée612* Les organisations qui ont désactivé les commentaires sur les produits, les [organisations avec rétention zéro des données](https://code.claude.com/docs/fr/zero-data-retention.md#features-disabled-under-zdr), et les organisations où la [configuration HIPAA](https://code.claude.com/docs/fr/hipaa-setup.md) est appliquée

613* Les sessions où Claude Code a [cessé de proposer des commentaires après un rapport refusé](https://code.claude.com/docs/fr/errors.md#feedback-is-disabled-by-your-organizations-policy)

599 614 

600## Disponibilité de l'outil Task615## Disponibilité de l'outil Task

601 616 

Details

70 70 

71### Disponibilité des modèles sous ZDR71### Disponibilité des modèles sous ZDR

72 72 

73Claude Fable 5.1 et Fable 5 sont des [modèles couverts](https://support.claude.com/en/articles/15425695-covered-models) qui [nécessitent la rétention de données](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements) par défaut, et la possibilité pour une organisation ou un espace de travail ZDR de les utiliser est régie par les politiques des modèles couverts plutôt que par Claude Code. Lorsque votre organisation ne peut pas les utiliser, les modèles sont soit absents du sélecteur `/model`, soit affichés comme désactivés, et le serveur rejette les demandes pour ceux-ci quel que soit la configuration du client.73Claude Fable 5.2, Fable 5.1 et Fable 5 sont des [modèles couverts](https://support.claude.com/en/articles/15425695-covered-models) qui [nécessitent la rétention de données](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements) par défaut, et la possibilité pour une organisation ou un espace de travail ZDR de les utiliser est régie par les politiques des modèles couverts plutôt que par Claude Code. Lorsque votre organisation ne peut pas les utiliser, les modèles sont soit absents du sélecteur `/model`, soit affichés comme désactivés, et le serveur rejette les requêtes pour ceux-ci quelle que soit la configuration du client.

74 74 

75Les autres modèles restent disponibles sous ZDR. Les modèles Fable ne sont pas le modèle par défaut, et l'alias `best`, qui se résout en dernier modèle Fable où il est disponible, se résout en Opus pour les organisations où il ne l'est pas.75Les autres modèles restent disponibles sous ZDR. Les modèles Fable ne sont pas le modèle par défaut, et l'alias `best` se résout en Opus.

76 76 

77## Conservation des données pour les violations de politique77## Conservation des données pour les violations de politique

78 78