Note de l'auteur : Solution complète à l'erreur « modèle introuvable » lors de la connexion de Claude Code à une API proxy tierce : syntaxe correcte de l'URL de base, méthode de configuration de settings.json et tableau de correspondance des derniers noms de modèles.
Lors de l'utilisation de Claude Code, l'erreur la plus fréquente est la suivante :
There's an issue with the selected model (claude-sonnet-4-6). It may not exist or you may not have access to it. Run /model to pick a different model.
Cette erreur survient généralement dans deux cas :
- Vous utilisez une clé API officielle, mais le nom du modèle est mal orthographié (il suffit de lancer
/modelpour en choisir un nouveau). - Vous utilisez un service proxy API tiers, et l'URL de base (Base URL) est mal configurée, ce qui entraîne l'échec du routage du modèle.
Cet article se concentre sur la solution complète pour le second cas, en prenant l'exemple de APIYI (apiyi.com). Nous verrons comment configurer les variables d'environnement, le fichier settings.json, ainsi que le tableau de correspondance des derniers noms de modèles Claude.
Valeur ajoutée : Après avoir lu cet article, vous saurez configurer correctement Claude Code avec une API proxy tierce, éliminer l'erreur de modèle introuvable et utiliser toutes les fonctionnalités de Claude Code de manière stable.
I. Diagnostic rapide : Erreur de nom de modèle ou problème d'URL de base ?
Avant de passer à la configuration, prenez 30 secondes pour identifier votre problème :
| Symptôme | Cause probable | Solution |
|---|---|---|
Message Run /model to pick a different model |
Le modèle n'existe pas ou accès refusé | Exécutez /model pour resélectionner |
| Nom de modèle correct, mais toujours une erreur | Problème de configuration de l'URL de base | Vérifiez ANTHROPIC_BASE_URL |
| Échec de la validation de la clé API | Clé invalide ou non définie | Reconfigurez ANTHROPIC_API_KEY |
| Temps d'attente dépassé / Connexion refusée | Adresse du proxy erronée | Vérifiez le format de l'URL de base |
| Tous les modèles renvoient une erreur | Le proxy n'est pas compatible avec le format Anthropic | Vérifiez que le proxy supporte le protocole natif Anthropic |
Si vous utilisez une clé API Anthropic officielle et que vous pouvez accéder normalement à anthropic.com, utilisez simplement la commande /model dans Claude Code pour changer de modèle, sans configuration supplémentaire.
Si vous utilisez un service proxy API tiers (comme apiyi.com), veuillez suivre les solutions de configuration ci-dessous.
🎯 Conseil : Il est recommandé d'utiliser la plateforme APIYI (apiyi.com) pour Claude Code. Elle est compatible avec le format natif d'Anthropic et supporte toute la gamme des derniers modèles comme
claude-opus-4-6etclaude-sonnet-4-6, garantissant une utilisation stable.
2. Configuration clé pour l'accès à Claude Code via un service proxy API tiers
2.1 Format correct de la Base URL : retirez le /v1
C'est l'étape la plus cruciale, et aussi celle où l'on fait le plus souvent des erreurs.
Claude Code possède une logique de traitement spécifique pour la Base URL : il ajoute automatiquement /v1/messages après la Base URL que vous avez définie. Par conséquent :
-
❌ Mauvaise syntaxe :
ANTHROPIC_BASE_URL=https://api.apiyi.com/v1- Le chemin de requête réel devient :
https://api.apiyi.com/v1/v1/messages(le /v1 est doublé) - Résultat : Le routage ne trouve pas le point de terminaison, le modèle renvoie une erreur.
- Le chemin de requête réel devient :
-
✅ Bonne syntaxe :
ANTHROPIC_BASE_URL=https://api.apiyi.com- Le chemin de requête réel devient :
https://api.apiyi.com/v1/messages - Résultat : L'interface native d'Anthropic est correctement atteinte.
- Le chemin de requête réel devient :
📌 Résumé de la règle : Lors de la configuration de
ANTHROPIC_BASE_URL, saisissez simplement la racine du domaine, sans ajouter le suffixe/v1. Claude Code s'occupera de compléter le chemin complet.
2.2 Obtenir la clé API
Connectez-vous au back-office d'APIYI pour obtenir votre jeton : Page de gestion des jetons APIYI api.apiyi.com/token
Conseils pour choisir votre jeton :
| Type de jeton | Scénario d'utilisation | Remise |
|---|---|---|
| Jeton par défaut | Scénarios généraux, prêt à l'emploi | Prix standard |
| Jeton du groupe ClaudeCode | Dédié spécifiquement à Claude Code | 12 % de réduction |
Lors de la création d'un nouveau jeton, sélectionnez le groupe ClaudeCode pour bénéficier d'une réduction de 12 %, ce qui réduit vos coûts d'utilisation à long terme.
III. Détails des deux modes de configuration
Méthode 1 : Configuration par variables d'environnement (recommandée pour des tests temporaires)
Exécutez les commandes suivantes dans votre terminal pour une prise en compte immédiate (valable uniquement pour la session actuelle) :
# Définir l'URL de base du service proxy API tiers (Attention : ne pas ajouter /v1)
export ANTHROPIC_BASE_URL="https://api.apiyi.com"
# Définir la clé API (remplacez par votre clé réelle)
export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"
# Lancer Claude Code
claude
Vérifier si la configuration est active :
# Afficher les variables d'environnement actuelles
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY
# Devrait afficher :
# https://api.apiyi.com
# sk-xxxxxx...
Avantages et inconvénients :
- ✅ Simple et rapide, aucune modification de fichier requise
- ✅ N'affecte pas la configuration des autres sessions
- ❌ Doit être configuré à chaque ouverture d'un nouveau terminal (sauf si écrit dans
.zshrc/.bashrc)
Solution pour rendre les changements permanents (écriture dans le fichier de configuration du Shell) :
# Pour les utilisateurs de zsh (par défaut sur macOS)
echo 'export ANTHROPIC_BASE_URL="https://api.apiyi.com"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-votre-clé"' >> ~/.zshrc
source ~/.zshrc
# Pour les utilisateurs de bash
echo 'export ANTHROPIC_BASE_URL="https://api.apiyi.com"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="sk-votre-clé"' >> ~/.bashrc
source ~/.bashrc
Méthode 2 : Configuration via settings.json (recommandée pour une utilisation à long terme)
Éditez le fichier ~/.claude/settings.json (configuration globale, s'applique à tous les projets) :
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com",
"ANTHROPIC_API_KEY": "sk-votre-clé-API"
}
}
🎯 Conseil pratique : Utilisez
~/.claude/settings.jsonpour une configuration globale. Une fois configuré, c'est permanent et vous n'avez pas besoin de répéter les variables d'environnement à chaque fois. Visitez APIYI (apiyi.com) pour obtenir votre clé, et choisissez les jetons du groupe ClaudeCode pour bénéficier de 12 % de réduction.
Si le fichier n'existe pas, créez-le manuellement :
# Créer le répertoire .claude (s'il n'existe pas)
mkdir -p ~/.claude
# Créer le fichier settings.json
cat > ~/.claude/settings.json << 'EOF'
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com",
"ANTHROPIC_API_KEY": "sk-remplacez-par-votre-clé"
}
}
EOF
Priorité de configuration (de la plus haute à la plus basse) :
| Priorité | Source de configuration | Description |
|---|---|---|
| 1 (Max) | Variables d'environnement | export direct dans le terminal |
| 2 | .claude/settings.local.json |
Configuration locale du projet (non soumise à git) |
| 3 | .claude/settings.json |
Configuration partagée du projet |
| 4 (Min) | ~/.claude/settings.json |
Configuration utilisateur globale |
Pour un même paramètre, la priorité la plus haute écrasera la plus basse. Si vous avez également un fichier settings.json dans le répertoire de votre projet, gardez cette hiérarchie en tête.
IV. Derniers noms de modèles supportés par Claude Code
Voici les derniers noms de modèles Claude pour 2026. Ils doivent être saisis avec précision, en respectant scrupuleusement la casse et les chiffres :
Modèles d'inférence standard
| Nom du modèle | Série | Positionnement des capacités | Cas d'utilisation |
|---|---|---|---|
claude-opus-4-6 |
Claude 4.6 | Capacités maximales | Code complexe, analyse approfondie, traitement de documents longs |
claude-sonnet-4-6 |
Claude 4.6 | Équilibre capacité/vitesse | Programmation quotidienne, revue de code, rédaction de documents |
claude-haiku-4-5-20251001 |
Claude 4.5 | Réponse ultra-rapide | Questions-réponses simples, complétion de code, tâches rapides |
Modèles d'inférence améliorés (Mode Pensée)
En ajoutant le suffixe -thinking au nom du modèle, vous pouvez activer le mode de pensée étendu. Le modèle effectuera alors un raisonnement approfondi avant de répondre :
| Nom du modèle | Modèle de base | Caractéristiques |
|---|---|---|
claude-opus-4-6-thinking |
claude-opus-4-6 | Raisonnement le plus puissant, idéal pour les mathématiques, la logique et les décisions complexes |
claude-sonnet-4-6-thinking |
claude-sonnet-4-6 | Équilibre entre raisonnement et vitesse, le premier choix pour un usage quotidien |
claude-haiku-4-5-20251001-thinking |
claude-haiku-4-5-20251001 | Raisonnement léger |
💡 Conseil de sélection : Pour une utilisation quotidienne de Claude Code, nous recommandons
claude-sonnet-4-6, qui offre le meilleur équilibre entre qualité de codage et vitesse de réponse. Pour la conception d'architectures complexes ou le débogage de bugs difficiles, passez àclaude-opus-4-6ouclaude-sonnet-4-6-thinking.
V. Changer de modèle dans Claude Code
Une fois que vous avez configuré l'URL de base (Base URL) et la clé API, il existe deux façons de changer de modèle :
5.1 Utiliser la commande /model (la plus simple)
Saisissez directement dans votre conversation Claude Code :
/model
Claude Code affichera une liste de sélection de modèles. Si vous utilisez un service proxy API tiers, il est possible que tous les modèles ne s'affichent pas automatiquement dans la liste ; dans ce cas, vous devrez saisir manuellement le nom du modèle.
5.2 Spécifier les modèles par défaut dans settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com",
"ANTHROPIC_API_KEY": "sk-votre-clé-API",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6"
}
}
Grâce aux variables d'environnement ANTHROPIC_DEFAULT_*_MODEL, vous pouvez spécifier le nom exact du modèle pour chaque gamme. Cela permet d'éviter que Claude Code n'utilise les noms par défaut intégrés (qui pourraient ne pas correspondre à ceux de votre service proxy API).
🎯 Exemple de configuration complète : Il est recommandé d'enregistrer cette configuration dans
~/.claude/settings.json. Utilisez un jeton de groupe ClaudeCode d'APIYI (apiyi.com) commeANTHROPIC_API_KEY.
VI. FAQ : Erreurs courantes et solutions
Q1 : Claude Code ne démarre plus du tout après avoir configuré ANTHROPIC_BASE_URL ?
Vérifiez si le format JSON est correct. Erreurs fréquentes :
- Une virgule en trop après la dernière paire clé-valeur (le JSON n'autorise pas les virgules traînantes).
- Utilisation de guillemets incurvés
« »ou“ ”au lieu des guillemets droits standards"".
# Vérifier le format JSON
cat ~/.claude/settings.json | python3 -m json.tool
Si la sortie est normale, le format est correct. Si une erreur s'affiche, c'est qu'il y a un problème de syntaxe.
Q2 : J'ai une erreur Invalid API key, pourtant ma clé est correcte ?
Causes possibles :
- Espaces avant ou après la clé → Vérifiez que vous n'avez pas copié d'espaces superflus.
- Clé expirée ou désactivée → Connectez-vous sur
api.apiyi.com/tokenpour en générer une nouvelle. - Problème de priorité des variables d'environnement → Une ancienne variable
ANTHROPIC_API_KEYexiste peut-être déjà dans votre système.
# Vérifier s'il existe plusieurs sources pour les variables d'environnement
env | grep ANTHROPIC
Q3 : L'invocation du modèle fonctionne, mais les résultats sont de mauvaise qualité ou le format est anormal ?
Cause possible : Le service proxy API ne supporte pas parfaitement le format Anthropic, notamment la gestion du "system prompt".
Méthode de vérification : Testez directement le service proxy avec une commande curl :
curl https://api.apiyi.com/v1/messages \
-H "Content-Type: application/json" \
-H "x-api-key: sk-votre-clé" \
-H "anthropic-version: 2023-06-01" \
-d '{
"model": "claude-sonnet-4-6",
"max_tokens": 100,
"messages": [{"role": "user", "content": "Dis bonjour"}]
}'
Une réponse normale doit contenir le champ content et la sortie textuelle réelle. Si le retour est anormal, le problème vient du service proxy.
🎯 Diagnostic rapide : APIYI (apiyi.com) est totalement compatible avec le format natif d'Anthropic. Le test curl ci-dessus fonctionnera parfaitement sur cette plateforme. Si vous testez un autre service proxy API, utilisez cette commande pour vérifier rapidement la compatibilité.
Q4 : Comment configurer les variables d'environnement sous Windows ?
Pour les utilisateurs Windows, la méthode settings.json est recommandée car elle est plus simple et plus fiable :
// C:\Users\VotreNomUtilisateur\.claude\settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com",
"ANTHROPIC_API_KEY": "sk-votre-clé-API"
}
}
Si vous préférez utiliser PowerShell pour définir des variables temporaires :
$env:ANTHROPIC_BASE_URL = "https://api.apiyi.com"
$env:ANTHROPIC_API_KEY = "sk-votre-clé-API"
claude
Q5 : Comment utiliser des configurations API différentes selon les projets ?
Créez un fichier .claude/settings.json à la racine de votre projet (ce fichier est prioritaire sur la configuration globale) :
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.apiyi.com",
"ANTHROPIC_API_KEY": "sk-clé-spécifique-au-projet"
}
}
Note : Si ce fichier contient une clé, il est conseillé de l'ajouter à votre .gitignore pour éviter de le pousser sur un dépôt public. Utiliser .claude/settings.local.json (configuration locale dédiée) est encore plus sûr, car il n'est généralement pas suivi par git.
VII. Liste de vérification de la configuration
Une fois la configuration terminée, suivez ces étapes pour vérifier :
# Étape 1 : Confirmer que les variables d'environnement sont effectives
echo "Base URL: $ANTHROPIC_BASE_URL"
echo "API Key: ${ANTHROPIC_API_KEY:0:10}..."
# Étape 2 : Tester la connectivité de l'API
curl -s https://api.apiyi.com/v1/models \
-H "x-api-key: $ANTHROPIC_API_KEY" | head -c 200
# Étape 3 : Lancer Claude Code et tester
claude --version
claude
Saisissez /status dans la boîte de dialogue de Claude Code pour vérifier l'état actuel de la connexion et confirmer que l'URL de base et la configuration du modèle sont correctes.
🎯 Une fois configuré : Il est recommandé de tester l'envoi d'un message simple pour confirmer que Claude Code répond normalement. La plateforme APIYI (apiyi.com) permet de consulter votre solde et de surveiller en temps réel la consommation de tokens de Claude Code via le tableau de bord, facilitant ainsi le contrôle des coûts.
Conclusion
Si vous rencontrez l'erreur « modèle introuvable » lors de l'accès à un service proxy API tiers avec Claude Code, la cause est dans 90 % des cas un format d'URL de base incorrect. Les principes fondamentaux sont :
- Ne pas ajouter
/v1à l'URL de base : saisissezhttps://api.apiyi.com, Claude Code ajoutera automatiquement/v1/messages. - Correspondance exacte du nom du modèle : utilisez les noms complets tels que
claude-sonnet-4-6,claude-opus-4-6,claude-haiku-4-5-20251001, etc. - Configuration settings.json recommandée : l'écriture dans
~/.claude/settings.jsonrend la configuration permanente, évitant ainsi de devoir définir les variables d'environnement à chaque fois. - Jeton dédié à Claude Code : sélectionnez le groupe ClaudeCode dans le tableau de bord APIYI pour bénéficier d'une réduction de 12 %.
Si vous utilisez uniquement une clé API Anthropic officielle et que votre réseau permet une connexion directe, il vous suffit d'exécuter la commande /model dans Claude Code pour choisir votre modèle, sans aucune configuration supplémentaire.
🎯 Obtenir une clé API : visitez APIYI (apiyi.com) pour créer un compte, puis créez un jeton dans le groupe ClaudeCode sur la page de gestion des jetons
api.apiyi.com/token. La plateforme propose un paiement à l'usage, sans consommation minimale, facturé selon l'utilisation réelle des tokens, ce qui convient parfaitement aux particuliers comme aux équipes.
Cet article a été préparé par l'équipe technique d'APIYI, sur la base de tests réels avec Claude Code v2.x. En cas de problème de configuration, n'hésitez pas à consulter le centre d'aide d'APIYI sur help.apiyi.com.
