Dépannage de Claude Code
L'essentiel du dépannage de Claude Code consiste à vérifier s'il a bien chargé la configuration Claude / Anthropic. Ne mélangez pas les adresses compatibles OpenAI, les noms de modèles Codex ou les clés Gemini dans Claude Code.
Que vérifier en premier ?
| Éléments à vérifier | Comment vérifier | Pourquoi |
|---|---|---|
| Outil ciblé | Assurez-vous de dépanner Claude Code, et non Codex ou Gemini CLI | Les fichiers de configuration, les protocoles et les noms de modèles varient selon les outils. |
| Protocole du provider | Claude, Anthropic et Claude Code sont explicitement mentionnés dans la console ou le tutoriel | Les providers qui ne proposent que des interfaces compatibles OpenAI ne prennent pas forcément en charge Claude Code |
| Type de clé | Utilisez la clé correspondante pour Claude / Anthropic | Si le type de clé est incorrect, cela entraînera directement une erreur 401 ou un échec d'authentification |
| État du terminal | Après avoir changé de configuration, rouvrez le terminal et réessayez | L'ancien terminal peut encore utiliser les variables d'environnement ou les configurations antérieures au changement |
Erreurs courantes
| Symptôme | Vérification prioritaire | Solutions |
|---|---|---|
| La commande se lance, mais la requête échoue | Si Claude Code a bien récupéré la nouvelle configuration | Fermez la fenêtre actuelle du terminal et rouvrez-la, puis envoyez une question de test très courte. Après avoir basculé via CC-Switch, ne modifiez pas manuellement la même configuration en même temps. |
| 401 / Unauthorized | Type et intégrité de la clé | Vérifiez que vous utilisez bien la clé correspondante pour Claude / Anthropic, ne renseignez pas de clé compatible OpenAI dans Claude Code ; vérifiez l'absence d'espaces avant et après lors d'une nouvelle copie. |
| 404 / model not found | Nom du modèle Claude | Renseignez exactement le nom indiqué dans la console du provider pour les modèles Claude, sans modifier la casse, les tirets ou les numéros de version. |
| Délai d'attente dépassé ou aucune réponse | Base URL de Claude | Vérifiez l'adresse d'API Claude / Anthropic dans la console ; les providers qui ne fournissent que des adresses compatibles OpenAI peuvent ne pas supporter Claude Code. |
| Utilise toujours l'ancien provider après le changement | Session de terminal et source de configuration | Rouvrez le terminal et testez à nouveau ; si le problème persiste, confirmez que le Provider actuel dans CC-Switch a bien été appliqué à Claude Code. |
Test minimal
Lors du test, envoyez d'abord une question courte prédéfinie, vérifiez qu'il répond correctement, puis passez à votre projet réel.
Test minimal de Claude Code
claude "Please reply only: Claude Code configuration test successful"Modèle de signalement
Lorsque vous contactez le support du provider, écrivez comme ceci
Tool: Claude Code System version: Provider dashboard Base URL: Model ID / model name: Exact error: I have checked: no spaces in the Key / balance is sufficient / model name copied exactly / Base URL copied from the dashboard / terminal reopened