1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# Référence des erreurs

6 

7> Consultez les messages d'erreur d'exécution de Claude Code avec leur signification et comment les corriger.

8 

9Cette page répertorie les erreurs d'exécution que Claude Code affiche et comment récupérer de chacune d'elles, ainsi que ce qu'il faut vérifier lorsque les réponses semblent incorrectes sans erreur. Pour les erreurs d'installation telles que `command not found` ou les défaillances TLS lors de la configuration, consultez [Troubleshooting installation and login](/fr/troubleshooting-install).

10 

11Ces erreurs et les commandes de récupération s'appliquent sur l'ensemble de l'interface CLI, l'[application Desktop](/fr/desktop) et [Claude Code sur le web](/fr/claude-code-on-the-web), car les trois encapsulent le même CLI Claude Code. Pour les problèmes spécifiques à une surface, consultez la section dépannage sur la page de cette surface.

12 

13<Note>

14 Claude Code appelle l'API Claude pour les réponses du modèle, donc la plupart des erreurs d'exécution correspondent à un code d'erreur API sous-jacent. Cette page couvre ce que chaque erreur signifie dans Claude Code et comment récupérer. Pour les définitions brutes du code de statut HTTP, consultez la [référence des erreurs de la plateforme Claude](https://platform.claude.com/docs/en/api/errors).

15</Note>

16 

17## Trouvez votre erreur

18 

19Faites correspondre le message que vous voyez dans votre terminal à une section ci-dessous.

20 

21| Message | Section |

22| :----------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------- |

23| `API Error: 500 ... Internal server error` | [Erreurs serveur](#api-error-500-internal-server-error) |

24| `API Error: Repeated 529 Overloaded errors` | [Erreurs serveur](#api-error-repeated-529-overloaded-errors) |

25| `Request timed out` | [Erreurs serveur](#request-timed-out), ou [Réseau](#unable-to-connect-to-api) si le message mentionne votre connexion Internet |

26| `<model> is temporarily unavailable, so auto mode cannot determine the safety of...` | [Erreurs serveur](#auto-mode-cannot-determine-the-safety-of-an-action) |

27| `You've hit your session limit` / `You've hit your weekly limit` | [Limites d'utilisation](#youve-hit-your-session-limit) |

28| `Server is temporarily limiting requests` | [Limites d'utilisation](#server-is-temporarily-limiting-requests) |

29| `Request rejected (429)` | [Limites d'utilisation](#request-rejected-429) |

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

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

32| `Invalid API key` | [Authentification](#invalid-api-key) |

33| `This organization has been disabled` | [Authentification](#this-organization-has-been-disabled) |

34| `OAuth token revoked` / `OAuth token has expired` | [Authentification](#oauth-token-revoked-or-expired) |

35| `does not meet scope requirement user:profile` | [Authentification](#oauth-scope-requirement) |

36| `Unable to connect to API` | [Réseau](#unable-to-connect-to-api) |

37| `SSL certificate verification failed` | [Réseau](#ssl-certificate-errors) |

38| `Prompt is too long` | [Erreurs de requête](#prompt-is-too-long) |

39| `Error during compaction: Conversation too long` | [Erreurs de requête](#error-during-compaction-conversation-too-long) |

40| `Request too large` | [Erreurs de requête](#request-too-large) |

41| `Image was too large` | [Erreurs de requête](#image-was-too-large) |

42| `PDF too large` / `PDF is password protected` | [Erreurs de requête](#pdf-errors) |

43| `Extra inputs are not permitted` | [Erreurs de requête](#extra-inputs-are-not-permitted) |

44| `There's an issue with the selected model` | [Erreurs de requête](#theres-an-issue-with-the-selected-model) |

45| `Claude Opus is not available with the Claude Pro plan` | [Erreurs de requête](#claude-opus-is-not-available-with-the-claude-pro-plan) |

46| `thinking.type.enabled is not supported for this model` | [Erreurs de requête](#thinking-type-enabled-is-not-supported-for-this-model) |

47| `max_tokens must be greater than thinking.budget_tokens` | [Erreurs de requête](#thinking-budget-exceeds-output-limit) |

48| `API Error: 400 due to tool use concurrency issues` | [Erreurs de requête](#tool-use-or-thinking-block-mismatch) |

49| Les réponses semblent de qualité inférieure à la normale | [Qualité des réponses](#responses-seem-lower-quality-than-usual) |

50 

51## Tentatives automatiques

52 

53Claude Code réessaie les défaillances transitoires avant de vous afficher une erreur. Les erreurs serveur, les réponses surchargées, les délais d'attente des requêtes, les accélérateurs 429 temporaires et les connexions interrompues sont tous réessayés jusqu'à 10 fois avec un backoff exponentiel. Lors des tentatives, le spinner affiche un compte à rebours `Retrying in Ns · attempt x/y`.

54 

55Lorsque vous voyez l'une des erreurs de cette page, ces tentatives ont déjà été épuisées. Vous pouvez ajuster le comportement avec deux variables d'environnement :

56 

57| Variable | Par défaut | Effet |

58| :---------------------------------------- | :--------- | :------------------------------------------------------------------------------------------------------------------------------------------------------- |

59| [`CLAUDE_CODE_MAX_RETRIES`](/fr/env-vars) | 10 | Nombre de tentatives. Réduisez-le pour afficher les défaillances plus rapidement dans les scripts ; augmentez-le pour attendre les incidents plus longs. |

60| [`API_TIMEOUT_MS`](/fr/env-vars) | 600000 | Délai d'attente par requête en millisecondes. Augmentez-le pour les réseaux lents ou les proxies. |

61 

62## Erreurs serveur

63 

64Ces erreurs proviennent de l'infrastructure Anthropic plutôt que de votre compte ou de votre requête.

65 

66### API Error: 500 Internal server error

67 

68Claude Code affiche le corps de la réponse API brute pour tout statut 5xx. L'exemple ci-dessous montre une réponse 500 :

69 

70```text theme={null}

71API Error: 500 {"type":"error","error":{"type":"api_error","message":"Internal server error"}} · check status.claude.com

72```

73 

74Cela indique une défaillance inattendue à l'intérieur de l'API. Elle n'est pas causée par votre prompt, vos paramètres ou votre compte.

75 

76**Que faire :**

77 

78* Vérifiez [status.claude.com](https://status.claude.com) pour les incidents actifs

79* Attendez une minute, puis envoyez votre message à nouveau. Votre message original est toujours dans la conversation, donc pour un long prompt vous pouvez taper `try again` au lieu de coller le tout.

80* Si l'erreur persiste sans incident affiché, exécutez `/feedback` pour qu'Anthropic puisse enquêter avec les détails de votre requête. Consultez [Signaler une erreur](#report-an-error) si `/feedback` n'est pas disponible sur votre fournisseur.

81 

82### API Error: Repeated 529 Overloaded errors

83 

84L'API est temporairement à pleine capacité pour tous les utilisateurs. Claude Code a déjà réessayé plusieurs fois avant d'afficher ce message :

85 

86```text theme={null}

87API Error: Repeated 529 Overloaded errors · check status.claude.com

88```

89 

90Un 529 n'est pas votre limite d'utilisation et ne compte pas contre votre quota.

91 

92**Que faire :**

93 

94* Vérifiez [status.claude.com](https://status.claude.com) pour les avis de capacité

95* Réessayez dans quelques minutes

96* Exécutez `/model` et basculez vers un modèle différent pour continuer à travailler, car la capacité est suivie par modèle. Claude Code vous invite à le faire lorsqu'un modèle est sous une charge particulièrement élevée, par exemple `Opus is experiencing high load, please use /model to switch to Sonnet`.

97 

98### Request timed out

99 

100L'API n'a pas répondu avant la date limite de connexion.

101 

102```text theme={null}

103Request timed out

104```

105 

106Cela peut se produire pendant les périodes de charge élevée ou lorsqu'une très grande réponse est générée. Le délai d'attente par défaut de la requête est de 10 minutes.

107 

108**Que faire :**

109 

110* Réessayez la requête

111* Pour les tâches longues, divisez le travail en prompts plus petits

112* Si un réseau lent ou un proxy est la cause, augmentez `API_TIMEOUT_MS` comme décrit dans [Tentatives automatiques](#automatic-retries)

113* Si les délais d'attente sont fréquents et que votre réseau est par ailleurs sain, consultez [Erreurs réseau et de connexion](#network-and-connection-errors) ci-dessous

114 

115### Auto mode cannot determine the safety of an action

116 

117Le modèle que le [mode auto](/fr/permission-modes#eliminate-prompts-with-auto-mode) utilise pour classer les actions est surchargé, donc le mode auto a bloqué l'action au lieu de l'approuver sans vérification.

118 

119```text theme={null}

120<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait briefly and then try this action again.

121```

122 

123Les lectures, les recherches et les modifications dans votre répertoire de travail ignorent le classificateur, donc elles continuent à fonctionner pendant la panne.

124 

125**Que faire :**

126 

127* Réessayez après quelques secondes ; Claude voit le même message et réessaie généralement automatiquement

128* Si les tentatives continuent d'échouer, continuez avec les tâches en lecture seule et revenez à l'action bloquée plus tard

129* C'est transitoire et sans rapport avec l'[admissibilité du mode auto](/fr/permission-modes#eliminate-prompts-with-auto-mode) ; vous n'avez pas besoin de modifier les paramètres

130 

131## Limites d'utilisation

132 

133Ces erreurs signifient qu'un quota lié à votre compte ou à votre plan a été atteint. Elles sont distinctes des [erreurs serveur](#server-errors), qui affectent tout le monde.

134 

135### You've hit your session limit

136 

137Les plans d'abonnement incluent une allocation d'utilisation roulante. Lorsqu'elle s'épuise, vous voyez l'un de ces messages :

138 

139```text theme={null}

140You've hit your session limit · resets 3:45pm

141You've hit your weekly limit · resets Mon 12:00am

142You've hit your Opus limit · resets 3:45pm

143```

144 

145Claude Code bloque les demandes supplémentaires jusqu'à l'heure de réinitialisation indiquée dans le message.

146 

147**Que faire :**

148 

149* Attendez l'heure de réinitialisation indiquée dans l'erreur

150* Exécutez `/usage` pour voir les limites de votre plan et quand elles se réinitialisent

151* Exécutez `/extra-usage` pour acheter une utilisation supplémentaire sur Pro et Max, ou pour la demander à votre administrateur sur Team et Enterprise. Consultez [Extra usage for paid plans](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) pour savoir comment cela est facturé.

152* Pour mettre à niveau votre plan pour des limites de base plus élevées, consultez [claude.com/pricing](https://claude.com/pricing)

153 

154Pour surveiller votre allocation restante avant d'atteindre la limite, ajoutez les champs `rate_limits` à une [ligne d'état personnalisée](/fr/statusline#rate-limit-usage), ou dans l'application Desktop cliquez sur l'[anneau d'utilisation](/fr/desktop#check-usage) à côté du sélecteur de modèle.

155 

156### Server is temporarily limiting requests

157 

158L'API a appliqué un accélérateur de courte durée qui n'est pas lié à votre quota de plan.

159 

160```text theme={null}

161API Error: Server is temporarily limiting requests (not your usage limit)

162```

163 

164Ceci est [réessayé automatiquement](#automatic-retries) avant d'être affiché.

165 

166**Que faire :**

167 

168* Attendez brièvement et réessayez

169* Vérifiez [status.claude.com](https://status.claude.com) si cela persiste

170 

171### Request rejected (429)

172 

173Vous avez atteint la limite de débit configurée pour votre clé API, votre projet Amazon Bedrock ou votre projet Google Vertex AI.

174 

175```text theme={null}

176API Error: Request rejected (429) · this may be a temporary capacity issue

177```

178 

179**Que faire :**

180 

181* Exécutez `/status` et confirmez que les identifiants actifs sont ceux que vous attendez. Une `ANTHROPIC_API_KEY` égarée dans votre environnement peut acheminer les requêtes via une clé de niveau inférieur au lieu de votre abonnement.

182* Vérifiez la console de votre fournisseur pour les limites actives et demandez un niveau supérieur si nécessaire

183* Pour les clés API Anthropic, consultez la [référence des limites de débit](https://platform.claude.com/docs/en/api/rate-limits) pour savoir comment fonctionnent les niveaux et comment définir des plafonds par espace de travail

184* Réduisez la concurrence : réduisez [`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/fr/env-vars), évitez d'exécuter de nombreux sous-agents parallèles, ou basculez vers un modèle plus petit avec `/model` pour les exécutions scriptées à haut volume

185 

186### Credit balance is too low

187 

188Votre organisation Console a épuisé ses crédits prépayés.

189 

190```text theme={null}

191Credit balance is too low

192```

193 

194**Que faire :**

195 

196* Ajoutez des crédits sur [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing), et envisagez d'activer le rechargement automatique pour que le solde se remplisse avant d'atteindre zéro

197* Basculez vers l'authentification par abonnement avec `/login` si vous avez un plan Pro, Max, Team ou Enterprise

198* Définissez des plafonds de dépenses par espace de travail dans la Console pour empêcher un seul projet de drainer le solde de l'organisation. Consultez [Gérer les coûts efficacement](/fr/costs).

199 

200## Erreurs d'authentification

201 

202Ces erreurs signifient que Claude Code ne peut pas prouver qui vous êtes à l'API. Exécutez `/status` à tout moment pour voir quel identifiant est actuellement actif.

203 

204### Not logged in

205 

206Aucun identifiant valide n'est disponible pour cette session.

207 

208```text theme={null}

209Not logged in · Please run /login

210```

211 

212**Que faire :**

213 

214* Exécutez `/login` pour vous authentifier avec votre abonnement Claude ou votre compte Console

215* Si vous vous attendiez à ce qu'une variable d'environnement vous authentifie, confirmez que `ANTHROPIC_API_KEY` est définie et exportée dans le shell où vous avez lancé `claude`

216* Pour l'intégration continue ou l'automatisation où la connexion interactive n'est pas possible, configurez un script [`apiKeyHelper`](/fr/settings#available-settings) qui récupère une clé au démarrage

217* Consultez [Précédence d'authentification](/fr/authentication#authentication-precedence) pour comprendre quel identifiant gagne lorsque plusieurs sont présents

218 

219Si vous êtes invité à vous connecter à plusieurs reprises, consultez [Not logged in or token expired](/fr/troubleshoot-install#not-logged-in-or-token-expired) pour les corrections d'horloge système et de Keychain macOS.

220 

221### Invalid API key

222 

223La variable d'environnement `ANTHROPIC_API_KEY` ou le script `apiKeyHelper` a renvoyé une clé que l'API a rejetée.

224 

225```text theme={null}

226Invalid API key · Fix external API key

227```

228 

229**Que faire :**

230 

231* Vérifiez les fautes de frappe et confirmez que la clé n'a pas été révoquée dans la [Console](https://platform.claude.com/settings/keys)

232* Exécutez `env | grep ANTHROPIC` dans le même shell. Des outils comme direnv, les plugins shell dotenv et les terminaux IDE peuvent charger une clé obsolète à partir d'un fichier `.env` dans votre projet sans que vous la définissiez explicitement.

233* Déconfigurez `ANTHROPIC_API_KEY` et exécutez `/login` pour utiliser l'authentification par abonnement à la place

234* Si la clé provient d'un script [`apiKeyHelper`](/fr/settings#available-settings), exécutez le script directement pour confirmer qu'il imprime une clé valide sur stdout

235* Exécutez `/status` pour confirmer quelle source d'identifiant Claude Code utilise réellement

236 

237### This organization has been disabled

238 

239Une `ANTHROPIC_API_KEY` obsolète d'une organisation Console désactivée remplace votre connexion par abonnement.

240 

241```text theme={null}

242Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your other credentials

243API Error: 400 ... This organization has been disabled.

244```

245 

246Les variables d'environnement ont la priorité sur `/login`, donc une clé exportée dans votre profil shell ou chargée à partir d'un fichier `.env` est utilisée même lorsque vous avez un abonnement Pro ou Max fonctionnant. En mode non interactif (`-p`), la clé est toujours utilisée lorsqu'elle est présente.

247 

248**Que faire :**

249 

250* Déconfigurez `ANTHROPIC_API_KEY` dans le shell actuel et supprimez-le de votre profil shell, puis relancez `claude`

251* Exécutez `/status` après pour confirmer que l'identifiant actif est votre abonnement

252* Si aucune variable d'environnement n'est définie et que l'erreur persiste, l'organisation désactivée est celle liée à votre `/login`. Contactez le support ou connectez-vous avec un compte différent.

253 

254### OAuth token revoked or expired

255 

256Votre connexion enregistrée n'est plus valide. Un jeton révoqué signifie que vous vous êtes déconnecté partout ou qu'un administrateur a supprimé l'accès ; un jeton expiré signifie que l'actualisation automatique a échoué en milieu de session.

257 

258```text theme={null}

259OAuth token revoked · Please run /login

260OAuth token has expired · Please run /login

261API Error: 401 ... authentication_error

262```

263 

264**Que faire :**

265 

266* Exécutez `/login` pour vous reconnecter

267* Si l'erreur revient dans la même session après la réauthentification, exécutez d'abord `/logout` pour effacer complètement le jeton stocké, puis `/login`

268* Pour les invites répétées de connexion entre les lancements, consultez les vérifications d'horloge système et de Keychain macOS dans [Troubleshooting](/fr/troubleshoot-install#not-logged-in-or-token-expired)

269* Pour les autres défaillances incluant `403 Forbidden` et les problèmes de navigateur OAuth, consultez [Login and authentication](/fr/troubleshoot-install#login-and-authentication)

270 

271### OAuth scope requirement

272 

273Le jeton stocké est antérieur à une portée de permission qu'une fonctionnalité plus récente nécessite. Vous voyez cela le plus souvent à partir de `/usage` et de l'indicateur d'utilisation de la ligne d'état :

274 

275```text theme={null}

276OAuth token does not meet scope requirement: user:profile

277```

278 

279**Que faire :**

280 

281* Exécutez `/login` pour créer un nouveau jeton avec les portées actuelles. Vous n'avez pas besoin de vous déconnecter d'abord.

282 

283## Erreurs réseau et de connexion

284 

285Ces erreurs signifient que Claude Code n'a pas pu atteindre l'API du tout. Elles proviennent presque toujours de votre réseau local, proxy ou pare-feu plutôt que de l'infrastructure Anthropic.

286 

287### Unable to connect to API

288 

289La connexion TCP à l'API a échoué ou ne s'est jamais complétée.

290 

291```text theme={null}

292Unable to connect to API. Check your internet connection

293Unable to connect to API (ECONNREFUSED)

294Unable to connect to API (ECONNRESET)

295Unable to connect to API (ETIMEDOUT)

296fetch failed

297Request timed out. Check your internet connection and proxy settings

298```

299 

300Les causes courantes incluent l'absence d'accès Internet, un VPN qui bloque `api.anthropic.com`, ou un proxy d'entreprise requis qui n'est pas configuré.

301 

302**Que faire :**

303 

304* Confirmez que vous pouvez atteindre l'hôte API à partir du même shell en exécutant `curl -I https://api.anthropic.com`. Sur Windows PowerShell, utilisez `curl.exe -I https://api.anthropic.com` pour que l'alias `Invoke-WebRequest` intégré ne soit pas utilisé.

305* Si vous êtes derrière un proxy d'entreprise, définissez `HTTPS_PROXY` avant de lancer Claude Code et consultez [Network configuration](/fr/network-config)

306* Si vous acheminez via une passerelle LLM ou un relais, définissez [`ANTHROPIC_BASE_URL`](/fr/env-vars) sur son adresse. Consultez [LLM gateway configuration](/fr/llm-gateway) pour la configuration.

307* Assurez-vous que votre pare-feu autorise les hôtes répertoriés dans [Network access requirements](/fr/network-config#network-access-requirements)

308* Les défaillances intermittentes sont [réessayées automatiquement](#automatic-retries) ; les défaillances persistantes pointent vers un problème de réseau local

309 

310Si `curl` réussit mais que Claude Code échoue toujours, la cause est généralement quelque chose entre Node.js et le réseau plutôt que le réseau lui-même :

311 

312* Sur Linux et WSL, vérifiez `/etc/resolv.conf` pour un serveur de noms inaccessible. WSL en particulier peut hériter d'un résolveur cassé de l'hôte.

313* Sur macOS, un client VPN qui a été déconnecté ou désinstallé peut laisser une interface de tunnel ou une règle de routage. Vérifiez `ifconfig` pour les interfaces `utun` obsolètes et supprimez l'extension réseau du VPN dans les Paramètres système.

314* Docker Desktop et les runtimes de conteneurs similaires peuvent intercepter le trafic sortant. Quittez-les et réessayez pour exclure cela.

315 

316### SSL certificate errors

317 

318Un proxy ou un appareil de sécurité sur votre réseau intercepte le trafic TLS avec son propre certificat, et Node.js ne le fait pas confiance.

319 

320```text theme={null}

321Unable to connect to API: SSL certificate verification failed. Check your proxy or corporate SSL certificates

322Unable to connect to API: Self-signed certificate detected

323```

324 

325**Que faire :**

326 

327* Exportez le bundle CA de votre organisation et pointez Node dessus avec `NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem`

328* Consultez [Network configuration](/fr/network-config#custom-ca-certificates) pour les instructions de configuration complètes

329* Ne définissez pas `NODE_TLS_REJECT_UNAUTHORIZED=0`, qui désactive complètement la validation des certificats

330 

331## Erreurs de requête

332 

333Ces erreurs signifient que l'API a reçu votre requête mais a rejeté son contenu.

334 

335### Prompt is too long

336 

337La conversation plus les fichiers joints dépassent la fenêtre de contexte du modèle.

338 

339```text theme={null}

340Prompt is too long

341```

342 

343**Que faire :**

344 

345* Exécutez `/compact` pour résumer les tours antérieurs et libérer de l'espace, ou `/clear` pour recommencer

346* Exécutez `/context` pour voir une ventilation de ce qui consomme la fenêtre : prompt système, outils, fichiers mémoire et messages

347* Désactivez les serveurs MCP que vous n'utilisez pas avec `/mcp disable <name>` pour supprimer leurs définitions d'outils du contexte

348* Réduisez les fichiers mémoire `CLAUDE.md` volumineux, ou déplacez les instructions dans les [règles à portée de chemin](/fr/memory#path-specific-rules) qui se chargent uniquement lorsqu'elles sont pertinentes

349* Les sous-agents héritent de chaque définition d'outil MCP de la session parent, ce qui peut remplir leur fenêtre de contexte avant le premier tour. Désactivez les serveurs MCP que vous n'utilisez pas avant de générer des sous-agents.

350* La compaction automatique est activée par défaut et empêche normalement cette erreur. Si vous avez défini [`DISABLE_AUTO_COMPACT`](/fr/env-vars), réactivez-la ou exécutez `/compact` manuellement avant que la fenêtre ne se remplisse.

351 

352Consultez [Explore the context window](/fr/context-window) pour une vue interactive de la façon dont le contexte se remplit.

353 

354### Error during compaction: Conversation too long

355 

356`/compact` lui-même a échoué car il n'y a pas assez d'espace libre pour contenir le résumé qu'il produit.

357 

358```text theme={null}

359Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.

360```

361 

362Cela peut se produire lorsque la fenêtre est déjà pleine au moment où la compaction automatique se déclenche, ou lorsque vous exécutez `/compact` après avoir vu `Prompt is too long`.

363 

364**Que faire :**

365 

366* Appuyez sur Esc deux fois pour ouvrir la liste des messages et revenir plusieurs tours en arrière. Cela supprime les messages les plus récents du contexte. Ensuite, exécutez `/compact` à nouveau.

367* Si revenir en arrière ne libère pas assez d'espace, exécutez `/clear` pour démarrer une nouvelle session. Votre conversation précédente est préservée et peut être rouverte avec `/resume`.

368 

369### Request too large

370 

371Le corps de la requête brute a dépassé la limite d'octets de l'API avant la tokenisation, généralement en raison d'un fichier collé volumineux ou d'une pièce jointe.

372 

373```text theme={null}

374Request too large (max 30 MB). Double press esc to go back and remove or shrink the attached content.

375```

376 

377C'est une limite de taille sur la requête HTTP, distincte de la [limite de fenêtre de contexte](#prompt-is-too-long).

378 

379**Que faire :**

380 

381* Appuyez sur Esc deux fois et revenir en arrière au-delà du tour qui a ajouté le contenu surdimensionné

382* Référencez les fichiers volumineux par chemin au lieu de coller leur contenu, afin que Claude puisse les lire par morceaux

383* Pour les images, consultez [Image was too large](#image-was-too-large) ci-dessous

384 

385### Image was too large

386 

387Une image collée ou jointe dépasse les limites de taille ou de dimension de l'API.

388 

389```text theme={null}

390Image was too large. Double press esc to go back and try again with a smaller image.

391API Error: 400 ... image dimensions exceed max allowed size

392```

393 

394L'image reste dans l'historique de la conversation après l'erreur, donc chaque message suivant échoue avec la même erreur jusqu'à ce que vous la supprimiez.

395 

396**Que faire :**

397 

398* Appuyez sur Esc deux fois et revenir en arrière au-delà du tour où l'image a été ajoutée

399* Redimensionnez l'image avant de la coller. L'API accepte les images jusqu'à 8000 pixels sur le bord le plus long pour une seule image, ou 2000 pixels lorsque de nombreuses images sont en contexte.

400* Prenez une capture d'écran plus serrée de la région pertinente au lieu de l'écran complet

401 

402### PDF errors

403 

404Le PDF que vous avez joint n'a pas pu être traité.

405 

406```text theme={null}

407PDF too large (max 100 pages, 32 MB). Try splitting it or extracting text first.

408PDF is password protected. Try removing protection or extracting text first.

409The PDF file was not valid. Try converting to a different format first.

410```

411 

412**Que faire :**

413 

414* Pour les PDF surdimensionnés, demandez à Claude de lire une plage de pages avec l'outil Read au lieu de joindre le fichier entier, ou extrayez le texte avec un outil comme `pdftotext` et référencez le fichier de sortie par chemin

415* Pour les PDF protégés ou invalides, supprimez le mot de passe ou réexportez le fichier à partir de son application source, puis réessayez

416 

417### Extra inputs are not permitted

418 

419Un proxy ou une passerelle LLM entre Claude Code et l'API a supprimé l'en-tête de requête `anthropic-beta`, donc l'API a rejeté les champs qui en dépendent.

420 

421```text theme={null}

422API Error: 400 ... Extra inputs are not permitted ... context_management

423API Error: 400 ... Extra inputs are not permitted ... tools.0.custom.input_examples

424API Error: 400 ... Unexpected value(s) for the `anthropic-beta` header

425```

426 

427Claude Code envoie des champs bêta uniquement tels que `context_management`, `effort` et les `input_examples` d'outils aux côtés d'un en-tête `anthropic-beta` qui les active. Lorsqu'une passerelle transfère le corps mais supprime l'en-tête, l'API voit des champs qu'elle ne reconnaît pas.

428 

429**Que faire :**

430 

431* Configurez votre passerelle pour transférer l'en-tête `anthropic-beta`. Consultez [LLM gateway configuration](/fr/llm-gateway).

432* En dernier recours, définissez [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/fr/env-vars) avant de lancer. Cela désactive les fonctionnalités qui nécessitent l'en-tête bêta pour que les requêtes réussissent via une passerelle qui ne peut pas le transférer.

433 

434### There's an issue with the selected model

435 

436Le nom du modèle configuré n'a pas été reconnu ou votre compte n'a pas accès à celui-ci.

437 

438```text theme={null}

439There's an issue with the selected model (claude-...). It may not exist or you may not have access to it. Run /model to select a different one.

440```

441 

442**Que faire :**

443 

444* Exécutez `/model` pour choisir parmi les modèles disponibles pour votre compte

445* Utilisez un alias tel que `sonnet` ou `opus` au lieu d'un ID complet versionné. Les alias suivent la dernière version pour qu'ils ne deviennent pas obsolètes. Consultez [Model configuration](/fr/model-config).

446* Si le mauvais modèle continue de revenir, un ID obsolète est défini quelque part. Vérifiez dans [l'ordre de priorité](/fr/model-config#setting-your-model) : l'indicateur `--model`, la variable d'environnement `ANTHROPIC_MODEL`, puis le champ `model` dans `.claude/settings.local.json`, le fichier `.claude/settings.json` de votre projet, et `~/.claude/settings.json`. Supprimez la valeur obsolète et Claude Code revient à votre compte par défaut.

447* Pour les déploiements Vertex AI, consultez [Vertex AI troubleshooting](/fr/google-vertex-ai#troubleshooting).

448 

449### Claude Opus is not available with the Claude Pro plan

450 

451Votre plan d'abonnement actif n'inclut pas le modèle que vous avez sélectionné.

452 

453```text theme={null}

454Claude Opus is not available with the Claude Pro plan · Select a different model in /model

455```

456 

457**Que faire :**

458 

459* Exécutez `/model` et sélectionnez un modèle que votre plan inclut

460* Si vous avez récemment mis à niveau votre plan et voyez toujours cela, exécutez `/logout` puis `/login`. Le jeton stocké reflète votre plan au moment où vous vous êtes connecté, donc la mise à niveau sur le web ne prend effet dans une session existante que jusqu'à ce que vous vous réauthentifiiez.

461* Consultez [claude.com/pricing](https://claude.com/pricing) pour savoir quels modèles chaque plan inclut

462 

463### thinking.type.enabled is not supported for this model

464 

465Votre version de Claude Code est plus ancienne que le minimum pour Opus 4.7. L'interface CLI a envoyé une configuration de réflexion que le modèle n'accepte plus.

466 

467```text theme={null}

468API Error: 400 ... "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.

469```

470 

471**Que faire :**

472 

473* Exécutez `claude update` pour mettre à niveau vers v2.1.111 ou ultérieur, puis redémarrez Claude Code

474* Si vous ne pouvez pas mettre à niveau, exécutez `/model` et sélectionnez Opus 4.6 ou Sonnet à la place

475* Si vous rencontrez cela dans le SDK Agent, consultez [SDK troubleshooting](/fr/agent-sdk/quickstart#troubleshooting)

476 

477### Thinking budget exceeds output limit

478 

479Le budget de réflexion étendue configuré dépasse la longueur de réponse maximale, donc il n'y a pas de place pour la réponse réelle.

480 

481```text theme={null}

482API Error: 400 ... max_tokens must be greater than thinking.budget_tokens

483```

484 

485Claude Code ajuste automatiquement ces valeurs sur l'API Anthropic. Vous voyez généralement cette erreur sur Amazon Bedrock ou Google Vertex AI lorsque [`MAX_THINKING_TOKENS`](/fr/env-vars) est défini plus haut que la limite de sortie du fournisseur, ou lorsque le mode plan augmente le budget de réflexion.

486 

487**Que faire :**

488 

489* Réduisez `MAX_THINKING_TOKENS`, ou augmentez [`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/fr/env-vars) au-dessus du budget de réflexion

490* Consultez [Extended thinking](/fr/common-workflows#use-extended-thinking-thinking-mode) pour savoir comment le budget interagit avec la longueur de sortie

491 

492### Tool use or thinking block mismatch

493 

494L'historique de la conversation a atteint l'API dans un état incohérent, généralement après qu'un appel d'outil a été interrompu ou qu'un tour a été modifié en milieu de flux.

495 

496```text theme={null}

497API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.

498API Error: 400 ... unexpected `tool_use_id` found in `tool_result` blocks

499API Error: 400 ... thinking blocks ... cannot be modified

500```

501 

502Les trois variantes signifient la même chose : la séquence de blocs `tool_use`, `tool_result` et `thinking` dans l'historique ne correspond plus à ce que l'API attend.

503 

504**Que faire :**

505 

506* Exécutez `/rewind`, ou appuyez sur Esc deux fois, pour revenir à un point de contrôle avant le tour corrompu et continuer à partir de là. Consultez [Checkpointing](/fr/checkpointing) pour savoir comment les points de contrôle sont créés et restaurés.

507 

508## Les réponses semblent de qualité inférieure à la normale

509 

510Si les réponses de Claude semblent moins capables que vous ne l'attendez mais qu'aucune erreur n'est affichée, la cause est généralement l'état de la conversation plutôt que le modèle lui-même. Claude Code ne change pas silencieusement les versions de modèle. Il peut basculer vers un modèle de secours dans des cas spécifiques tels qu'un quota Opus atteint ou une région Bedrock ou Vertex AI manquant votre modèle ; la vérification de sélection de modèle ci-dessous capture les deux, et [Model configuration](/fr/model-config) explique quand le secours s'applique.

511 

512Vérifiez d'abord ceux-ci :

513 

514* **Sélection du modèle** : exécutez `/model` pour confirmer que vous êtes sur le modèle que vous attendez. Un choix `/model` précédent ou une variable d'environnement `ANTHROPIC_MODEL` peut vous mettre sur un modèle plus petit que prévu.

515* **Niveau d'effort** : exécutez `/effort` pour vérifier le niveau de raisonnement actuel et augmentez-le pour le débogage difficile ou le travail de conception. Les valeurs par défaut varient selon le modèle, donc vérifiez avant de supposer que vous êtes en dessous du maximum. Consultez [Adjust effort level](/fr/model-config#adjust-effort-level) pour les valeurs par défaut par modèle et le raccourci `ultrathink`.

516* **Pression de contexte** : exécutez `/context` pour voir à quel point la fenêtre est pleine. Si elle est près de la capacité, exécutez `/compact` à un point de rupture naturel ou `/clear` pour recommencer. Consultez [Explore the context window](/fr/context-window) pour savoir comment la compaction automatique affecte les tours antérieurs.

517* **Instructions obsolètes** : les fichiers `CLAUDE.md` volumineux ou obsolètes et les définitions d'outils MCP consomment du contexte et peuvent orienter les réponses. `/doctor` signale les fichiers mémoire surdimensionnés et les définitions de sous-agents ; `/context` affiche l'utilisation des jetons d'outils MCP.

518 

519Lorsqu'une réponse s'avère mauvaise, le rembobinage fonctionne généralement mieux que de répondre avec des corrections. Appuyez sur Esc deux fois ou exécutez `/rewind` pour revenir avant le mauvais tour, puis reformulez le prompt avec plus de détails. Corriger dans le fil conserve la mauvaise tentative en contexte, ce qui peut ancrer les réponses ultérieures à celle-ci. Consultez [Checkpointing](/fr/checkpointing).

520 

521Si la qualité semble toujours incorrecte après avoir vérifié ce qui précède, exécutez `/feedback` et décrivez ce que vous attendiez par rapport à ce que vous avez obtenu. Les commentaires soumis de cette manière incluent la transcription de la conversation, ce qui est le moyen le plus rapide pour Anthropic de diagnostiquer une véritable régression. Consultez [Signaler une erreur](#report-an-error) si `/feedback` n'est pas disponible sur votre fournisseur.

522 

523## Signaler une erreur

524 

525Cette page couvre les erreurs de l'API Claude. Pour les erreurs d'autres composants Claude Code, consultez le guide pertinent :

526 

527* Le serveur MCP n'a pas pu se connecter ou s'authentifier : [MCP](/fr/mcp)

528* Le script hook a échoué ou a bloqué un outil : [Debug hooks](/fr/hooks#debug-hooks)

529* Autorisation refusée ou erreurs du système de fichiers lors de l'installation : [Troubleshooting](/fr/troubleshooting)

530 

531Si une erreur n'est pas répertoriée ici ou que la correction suggérée n'aide pas :

532 

533* Exécutez `/feedback` dans Claude Code pour envoyer la transcription et une description à Anthropic. La commande offre également d'ouvrir un problème GitHub prérempli. Les commentaires ne sont pas disponibles sur les déploiements Bedrock, Vertex AI et Foundry.

534* Exécutez `/doctor` pour vérifier les problèmes de configuration locale

535* Vérifiez [status.claude.com](https://status.claude.com) pour les incidents actifs

536* Recherchez les [problèmes existants](https://github.com/anthropics/claude-code/issues) sur GitHub