Documentation — Spybara

amazon-bedrock.md +8 −3

Details

349 349

350### Lorsqu'un modèle est désactivé en cours de session350### Lorsqu'un modèle est désactivé en cours de session

351 351

352Si votre compte perd l'accès au modèle sur lequel votre session s'exécute, par exemple parce qu'un administrateur le désactive dans votre compte Amazon Bedrock, Claude Code bascule la session vers un autre modèle au lieu d'échouer à chaque requête, et affiche `Switched to <fallback> because <model> is not available`. Il essaie les mêmes modèles que le basculement au démarrage : les versions antérieures du même niveau d'abord et, pour une session Opus sans version Opus disponible, le modèle Sonnet par défaut.352Lorsqu'Amazon Bedrock rejette le modèle de votre session comme indisponible pour votre compte, Claude Code bascule votre session vers un autre modèle, et vous pouvez continuer à travailler. Vous voyez un message qui commence par `Switched to <fallback> because <model> is not available`. Cela se produit, par exemple, lorsqu'un administrateur désactive le modèle ou que le modèle le plus récent n'est pas encore disponible pour votre compte.

353 353

354Le basculement s'applique uniquement à un niveau que vous n'avez pas épinglé, la même condition que le basculement au démarrage. Une session sur une version spécifique que vous avez choisie, ou sur un [ARN de profil d'inférence d'application](#map-each-model-version-to-an-inference-profile), conserve son modèle et, sans chaîne de modèles de secours, la requête échoue à la place. En [mode auto](https://code.claude.com/docs/fr/permission-modes.md#enable-auto-mode-on-bedrock-agent-platform-or-foundry), Claude Code bascule uniquement vers un modèle que le mode auto prend en charge sur Amazon Bedrock. Si aucun de ces modèles n'est disponible non plus, la requête échoue avec [AWS authentication failed](https://code.claude.com/docs/fr/errors.md#aws-authentication-failed) et un conseil pour activer le modèle.354Si vous avez configuré une [chaîne de modèles de secours](https://code.claude.com/docs/fr/model-config.md#fallback-model-chains), Claude Code bascule plutôt vers votre modèle de secours configuré. Sans chaîne, la requête échoue dans des cas tels que ceux-ci :

355 355

356Une [chaîne de modèles de secours](https://code.claude.com/docs/fr/model-config.md#fallback-model-chains) que vous configurez remplace le basculement de niveau : sur ces refus, Claude Code bascule vers votre modèle de secours configuré à la place. Pour que les requêtes refusées échouent plutôt que de basculer, définissez [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](https://code.claude.com/docs/fr/env-vars). Une chaîne de secours que vous avez configurée bascule toujours sur ces refus ; supprimez également la chaîne si vous voulez que chaque requête refusée échoue.356* Votre session utilise un modèle épinglé, une version spécifique que vous avez choisie ou un [ARN de profil d'inférence d'application](#map-each-model-version-to-an-inference-profile)

357* Aucun des [modèles que Claude Code essaie](#startup-model-checks) n'est disponible. En [mode auto](https://code.claude.com/docs/fr/permission-modes.md#enable-auto-mode-on-bedrock-agent-platform-or-foundry), Claude Code bascule uniquement vers un modèle que le mode auto prend en charge sur Amazon Bedrock.

358

359Pour continuer à travailler, exécutez `/model` dans la session et appuyez sur `s` sur un modèle que votre compte peut utiliser, ce qui laisse votre valeur par défaut inchangée. Une erreur `403` s'affiche sous la forme [AWS authentication failed](https://code.claude.com/docs/fr/errors.md#aws-authentication-failed).

360

361Pour que les requêtes refusées échouent plutôt que de basculer, définissez [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](https://code.claude.com/docs/fr/env-vars). Si vous avez configuré une chaîne de modèles de secours, supprimez-la également, car Claude Code bascule toujours vers ce modèle de secours.

357 362

358## Préfixes de profil d'inférence inter-régions363## Préfixes de profil d'inférence inter-régions

359 364

best-practices.md +1 −1

Details

315 {315 {

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

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

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

319 ]319 ]

320 }320 }

321 ]321 ]

claude-apps-gateway.md +3 −1

Details

74| PostgreSQL 11 ou ultérieur | Prend en charge le flux de connexion par appareil et les compteurs de limite de débit. Un service PostgreSQL géré convient, y compris le plus petit niveau ; consultez [quelles bases de données sont prises en charge](https://code.claude.com/docs/fr/claude-apps-gateway-deploy.md#postgres). Avec les [limites de dépenses](https://code.claude.com/docs/fr/claude-apps-gateway-spend-limits.md), il contient également des tables durables de dépenses, d'audit et d'identité qui doivent être sauvegardées. TLS via `?sslmode=require` est recommandé. PostgreSQL 11, 12 et 13 nécessitent Claude Code v2.1.290 ou ultérieur sur le serveur de la passerelle. Le projet PostgreSQL ne maintient plus ces versions ; utilisez donc une version plus récente lorsque c'est possible. |74| PostgreSQL 11 ou ultérieur | Prend en charge le flux de connexion par appareil et les compteurs de limite de débit. Un service PostgreSQL géré convient, y compris le plus petit niveau ; consultez [quelles bases de données sont prises en charge](https://code.claude.com/docs/fr/claude-apps-gateway-deploy.md#postgres). Avec les [limites de dépenses](https://code.claude.com/docs/fr/claude-apps-gateway-spend-limits.md), il contient également des tables durables de dépenses, d'audit et d'identité qui doivent être sauvegardées. TLS via `?sslmode=require` est recommandé. PostgreSQL 11, 12 et 13 nécessitent Claude Code v2.1.290 ou ultérieur sur le serveur de la passerelle. Le projet PostgreSQL ne maintient plus ces versions ; utilisez donc une version plus récente lorsque c'est possible. |

75| Upstream de modèle | Identifiants Amazon Bedrock, identifiants Claude Platform on AWS, identifiants Google Cloud, une ressource Microsoft Foundry ou une clé API Anthropic. Plusieurs upstreams sont pris en charge avec basculement. |75| Upstream de modèle | Identifiants Amazon Bedrock, identifiants Claude Platform on AWS, identifiants Google Cloud, une ressource Microsoft Foundry ou une clé API Anthropic. Plusieurs upstreams sont pris en charge avec basculement. |

76| HTTPS | La passerelle doit être accessible via `https://` depuis les ordinateurs portables des développeurs et depuis tout navigateur utilisé pour la connexion ; la passerelle sert la page de vérification de l'appareil sur le même listener. Fournissez un certificat TLS via `listen.tls` ou exécutez-la derrière un ingress qui termine TLS, et définissez `listen.public_url` sur l'origine externe dans les deux cas. Lors de `/login`, Claude Code n'accepte une origine `http://` simple que lorsque l'hôte de la passerelle est une adresse de loopback : `localhost`, `127.0.0.1` ou `::1`. |76| HTTPS | La passerelle doit être accessible via `https://` depuis les ordinateurs portables des développeurs et depuis tout navigateur utilisé pour la connexion ; la passerelle sert la page de vérification de l'appareil sur le même listener. Fournissez un certificat TLS via `listen.tls` ou exécutez-la derrière un ingress qui termine TLS, et définissez `listen.public_url` sur l'origine externe dans les deux cas. Lors de `/login`, Claude Code n'accepte une origine `http://` simple que lorsque l'hôte de la passerelle est une adresse de loopback : `localhost`, `127.0.0.1` ou `::1`. |

77| Adresse de réseau privé | Lors de `/login`, Claude Code exige que le nom d'hôte ou l'adresse IP de la passerelle se résolve uniquement en adresses privées : RFC 1918, link-local, CGNAT `100.64.0.0/10`, IPv6 ULA `fc00::/7` ou loopback. Pour une passerelle que vous hébergez, toute adresse publique en dehors d'un bloc que vous déclarez est rejetée ; consultez le [modèle de menaces](https://code.claude.com/docs/fr/claude-apps-gateway-deploy.md#threat-model-summary) dans le guide de déploiement. Si les machines des développeurs acheminent le trafic HTTPS via un proxy d'entreprise, la connexion exige également que l'hôte du proxy se résolve en adresses privées ; si ce n'est pas le cas, ajoutez l'hôte de la passerelle à `NO_PROXY` afin que la CLI se connecte directement. Si votre réseau interne est numéroté à partir d'un espace IPv4 public appartenant à votre organisation, [déclarez ces blocs](#allow-a-gateway-on-public-address-space-you-own) afin que `/login` accepte une passerelle à cet emplacement. |77| Adresse de réseau privé | Le `/login` de Claude Code exige que le nom d'hôte ou l'adresse IP de la passerelle se résolve uniquement en adresses privées : plages RFC 1918 et link-local, CGNAT `100.64.0.0/10`, IPv6 ULA `fc00::/7` et loopback. Consultez le [modèle de menaces](https://code.claude.com/docs/fr/claude-apps-gateway-deploy.md#threat-model-summary). Si votre réseau interne est numéroté à partir d'un espace IPv4 public appartenant à votre organisation, [déclarez ces blocs](#allow-a-gateway-on-public-address-space-you-own) afin que `/login` accepte une passerelle à cet emplacement. |

78| Environnement d'exécution Linux | Le serveur de la passerelle s'exécute uniquement sur le binaire Linux natif. macOS fonctionne pour le développement local. Windows n'est pas pris en charge comme plateforme serveur. |78| Environnement d'exécution Linux | Le serveur de la passerelle s'exécute uniquement sur le binaire Linux natif. macOS fonctionne pour le développement local. Windows n'est pas pris en charge comme plateforme serveur. |

79 79

80Lorsque `HTTPS_PROXY` ou `HTTP_PROXY` s'applique à l'hôte de la passerelle, la connexion nécessite également soit un proxy dont le nom d'hôte se résout en adresses privées, soit l'hôte de la passerelle dans `NO_PROXY` sur les machines des développeurs. Si ces machines définissent également `no_proxy`, ajoutez-y aussi l'hôte de la passerelle, sinon les requêtes de modèle passent toujours par le proxy.

80### Étapes82### Étapes

81 83

82**1. Enregistrer un client OAuth dans votre IdP**84**1. Enregistrer un client OAuth dans votre IdP**

claude-apps-gateway-config.md +8 −2

Details

656 656

657| Configuration | Comment |657| Configuration | Comment |

658| - | - |658| - | - |

659| RBAC | Accordez à l'identité de la passerelle `Azure AI User` ou `Cognitive Services User` sur la ressource Microsoft Foundry |659| RBAC | Accordez à l'identité de la passerelle le rôle `Foundry User` ou `Cognitive Services User` sur la ressource Microsoft Foundry |

660| Déploiements | Microsoft Foundry utilise les noms de déploiement choisis par l'administrateur, pas les ID de modèle canoniques. Ajoutez un bloc [`models:`](#models) mappant chaque ID canonique à votre nom de déploiement. |660| Déploiements | Microsoft Foundry utilise les noms de déploiement choisis par l'administrateur, pas les ID de modèle canoniques. Ajoutez un bloc [`models:`](#models) mappant chaque ID canonique à votre nom de déploiement. |

661| AKS (workload identity) | Fédérez une identité gérée attribuée par l'utilisateur avec l'émetteur OIDC du cluster et liez-la au compte de service de la passerelle. `use_azure_ad: true` la récupère via `WorkloadIdentityCredential`. |661| AKS (workload identity) | Fédérez une identité gérée attribuée par l'utilisateur avec l'émetteur OIDC du cluster et liez-la au compte de service de la passerelle. `use_azure_ad: true` la récupère via `WorkloadIdentityCredential`. |

662| ACI / App Service | Activez l'identité gérée attribuée par le système ou l'utilisateur sur la ressource. `use_azure_ad: true` la récupère. |662| ACI / App Service | Activez l'identité gérée attribuée par le système ou l'utilisateur sur la ressource. `use_azure_ad: true` la récupère. |

1001 1001

1002Chaque clé sous `upstream_model` doit correspondre au `name` d'un upstream configuré, qui par défaut est le nom du fournisseur. Une clé qui ne correspond à aucun upstream fait échouer le démarrage, donc omettez les lignes pour les fournisseurs que vous n'utilisez pas.1002Chaque clé sous `upstream_model` doit correspondre au `name` d'un upstream configuré, qui par défaut est le nom du fournisseur. Une clé qui ne correspond à aucun upstream fait échouer le démarrage, donc omettez les lignes pour les fournisseurs que vous n'utilisez pas.

1003 1003

1004Pour permettre aux développeurs d'utiliser l'alias `fable` avec `auto_include_builtin_models: false`, ajoutez une entrée `claude-fable-5` à `models`. C'est l'ID vers lequel l'[alias `fable`](https://code.claude.com/docs/fr/model-config#fable-alias-resolution) se résout pour les développeurs connectés à la passerelle. Sans elle, leurs messages échouent avec une erreur qui commence par `API Error: 400 model claude-fable-5 is not in the operator's model allowlist`.

1005

1004### `managed`1006### `managed`

1005 1007

1006Le bloc `managed` définit des politiques d'accès basées sur les rôles, indexées sur les groupes IdP ou le domaine e-mail. Les politiques sont évaluées dans l'ordre ; par défaut, la première correspondance est sélectionnée, puis fusionnée sur la base fourre-tout `match: {}`. Un utilisateur correspondant à deux politiques de rôle n'obtient que la première, de sorte que les règles de refus de la seconde politique ne s'appliquent pas, sauf si vous [appliquez toutes les politiques correspondantes](#apply-every-matching-policy). Les politiques sont servies par utilisateur à `GET /managed/settings` avec une mise en cache ETag/304.1008Le bloc `managed` définit des politiques d'accès basées sur les rôles, indexées sur les groupes IdP ou le domaine e-mail. Les politiques sont évaluées dans l'ordre ; par défaut, la première correspondance est sélectionnée, puis fusionnée sur la base fourre-tout `match: {}`. Un utilisateur correspondant à deux politiques de rôle n'obtient que la première, de sorte que les règles de refus de la seconde politique ne s'appliquent pas, sauf si vous [appliquez toutes les politiques correspondantes](#apply-every-matching-policy). Les politiques sont servies par utilisateur à `GET /managed/settings` avec une mise en cache ETag/304.

1025Un fourre-tout `match: {}`, conventionnellement listé en dernier, est traité comme une couche de base. Chaque autre politique hérite du fourre-tout toute clé qu'elle ne définit pas, afin que les entrées par rôle n'aient besoin de lister que ce qui diffère de la valeur par défaut de l'organisation. Les règles de fusion dépendent du type de clé :1027Un fourre-tout `match: {}`, conventionnellement listé en dernier, est traité comme une couche de base. Chaque autre politique hérite du fourre-tout toute clé qu'elle ne définit pas, afin que les entrées par rôle n'aient besoin de lister que ce qui diffère de la valeur par défaut de l'organisation. Les règles de fusion dépendent du type de clé :

1026 1028

1027* **Listes d'autorisation** : `availableModels` et `permissions.allow`. La liste d'une politique spécifique remplace complètement celle de la base.1029* **Listes d'autorisation** : `availableModels` et `permissions.allow`. La liste d'une politique spécifique remplace complètement celle de la base.

1028* **Listes de refus et tableaux de hooks** : `permissions.deny`, `permissions.ask`, `disabledMcpjsonServers`, `deniedMcpServers`, `blockedMarketplaces`, `deniedModels` et chaque tableau de type d'événement `hooks`. Ceux-ci prennent l'union de la base et de la politique, de sorte qu'un refus ou un hook d'audit à l'échelle de l'organisation ne puisse pas être supprimé accidentellement par un remplacement par rôle.1030* **Listes de refus et tableaux de hooks** : ceux-ci prennent l'union de la base et de la politique :

1031 * `permissions.deny` et `permissions.ask`

1032 * `disabledMcpjsonServers` et `deniedMcpServers`

1033 * `blockedMarketplaces` et `deniedModels`

1034 * Les tableaux de types d'événements `hooks`

1029* **Clés de type enregistrement** : `env`, `modelOverrides` et `skillOverrides`. Celles-ci fusionnent superficiellement, afin qu'un bloc `env` par rôle remplace les clés qu'il définit et hérite du reste de la base.1035* **Clés de type enregistrement** : `env`, `modelOverrides` et `skillOverrides`. Celles-ci fusionnent superficiellement, afin qu'un bloc `env` par rôle remplace les clés qu'il définit et hérite du reste de la base.

1030 1036

1031`availableModels` est également appliqué côté serveur à `/v1/messages`, afin qu'un modèle refusé retourne `400` indépendamment de ce que le client envoie. Une liste vide refuse tous les modèles. La vérification couvre également le modèle sur lequel une session démarre avant que le développeur n'en choisisse un ; [démarrez donc les sessions sur un modèle autorisé par la politique](#start-sessions-on-a-model-the-policy-allows).1037`availableModels` est également appliqué côté serveur à `/v1/messages`, afin qu'un modèle refusé retourne `400` indépendamment de ce que le client envoie. Une liste vide refuse tous les modèles. La vérification couvre également le modèle sur lequel une session démarre avant que le développeur n'en choisisse un ; [démarrez donc les sessions sur un modèle autorisé par la politique](#start-sessions-on-a-model-the-policy-allows).

claude-apps-gateway-deploy.md +1 −1

Details

92 92

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

94 94

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

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

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

98 98

claude-projects.md +2 −0

Details

274 274

275Le thread s'exécute en [mode auto](https://code.claude.com/docs/fr/permission-modes.md#eliminate-prompts-with-auto-mode), de sorte que Claude exécute des commandes et modifie des fichiers dans ce dossier sans vous demander à chaque fois. Si le mode auto n'est pas disponible ou est désactivé dans le Claude Code de cet ordinateur, le thread s'exécute sans lui, et toute demande de permission qu'il émet attend votre réponse dans le thread, comme le décrit [Débloquer un thread en attente d'approbation](#unblock-a-thread-waiting-on-approval).275Le thread s'exécute en [mode auto](https://code.claude.com/docs/fr/permission-modes.md#eliminate-prompts-with-auto-mode), de sorte que Claude exécute des commandes et modifie des fichiers dans ce dossier sans vous demander à chaque fois. Si le mode auto n'est pas disponible ou est désactivé dans le Claude Code de cet ordinateur, le thread s'exécute sans lui, et toute demande de permission qu'il émet attend votre réponse dans le thread, comme le décrit [Débloquer un thread en attente d'approbation](#unblock-a-thread-waiting-on-approval).

276 276

277Pour exécuter le thread dans un autre mode, démarrez `claude remote-control` avec [`--settings`](https://code.claude.com/docs/fr/remote-control#start-a-remote-control-session). [`permissions.defaultMode`](https://code.claude.com/docs/fr/permission-modes#start-in-a-different-mode), dans ce fichier ou dans les paramètres de cet ordinateur, peut alors choisir un autre mode.

278

277Pendant l'exécution du thread, une icône d'ordinateur portable dans son en-tête indique si votre ordinateur est connecté. Cliquez dessus pour voir quel dossier le thread utilise ou pour couper la connexion. Le thread se met en pause lorsque cet ordinateur est en veille, et s'arrête si l'application de bureau ou `claude remote-control` se ferme.279Pendant l'exécution du thread, une icône d'ordinateur portable dans son en-tête indique si votre ordinateur est connecté. Cliquez dessus pour voir quel dossier le thread utilise ou pour couper la connexion. Le thread se met en pause lorsque cet ordinateur est en veille, et s'arrête si l'application de bureau ou `claude remote-control` se ferme.

278 280

279* **Pour relancer le thread** : consultez [Lost contact with your folder](#lost-contact-with-your-folder)281* **Pour relancer le thread** : consultez [Lost contact with your folder](#lost-contact-with-your-folder)

commands.md +0 −2

Details

35Le tableau ci-dessous répertorie toutes les commandes incluses dans Claude Code. La plupart sont des commandes intégrées dont le comportement est codé dans la CLI. Deux types d'entrées sont signalés :35Le tableau ci-dessous répertorie toutes les commandes incluses dans Claude Code. La plupart sont des commandes intégrées dont le comportement est codé dans la CLI. Deux types d'entrées sont signalés :

36 36

37* **[Skill](https://code.claude.com/docs/fr/skills.md#bundled-skills)** : un skill fourni. Il fonctionne comme les skills que vous écrivez vous-même : un prompt transmis à Claude.37* **[Skill](https://code.claude.com/docs/fr/skills.md#bundled-skills)** : un skill fourni. Il fonctionne comme les skills que vous écrivez vous-même : un prompt transmis à Claude.

~~38 * `/verify` ne s'exécute que lorsque vous l'invoquez.~~

39* **[Workflow](https://code.claude.com/docs/fr/workflows.md#bundled-workflows)** : un [workflow dynamique](https://code.claude.com/docs/fr/workflows.md) fourni qui répartit le travail entre de nombreux sous-agents et s'exécute en arrière-plan.38* **[Workflow](https://code.claude.com/docs/fr/workflows.md#bundled-workflows)** : un [workflow dynamique](https://code.claude.com/docs/fr/workflows.md) fourni qui répartit le travail entre de nombreux sous-agents et s'exécute en arrière-plan.

~~40 * `/deep-research` ne s'exécute que lorsque vous l'invoquez.~~

41 39

42Pour ajouter vos propres commandes, consultez [skills](https://code.claude.com/docs/fr/skills.md).40Pour ajouter vos propres commandes, consultez [skills](https://code.claude.com/docs/fr/skills.md).

43 41

desktop-linux.md +1 −1

Details

71 71

72Lancez **Claude** à partir de votre lanceur d'applications, ou exécutez `claude-desktop` à partir d'un terminal, et connectez-vous avec votre compte Anthropic.72Lancez **Claude** à partir de votre lanceur d'applications, ou exécutez `claude-desktop` à partir d'un terminal, et connectez-vous avec votre compte Anthropic.

73 73

74L'application Linux se connecte de la même manière que sur macOS et Windows : avec un abonnement claude.ai, ou via le SSO de votre organisation. Pour l'authentification par clé API, utilisez la [CLI](https://code.claude.com/docs/fr/quickstart.md). Pour utiliser plutôt Desktop avec Amazon Bedrock, la plateforme Agent de Google Cloud, Microsoft Foundry ou une passerelle LLM, consultez [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview). Pour les proxys et les autorités de certification personnalisées dans ces déploiements, consultez la [configuration réseau](https://code.claude.com/docs/fr/network-config.md).74L'application Linux se connecte de la même manière que sur macOS et Windows : avec un abonnement claude.ai, ou via le SSO de votre organisation. Pour utiliser plutôt Desktop avec une clé API Claude, Amazon Bedrock, la plateforme Agent de Google Cloud, Microsoft Foundry ou une passerelle LLM, consultez [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview). Pour les proxys et les autorités de certification personnalisées dans ces déploiements, consultez la [configuration réseau](https://code.claude.com/docs/fr/network-config.md).

75 75

76### Installer à partir d'un fichier téléchargé76### Installer à partir d'un fichier téléchargé

77 77

desktop-scheduled-tasks.md +7 −2

Details

83 83

84**8. Choisir le mode de permission et le modèle**84**8. Choisir le mode de permission et le modèle**

85 85

86Dans la barre d'outils de la zone d'instructions, sélectionnez un [mode de permission](#permissions-for-scheduled-tasks) et un modèle. Si vous ne les modifiez pas, les exécutions utilisent vos paramètres Claude Code et le modèle par défaut.86Dans la barre d'outils de la zone d'instructions, sélectionnez un [mode de permission](#permissions-for-scheduled-tasks) et un modèle.

88* **Mode de permission** : si vous ne le modifiez pas, les exécutions utilisent vos paramètres Claude Code.

89* **Modèle** : si le menu des modèles affiche **Default · Set by admin** et que vous ne choisissez pas un autre modèle, les exécutions utilisent le modèle défini par votre organisation dans les [paramètres gérés](https://code.claude.com/docs/fr/managed-settings.md). Une [exécution de rattrapage](#missed-runs) qui démarre à l'ouverture de l'application peut plutôt utiliser le [modèle par défaut à l'exécution pour votre compte](https://code.claude.com/docs/fr/model-config.md#default-model-setting).

87 90

88**9. Créer la tâche**91**9. Créer la tâche**

89 92

90Cliquez sur **Create**. Si vous n'avez pas encore approuvé le dossier, Desktop vous demande de l'approuver à ce moment-là. La page de détails de la tâche s'ouvre.93Cliquez sur **Create**. Si vous n'avez pas encore approuvé le dossier, Desktop vous demande de l'approuver à ce moment-là. La page de détails de la tâche s'ouvre.

91 94

95Pour savoir à quel modèle correspond **Default · Set by admin**, cliquez sur **Run now** sur la page de détails pour exécuter la tâche immédiatement. Ensuite, [ouvrez la session de l'exécution](#find-a-runs-session) : la ligne située sous la zone de prompt affiche le nom du modèle.

92Sur la page de détails, cliquez sur l'icône en forme de crayon pour ouvrir le [formulaire **Edit**](#manage-scheduled-tasks). Vous pouvez y modifier la **Description** que Desktop a remplie à partir de vos instructions, sélectionner **Worktree** ou passer la planification en **Manual** ou **Custom**.97Sur la page de détails, cliquez sur l'icône en forme de crayon pour ouvrir le [formulaire **Edit**](#manage-scheduled-tasks). Vous pouvez y modifier la **Description** que Desktop a remplie à partir de vos instructions, sélectionner **Worktree** ou passer la planification en **Manual** ou **Custom**.

93 98

94Vous pouvez également créer une tâche en décrivant ce que vous souhaitez dans n'importe quelle session. Par exemple, « configurer une revue de code quotidienne qui s'exécute chaque matin à 9h » crée une tâche récurrente. Une demande comme « rappelle-moi à 15h demain de vérifier le déploiement » crée une tâche unique qui se désactive après son exécution.99Vous pouvez également créer une tâche en décrivant ce que vous souhaitez dans n'importe quelle session. Par exemple, « configurer une revue de code quotidienne qui s'exécute chaque matin à 9h » crée une tâche récurrente. Une demande comme « rappelle-moi à 15h demain de vérifier le déploiement » crée une tâche unique qui se désactive après son exécution.

181 186

182Pour permettre à une tâche de modifier sa propre planification ou son prompt avec l'outil MCP `update_scheduled_task`, cliquez sur **Run now** et approuvez l'appel à chaque fois.187Pour permettre à une tâche de modifier sa propre planification ou son prompt avec l'outil MCP `update_scheduled_task`, cliquez sur **Run now** et approuvez l'appel à chaque fois.

183 188

184Pour modifier le prompt d'une tâche sur le disque, ouvrez `~/.claude/scheduled-tasks/<task-name>/SKILL.md` (ou sous [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/fr/env-vars) si défini). Le fichier utilise le frontmatter YAML pour `name` et `description`, avec le prompt comme corps. Les modifications prennent effet à la prochaine exécution. La planification, le dossier, le modèle et l'état activé ne sont pas dans ce fichier : modifiez-les via le formulaire Edit ou demandez à Claude.189Pour modifier le prompt d'une tâche sur le disque, ouvrez `~/.claude/scheduled-tasks/<task-name>/SKILL.md` (ou sous [`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/fr/env-vars) si défini). Le fichier utilise le frontmatter YAML pour `name` et `description`, avec le prompt comme corps. Les modifications prennent effet à la prochaine exécution. La planification, le dossier et l'état activé ne sont pas dans ce fichier : modifiez-les via le formulaire Edit ou demandez à Claude.

185 190

186## Ressources connexes191## Ressources connexes

187 192

errors.md +51 −8

Details

122| `A request to MCP server "<name>" was sent without your stored credentials` | [Authentification](#couldnt-read-the-stored-credentials-for-mcp-server) |122| `A request to MCP server "<name>" was sent without your stored credentials` | [Authentification](#couldnt-read-the-stored-credentials-for-mcp-server) |

123| `This server's URL is missing or not a valid URL, so sign-in can't start` | [Authentification](#mcp-server-url-is-missing-or-not-a-valid-url) |123| `This server's URL is missing or not a valid URL, so sign-in can't start` | [Authentification](#mcp-server-url-is-missing-or-not-a-valid-url) |

124| `Issuer mismatch in authorization response (RFC 9207)` | [Authentification](#issuer-mismatch-in-authorization-response) |124| `Issuer mismatch in authorization response (RFC 9207)` | [Authentification](#issuer-mismatch-in-authorization-response) |

125| `Stopped an OAuth request` | [Authentification](#stopped-an-oauth-request) |

125| `Refusing to send credentials to non-https token endpoint` / `<short-name> from the MCP SDK for <server-url>` | [Authentification](#refusing-to-send-credentials-to-non-https-token-endpoint) |126| `Refusing to send credentials to non-https token endpoint` / `<short-name> from the MCP SDK for <server-url>` | [Authentification](#refusing-to-send-credentials-to-non-https-token-endpoint) |

252| `Remote Control did not start: "<question>" got no answer` | [Erreurs de ligne de commande](#remote-control-did-not-start-got-no-answer) |253| `Remote Control did not start: "<question>" got no answer` | [Erreurs de ligne de commande](#remote-control-did-not-start-got-no-answer) |

253| `` `<flag>` before `remote-control` is not carried over to the sessions Remote Control starts `` | [Erreurs de ligne de commande](#not-carried-over-to-the-sessions-remote-control-starts) |254| `` `<flag>` before `remote-control` is not carried over to the sessions Remote Control starts `` | [Erreurs de ligne de commande](#not-carried-over-to-the-sessions-remote-control-starts) |

255| `Remote Control did not start, because sessions would skip part or all of the --settings file` | [Erreurs de ligne de commande](#remote-control-did-not-start-because-of-the-settings-file) |

256| `The settings file <file> has changed since Remote Control started, so this session did not start` | [Erreurs de ligne de commande](#settings-file-changed-since-remote-control-started) |

254| `--sandbox is not supported by claude remote-control` / `--no-sandbox is not supported by claude remote-control` | [Erreurs de ligne de commande](#sandbox-is-not-supported-by-claude-remote-control) |257| `--sandbox is not supported by claude remote-control` / `--no-sandbox is not supported by claude remote-control` | [Erreurs de ligne de commande](#sandbox-is-not-supported-by-claude-remote-control) |

255| `` `claude import` is not yet available in this build `` | [Erreurs de ligne de commande](#claude-import-is-not-yet-available-in-this-build) |258| `` `claude import` is not yet available in this build `` | [Erreurs de ligne de commande](#claude-import-is-not-yet-available-in-this-build) |

266| `Error: MCP tool <name> (passed via --permission-prompt-tool) not found` | [Erreurs de ligne de commande](#mcp-permission-prompt-tool-not-found) |269| `Error: MCP tool <name> (passed via --permission-prompt-tool) not found` | [Erreurs de ligne de commande](#mcp-permission-prompt-tool-not-found) |

267| `OAuth callback port <port> is already in use — another process may be holding it` | [Erreurs de ligne de commande](#oauth-callback-port-is-already-in-use) |270| `OAuth callback port <port> is already in use — another process may be holding it` | [Erreurs de ligne de commande](#oauth-callback-port-is-already-in-use) |

269| `Shell command failed for pattern "..."`, depuis `/security-review` ou tout skill qui injecte du contexte dynamique | [Erreurs de ligne de commande](#security-review-fails-without-origin-head) |272| `Shell command failed for pattern "..."`, provenant de `/security-review` ou de tout skill qui injecte un contexte dynamique | [Erreurs de ligne de commande](#security-review-fails-without-origin-head) |

270| `Shell command permission check failed for pattern "..."`, provenant d'un skill qui injecte du contexte dynamique | [Erreurs de ligne de commande](#security-review-fails-without-origin-head) |273| `Shell command permission check failed for pattern "..."`, provenant d'un skill qui injecte du contexte dynamique | [Erreurs de ligne de commande](#security-review-fails-without-origin-head) |

271| ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found`` | [Erreurs de ligne de commande](#security-review-fails-without-origin-head) |274| ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found`` | [Erreurs de ligne de commande](#security-review-fails-without-origin-head) |

272| `No shell command in <name> was run, because the <tool> tool does not accept one of them` | [Erreurs de ligne de commande](#no-shell-command-was-run) |275| `No shell command in <name> was run, because the <tool> tool does not accept one of them` | [Erreurs de ligne de commande](#no-shell-command-was-run) |

825Les appels suivants dans la même réponse de Claude peuvent être refusés avec ce motif :828Les appels suivants dans la même réponse de Claude peuvent être refusés avec ce motif :

826 829

827```text theme={null}830```text theme={null}

828another call in this response was changed by a hook after auto mode reviewed it, or could not be confirmed unchanged831another call in this response was changed after auto mode reviewed it, or could not be confirmed unchanged

829```832```

830 833

831Claude peut alors émettre à nouveau chaque appel refusé afin que le serveur l'examine. Si une demande de permission s'ouvre, répondez-y. Vous n'avez rien d'autre à faire, sauf si Claude indique dans sa réponse que le mode auto n'a pas pu vérifier l'appel. Dans ce cas, arrêtez la modification ou approuvez l'appel vous-même, puis demandez à Claude de réessayer l'appel :834Claude peut alors émettre à nouveau chaque appel refusé afin que le serveur l'examine. Si une demande de permission s'ouvre, répondez-y. Vous n'avez rien d'autre à faire, sauf si Claude indique dans sa réponse que le mode auto n'a pas pu vérifier l'appel. Dans ce cas, arrêtez la modification ou approuvez l'appel vous-même, puis demandez à Claude de réessayer l'appel :

1822 1825

1823Avant la v2.1.232, Claude Code n'utilisait le runtime v2 que dans le cadre d'un déploiement progressif ou lorsque vous définissiez `MCP_SDK_GENERATION=v2`.1826Avant la v2.1.232, Claude Code n'utilisait le runtime v2 que dans le cadre d'un déploiement progressif ou lorsque vous définissiez `MCP_SDK_GENERATION=v2`.

1824 1827

1828### Stopped an OAuth request

1829

1830Ce message signifie que Claude Code a arrêté une [requête OAuth pour un serveur MCP](https://code.claude.com/docs/fr/mcp.md#authenticate-with-remote-mcp-servers) parce qu'un endpoint OAuth l'a redirigée. Dans les deux formes du message, la première adresse est celle qui a envoyé la redirection :

1831

1832```text theme={null}

1833Stopped an OAuth request, which can hold secrets: https://auth.example.com redirected it to https://other.example.com. Ask the owner of https://auth.example.com to remove that redirect.

1834Stopped an OAuth request: https://auth.example.com redirected it more than 5 times. Ask the owner of https://auth.example.com to fix those redirects.

1835```

1836

1837**Que faire :**

1838

1839* Demandez au responsable de la première adresse, par exemple l'opérateur du serveur MCP, de supprimer ou de corriger la redirection. Réessayez ensuite depuis `/mcp`.

1840

1825### Refus d'envoyer des identifiants à un endpoint de jeton non HTTPS1841### Refus d'envoyer des identifiants à un endpoint de jeton non HTTPS

1826 1842

1827Sur le [runtime v2](https://code.claude.com/docs/fr/mcp.md#mcp-client-runtimes), Claude Code n'envoie une requête de jeton [OAuth MCP](https://code.claude.com/docs/fr/mcp.md#authenticate-with-remote-mcp-servers) qu'à un endpoint de jeton servi en HTTPS ou sur `localhost`, `127.0.0.1` ou `::1`. Ce message signifie que l'endpoint de jeton du serveur n'est ni l'un ni l'autre ; Claude Code s'est donc arrêté avant d'envoyer la requête. Cela se produit après la connexion par navigateur, de sorte que l'étape du navigateur réussit d'abord, puis à nouveau chaque fois que Claude Code actualise le jeton du serveur.1843Sur le [runtime v2](https://code.claude.com/docs/fr/mcp.md#mcp-client-runtimes), Claude Code n'envoie une requête de jeton [OAuth MCP](https://code.claude.com/docs/fr/mcp.md#authenticate-with-remote-mcp-servers) qu'à un endpoint de jeton servi en HTTPS ou sur `localhost`, `127.0.0.1` ou `::1`. Ce message signifie que l'endpoint de jeton du serveur n'est ni l'un ni l'autre ; Claude Code s'est donc arrêté avant d'envoyer la requête. Cela se produit après la connexion par navigateur, de sorte que l'étape du navigateur réussit d'abord, puis à nouveau chaque fois que Claude Code actualise le jeton du serveur.

2207 2223

2208### L'hôte n'est pas autorisé dans une session cloud2224### L'hôte n'est pas autorisé dans une session cloud

2209 2225

2210Une requête HTTP sortante d'une session cloud ou d'une tâche planifiée cloud a été bloquée par la politique réseau de l'environnement.2226Dans une session cloud ou une tâche planifiée cloud, un `403` ou une erreur DNS comme `ENOTFOUND` peut signifier que l'hôte demandé ne figure pas dans la [liste d'autorisation de l'environnement cloud](https://code.claude.com/docs/fr/cloud-environments.md#access-levels). Pour le confirmer, vérifiez l'hôte par rapport à cette liste. Un `403` accompagné de cet en-tête confirme le blocage, mais le `403` d'une requête bloquée ne comporte pas toujours cet en-tête :

2211 2227

2212```text theme={null}2228```text theme={null}

2213HTTP 4032229HTTP 403

2565 2581

2566Claude Code redimensionne normalement les images volumineuses automatiquement. Ces erreurs signifient que l'image n'a pas pu être décodée ou redimensionnée pour respecter les limites de l'API.2582Claude Code redimensionne normalement les images volumineuses automatiquement. Ces erreurs signifient que l'image n'a pas pu être décodée ou redimensionnée pour respecter les limites de l'API.

2567 2583

2584L'erreur que vous voyez peut indiquer une limite en pixels différente, comme `2576x2576px` là où ces exemples indiquent `2000x2000px`.

2585

2568**Que faire :**2586**Que faire :**

2569 2587

2570* Si le message vous demande de convertir l'image, convertissez-la en PNG, JPEG, GIF ou WebP et joignez-la à nouveau. Pour ces formats, Claude Code peut vérifier les dimensions à partir de l'en-tête du fichier, sans décoder l'image.2588* Si le message vous demande de convertir l'image, convertissez-la en PNG, JPEG, GIF ou WebP et joignez-la à nouveau. Pour ces formats, Claude Code peut vérifier les dimensions à partir de l'en-tête du fichier, sans décoder l'image.

2873* **Une raison écrite par un hook** : un hook PreModelSwitch a fourni cette raison lorsqu'il [a refusé le changement ou demandé une confirmation](https://code.claude.com/docs/fr/hooks.md#premodelswitch-decision-control). Traitez ce qu'il demande, ou choisissez un modèle autorisé par vos hooks.2891* **Une raison écrite par un hook** : un hook PreModelSwitch a fourni cette raison lorsqu'il [a refusé le changement ou demandé une confirmation](https://code.claude.com/docs/fr/hooks.md#premodelswitch-decision-control). Traitez ce qu'il demande, ou choisissez un modèle autorisé par vos hooks.

2874* **`PreModelSwitch hook <name> did not respond before its timeout`** : un hook qui ne répond pas avant son [délai d'expiration](https://code.claude.com/docs/fr/hooks.md#timeouts) bloque le changement. Corrigez la commande bloquée ou augmentez le `timeout` de ce hook, puis changez à nouveau de modèle.2892* **`PreModelSwitch hook <name> did not respond before its timeout`** : un hook qui ne répond pas avant son [délai d'expiration](https://code.claude.com/docs/fr/hooks.md#timeouts) bloque le changement. Corrigez la commande bloquée ou augmentez le `timeout` de ce hook, puis changez à nouveau de modèle.

2875* **`confirmation required, and this session cannot ask`** : un hook a répondu `ask` sans raison, et une requête de contrôle n'a aucun moyen d'afficher la demande de confirmation. Une commande `/model` dans une [exécution `-p`](https://code.claude.com/docs/fr/headless) signale la même condition avec `(run /model interactively to confirm)` après la raison. Effectuez le changement depuis une session interactive, ou modifiez la décision du hook pour ce modèle.2893* **`confirmation required, and this session cannot ask`** : un hook a répondu `ask` sans raison, et une requête de contrôle n'a aucun moyen d'afficher la demande de confirmation. Une commande `/model` dans une [exécution `-p`](https://code.claude.com/docs/fr/headless) signale la même condition avec `(run /model interactively to confirm)` après la raison. Effectuez le changement depuis une session interactive, ou modifiez la décision du hook pour ce modèle.

2876* **`so organization-managed PreModelSwitch hooks could not be checked`** : Claude Code n'a pas pu déterminer quels hooks PreModelSwitch fournissent les [plugins gérés](https://code.claude.com/docs/fr/settings-reference.md#enabledplugins) de votre organisation, par exemple parce qu'un plugin géré n'a pas pu se charger. L'un de ces hooks pourrait bloquer le changement : Claude Code refuse donc plutôt que d'appliquer le changement sans vérification. Le début de la raison nomme ce qui a échoué. Claude Code vérifie à nouveau à chaque tentative de changement : un échec qui a depuis disparu cesse donc de bloquer ; si l'échec persiste, exécutez `claude --debug` et changez à nouveau de modèle pour capturer les détails, puis corrigez le plugin ou demandez à votre administrateur de le corriger.2894* **`so organization-managed PreModelSwitch hooks could not be checked`** : Claude Code avant la v2.1.323 refuse lorsqu'il ne peut pas déterminer quels hooks PreModelSwitch vos [plugins gérés](https://code.claude.com/docs/fr/settings-reference.md#enabledplugins) fournissent. Le texte qui précède cette expression nomme ce qui a échoué. Pour mettre fin au refus, mettez à jour Claude Code. Pour que les hooks d'un plugin en échec s'exécutent également, corrigez le plugin ou adressez-vous à votre administrateur. Pour plus de détails, lancez `claude --debug` dans votre shell et changez de modèle, puis lisez le [log de débogage](https://code.claude.com/docs/fr/hooks.md#debug-hooks).

2877* **`a PreModelSwitch hook failed before answering`** ou **`PreModelSwitch hooks were cancelled (the control stream closed) before answering`** : l'exécution du hook s'est terminée sans verdict, et Claude Code ne considère pas cela comme une approbation. Exécutez `claude --debug` pour voir ce qui a échoué, puis changez à nouveau de modèle.2895* **`a PreModelSwitch hook failed before answering`** ou **`PreModelSwitch hooks were cancelled (the control stream closed) before answering`** : l'exécution du hook s'est terminée sans verdict, et Claude Code ne considère pas cela comme une approbation. Exécutez `claude --debug` pour voir ce qui a échoué, puis changez à nouveau de modèle.

2878 2896

2879Avant la v2.1.260, le refus lié aux plugins gérés indiquait `plugin hooks could not be loaded, so PreModelSwitch hooks could not be checked; see the debug log`. Claude Code réessayait une fois le chargement des plugins, puis refusait les changements ultérieurs dans la session, même lorsque votre organisation ne gérait aucun plugin. Sur ces versions, redémarrez la session pour relancer le chargement des plugins.2897Avant la v2.1.260, le refus lié aux plugins gérés indiquait `plugin hooks could not be loaded, so PreModelSwitch hooks could not be checked; see the debug log`. Claude Code réessayait une fois le chargement des plugins, puis refusait les changements ultérieurs dans la session, même lorsque votre organisation ne gérait aucun plugin. Sur ces versions, redémarrez la session pour relancer le chargement des plugins.

3499* **`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`.3517* **`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`.

3500* **`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.3518* **`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.

3501* **`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`.3519* **`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`.

3502* **``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`.3520* **``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 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`.

3503 3521

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

3505 3523

3522Vous avez démarré [Remote Control](https://code.claude.com/docs/fr/remote-control.md) avec un flag `claude` global placé avant le verbe `remote-control`, un flag qui restreindrait ou configurerait les sessions que Remote Control démarre, comme `--settings`, `--setting-sources`, `--permission-mode`, `--disallowed-tools` ou `--mcp-config`. Un flag placé avant le verbe n'atteint jamais ces sessions. Claude Code refuse plutôt de démarrer, en mentionnant le flag :3540Vous avez démarré [Remote Control](https://code.claude.com/docs/fr/remote-control.md) avec un flag `claude` global placé avant le verbe `remote-control`, un flag qui restreindrait ou configurerait les sessions que Remote Control démarre, comme `--settings`, `--setting-sources`, `--permission-mode`, `--disallowed-tools` ou `--mcp-config`. Un flag placé avant le verbe n'atteint jamais ces sessions. Claude Code refuse plutôt de démarrer, en mentionnant le flag :

3523 3541

3524```text theme={null}3542```text theme={null}

3525Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it — remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`).3543Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it — remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`). Pass settings with `claude remote-control --settings <file>`.

3526```3544```

3527 3545

3528Claude Code ne refuse pas les flags globaux qu'il est sans danger d'ignorer, comme `--verbose`, `--model`, ou un `--session-id` ou `--plugin-dir` injecté par un wrapper : il les ignore et Remote Control démarre.3546Claude Code ne refuse pas les flags globaux qu'il est sans danger d'ignorer, comme `--verbose`, `--model`, ou un `--session-id` ou `--plugin-dir` injecté par un wrapper : il les ignore et Remote Control démarre.

3536 3554

3537Avant la v2.1.248, `claude remote-control` n'acceptait pas ses propres flags lorsqu'un flag global venait en premier, et la commande échouait avec une erreur `unknown option`.3555Avant la v2.1.248, `claude remote-control` n'acceptait pas ses propres flags lorsqu'un flag global venait en premier, et la commande échouait avec une erreur `unknown option`.

3538 3556

3557### Remote Control n'a pas démarré à cause du fichier `--settings`

3558

3559Le fichier que vous avez passé à [`claude remote-control --settings`](https://code.claude.com/docs/fr/remote-control#start-a-remote-control-session) présente un problème :

3560

3561```text theme={null}

3562Error: Remote Control did not start, because sessions would skip part or all of the --settings file ./rc-settings.json: Invalid or malformed JSON

3563```

3564

3565**Que faire :**

3566

3567* Corrigez le problème que nomme le message, puis exécutez à nouveau votre commande `claude remote-control`

3568

3569### Le fichier de paramètres a changé depuis le démarrage de Remote Control

3570

3571Ce message dans le terminal qui exécute `claude remote-control` signifie que les sessions ne démarreront pas à partir du fichier que vous avez passé à [`--settings`](https://code.claude.com/docs/fr/remote-control#start-a-remote-control-session) dans son état actuel :

3572

3573```text theme={null}

3574Session failed: Error: The settings file /path/to/settings.json has changed since Remote Control started, so this session did not start. Restart `claude remote-control` to use it as it is now.

3575```

3576

3577**Que faire :**

3578

3579* Pour utiliser le fichier dans son état actuel, arrêtez `claude remote-control` et exécutez à nouveau la même commande. Pour retrouver les sessions qu'il servait, consultez [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).

3580* Pour conserver les paramètres avec lesquels Remote Control a démarré, rétablissez le contenu du fichier tel qu'il était, puis exécutez à nouveau la commande si `claude remote-control` s'est arrêté

3581

3539### `--sandbox` or `--no-sandbox` is not supported by claude remote-control3582### `--sandbox` or `--no-sandbox` is not supported by claude remote-control

3540 3583

3541Cette erreur signifie que la commande qui démarre votre serveur [Remote Control](https://code.claude.com/docs/fr/remote-control.md) passe `--sandbox` ou `--no-sandbox` après `remote-control`, et `claude remote-control` n'accepte aucun de ces flags. Le serveur se termine avec le code 1 au lieu de démarrer :3584Cette erreur signifie que la commande qui démarre votre serveur [Remote Control](https://code.claude.com/docs/fr/remote-control.md) passe `--sandbox` ou `--no-sandbox` après `remote-control`, et `claude remote-control` n'accepte aucun de ces flags. Le serveur se termine avec le code 1 au lieu de démarrer :

3806 3849

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

3808 3851

3809* `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) explique quels résultats interrompent l'invocation dans chaque mode de permission et comment pré-approuver une commande avec `allowed-tools`3852* `Shell command permission check failed for pattern "..."` : la vérification des permissions de la commande ne l'a pas autorisée. [Vérifications des permissions 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'exécution dans chaque mode de permission et comment pré-approuver une commande avec `allowed-tools`

3810* ``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)3853* ``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)

3811 3854

3812**Marche à suivre :**3855**Marche à suivre :**

3813 3856

gateways.md +1 −1

Details

63* **Télémétrie client** : Claude Code désactive son analyse client liée à Anthropic lorsqu'une session se connecte à une passerelle d'applications Claude. Pour maintenir également la télémétrie de démarrage avant la connexion désactivée, livrez [`DISABLE_TELEMETRY`](https://code.claude.com/docs/fr/managed-settings#turn-telemetry-off-for-your-organization) dans les [paramètres gérés côté client](https://code.claude.com/docs/fr/claude-apps-gateway-config.md#client-side-managed-settings) sur chaque appareil.63* **Télémétrie client** : Claude Code désactive son analyse client liée à Anthropic lorsqu'une session se connecte à une passerelle d'applications Claude. Pour maintenir également la télémétrie de démarrage avant la connexion désactivée, livrez [`DISABLE_TELEMETRY`](https://code.claude.com/docs/fr/managed-settings#turn-telemetry-off-for-your-organization) dans les [paramètres gérés côté client](https://code.claude.com/docs/fr/claude-apps-gateway-config.md#client-side-managed-settings) sur chaque appareil.

64* **Télémétrie client sur d'autres passerelles** : le fait que Claude Code envoie le flux de télémétrie client optionnel dépend de votre fournisseur, et le [tableau des valeurs par défaut de télémétrie](https://code.claude.com/docs/fr/data-usage.md#default-behaviors-by-api-provider) couvre chaque cas.64* **Télémétrie client sur d'autres passerelles** : le fait que Claude Code envoie le flux de télémétrie client optionnel dépend de votre fournisseur, et le [tableau des valeurs par défaut de télémétrie](https://code.claude.com/docs/fr/data-usage.md#default-behaviors-by-api-provider) couvre chaque cas.

65* **Destinations de télémétrie** : l'endroit où Claude Code envoie la télémétrie d'une session de passerelle dépend de la façon dont la session s'est connectée, et [Ce qui est appliqué aux développeurs](https://code.claude.com/docs/fr/claude-apps-gateway#whats-enforced-on-developers) indique où les exports de chaque type de session vont.65* **Destinations de télémétrie** : l'endroit où Claude Code envoie la télémétrie d'une session de passerelle dépend de la façon dont la session s'est connectée, et [Ce qui est appliqué aux développeurs](https://code.claude.com/docs/fr/claude-apps-gateway#whats-enforced-on-developers) indique où les exports de chaque type de session vont.

66* **Proxies HTTP d'entreprise** : un `HTTPS_PROXY` s'insère entre Claude Code et chaque serveur avec lequel il communique, y compris la passerelle. Si votre réseau en nécessite un, [configurez le proxy](https://code.claude.com/docs/fr/network-config.md) en plus de la passerelle. Pour une passerelle d'applications Claude que vous hébergez, [la connexion vérifie que l'hôte proxy est également sur un réseau privé](https://code.claude.com/docs/fr/claude-apps-gateway#prerequisites) ; si ce n'est pas le cas, ajoutez l'hôte de la passerelle à `NO_PROXY` pour que l'interface CLI s'y connecte directement.66* **Proxys HTTP d'entreprise** : Claude Code envoie ses requêtes, y compris celles destinées à la passerelle, via le proxy défini dans `HTTPS_PROXY`. Si votre réseau nécessite un proxy, [configurez-le](https://code.claude.com/docs/fr/network-config.md). Si le proxy s'applique à une passerelle d'applications Claude que vous hébergez, la [connexion](https://code.claude.com/docs/fr/claude-apps-gateway#prerequisites) nécessite que le nom d'hôte du proxy se résolve en adresses privées, ou que l'hôte de la passerelle figure dans `NO_PROXY`.

67 67

68## Étapes suivantes68## Étapes suivantes

69 69

github-actions-cloud-providers.md +2 −2

Details

83>83>

84> Créez une application Microsoft Entra avec une identité fédérée pour votre référentiel, en suivant le [guide Microsoft pour l'authentification à partir de GitHub Actions](https://learn.microsoft.com/en-us/azure/developer/github/connect-from-azure-openid-connect) :84> Créez une application Microsoft Entra avec une identité fédérée pour votre référentiel, en suivant le [guide Microsoft pour l'authentification à partir de GitHub Actions](https://learn.microsoft.com/en-us/azure/developer/github/connect-from-azure-openid-connect) :

85>85>

86> * Enregistrez une application Microsoft Entra et ajoutez une identité fédérée qui fait confiance aux jetons que GitHub émet à votre référentiel. Une identité gérée affectée par l'utilisateur fonctionne à la place d'une application. Les deux ont l'ID client que vous notez ci-dessous86> * Enregistrez une application Microsoft Entra et ajoutez des identifiants d'identité fédérée qui font confiance aux jetons que GitHub émet à votre dépôt. Une identité gérée affectée par l'utilisateur fonctionne à la place d'une application. Les deux ont l'ID client que vous notez ci-dessous

87> * Attribuez à l'application le rôle `Azure AI User` sur votre ressource Foundry. Voir [Configuration Azure RBAC](https://code.claude.com/docs/fr/microsoft-foundry.md#azure-rbac-configuration) pour un rôle personnalisé plus étroit87> * Attribuez à l'application le rôle `Foundry User` sur votre ressource Foundry. Voir [Configuration Azure RBAC](https://code.claude.com/docs/fr/microsoft-foundry.md#azure-rbac-configuration) pour l'autre rôle intégré et les rôles personnalisés

88>88>

89> Notez l'ID client de l'application, votre ID de locataire et votre ID d'abonnement. Vous les ajoutez en tant que secrets à l'étape suivante.89> Notez l'ID client de l'application, votre ID de locataire et votre ID d'abonnement. Vous les ajoutez en tant que secrets à l'étape suivante.

90 90

google-vertex-ai.md +8 −3

Details

228 228

229### Lorsqu'un modèle est désactivé en cours de session229### Lorsqu'un modèle est désactivé en cours de session

230 230

231Si votre projet perd l'accès au modèle sur lequel votre session s'exécute, par exemple parce qu'un administrateur le désactive dans [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden), Claude Code bascule la session vers un autre modèle au lieu d'échouer à chaque demande, et affiche `Switched to <fallback> because <model> is not available`. Il essaie les mêmes modèles que le retour au démarrage : les versions antérieures du même niveau d'abord et, pour une session Opus sans version Opus disponible, le modèle Sonnet par défaut.231Lorsque Agent Platform rejette le modèle de votre session comme indisponible dans votre projet ou votre région, Claude Code bascule votre session vers un autre modèle, et vous pouvez continuer à travailler. Vous voyez un message qui commence par `Switched to <fallback> because <model> is not available`. Cela se produit, par exemple, lorsqu'un administrateur désactive le modèle dans [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden) ou qu'il n'est pas servi dans votre région.

232 232

233Le basculement s'applique uniquement à un niveau que vous n'avez pas épinglé, la même condition que le retour au démarrage. Une session sur une version spécifique que vous avez choisie conserve son modèle et, sans une chaîne de modèle de secours, la demande échoue à la place. En [mode auto](https://code.claude.com/docs/fr/permission-modes.md#enable-auto-mode-on-bedrock-agent-platform-or-foundry), Claude Code bascule uniquement vers un modèle que le mode auto supporte sur Agent Platform. Si aucun de ces modèles n'est disponible non plus, la demande échoue.233Si vous avez configuré une [chaîne de modèles de secours](https://code.claude.com/docs/fr/model-config.md#fallback-model-chains), Claude Code bascule plutôt vers votre modèle de secours configuré. Sans chaîne, la requête échoue dans des cas tels que ceux-ci :

234 234

235Une [chaîne de modèle de secours](https://code.claude.com/docs/fr/model-config.md#fallback-model-chains) que vous configurez remplace le basculement de niveau : sur ces refus, Claude Code bascule vers votre secours configuré à la place. Pour que les demandes refusées échouent plutôt que de basculer, définissez [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](https://code.claude.com/docs/fr/env-vars). Une chaîne de secours que vous avez configurée bascule toujours sur ces refus ; supprimez également la chaîne si vous voulez que chaque demande refusée échoue.235* Votre session utilise un modèle épinglé ou une version spécifique que vous avez choisie

236* Aucun des [modèles que Claude Code essaie](#startup-model-checks) n'est disponible. En [mode auto](https://code.claude.com/docs/fr/permission-modes.md#enable-auto-mode-on-bedrock-agent-platform-or-foundry), Claude Code bascule uniquement vers un modèle que le mode auto prend en charge sur Agent Platform.

237

238Pour continuer à travailler, exécutez `/model` dans la session et appuyez sur `s` sur un modèle disponible dans votre projet et votre région, ce qui laisse votre valeur par défaut inchangée.

239

240Pour que les requêtes rejetées échouent au lieu de basculer, définissez [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](https://code.claude.com/docs/fr/env-vars). Si vous avez configuré une chaîne de modèles de secours, supprimez-la également, car Claude Code bascule toujours vers ce modèle de secours.

236 241

237## Configuration IAM242## Configuration IAM

238 243

hooks.md +9 −3

Details

3000 3000

3001S'exécute lorsqu'un fichier de configuration change pendant une session. Utilisez-le pour auditer les modifications de paramètres, appliquer des politiques de sécurité ou bloquer les modifications non autorisées des fichiers de configuration.3001S'exécute lorsqu'un fichier de configuration change pendant une session. Utilisez-le pour auditer les modifications de paramètres, appliquer des politiques de sécurité ou bloquer les modifications non autorisées des fichiers de configuration.

3002 3002

3003Claude Code exécute les hooks ConfigChange lorsqu'un fichier de paramètres, un fichier de politique gérée ou un fichier de skill change. Pour la politique gérée, il ne les exécute que lorsque `managed-settings.json` ou un fichier de `managed-settings.d/` change. Il applique les [paramètres gérés par le serveur](https://code.claude.com/docs/fr/server-managed-settings.md) et les modifications des préférences gérées macOS ou de la politique du registre Windows sans les exécuter. Sous WSL avec [`wslInheritsWindowsSettings`](https://code.claude.com/docs/fr/settings-reference#wslinheritswindowssettings), il applique également, lors de son interrogation de la politique, un fichier de paramètres gérés côté Windows modifié sans les exécuter.3003Claude Code exécute les hooks ConfigChange lorsqu'un fichier de paramètres, un fichier de politique gérée ou un fichier de skill change. Pour la politique gérée, il ne les exécute que lorsque `managed-settings.json` ou un fichier dans `managed-settings.d/` change.

3004 3004

3005Le matcher filtre sur la source de configuration :3005Le matcher filtre sur la source de configuration :

3006 3006

3014 3014

3015Cet exemple journalise toutes les modifications de configuration pour un audit de sécurité :3015Les modifications suivantes prennent effet sans exécuter les hooks :

3016

3017* Les règles et paramètres que vous enregistrez avec **Yes, and don't ask again**, `/permissions` ou `/model`, dans la session depuis laquelle vous les avez enregistrés. Si une autre session ouverte charge le même fichier, les hooks s'y exécutent.

3018* Les mises à jour des [paramètres gérés par le serveur](https://code.claude.com/docs/fr/server-managed-settings.md), des préférences gérées macOS ou des stratégies du registre Windows

3019* Sous WSL avec [`wslInheritsWindowsSettings`](https://code.claude.com/docs/fr/settings-reference#wslinheritswindowssettings), un fichier de paramètres gérés modifié côté Windows, que Claude Code prend en compte lors de son interrogation périodique des stratégies

3020

3021Cet exemple journalise les modifications de configuration à des fins d'audit de sécurité :

3016 3022

3017```json theme={null}3023```json theme={null}

3018{3024{

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

3336 {3342 {

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

3338 "command": "bash -c 'jq -r .worktree_path | xargs rm -rf'"3344 "command": "bash -c 'p=$(jq -er .worktree_path) && rm -rf -- \"$p\"'"

3339 }3345 }

3340 ]3346 ]

3341 }3347 }

hooks-guide.md +3 −3

Details

50 "PostToolUse": [50 "PostToolUse": [

51 {51 {

52 "matcher": "Edit|Write",52 "matcher": "Edit|Write",

~~53 "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write" }]~~53 "hooks": [{ "type": "command", "command": "f=$(jq -r '.tool_input.file_path') && npx prettier --write --ignore-unknown \"$f\"" }]

54 }54 }

55 ],55 ],

56 "Notification": [56 "Notification": [

221 "hooks": [221 "hooks": [

222 {222 {

223 "type": "command",223 "type": "command",

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

225 }225 }

226 ]226 ]

227 }227 }

336 336

337Suivez les modifications des fichiers de paramètres ou de skills au cours d'une session. L'événement `ConfigChange` se déclenche lorsqu'un processus externe ou un éditeur modifie un fichier de configuration, ce qui vous permet de journaliser les modifications à des fins de conformité ou de bloquer les modifications non autorisées.337Suivez les modifications des fichiers de paramètres ou de skills au cours d'une session. L'événement `ConfigChange` se déclenche lorsqu'un processus externe ou un éditeur modifie un fichier de configuration, ce qui vous permet de journaliser les modifications à des fins de conformité ou de bloquer les modifications non autorisées.

338 338

339Cet exemple ajoute chaque modification à un log d'audit. Ajoutez ceci à `~/.claude/settings.json` :339Cet exemple ajoute chaque événement à un log d'audit. Ajoutez ceci à `~/.claude/settings.json` :

340 340

341```json theme={null}341```json theme={null}

342{342{

interactive-mode.md +3 −7

Details

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

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

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

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

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

81| :- | :- | :- |81| :- | :- | :- |

84| Shift+Enter | `Shift+Enter` | Natif dans iTerm2, WezTerm, Ghostty, Kitty, Warp, Apple Terminal, Windows Terminal. Pour les autres terminaux, consultez [Saisir des prompts multilignes](https://code.claude.com/docs/fr/terminal-config.md#enter-multiline-prompts) |84| Shift+Enter | `Shift+Enter` | Natif dans iTerm2, WezTerm, Ghostty, Kitty, Warp, Windows Terminal. Pour les autres terminaux, consultez [Saisir des prompts multilignes](https://code.claude.com/docs/fr/terminal-config.md#enter-multiline-prompts) |

87 87

137 137

138Activez l'édition de style vim via `/config` → Editor mode.138Activez l'édition de style vim via `/config` → Editor mode.

139 139

140Claude Code conserve votre mode vim et la position du curseur lorsque vous basculez le [lecteur de transcription](#transcript-viewer) avec `Ctrl+O` ou ouvrez et fermez un panneau tel que `/config`. Si vous quittez l'invite en mode NORMAL, elle est toujours en mode NORMAL lorsque vous revenez, avec le curseur où vous l'aviez laissé.

~~141~~

142### Changement de mode140### Changement de mode

143 141

302 * Appuyez sur `Ctrl+C` pour annuler et restaurer votre saisie d'origine300 * Appuyez sur `Ctrl+C` pour annuler et restaurer votre saisie d'origine

303 * Appuyez sur `Backspace` sur une recherche vide pour annuler301 * Appuyez sur `Backspace` sur une recherche vide pour annuler

304 302

305Accepter une correspondance ou annuler la recherche prend effet immédiatement, même pendant que Claude Code charge encore l'historique.

~~306~~

307Pour retrouver un prompt antérieur lorsque vous ne vous souvenez que d'un long contenu que vous y avez collé, comme un log d'erreur, appuyez sur `Ctrl+R` et tapez un mot de ce contenu collé. Nécessite Claude Code v2.1.314 ou version ultérieure.303Pour retrouver un prompt antérieur lorsque vous ne vous souvenez que d'un long contenu que vous y avez collé, comme un log d'erreur, appuyez sur `Ctrl+R` et tapez un mot de ce contenu collé. Nécessite Claude Code v2.1.314 ou version ultérieure.

308 304

309## Commandes Bash en arrière-plan305## Commandes Bash en arrière-plan

600 596

601### Ce que Claude Code souligne597### Ce que Claude Code souligne

602 598

603Peu de temps après que vous ayez arrêté de taper, Claude Code souligne les mots que le dictionnaire ne connaît pas. Il laisse le mot que vous tapez encore seul jusqu'à ce que vous le dépassiez, et il ne change jamais votre texte. Il ignore également le texte qui ressemble à du code :599Peu de temps après que vous avez arrêté de taper, Claude Code souligne les mots que le dictionnaire ne connaît pas. Il ne touche pas au mot que vous êtes encore en train de taper tant que vous ne l'avez pas dépassé. Il ignore également le texte qui ressemble à du code :

604 600

605* Les commandes telles que `/help`, les mentions `@`, les URL, les chemins de fichiers, et les drapeaux tels que `--verbose`601* Les commandes telles que `/help`, les mentions `@`, les URL, les chemins de fichiers, et les drapeaux tels que `--verbose`

606* Les mots avec des chiffres, des traits de soulignement, ou une lettre majuscule après la première, et le texte entre backticks602* Les mots avec des chiffres, des traits de soulignement, ou une lettre majuscule après la première, et le texte entre backticks

keybindings.md +6 −1

Details

581 581

582Claude Code lie ces accords par défaut sur le préfixe `ctrl+x`, par contexte :582Claude Code lie ces accords par défaut sur le préfixe `ctrl+x`, par contexte :

583 583

584* `Chat` : `ctrl+x ctrl+k`, `ctrl+x ctrl+e`, `ctrl+x enter`, `ctrl+x ctrl+a`, `ctrl+x ctrl+s` et `ctrl+x tab`584* `Chat` : `ctrl+x ctrl+k`, `ctrl+x ctrl+e`, `ctrl+x enter`, `ctrl+x ctrl+a`, `ctrl+x ctrl+s`, `ctrl+x tab`, `ctrl+x ctrl+=`, `ctrl+x ctrl+-`, `ctrl+x ctrl+_`, `ctrl+x =` et `ctrl+x -`

585* `Task` : `ctrl+x ctrl+b`585* `Task` : `ctrl+x ctrl+b`

586* `DiffPanel` : `ctrl+x b`586* `DiffPanel` : `ctrl+x b`

587* `Pane` : `ctrl+x left`, `ctrl+x right`, `ctrl+x up`, `ctrl+x down` et `ctrl+x x`587* `Pane` : `ctrl+x left`, `ctrl+x right`, `ctrl+x up`, `ctrl+x down` et `ctrl+x x`

631 "ctrl+x ctrl+a": null,631 "ctrl+x ctrl+a": null,

632 "ctrl+x ctrl+s": null,632 "ctrl+x ctrl+s": null,

633 "ctrl+x tab": null,633 "ctrl+x tab": null,

634 "ctrl+x ctrl+=": null,

635 "ctrl+x ctrl+-": null,

636 "ctrl+x ctrl+_": null,

637 "ctrl+x =": null,

638 "ctrl+x -": null,

634 "ctrl+x": "chat:newline"639 "ctrl+x": "chat:newline"

635 }640 }

636 }641 }

llm-gateway-connect.md +3 −2

Details

156 156

157### Conflits avec une connexion existante157### Conflits avec une connexion existante

158 158

159Une variable d'identifiant de passerelle a priorité sur une connexion claude.ai sauvegardée ou une clé Console. Avec `ANTHROPIC_AUTH_TOKEN`, la variable a priorité immédiatement. Avec `ANTHROPIC_API_KEY`, vous êtes invité une fois en mode interactif à approuver la clé avant qu'elle ne prenne le contrôle.159Vos requêtes utilisent une variable d'identifiant de passerelle plutôt qu'une connexion claude.ai sauvegardée. Avec `ANTHROPIC_AUTH_TOKEN`, la variable a priorité immédiatement. Avec `ANTHROPIC_API_KEY`, vous êtes invité une fois en mode interactif à approuver la clé avant qu'elle ne prenne le contrôle.

160 160

161Exécutez `/status` pour confirmer quelle source d'identifiant est active. Si le démarrage affiche un avertissement de conflit d'authentification nommant deux sources, voir la première ligne du [tableau de dépannage](#troubleshoot-gateway-errors) pour savoir laquelle supprimer. Pour effacer une connexion sauvegardée afin que seul l'identifiant de passerelle reste, exécutez `/logout`.161Exécutez `/status` pour confirmer quelle source d'identifiant est active. Si le démarrage affiche un avertissement de conflit d'authentification nommant deux sources, voir la première ligne du [tableau de dépannage](#troubleshoot-gateway-errors) pour savoir laquelle supprimer. Pour effacer une connexion sauvegardée afin que seul l'identifiant de passerelle reste, exécutez `/logout`.

162 162

506 506

508| :- | :- | :- |508| :- | :- | :- |

509| Un avertissement de démarrage nommant deux sources d'identifiant et se terminant par `auth may not work as expected`. Les versions plus anciennes affichent `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` à la place. | Un identifiant de passerelle et une connexion sauvegardée sont tous deux actifs ; la variable est utilisée pour les demandes, mais la connexion obsolète peut causer un comportement d'authentification inattendu | Supprimez la variable pour utiliser la connexion sauvegardée, ou exécutez `/logout` pour utiliser l'identifiant de passerelle |509| Un avertissement de démarrage nommant deux sources d'identifiant et se terminant par `auth may not work as expected`. Les versions plus anciennes affichent `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` à la place. | Un identifiant de passerelle et une connexion sauvegardée sont tous deux actifs | Supprimez la variable pour utiliser la connexion sauvegardée, ou exécutez `/logout` pour utiliser l'identifiant de passerelle |

510| Erreurs `401` nommant un jeton invalide ou non reconnu | L'identifiant n'en est pas un que la passerelle a émis, ou il est dans un en-tête que la passerelle ne lit pas | Confirmez que la variable correspond à votre type d'identifiant dans le [tableau d'identifiant](#set-the-credential-variable), et régénérez la clé à la passerelle si elle a été révoquée |510| Erreurs `401` nommant un jeton invalide ou non reconnu | L'identifiant n'en est pas un que la passerelle a émis, ou il est dans un en-tête que la passerelle ne lit pas | Confirmez que la variable correspond à votre type d'identifiant dans le [tableau d'identifiant](#set-the-credential-variable), et régénérez la clé à la passerelle si elle a été révoquée |

511| `Your apiKeyHelper script is failing`, ou `apiKeyHelper failed:` sur stderr en mode non interactif | La commande dans le paramètre [`apiKeyHelper`](https://code.claude.com/docs/fr/settings-reference#apikeyhelper) n'a pas produit une clé utilisable, de sorte que les demandes portent une clé d'espace réservé | Exécutez la commande directement pour voir pourquoi elle échoue, et réauthentifiez-vous auprès de votre fournisseur d'identifiants s'il signale une session expirée ; voir [la référence d'erreur](https://code.claude.com/docs/fr/errors.md#your-apikeyhelper-script-is-failing) |511| `Your apiKeyHelper script is failing`, ou `apiKeyHelper failed:` sur stderr en mode non interactif | La commande dans le paramètre [`apiKeyHelper`](https://code.claude.com/docs/fr/settings-reference#apikeyhelper) n'a pas produit une clé utilisable, de sorte que les demandes portent une clé d'espace réservé | Exécutez la commande directement pour voir pourquoi elle échoue, et réauthentifiez-vous auprès de votre fournisseur d'identifiants s'il signale une session expirée ; voir [la référence d'erreur](https://code.claude.com/docs/fr/errors.md#your-apikeyhelper-script-is-failing) |

512| `Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)` quand rien ne répond à l'adresse, ou `Can't reach the API server — check your internet or DNS (ENOTFOUND)` quand le nom d'hôte ne se résout pas, souvent après une pause silencieuse tandis que Claude Code [réessaie avec backoff](https://code.claude.com/docs/fr/errors.md#automatic-retries). Le code entre parenthèses varie ; [Unable to connect to API](https://code.claude.com/docs/fr/errors.md#unable-to-connect-to-api) couvre les orthographes de code et la formulation antérieure | Rien n'a répondu à l'URL de base : l'adresse est mauvaise, ou un VPN ou un pare-feu bloque le chemin vers la passerelle | Exécutez le [test curl ci-dessus](#verify-the-connection), qui échoue immédiatement avec la même cause, et confirmez l'URL et le chemin réseau avec votre équipe de passerelle |512| `Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)` quand rien ne répond à l'adresse, ou `Can't reach the API server — check your internet or DNS (ENOTFOUND)` quand le nom d'hôte ne se résout pas, souvent après une pause silencieuse tandis que Claude Code [réessaie avec backoff](https://code.claude.com/docs/fr/errors.md#automatic-retries). Le code entre parenthèses varie ; [Unable to connect to API](https://code.claude.com/docs/fr/errors.md#unable-to-connect-to-api) couvre les orthographes de code et la formulation antérieure | Rien n'a répondu à l'URL de base : l'adresse est mauvaise, ou un VPN ou un pare-feu bloque le chemin vers la passerelle | Exécutez le [test curl ci-dessus](#verify-the-connection), qui échoue immédiatement avec la même cause, et confirmez l'URL et le chemin réseau avec votre équipe de passerelle |

520| `/fast` signale `Fast mode unavailable due to network connectivity issues` tandis que les requêtes d'inférence fonctionnent | La vérification de disponibilité du [mode rapide](https://code.claude.com/docs/fr/fast-mode.md) va directement à `api.anthropic.com` et ne suit pas `ANTHROPIC_BASE_URL`, de sorte que le blocage de l'accès direct sortant fait échouer la vérification | Ajoutez `api.anthropic.com` à la liste d'autorisation si l'accès sortant est bloqué, ou définissez une variable de saut. Voir [utiliser le mode rapide derrière les proxys et les passerelles LLM](https://code.claude.com/docs/fr/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |520| `/fast` signale `Fast mode unavailable due to network connectivity issues` tandis que les requêtes d'inférence fonctionnent | La vérification de disponibilité du [mode rapide](https://code.claude.com/docs/fr/fast-mode.md) va directement à `api.anthropic.com` et ne suit pas `ANTHROPIC_BASE_URL`, de sorte que le blocage de l'accès direct sortant fait échouer la vérification | Ajoutez `api.anthropic.com` à la liste d'autorisation si l'accès sortant est bloqué, ou définissez une variable de saut. Voir [utiliser le mode rapide derrière les proxys et les passerelles LLM](https://code.claude.com/docs/fr/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |

521| `/fast` signale `Fast mode is currently unavailable` dans une session qui s'authentifie avec une clé émise par la passerelle dans `ANTHROPIC_API_KEY` | Tant que `ANTHROPIC_BASE_URL` pointe vers votre passerelle et que la clé n'a pas le format d'une clé API Anthropic, Claude Code n'envoie pas la vérification de disponibilité du [mode rapide](https://code.claude.com/docs/fr/fast-mode.md). Sans vérification réussie antérieure en cache, il considère le mode rapide comme indisponible | Définissez `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS=1` ; voir [utiliser le mode rapide derrière les proxys et les passerelles LLM](https://code.claude.com/docs/fr/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |521| `/fast` signale `Fast mode is currently unavailable` dans une session qui s'authentifie avec une clé émise par la passerelle dans `ANTHROPIC_API_KEY` | Tant que `ANTHROPIC_BASE_URL` pointe vers votre passerelle et que la clé n'a pas le format d'une clé API Anthropic, Claude Code n'envoie pas la vérification de disponibilité du [mode rapide](https://code.claude.com/docs/fr/fast-mode.md). Sans vérification réussie antérieure en cache, il considère le mode rapide comme indisponible | Définissez `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS=1` ; voir [utiliser le mode rapide derrière les proxys et les passerelles LLM](https://code.claude.com/docs/fr/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |

522| `/fast` signale `Fast mode has been disabled by your organization` dans une session authentifiée avec `ANTHROPIC_AUTH_TOKEN`, même si l'organisation a le mode rapide activé | La vérification de disponibilité nécessite une connexion claude.ai ou une clé API ; avec seulement un jeton porteur, Claude Code traite le mode rapide comme désactivé sans envoyer la vérification | Définissez `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1` ; voir [utiliser le mode rapide derrière les proxys et les passerelles LLM](https://code.claude.com/docs/fr/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |522| `/fast` signale `Fast mode has been disabled by your organization` dans une session authentifiée avec `ANTHROPIC_AUTH_TOKEN`, même si l'organisation a le mode rapide activé | La vérification de disponibilité nécessite une connexion claude.ai ou une clé API ; avec seulement un jeton porteur, Claude Code traite le mode rapide comme désactivé sans envoyer la vérification | Définissez `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1` ; voir [utiliser le mode rapide derrière les proxys et les passerelles LLM](https://code.claude.com/docs/fr/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) |

523| `/feedback` enregistre un fichier local dans une session qui utilise `ANTHROPIC_BASE_URL` | Derrière une passerelle, `ANTHROPIC_AUTH_TOKEN` et une clé qui n'a pas le format d'une clé API Anthropic ne sont pas des identifiants Anthropic. Sans de tels identifiants, Claude Code écrit le rapport dans une archive locale sous `~/.claude/feedback-bundles/` au lieu de l'envoyer | Envoyez le fichier à votre représentant de compte Anthropic ou joignez-le à une demande d'assistance. Voir [services de télémétrie](https://code.claude.com/docs/fr/data-usage.md#telemetry-services) |

523| Claude Code vous demande de vous connecter même si le [test curl](#verify-the-connection) réussit | La CLI n'a pas d'identifiant propre : une URL de base accessible n'en est pas une, et dans une session interactive un bloc `env` dans le `.claude/settings.json` ou `.claude/settings.local.json` d'un projet s'applique uniquement après l'assistant de première exécution et l'[invite de confiance](https://code.claude.com/docs/fr/permissions.md#what-runs-before-you-trust-a-folder) | Définissez `ANTHROPIC_AUTH_TOKEN` quelque part que Claude Code lit avant la configuration de première exécution : un export shell, le bloc `env` dans `~/.claude/settings.json`, ou les paramètres gérés |524| Claude Code vous demande de vous connecter même si le [test curl](#verify-the-connection) réussit | La CLI n'a pas d'identifiant propre : une URL de base accessible n'en est pas une, et dans une session interactive un bloc `env` dans le `.claude/settings.json` ou `.claude/settings.local.json` d'un projet s'applique uniquement après l'assistant de première exécution et l'[invite de confiance](https://code.claude.com/docs/fr/permissions.md#what-runs-before-you-trust-a-folder) | Définissez `ANTHROPIC_AUTH_TOKEN` quelque part que Claude Code lit avant la configuration de première exécution : un export shell, le bloc `env` dans `~/.claude/settings.json`, ou les paramètres gérés |

524| `ANTHROPIC_API_KEY` est défini mais ignoré, sans invite | La clé a besoin d'une approbation unique dans les sessions interactives, et une clé précédemment refusée est ignorée sans demander à nouveau | Activez-la sous `/config` avec l'option `Use custom API key` |525| `ANTHROPIC_API_KEY` est défini mais ignoré, sans invite | La clé a besoin d'une approbation unique dans les sessions interactives, et une clé précédemment refusée est ignorée sans demander à nouveau | Activez-la sous `/config` avec l'option `Use custom API key` |

525| `This machine's managed settings require a first-party login`, ou [`Administrator policy requires a Cloud gateway sign-in`](https://code.claude.com/docs/fr/errors#administrator-policy-requires-a-cloud-gateway-sign-in) quand les paramètres gérés définissent `forceLoginMethod` à `"gateway"` ou définissent aussi `forceLoginGatewayUrl` | Les paramètres gérés incluent `forceLoginMethod` ou `forceLoginOrgUUID`, qui ne peuvent pas coexister avec `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, ou `apiKeyHelper` | Votre administrateur doit supprimer `forceLoginMethod`, `forceLoginOrgUUID`, et `forceLoginGatewayUrl` des paramètres gérés pour utiliser les identifiants de passerelle, ou supprimer l'identifiant de passerelle et utiliser la connexion que les paramètres gérés exigent. Les deux ne peuvent pas être combinés |526| `This machine's managed settings require a first-party login`, ou [`Administrator policy requires a Cloud gateway sign-in`](https://code.claude.com/docs/fr/errors#administrator-policy-requires-a-cloud-gateway-sign-in) quand les paramètres gérés définissent `forceLoginMethod` à `"gateway"` ou définissent aussi `forceLoginGatewayUrl` | Les paramètres gérés incluent `forceLoginMethod` ou `forceLoginOrgUUID`, qui ne peuvent pas coexister avec `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, ou `apiKeyHelper` | Votre administrateur doit supprimer `forceLoginMethod`, `forceLoginOrgUUID`, et `forceLoginGatewayUrl` des paramètres gérés pour utiliser les identifiants de passerelle, ou supprimer l'identifiant de passerelle et utiliser la connexion que les paramètres gérés exigent. Les deux ne peuvent pas être combinés |

llm-gateway-rollout.md +5 −5

Details

142claude -p "Reply with one word: connected"142claude -p "Reply with one word: connected"

143```143```

144 144

145**Point de contrôle** : la demande retourne une réponse, et la demande apparaît dans le journal de la passerelle comme un `POST` au chemin `/v1/messages` avec le statut `200`. Claude Code ajoute une chaîne de requête telle que `?beta=true`, donc faites correspondre le chemin, pas l'URL complète. Deux messages d'erreur pointent dans des directions différentes :145**Checkpoint** : le prompt renvoie une réponse, et la requête apparaît dans le log de la passerelle sous la forme d'un `POST` vers le chemin `/v1/messages` avec le statut `200`. Claude Code ajoute une chaîne de requête telle que `?beta=true`, donc faites la correspondance sur le chemin, pas sur l'URL complète. Vérifiez le message d'échec :

146 146

147* `Not logged in` : vérifiez le journal de la passerelle pour distinguer les deux causes. S'il est vide, aucune credential n'a atteint la session et aucune demande n'a quitté la machine ; réexécutez les exports dans le shell que vous testez. S'il affiche une demande rejetée avec `x-api-key` dans le corps `401`, la passerelle s'attend à des clés dans cet en-tête à la place ; basculez vers `ANTHROPIC_API_KEY`147* `Not logged in` : consultez le log de la passerelle. S'il est vide, aucun identifiant n'a atteint la session et aucune requête n'a quitté la machine ; réexécutez les exports dans le shell depuis lequel vous testez. S'il affiche un `401` de la passerelle mentionnant `x-api-key`, la passerelle attend plutôt les clés dans cet en-tête ; passez à `ANTHROPIC_API_KEY`. S'il affiche un `401` provenant de `api.anthropic.com` ou de l'endpoint de votre fournisseur, corrigez les identifiants du fournisseur détenus par la passerelle

148* `Failed to authenticate. API Error: 401` signifie qu'une credential a été envoyée et rejetée, et le journal de la passerelle dit où : un `401` nommant `api.anthropic.com` ou le point de terminaison de votre fournisseur signifie que la passerelle a atteint l'amont mais sa credential du fournisseur a été rejetée, donc la clé développeur a fonctionné et la credential du fournisseur que la passerelle détient est incorrecte ou un placeholder148* `Failed to authenticate. API Error: 401` signifie qu'une credential a été envoyée et rejetée, et le journal de la passerelle dit où : un `401` nommant `api.anthropic.com` ou le point de terminaison de votre fournisseur signifie que la passerelle a atteint l'amont mais sa credential du fournisseur a été rejetée, donc la clé développeur a fonctionné et la credential du fournisseur que la passerelle détient est incorrecte ou un placeholder

149 149

150Une URL de base incorrecte ou inaccessible produit un symptôme différent : Claude Code [réessaie la connexion avec backoff](https://code.claude.com/docs/fr/errors.md#automatic-retries) et peut rester sans sortie pendant plusieurs minutes avant de signaler une erreur. Si la commande semble se bloquer, vérifiez le journal de la passerelle au lieu d'attendre ; aucune demande arrivante signifie que `ANTHROPIC_BASE_URL` ne pointe pas vers la passerelle.150Une URL de base incorrecte ou inaccessible produit un symptôme différent : Claude Code [réessaie la connexion avec backoff](https://code.claude.com/docs/fr/errors.md#automatic-retries) et peut rester sans sortie pendant plusieurs minutes avant de signaler une erreur. Si la commande semble se bloquer, vérifiez le journal de la passerelle au lieu d'attendre ; aucune demande arrivante signifie que `ANTHROPIC_BASE_URL` ne pointe pas vers la passerelle.

247 247

248Vous devriez voir les lignes `data:` arriver de manière progressive. La réponse entière arrivant à la fois après une pause signifie que la passerelle met en mémoire tampon, ce qui bloque Claude Code ; un `404` signifie que le nom du modèle n'est pas acheminé. Répétez par nom de modèle.248Vous devriez voir les lignes `data:` arriver de manière progressive. La réponse entière arrivant à la fois après une pause signifie que la passerelle met en mémoire tampon, ce qui bloque Claude Code ; un `404` signifie que le nom du modèle n'est pas acheminé. Répétez par nom de modèle.

249 249

250Ensuite, démarrez `claude` et envoyez un message. Chaque symptôme à cette étape a une cause :250Démarrez ensuite `claude`, envoyez un message et comparez avec ce que vous observez :

251 251

252* Une invite de connexion signifie une lacune de credential. Exécutez `/status` et ouvrez l'onglet **Status** : quand la ligne `Setting sources` n'inclut pas les paramètres gérés, la distribution n'a pas atteint la machine ; quand elle le fait, la credential développeur n'a pas été livrée, donc définissez `ANTHROPIC_AUTH_TOKEN` ou le `apiKeyHelper`252* Un écran de connexion, ou `Not logged in` sans nouvelle entrée dans le log de la passerelle, signifie que des identifiants manquent. Exécutez `/status` et ouvrez l'onglet **Status** : si la ligne `Setting sources` n'inclut pas les paramètres gérés, la distribution n'a pas atteint la machine ; si elle les inclut, les identifiants du développeur n'ont pas été fournis, donc définissez `ANTHROPIC_AUTH_TOKEN` ou le `apiKeyHelper`

253* Les erreurs `Failed to authenticate` signifient que la passerelle rejette les demandes ; son journal dit quelle credential a échoué. Un rejet que la passerelle enregistre elle-même nomme la clé développeur, tandis qu'un `401` de `api.anthropic.com` ou du point de terminaison de votre fournisseur signifie que la credential du fournisseur que la passerelle détient a été rejetée253* `Please run /login · API Error: 401`, `Not logged in` ou `Invalid API key` avec un `401` dans le log de la passerelle : vérifiez qui a émis le `401`. Corrigez la clé développeur ou son en-tête si c'est la passerelle qui l'a émis, ou les identifiants du fournisseur qu'elle détient s'il provient de `api.anthropic.com` ou de l'endpoint de votre fournisseur

254* Une demande d'approbation ponctuelle de la clé est normale lors de la première utilisation lorsque la passerelle attend les clés dans l'en-tête `x-api-key`, définies via `ANTHROPIC_API_KEY`254* Une demande d'approbation ponctuelle de la clé est normale lors de la première utilisation lorsque la passerelle attend les clés dans l'en-tête `x-api-key`, définies via `ANTHROPIC_API_KEY`

255 255

256Si votre organisation utilise le [mode rapide](https://code.claude.com/docs/fr/fast-mode.md), exécutez `/fast` ici aussi : la vérification de disponibilité appelle `api.anthropic.com` directement plutôt que de suivre l'URL de base de la passerelle, donc une session acheminée par la passerelle peut signaler le mode rapide comme indisponible ou désactivé même si l'inférence fonctionne. [Utiliser le mode rapide derrière les proxies et les passerelles LLM](https://code.claude.com/docs/fr/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) mappe chaque message à la variable qui le restaure, distribuée avec [le reste de la configuration](#distribute-the-configuration).256Si votre organisation utilise le [mode rapide](https://code.claude.com/docs/fr/fast-mode.md), exécutez `/fast` ici aussi : la vérification de disponibilité appelle `api.anthropic.com` directement plutôt que de suivre l'URL de base de la passerelle, donc une session acheminée par la passerelle peut signaler le mode rapide comme indisponible ou désactivé même si l'inférence fonctionne. [Utiliser le mode rapide derrière les proxies et les passerelles LLM](https://code.claude.com/docs/fr/fast-mode.md#use-fast-mode-behind-proxies-and-llm-gateways) mappe chaque message à la variable qui le restaure, distribuée avec [le reste de la configuration](#distribute-the-configuration).

microsoft-foundry.md +2 −16

Details

147 147

148## Configuration Azure RBAC148## Configuration Azure RBAC

149 149

150Les rôles par défaut `Azure AI User` et `Cognitive Services User` incluent toutes les autorisations requises pour invoquer les modèles Claude.150Si vous vous authentifiez avec Microsoft Entra ID ou avec un jeton porteur émis par celui-ci, attribuez à votre identité le rôle `Foundry User` ou `Cognitive Services User` sur votre ressource Foundry. Il se peut que `Foundry User` apparaisse encore sous son ancien nom, `Azure AI User`.

151 151

152Pour des autorisations plus restrictives, créez un rôle personnalisé avec les éléments suivants :152Si ces rôles ne répondent pas à vos besoins, consultez la [documentation RBAC de Microsoft Foundry](https://learn.microsoft.com/en-us/azure/foundry/concepts/rbac-foundry) pour les rôles personnalisés.

~~153~~

154```json theme={null}

155{

156 "permissions": [

157 {

158 "dataActions": [

159 "Microsoft.CognitiveServices/accounts/providers/*"

160 ]

161 }

162 ]

163}

164```

~~165~~

166Pour plus de détails, consultez la [documentation RBAC de Microsoft Foundry](https://learn.microsoft.com/en-us/azure/ai-foundry/concepts/rbac-azure-ai-foundry).

167 153

168## Fenêtre de contexte de 1M tokens154## Fenêtre de contexte de 1M tokens

169 155

model-config.md +5 −3

Details

157 157

158Lorsque le modèle actif au démarrage provient des paramètres de projet ou gérés plutôt que de votre propre sélection, l'en-tête de démarrage indique quel fichier de paramètres l'a défini. Exécutez `/model` pour remplacer ; le paramètre de projet ou géré se réapplique au prochain lancement. Sur les plates-formes qui intègrent Claude Code et définissent [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](https://code.claude.com/docs/fr/env-vars), la configuration du 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 en fournit une ; [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.158Lorsque le modèle actif au démarrage provient des paramètres de projet ou gérés plutôt que de votre propre sélection, l'en-tête de démarrage indique quel fichier de paramètres l'a défini. Exécutez `/model` pour remplacer ; le paramètre de projet ou géré se réapplique au prochain lancement. Sur les plates-formes qui intègrent Claude Code et définissent [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](https://code.claude.com/docs/fr/env-vars), la configuration du 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 en fournit une ; [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.

159 159

160Si vous ou votre organisation configurez des [hooks PreModelSwitch](https://code.claude.com/docs/fr/hooks.md#premodelswitch), ils s'exécutent avant qu'un basculement demandé s'applique et peuvent le bloquer ou vous demander de confirmer.160Si vous ou votre organisation configurez des [hooks PreModelSwitch](https://code.claude.com/docs/fr/hooks.md#premodelswitch), ils s'exécutent avant qu'un basculement demandé s'applique et peuvent le bloquer ou vous demander de confirmer. Pour savoir pourquoi un hook a bloqué un basculement et ce qu'il faut faire, consultez [Le basculement de modèle a été bloqué par un hook PreModelSwitch](https://code.claude.com/docs/fr/errors.md#model-switch-was-blocked-by-a-premodelswitch-hook).

161 161

162Lorsque Claude Code ne peut pas dire quels hooks PreModelSwitch vos [plugins gérés](https://code.claude.com/docs/fr/settings-reference.md#enabledplugins) de l'organisation fournissent, par exemple parce qu'un plugin géré n'a pas pu se charger, il refuse le basculement plutôt que de l'appliquer sans vérification, et il vérifie à nouveau à chaque nouvelle tentative. Consultez [Le basculement de modèle a été bloqué par un hook PreModelSwitch](https://code.claude.com/docs/fr/errors.md#model-switch-was-blocked-by-a-premodelswitch-hook) pour le message et la récupération.162Si un [plugin géré](https://code.claude.com/docs/fr/settings-reference.md#enabledplugins) ou ses hooks ne parviennent pas à se charger, vous pouvez toujours basculer de modèle. Les hooks PreModelSwitch du plugin ne s'exécutent pas, de sorte qu'un basculement que l'un d'eux aurait bloqué peut avoir lieu. Les autres hooks PreModelSwitch qui se sont chargés s'exécutent toujours et peuvent le bloquer. Si une version de Claude Code antérieure à v2.1.323 refuse le basculement avec `so organization-managed PreModelSwitch hooks could not be checked`, mettez à jour Claude Code.

163

164Pour voir ce qui a échoué, exécutez `/plugin` dans votre session et ouvrez l'[onglet **Errors**](https://code.claude.com/docs/fr/plugins/troubleshooting.md#failed-to-load-hooks-from-and-hooks-that-dont-fire). Si rien n'y figure, démarrez une nouvelle session avec `claude --debug` depuis votre shell et basculez vers un autre modèle, puis lisez le [log de débogage](https://code.claude.com/docs/fr/hooks.md#debug-hooks). Après avoir corrigé le plugin, ou lorsqu'une [mise à jour du plugin](https://code.claude.com/docs/fr/plugins/install.md#keep-plugins-updated) apporte le correctif de votre administrateur sur votre machine, exécutez `/reload-plugins` dans votre session pour que ses hooks s'exécutent.

163 165

164Lorsque vous basculez les modèles via la méthode `setModel()` du [SDK Agent](https://code.claude.com/docs/fr/agent-sdk/overview.md), via une application telle que l'[application de bureau](https://code.claude.com/docs/fr/desktop.md), ou à partir d'un appareil connecté via [Remote Control](https://code.claude.com/docs/fr/remote-control.md), Claude Code vérifie la valeur au basculement :166Lorsque vous basculez les modèles via la méthode `setModel()` du [SDK Agent](https://code.claude.com/docs/fr/agent-sdk/overview.md), via une application telle que l'[application de bureau](https://code.claude.com/docs/fr/desktop.md), ou à partir d'un appareil connecté via [Remote Control](https://code.claude.com/docs/fr/remote-control.md), Claude Code vérifie la valeur au basculement :

165 167

903 905

904### Corriger la fenêtre pour une passerelle ou un ID de modèle personnalisé906### Corriger la fenêtre pour une passerelle ou un ID de modèle personnalisé

905 907

906L'un ou l'autre de ces avertissements au démarrage signifie que Claude Code ne reconnaît pas l'ID de modèle de votre session ; il ne peut donc pas déterminer la fenêtre de contexte du modèle et suppose 200 K tokens :908L'un ou l'autre de ces avertissements signifie que Claude Code ne reconnaît pas l'ID de modèle de votre session ; il ne peut donc pas déterminer la fenêtre de contexte du modèle et suppose 200 K tokens :

907 909

908```text theme={null}910```text theme={null}

909⚠ Model "my-gateway-opus" isn't recognized · context assumed to be 200k tokens · ...911⚠ Model "my-gateway-opus" isn't recognized · context assumed to be 200k tokens · ...

monitoring-usage.md +1 −1

Details

431> * **Aucun espace autorisé** : les valeurs ne peuvent pas contenir d'espaces. Par exemple, `user.organizationName=My Company` est invalide431> * **Aucun espace autorisé** : les valeurs ne peuvent pas contenir d'espaces. Par exemple, `user.organizationName=My Company` est invalide

432> * **Format** : doit être des paires clé=valeur séparées par des virgules : `key1=value1,key2=value2`432> * **Format** : doit être des paires clé=valeur séparées par des virgules : `key1=value1,key2=value2`

433> * **Caractères autorisés** : uniquement les caractères US-ASCII à l'exclusion des caractères de contrôle, des espaces, des guillemets doubles, des virgules, des points-virgules et des barres obliques inverses433> * **Caractères autorisés** : uniquement les caractères US-ASCII à l'exclusion des caractères de contrôle, des espaces, des guillemets doubles, des virgules, des points-virgules et des barres obliques inverses

434> * **Caractères spéciaux** : les caractères en dehors de la plage autorisée doivent être codés en pourcentage434> * **Caractères spéciaux** : les caractères en dehors de la plage autorisée doivent être codés en pourcentage, et un `=` à l'intérieur d'une valeur doit être écrit `%3D`

435>435>

436> Pour une valeur qui aurait besoin d'un espace, utilisez des traits de soulignement ou camelCase à la place. Les exemples suivants définissent `org.name` avec chaque forme :436> Pour une valeur qui aurait besoin d'un espace, utilisez des traits de soulignement ou camelCase à la place. Les exemples suivants définissent `org.name` avec chaque forme :

437>437>

permission-modes.md +1 −1

Details

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

305```305```

306 306

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

308 308

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

310 310

plugins/create.md +1 −1

Details

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

345 {345 {

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

347 "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npm run lint:fix" }]347 "hooks": [{ "type": "command", "command": "f=$(jq -r '.tool_input.file_path') && npm run lint:fix -- \"$f\"" }]

348 }348 }

349 ]349 ]

350 }350 }

plugins/mods/test.md +1 −10

Details

196 196

197### Vérifier un résultat avec `expect`197### Vérifier un résultat avec `expect`

198 198

199Le kit propose ces assertions, et celle que vous choisissez se place après la valeur que vous vérifiez, comme dans `expect(answer.text).toBe('ok')` :199`expect` dispose de son propre ensemble d'assertions, comme `toEqual` et `toHaveLength`, qui se placent après la valeur que vous vérifiez, comme dans `expect(answer.text).toBe('ok')`. Pour la liste complète, recherchez `type Matchers` dans `claude-code/index.d.ts` parmi [les types de votre build](https://code.claude.com/docs/fr/plugins/mods/create.md#get-the-types-for-your-build). Placez `.not` devant l'assertion pour vérifier le contraire. Pour vérifier la valeur avec laquelle une promesse se règle, placez `.resolves` ou `.rejects` juste après `expect(...)` et ajoutez `await` devant la ligne, comme dans `await expect(promise).rejects.toThrow()`.

~~200~~

201* **Égalité** : `toBe` pour la même valeur ou le même objet, `toEqual` pour la structure, `toStrictEqual` pour la structure plus les champs `undefined` et le prototype, et `toMatchObject` pour les champs que vous nommez

202* **Texte** : `toMatch`, qui accepte une expression régulière ou une sous-chaîne, `toStartWith` et `toEndWith`

203* **Nombres** : `toBeGreaterThan`, `toBeGreaterThanOrEqual`, `toBeLessThan`, `toBeLessThanOrEqual`

204* **Contenu** : `toContain` pour une sous-chaîne ou un membre, `toContainEqual` pour un membre comparé par structure, `toHaveLength` et `toHaveProperty`

205* **Présence et type** : `toBeDefined`, `toBeUndefined`, `toBeNull`, `toBeTruthy`, `toBeFalsy`, `toBeNaN`, `toBeInstanceOf`

206* **Levée d'exceptions** : `toThrow`, pour une fonction que `expect` appelle, ou pour une promesse que vous vérifiez avec `.rejects`

~~207~~

208Placez `.not` devant une assertion pour vérifier le contraire, et `.resolves` ou `.rejects` pour vérifier la valeur avec laquelle une promesse se règle.

209 200

210Quand un `expect` échoue à l'intérieur d'un stub ou d'un hook que vous avez passé à `on` sous forme de fonction simple plutôt que de générateur asynchrone, le test échoue. Le moteur ignore ce hook, et la sortie de l'échec le nomme, par exemple `in the test's store.set hook`.201Quand un `expect` échoue à l'intérieur d'un stub ou d'un hook que vous avez passé à `on` sous forme de fonction simple plutôt que de générateur asynchrone, le test échoue. Le moteur ignore ce hook, et la sortie de l'échec le nomme, par exemple `in the test's store.set hook`.

211 202

remote-control.md +2 −1

Details

67> | `--capacity <N>` | Nombre maximal de sessions simultanées. La valeur par défaut est 32. Ne peut pas être utilisé avec `--spawn=session`. |67> | `--capacity <N>` | Nombre maximal de sessions simultanées. La valeur par défaut est 32. Ne peut pas être utilisé avec `--spawn=session`. |

68> | `--[no-]create-session-in-dir` | Pré-crée une session dans le répertoire actuel au démarrage du serveur, afin que vous puissiez saisir du texte immédiatement. En mode `worktree`, cette session reste dans le répertoire actuel tandis que les sessions à la demande obtiennent des worktrees isolés. Activé par défaut. Si vous passez `--no-create-session-in-dir` pour démarrer sans aucune session, Claude Code archive les sessions du serveur lorsque vous l'arrêtez, il n'y a donc rien à [reprendre](#resume-sessions-after-stopping-the-server). |68> | `--[no-]create-session-in-dir` | Pré-crée une session dans le répertoire actuel au démarrage du serveur, afin que vous puissiez saisir du texte immédiatement. En mode `worktree`, cette session reste dans le répertoire actuel tandis que les sessions à la demande obtiennent des worktrees isolés. Activé par défaut. Si vous passez `--no-create-session-in-dir` pour démarrer sans aucune session, Claude Code archive les sessions du serveur lorsque vous l'arrêtez, il n'y a donc rien à [reprendre](#resume-sessions-after-stopping-the-server). |

69> | `--permission-mode <mode>` | Définit le [mode de permission](https://code.claude.com/docs/fr/permission-modes.md) initial des sessions du serveur, par exemple `acceptEdits`. Accepte `manual` comme alias de `default` ; un mode non reconnu arrête le serveur au démarrage et liste les modes valides. |69> | `--permission-mode <mode>` | Définit le [mode de permission](https://code.claude.com/docs/fr/permission-modes.md) initial des sessions du serveur, par exemple `acceptEdits`. Accepte `manual` comme alias de `default` ; un mode non reconnu arrête le serveur au démarrage et liste les modes valides. |

70> | `--settings <file>` | Applique un fichier de paramètres JSON aux sessions du serveur, avec la même [priorité](https://code.claude.com/docs/fr/settings.md#settings-precedence) que `claude --settings`. Indiquez un chemin de fichier, et non une chaîne JSON. Nécessite Claude Code v2.1.321 ou ultérieur. |

70> | `--chrome` / `--no-chrome` | Active ou désactive l'[intégration Chrome](https://code.claude.com/docs/fr/chrome.md) dans les sessions créées par le serveur, afin que Claude puisse utiliser Chrome sur votre machine pendant que vous travaillez depuis un autre appareil. Sans l'un ou l'autre de ces flags, la session pré-créée par le serveur et toute session que vous démarrez vous-même depuis claude.ai/code ou l'application Claude commencent avec Chrome désactivé, même si vous avez [activé Chrome par défaut](https://code.claude.com/docs/fr/chrome.md#enable-chrome-by-default). Une session que le serveur démarre pour l'un de vos fils de [projet](https://code.claude.com/docs/fr/claude-projects.md) suit plutôt ce paramètre, sauf en mode `bypassPermissions`. Nécessite Claude Code v2.1.273 ou ultérieur. |71> | `--chrome` / `--no-chrome` | Active ou désactive l'[intégration Chrome](https://code.claude.com/docs/fr/chrome.md) dans les sessions créées par le serveur, afin que Claude puisse utiliser Chrome sur votre machine pendant que vous travaillez depuis un autre appareil. Sans l'un ou l'autre de ces flags, la session pré-créée par le serveur et toute session que vous démarrez vous-même depuis claude.ai/code ou l'application Claude commencent avec Chrome désactivé, même si vous avez [activé Chrome par défaut](https://code.claude.com/docs/fr/chrome.md#enable-chrome-by-default). Une session que le serveur démarre pour l'un de vos fils de [projet](https://code.claude.com/docs/fr/claude-projects.md) suit plutôt ce paramètre, sauf en mode `bypassPermissions`. Nécessite Claude Code v2.1.273 ou ultérieur. |

71> | `-d`, `--debug[=<filter>]` | Active les logs de débogage du serveur, éventuellement filtrés par catégorie. Ne passez un filtre que sous la forme `=`, par exemple `--debug=api,hooks`. Nécessite Claude Code v2.1.282 ou ultérieur. |72> | `-d`, `--debug[=<filter>]` | Active les logs de débogage du serveur, éventuellement filtrés par catégorie. Ne passez un filtre que sous la forme `=`, par exemple `--debug=api,hooks`. Nécessite Claude Code v2.1.282 ou ultérieur. |

72> | `--debug-file <path>` | Écrit les logs de débogage dans le fichier indiqué. |73> | `--debug-file <path>` | Écrit les logs de débogage dans le fichier indiqué. |

73> | `--verbose` | Affiche des logs détaillés sur les connexions et les sessions. |74> | `--verbose` | Affiche des logs détaillés sur les connexions et les sessions. |

74> | `--sandbox`, `--no-sandbox` | Supprimés dans la v2.1.300. Si vous passez l'un de ces flags, le serveur [se ferme avec une erreur](https://code.claude.com/docs/fr/errors.md#sandbox-is-not-supported-by-claude-remote-control) au lieu de démarrer. |75> | `--sandbox`, `--no-sandbox` | Supprimés dans la v2.1.300. Si vous passez l'un de ces flags, le serveur [se ferme avec une erreur](https://code.claude.com/docs/fr/errors.md#sandbox-is-not-supported-by-claude-remote-control) au lieu de démarrer. |

75>76>

76> Si vous passez un flag global de `claude` avant `remote-control`, ou si un script wrapper en ajoute un, Claude Code ne transmet pas ce flag aux sessions créées par le serveur. Claude Code ne laisse passer le flag que lorsqu'il est établi que son abandon ne change pas ce que ces sessions peuvent faire, comme `--verbose` ou `--model`. Pour tout autre flag, comme `--settings`, Claude Code [refuse de démarrer](https://code.claude.com/docs/fr/errors.md#not-carried-over-to-the-sessions-remote-control-starts) et indique le flag à supprimer.77> Si vous passez un flag global de `claude` avant `remote-control`, ou si un script wrapper en ajoute un, Claude Code ne transmet pas ce flag aux sessions créées par le serveur. Le serveur démarre tout de même avec certains flags, comme `--verbose` ou `--model`. Avec tout autre flag, le serveur [ne démarre pas](https://code.claude.com/docs/fr/errors.md#not-carried-over-to-the-sessions-remote-control-starts). Pour passer un fichier de paramètres, placez `--settings` après `remote-control`.

77>78>

78> Pour exécuter dans un sandbox les sessions démarrées par le serveur, activez le [sandboxing](https://code.claude.com/docs/fr/sandboxing.md) dans un fichier de paramètres.79> Pour exécuter dans un sandbox les sessions démarrées par le serveur, activez le [sandboxing](https://code.claude.com/docs/fr/sandboxing.md) dans un fichier de paramètres.

79>80>

routines.md +1 −1

Details

431 431

432Chaque tâche planifiée utilise un [environnement cloud](https://code.claude.com/docs/fr/cloud-environments.md) qui contrôle l'accès réseau, les variables d'environnement et les scripts de configuration. La tâche hérite de la politique réseau de l'environnement à chaque exécution.432Chaque tâche planifiée utilise un [environnement cloud](https://code.claude.com/docs/fr/cloud-environments.md) qui contrôle l'accès réseau, les variables d'environnement et les scripts de configuration. La tâche hérite de la politique réseau de l'environnement à chaque exécution.

433 433

434L'environnement **Default** utilise l'accès **Limited** avec **Allow package managers** coché, de sorte que ses exécutions atteignent la [liste d'autorisation par défaut](https://code.claude.com/docs/fr/cloud-environments.md#default-allowed-domains). Une requête vers un hôte bloqué échoue avec `403` et `x-deny-reason: host_not_allowed`. Le trafic des connecteurs MCP est acheminé via les serveurs d'Anthropic, de sorte que les connecteurs que vous ajoutez à la tâche fonctionnent sans ajouter leurs hôtes aux **Allowed domains**. Supprimez les connecteurs dont vous n'avez pas besoin sous [Connecteurs](#connectors).434L'environnement **Default** utilise l'accès **Limited** avec **Allow package managers** coché, de sorte que ses exécutions atteignent la [liste d'autorisation par défaut](https://code.claude.com/docs/fr/cloud-environments.md#default-allowed-domains). Une requête vers un hôte bloqué échoue avec [une erreur telle qu'un `403` ou `ENOTFOUND`](https://code.claude.com/docs/fr/errors#host-not-allowed-in-a-cloud-session). Le trafic des connecteurs MCP est acheminé via les serveurs d'Anthropic, de sorte que les connecteurs que vous ajoutez à la tâche fonctionnent sans ajouter leurs hôtes aux **Allowed domains**. Supprimez les connecteurs dont vous n'avez pas besoin sous [Connecteurs](#connectors).

435 435

436Pour autoriser des domaines supplémentaires sur l'un de vos propres environnements, suivez ces étapes. Un [environnement partagé par l'organisation](https://code.claude.com/docs/fr/cloud-environments.md#organization-shared-environments) s'ouvre ici en lecture seule ; c'est donc un propriétaire qui modifie son accès réseau depuis la page **Cloud environments** des [paramètres d'administration](https://claude.ai/admin-settings).436Pour autoriser des domaines supplémentaires sur l'un de vos propres environnements, suivez ces étapes. Un [environnement partagé par l'organisation](https://code.claude.com/docs/fr/cloud-environments.md#organization-shared-environments) s'ouvre ici en lecture seule ; c'est donc un propriétaire qui modifie son accès réseau depuis la page **Cloud environments** des [paramètres d'administration](https://claude.ai/admin-settings).

437 437

sandboxing.md +5 −3

Details

276 276

277Ces chemins sont appliqués au niveau du système d'exploitation, de sorte que toutes les commandes exécutées dans le sandbox, y compris leurs processus enfants, les respectent. C'est l'approche recommandée lorsqu'un outil a besoin d'un accès en écriture à un emplacement spécifique, plutôt que d'exclure entièrement l'outil du sandbox avec `excludedCommands`.277Ces chemins sont appliqués au niveau du système d'exploitation, de sorte que toutes les commandes exécutées dans le sandbox, y compris leurs processus enfants, les respectent. C'est l'approche recommandée lorsqu'un outil a besoin d'un accès en écriture à un emplacement spécifique, plutôt que d'exclure entièrement l'outil du sandbox avec `excludedCommands`.

278 278

279Sous Linux et WSL2, une entrée pour un chemin qui n'existe pas encore n'a aucun effet ; créez donc d'abord le chemin.

280

279Lorsque vous définissez le même tableau de système de fichiers dans plusieurs [portées de paramètres](https://code.claude.com/docs/fr/settings.md#settings-precedence), Claude Code les fusionne, en combinant les chemins plutôt qu'en remplaçant le tableau d'une portée par celui d'une autre. Claude Code exclut une entrée de la fusion lorsqu'un verrou décrit dans [Empêcher les développeurs d'élargir la politique](#keep-developers-from-widening-the-policy) la couvre.281Lorsque vous définissez le même tableau de système de fichiers dans plusieurs [portées de paramètres](https://code.claude.com/docs/fr/settings.md#settings-precedence), Claude Code les fusionne, en combinant les chemins plutôt qu'en remplaçant le tableau d'une portée par celui d'une autre. Claude Code exclut une entrée de la fusion lorsqu'un verrou décrit dans [Empêcher les développeurs d'élargir la politique](#keep-developers-from-widening-the-policy) la couvre.

280 282

281Si vous excluez une source avec [`--setting-sources`](https://code.claude.com/docs/fr/cli-reference) dans la CLI ou [`settingSources`](https://code.claude.com/docs/fr/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) dans l'Agent SDK, Claude Code ignore ses entrées `sandbox.filesystem`, ses règles de permission `Edit` et ses règles de refus `Read` lors de la construction de la configuration du sandbox. Nécessite Claude Code v2.1.246 ou une version ultérieure.283Si vous excluez une source avec [`--setting-sources`](https://code.claude.com/docs/fr/cli-reference) dans la CLI ou [`settingSources`](https://code.claude.com/docs/fr/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) dans l'Agent SDK, Claude Code ignore ses entrées `sandbox.filesystem`, ses règles de permission `Edit` et ses règles de refus `Read` lors de la construction de la configuration du sandbox. Nécessite Claude Code v2.1.246 ou une version ultérieure.

376 378

377Comme la désactivation de l'isolation du système de fichiers élargit ce que les commandes en sandbox peuvent faire, Claude Code ne prend en compte `filesystem.disabled` qu'à partir des sources de paramètres suivantes :379Comme la désactivation de l'isolation du système de fichiers élargit ce que les commandes en sandbox peuvent faire, Claude Code ne prend en compte `filesystem.disabled` qu'à partir des sources de paramètres suivantes :

378 380

379* Les paramètres utilisateur, les paramètres gérés et le flag CLI `--settings` peuvent le définir. Les paramètres de projet dans `.claude/settings.json` et `.claude/settings.local.json` ne le peuvent pas, de sorte qu'un projet récupéré ne peut pas désactiver l'isolation du système de fichiers.381* Les paramètres utilisateur, les paramètres gérés et le flag CLI `--settings` peuvent le définir. Les paramètres de projet dans `.claude/settings.json` et `.claude/settings.local.json` ne peuvent pas le définir.

380* Lorsque les paramètres gérés configurent `sandbox.filesystem` de quelque manière que ce soit, ou listent une entrée `sandbox.credentials.files` avec `"mode": "deny"`, seuls les paramètres gérés peuvent définir la clé. Cela empêche les développeurs de désactiver l'isolation du système de fichiers dans un tel déploiement ; pour la désactiver pour tout le monde, définissez `"disabled": true` dans les paramètres gérés.382* Lorsque les paramètres gérés configurent `sandbox.filesystem` de quelque manière que ce soit, ou listent une entrée `sandbox.credentials.files` avec `"mode": "deny"`, seuls les paramètres gérés peuvent définir la clé. Pour désactiver l'isolation du système de fichiers pour tout le monde, définissez `"disabled": true` dans les paramètres gérés.

381* Lorsque [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](https://code.claude.com/docs/fr/env-vars) est défini, Claude Code ignore `filesystem.disabled` quelle que soit la source, y compris les paramètres gérés, et maintient l'isolation du système de fichiers activée.383* Lorsque [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](https://code.claude.com/docs/fr/env-vars) est défini, Claude Code ignore `filesystem.disabled` quelle que soit la source, y compris les paramètres gérés.

382 384

383Une entrée `mask` [valide](https://code.claude.com/docs/fr/settings-reference.md#invalid-credential-entries-in-managed-settings) ne verrouille pas la clé, même lorsque Claude Code [se rabat sur `deny`](#mask-credential-files) pour cette entrée au démarrage. Indiquez un chemin qui ne peut pas être masqué, comme un répertoire d'identifiants, sous forme d'entrée `deny` explicite dans les paramètres gérés, ce qui verrouille la clé.385Une entrée `mask` [valide](https://code.claude.com/docs/fr/settings-reference.md#invalid-credential-entries-in-managed-settings) ne verrouille pas la clé, même lorsque Claude Code [se rabat sur `deny`](#mask-credential-files) pour cette entrée au démarrage. Indiquez un chemin qui ne peut pas être masqué, comme un répertoire d'identifiants, sous forme d'entrée `deny` explicite dans les paramètres gérés, ce qui verrouille la clé.

384 386

settings.md +1 −1

Details

177 177

178Claude Code surveille vos fichiers de paramètres et les recharge quand ils changent, donc il applique la plupart des modifications à la session en cours sans redémarrage, y compris les modifications à `permissions`, `hooks`, et les assistants d'identifiants comme `apiKeyHelper`. Claude Code charge aussi un fichier de paramètres que vous créez en session si son répertoire existait quand la session a commencé. Pour le dossier `.claude/` du projet, il charge le fichier même quand vous créez le dossier dans la même session.178Claude Code surveille vos fichiers de paramètres et les recharge quand ils changent, donc il applique la plupart des modifications à la session en cours sans redémarrage, y compris les modifications à `permissions`, `hooks`, et les assistants d'identifiants comme `apiKeyHelper`. Claude Code charge aussi un fichier de paramètres que vous créez en session si son répertoire existait quand la session a commencé. Pour le dossier `.claude/` du projet, il charge le fichier même quand vous créez le dossier dans la même session.

179 179

180Le rechargement couvre les paramètres utilisateur, projet, locaux et gérés, et Claude Code exécute le [hook `ConfigChange`](https://code.claude.com/docs/fr/hooks#configchange) pour chaque changement de fichier de paramètres qu'il détecte, pas pour les paramètres gérés qui arrivent de MDM ou de la console claude.ai. Les paramètres gérés qui arrivent via MDM ou de la console claude.ai atteignent une session en cours selon un calendrier plutôt que sur enregistrement ; le [tableau de livraison](https://code.claude.com/docs/fr/managed-settings.md#choose-a-delivery-mechanism) le donne par source.180Le rechargement couvre les paramètres utilisateur, projet, locaux et gérés. Claude Code exécute le [hook `ConfigChange`](https://code.claude.com/docs/fr/hooks#configchange) pour les modifications directes des fichiers de paramètres, pas pour les paramètres gérés qui arrivent de MDM ou de la console claude.ai. Les paramètres gérés qui arrivent via MDM ou de la console claude.ai atteignent une session en cours selon un calendrier plutôt que sur enregistrement ; le [tableau de livraison](https://code.claude.com/docs/fr/managed-settings.md#choose-a-delivery-mechanism) le donne par source.

181 181

182Claude Code lit certaines clés une seule fois, au démarrage de la session, donc une modification à l'une d'elles n'atteint pas la session en cours. Les clés côté administrateur qui attendent aussi un redémarrage, comme `requiredMinimumVersion`, sont énumérées sous [où et quand une politique s'applique](https://code.claude.com/docs/fr/managed-settings.md#where-and-when-a-policy-applies). Celles que vous êtes le plus susceptible de modifier en session :182Claude Code lit certaines clés une seule fois, au démarrage de la session, donc une modification à l'une d'elles n'atteint pas la session en cours. Les clés côté administrateur qui attendent aussi un redémarrage, comme `requiredMinimumVersion`, sont énumérées sous [où et quand une politique s'applique](https://code.claude.com/docs/fr/managed-settings.md#where-and-when-a-policy-applies). Celles que vous êtes le plus susceptible de modifier en session :

183 183

settings-reference.md +2 −0

Details

1533}1533}

1534```1534```

1535 1535

1536Sous Linux et WSL2, une entrée pour un chemin qui n'existe pas encore n'a aucun effet, créez donc d'abord le chemin.

1537

1536Claude Code fusionne les entrées `allowWrite` et les chemins de vos règles de permission `Edit(...)` allow dans les portées de paramètres que la session charge, en laissant de côté ceux des paramètres du dépôt tant que [`permissions.blockReadsOutsideWorkingDirectories`](#sandboxed-commands-under-the-block) est activé. Les [verrous de dépôt](https://code.claude.com/docs/fr/sandboxing.md#repository-settings-under-an-admin-required-sandbox) peuvent également laisser de côté les entrées d'un dépôt. Une entrée `allowWrite` ne peut pas lever un [chemin protégé](https://code.claude.com/docs/fr/sandboxing.md#protected-paths).1538Claude Code fusionne les entrées `allowWrite` et les chemins de vos règles de permission `Edit(...)` allow dans les portées de paramètres que la session charge, en laissant de côté ceux des paramètres du dépôt tant que [`permissions.blockReadsOutsideWorkingDirectories`](#sandboxed-commands-under-the-block) est activé. Les [verrous de dépôt](https://code.claude.com/docs/fr/sandboxing.md#repository-settings-under-an-admin-required-sandbox) peuvent également laisser de côté les entrées d'un dépôt. Une entrée `allowWrite` ne peut pas lever un [chemin protégé](https://code.claude.com/docs/fr/sandboxing.md#protected-paths).

1537 1539

1538### `sandbox.filesystem.denyWrite`1540### `sandbox.filesystem.denyWrite`

setup.md +9 −27

Details

40>40>

41> **macOS, Linux, WSL :**41> **macOS, Linux, WSL :**

42>42>

~~43> ```bash theme={null}~~43> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

44> curl -fsSL https://claude.ai/install.sh | bash44> curl -fsSL https://claude.ai/install.sh | bash

45> ```45> ```

46>46>

48>48>

49> **Windows PowerShell :**49> **Windows PowerShell :**

50>50>

~~51> ```powershell theme={null}~~51> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

52> irm https://claude.ai/install.ps1 | iex52> irm https://claude.ai/install.ps1 | iex

53> ```53> ```

54>54>

55> **Windows CMD :**55> **Windows CMD :**

56>56>

~~57> ```batch theme={null}~~57> ```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

58> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd58> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

59> ```59> ```

60>60>

72 72

73> [tab] Homebrew73> [tab] Homebrew

74>74>

~~75> ```bash theme={null}~~75> ```bash theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

76> brew install --cask claude-code76> brew install --cask claude-code

77> ```77> ```

78>78>

84 84

85> [tab] WinGet85> [tab] WinGet

86>86>

~~87> ```powershell theme={null}~~87> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

88> winget install Anthropic.ClaudeCode88> winget install Anthropic.ClaudeCode

89> ```89> ```

90>90>

118 118

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

120 120

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

122 122

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

124 124

141 141

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

143 143

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

145 145

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

147 147

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

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

150```

~~151~~

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

~~153~~

154```bash theme={null}

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

156```

~~157~~

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

~~159~~

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

~~161~~

162```json theme={null}

163{

164 "env": {

165 "USE_BUILTIN_RIPGREP": "0"

166 }

167}

168```150```

169 151

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

443> wget -O /etc/apk/keys/claude-code.rsa.pub \425> wget -O /etc/apk/keys/claude-code.rsa.pub \

444> https://downloads.claude.ai/keys/claude-code.rsa.pub426> https://downloads.claude.ai/keys/claude-code.rsa.pub

445> echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories427> echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories

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

447> ```429> ```

448>430>

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

terminal-config.md +1 −1

Details

26 26

27| Terminal | Shift+Enter pour un saut de ligne |27| Terminal | Shift+Enter pour un saut de ligne |

28| :- | :- |28| :- | :- |

~~29| Ghostty, Kitty, iTerm2, WezTerm, Warp, Apple Terminal, Windows Terminal | Fonctionne sans configuration |~~29| Ghostty, Kitty, iTerm2, WezTerm, Warp, Windows Terminal | Fonctionne sans configuration |

30| Autres terminaux prenant en charge le protocole clavier kitty, tels que foot et Alacritty 0.16 ou version ultérieure | Fonctionne sans configuration. Nécessite Claude Code v2.1.269 ou version ultérieure |30| Autres terminaux prenant en charge le protocole clavier kitty, tels que foot et Alacritty 0.16 ou version ultérieure | Fonctionne sans configuration. Nécessite Claude Code v2.1.269 ou version ultérieure |

31| VS Code, Cursor, Devin Desktop, Alacritty antérieur à 0.16, Zed | Exécuter `/terminal-setup` une fois |31| VS Code, Cursor, Devin Desktop, Alacritty antérieur à 0.16, Zed | Exécuter `/terminal-setup` une fois |

32| gnome-terminal, IDE JetBrains tels que PyCharm et Android Studio | Non disponible ; utilisez Ctrl+J ou `\` puis Enter |32| gnome-terminal, IDE JetBrains tels que PyCharm et Android Studio | Non disponible ; utilisez Ctrl+J ou `\` puis Enter |

tools-reference.md +1 −3

Details

127 127

128Claude utilise `AskUserQuestion` pour vous poser des questions à choix multiples lorsqu'il a besoin d'une décision ou d'une clarification. Répondez en choisissant une option, ou tapez votre propre texte via la ligne `Other` ou le champ des notes.128Claude utilise `AskUserQuestion` pour vous poser des questions à choix multiples lorsqu'il a besoin d'une décision ou d'une clarification. Répondez en choisissant une option, ou tapez votre propre texte via la ligne `Other` ou le champ des notes.

129 129

130Lorsque vous répondez en tapant votre propre texte, Claude Code relaye la réponse avec une formulation neutre afin que Claude suive ce que vous avez écrit, y compris une demande d'attendre ou d'expliquer d'abord.

~~131~~

132### Délai d'expiration de la continuation automatique des questions130### Délai d'expiration de la continuation automatique des questions

133 131

134Les questions restent ouvertes jusqu'à ce que vous y répondiez. Si vous souhaitez qu'une question que vous laissez sans réponse se ferme finalement et permette à Claude de continuer sans vous, définissez le paramètre [`askUserQuestionTimeout`](https://code.claude.com/docs/fr/settings-reference#askuserquestiontimeout) sur `60s`, `5m`, ou `10m`, soit dans votre fichier `settings.json` utilisateur, soit à partir de la ligne **Question auto-continue timeout** dans `/config`.132Les questions restent ouvertes jusqu'à ce que vous y répondiez. Si vous souhaitez qu'une question que vous laissez sans réponse se ferme finalement et permette à Claude de continuer sans vous, définissez le paramètre [`askUserQuestionTimeout`](https://code.claude.com/docs/fr/settings-reference#askuserquestiontimeout) sur `60s`, `5m`, ou `10m`, soit dans votre fichier `settings.json` utilisateur, soit à partir de la ligne **Question auto-continue timeout** dans `/config`.

525 523

526## Comportement de l'outil Read524## Comportement de l'outil Read

527 525

528L'outil Read prend un chemin de fichier et retourne le contenu avec les numéros de ligne. Claude est configuré pour toujours passer des chemins absolus.526L'outil Read prend un chemin de fichier et retourne le contenu avec les numéros de ligne.

529 527

530Lire un fichier vide retourne un avis que le fichier existe mais que son contenu est vide, et un `offset` au-delà de la dernière ligne retourne un avis donnant le nombre de lignes du fichier.528Lire un fichier vide retourne un avis que le fichier existe mais que son contenu est vide, et un `offset` au-delà de la dernière ligne retourne un avis donnant le nombre de lignes du fichier.

531 529

troubleshoot-install.md +4 −10

Details

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

389> ```389> ```

390 390

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

392 392

393```bash theme={null}393```bash theme={null}

394ldd "$(command -v claude)" | grep "not found"394ldd "$(command -v claude)" | grep "not found"

906 906

907### Incompatibilité binaire musl ou glibc Linux907### Incompatibilité binaire musl ou glibc Linux

908 908

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

910 910

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

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

913```913```

914 914

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

~~916~~

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

918 916

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

924 922

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

926 924

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

928 ```bash theme={null}

929 apk add libgcc libstdc++ ripgrep

930 ```

931 Sur Alpine, `ripgrep` se trouve dans le dépôt communautaire. Si `apk` signale que le package manque, consultez [Configuration Alpine Linux](https://code.claude.com/docs/fr/setup.md#alpine-linux-and-musl-based-distributions).

932 926

933### `Illegal instruction`927### `Illegal instruction`

934 928

troubleshooting.md +1 −1

Details

152> apk add ripgrep152> apk add ripgrep

153> ```153> ```

154>154>

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

156 156

157> [tab] Arch157> [tab] Arch

158>158>

workflows.md +0 −2

Details

75| :- | :- |75| :- | :- |

76| `/deep-research <question>` | Lance des recherches web en parallèle sur une question sous plusieurs angles, récupère et recoupe les sources trouvées, vote sur chaque affirmation et renvoie un rapport avec citations, les affirmations qui n'ont pas résisté au recoupement étant filtrées. Nécessite que l'[outil WebSearch](https://code.claude.com/docs/fr/tools-reference.md#websearch-tool-behavior) soit disponible |76| `/deep-research <question>` | Lance des recherches web en parallèle sur une question sous plusieurs angles, récupère et recoupe les sources trouvées, vote sur chaque affirmation et renvoie un rapport avec citations, les affirmations qui n'ont pas résisté au recoupement étant filtrées. Nécessite que l'[outil WebSearch](https://code.claude.com/docs/fr/tools-reference.md#websearch-tool-behavior) soit disponible |

77 77

~~78`/deep-research` ne s'exécute que lorsque vous l'invoquez.~~

80Les [workflows que vous enregistrez](#save-the-workflow-for-reuse) vous-même deviennent des commandes de la même manière et apparaissent dans l'autocomplétion `/` aux côtés des workflows intégrés.78Les [workflows que vous enregistrez](#save-the-workflow-for-reuse) vous-même deviennent des commandes de la même manière et apparaissent dans l'autocomplétion `/` aux côtés des workflows intégrés.

81 79

82### Suivre l'exécution80### Suivre l'exécution

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