AIREITER

Utiliser GLM-5.2 dans Claude Code : guide complet de configuration

Dernière mise à jour: 2026-07-29 11:04:11

GLM-5.2 peut déjà remplacer Claude dans Claude Code, avec une mise en route qui prend environ deux minutes. Le principe est simple : Claude Code sait communiquer avec tout endpoint compatible avec l’API Messages d’Anthropic, et Zhipu propose cette compatibilité pour GLM. Il suffit donc de le pointer vers z.ai. Deux approches sont possibles : CC Switch, une application qui permet de basculer en un clic et de revenir à Claude quand nécessaire, ou la modification manuelle d’un fichier de configuration. Voici les deux méthodes, sous macOS, Windows et Linux.

La solution la plus simple : CC Switch

Si vous utilisez déjà plusieurs fournisseurs, évitez l’édition manuelle de fichiers et passez par CC Switch. Cette application de bureau open source sous licence MIT fonctionne sous Windows, macOS et Linux. Elle centralise les configurations de fournisseurs pour Claude Code, Codex, Gemini CLI et plusieurs autres CLI, sans avoir à modifier du JSON à la main.

  1. Installez CC Switch depuis ccswitch.io ou son dépôt GitHub. Dans la fenêtre principale, cliquez sur le bouton orange + en haut à droite pour ouvrir Add Provider, puis choisissez l’onglet Claude Provider.
  2. Saisissez zhipu dans la recherche des préréglages. Deux entrées apparaissent : Zhipu GLM, pour l’endpoint de Chine continentale, et Zhipu GLM en. En dehors de Chine continentale, sélectionnez Zhipu GLM en pour utiliser l’endpoint international.
Écran Add New Provider de CC Switch avec « zhipu » saisi dans la recherche des préréglages, affichant les préréglages Zhipu GLM et Zhipu GLM en sous l’onglet Claude Provider
  1. Faites défiler la page et collez votre clé API z.ai dans le champ API Key. Le préréglage renseigne automatiquement le reste : le format Anthropic Messages (Native), le champ d’authentification ANTHROPIC_AUTH_TOKEN et l’URL de base.
  2. Dans Model Mapping, associez glm-5.2 à chaque rôle demandé — Sonnet, Opus, Fable et Haiku — afin que toutes les requêtes soient envoyées à GLM, quel que soit le niveau choisi par Claude Code. Cochez la case 1M d’un rôle pour déclarer à Claude Code le contexte d’un million de tokens. Enregistrez.
Tableau de mapping des modèles dans l’éditeur de fournisseur CC Switch, avec les rôles Sonnet, Opus, Fable et Haiku tous définis sur glm-5.2, au format Anthropic Messages Native avec ANTHROPIC_AUTH_TOKEN
  1. De retour dans la liste des fournisseurs, cliquez sur Enable pour l’entrée Zhipu GLM. Vous pouvez conserver un fournisseur existant, tel que Claude Official, dans la liste pour revenir à Claude plus tard. Redémarrez ensuite Claude Code afin de vous assurer qu’il prend bien en compte le nouveau fournisseur. Lancez /status et vérifiez que le modèle affiché est glm-5.2.
Liste des fournisseurs dans CC Switch montrant Zhipu GLM et son bouton Enable, à côté d’un fournisseur Claude Official auquel revenir

L’intérêt de l’application par rapport à une configuration statique est qu’elle propose des préréglages pour la plupart des fournisseurs que vous pourriez vouloir tester : Kimi, MiniMax, MiMo, Qwen, DeepSeek et bien d’autres. Chaque ajout se résume alors à choisir un préréglage et renseigner une clé, plutôt qu’à réécrire une configuration. Le passage de l’un à l’autre, ou le retour à Claude, ne demande que quelques clics. C’est aussi ce qui rend le workflow hybride décrit plus loin réellement pratique.

Configurer GLM-5.2 à la main dans settings.json

Vous préférez tout contrôler vous-même, ou vous configurez une machine CI sans interface graphique ? Modifiez directement le fichier de paramètres.

  1. Récupérez une clé API depuis la console API Z.AI. Une clé à la consommation comme une clé liée à un abonnement GLM Coding Plan fonctionnent.
  2. Ajoutez ce bloc env à votre fichier de configuration Claude Code. Conservez les clés déjà présentes : ne remplacez pas le fichier entier. Le bloc est identique sur toutes les plateformes ; seul son emplacement change :

- macOS / Linux : ~/.claude/settings.json - Windows : %USERPROFILE%\.claude\settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "your_zai_api_key",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.2",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.2",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5.2",
    "API_TIMEOUT_MS": "3000000"
  }
}
  1. Redémarrez Claude Code, puis exécutez /status. La ligne du modèle doit afficher glm-5.2, ou glm-5.2[1m] pour la variante à un million de tokens. Si un modèle Claude apparaît encore, le fichier n’a pas été pris en compte : vérifiez la syntaxe JSON et le chemin utilisé.

Deux alternatives en ligne de commande sont disponibles si vous ne souhaitez pas modifier le fichier :

  • macOS / Linux — exportez les variables pour une session ponctuelle dans bash/zsh, puis lancez :
export ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"
export ANTHROPIC_AUTH_TOKEN="your_zai_api_key"
export ANTHROPIC_DEFAULT_OPUS_MODEL="glm-5.2"
export ANTHROPIC_DEFAULT_SONNET_MODEL="glm-5.2"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="glm-5.2"
claude

Fermez le terminal pour revenir à votre configuration habituelle.

  • Windows — définissez des variables d’environnement utilisateur persistantes dans PowerShell, puis redémarrez le terminal :
setx ANTHROPIC_BASE_URL "https://api.z.ai/api/anthropic"
setx ANTHROPIC_AUTH_TOKEN "your_zai_api_key"
setx ANTHROPIC_DEFAULT_OPUS_MODEL "glm-5.2"
setx ANTHROPIC_DEFAULT_SONNET_MODEL "glm-5.2"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "glm-5.2"

Les variables ANTHROPIC_DEFAULT_* redirigent les rôles de modèles utilisés par Claude Code : Opus, Sonnet et Haiku. Les versions récentes ajoutent un rôle Fable, également exposé par CC Switch. En les définissant toutes sur glm-5.2, chaque requête part vers GLM. Si vous préférez réserver les tâches de fond à un modèle rapide et économique, utilisez plutôt glm-4.5-air pour Haiku. Pour bénéficier de la fenêtre complète d’un million de tokens, indiquez glm-5.2[1m]. La valeur élevée de API_TIMEOUT_MS est plus importante qu’elle n’en a l’air : les réponses de GLM sont souvent plus lentes que celles de Claude, et le délai par défaut peut interrompre les longues générations.

Endpoint z.ai, proxy ou Coding Plan : quelle option choisir ?

Il existe trois moyens concrets d’utiliser GLM-5.2 dans Claude Code, mais ils ne répondent pas aux mêmes besoins.

L’endpoint natif z.ai : le choix recommandé. Il s’agit de l’URL https://api.z.ai/api/anthropic utilisée plus haut. Elle parle le protocole Anthropic, ce qui permet à Claude Code de s’y connecter sans intermédiaire. C’est l’option par défaut à privilégier.

Un proxy de traduction. D’autres hébergeurs, comme Fireworks, NVIDIA NIM ou des weights auto-hébergés, exposent GLM-5.2 via une API compatible OpenAI que Claude Code ne sait pas lire directement. Il faut donc un proxy pour convertir les formats. claude-code-router remplit ce rôle. Cette solution ne vaut surtout le coup que si vous avez déjà des crédits ou du matériel sur ces plateformes.

L’abonnement GLM Coding Plan. Cette formule mensuelle fixe, à partir de $18/month selon la page d’abonnement de z.ai, utilise le même endpoint z.ai mais facture un montant fixe au lieu d’un prix par token. Si vous codez quotidiennement dans Claude Code, un abonnement est généralement moins cher et plus prévisible que la facturation à l’usage. Comparez-le à votre consommation mensuelle de tokens pour identifier le seuil de rentabilité. Si votre usage est irrégulier, le paiement à la consommation reste plus avantageux.

Passer de GLM-5.2 à Claude, et inversement

Claude Code n’utilise qu’un fournisseur actif à la fois : vous devez donc basculer d’un fournisseur à l’autre, plutôt que répartir les rôles entre eux. Utilisez GLM-5.2 pour le volume courant, puis activez votre fournisseur Claude Official dans CC Switch lorsque vous avez besoin de Claude pour l’architecture, du code sensible du point de vue de la sécurité ou une revue. N’importe quel endpoint compatible Anthropic convient côté Claude : votre compte Anthropic ou un relais comme AIReiter, parmi d’autres options. Pour router automatiquement chaque requête entre plusieurs fournisseurs, une passerelle telle que claude-code-router peut assurer la répartition.

Résoudre les problèmes courants

SymptômeCause probableCorrectif
/status affiche encore un modèle Claudesettings.json n’est pas chargéVérifiez que le JSON est valide, que vous avez modifié ~/.claude/settings.json, puis redémarrez Claude Code
Erreur model not foundIdentifiant de modèle incorrect, sensible à la casseUtilisez exactement glm-5.2, glm-5.2[1m] ou glm-4.5-air
401 / échec d’authentificationLa clé ne correspond pas à l’endpointN’utilisez pas une clé OpenRouter avec l’URL z.ai ; régénérez la clé si nécessaire
Les longues générations sont interrompuesDélai d’expiration trop courtDéfinissez une valeur élevée pour API_TIMEOUT_MS, par exemple 3000000
Les appels d’outils échouent ou tournent en boucleJSON d’outil mal forméRéduisez le nombre de sous-agents parallèles, réessayez et simplifiez l’instruction

Questions fréquentes

GLM-5.2 est-il gratuit dans Claude Code ?

Pas de manière illimitée. z.ai a toutefois proposé des périodes de gratuité limitées pour GLM-5.2, et le Coding Plan démarre à $18/month. Même aux tarifs complets à la consommation, soit $1.40 / $4.40 par million, un usage léger ne coûte que quelques centimes.

GLM-5.2 prend-il en charge le contexte de 1M tokens dans Claude Code ?

Oui. Remplacez glm-5.2 par glm-5.2[1m] dans vos variables ANTHROPIC_DEFAULT_* afin que Claude Code utilise la fenêtre d’un million de tokens.

GLM-5.2 ou Claude : lequel est meilleur pour coder dans Claude Code ?

Pour les modifications courantes et séquentielles, l’écart de prix fait de GLM-5.2 le choix par défaut le plus rationnel. Claude a généralement l’avantage pour l’architecture en plusieurs étapes, les travaux sensibles sur le plan de la sécurité et les workflows de sous-agents à forte concurrence. La configuration de bascule permet d’utiliser chacun là où il excelle, plutôt que de devoir n’en choisir qu’un.

Puis-je utiliser GLM-5.2 dans des outils autres que Claude Code ?

Oui. Le même endpoint z.ai et les mêmes clés fonctionnent avec d’autres CLI agentiques : OpenCode, Cline et Kilo Code acceptent tous une URL de base personnalisée, et CC Switch gère des préréglages pour plusieurs d’entre eux.

Faut-il un abonnement Claude payant pour utiliser GLM-5.2 dans Claude Code ?

Non. Claude Code n’est que le client : une fois configuré vers z.ai, la facturation vient de z.ai, et non d’Anthropic. Un compte Claude n’est nécessaire que si vous souhaitez conserver Claude comme fournisseur disponible pour y revenir.

Faut-il redémarrer Claude Code après avoir changé de fournisseur dans CC Switch ?

D’après la documentation de CC Switch, Claude Code prend en charge le changement à chaud des données de fournisseur sans redémarrage, contrairement à la plupart des autres outils CLI qui nécessitent de redémarrer le terminal ou l’application. En pratique, redémarrer Claude Code reste le moyen le plus fiable de s’assurer que le changement a bien été appliqué.

Comment revenir à Claude avec la connexion officielle dans CC Switch ?

Ajoutez un fournisseur Claude Official depuis la liste des préréglages, activez-le, puis effectuez une fois le flux habituel de déconnexion / reconnexion OAuth de Claude Code. Vous pourrez ensuite basculer librement entre votre connexion Claude officielle et des fournisseurs tiers tels que z.ai.

CC Switch est-il gratuit et sûr à utiliser ?

Oui. Le projet est gratuit, open source et distribué sous licence MIT. Vos configurations restent en local dans une base de données SQLite avec écritures atomiques. Par conception, l’application modifie au minimum les fichiers de configuration propres à chaque outil : vos CLI continuent donc de fonctionner normalement même après sa désinstallation.

À lire également