Vous pouvez exécuter GLM-5.2 dans Claude Code dès aujourd’hui, et la configuration prend environ deux minutes. Claude Code communique avec n’importe quel endpoint qui prend en charge l’API Messages d’Anthropic, et Zhipu fournit exactement cela pour GLM — pointez Claude Code vers z.ai et c’est terminé. Il y a deux façons d’y accéder : une application de bascule en un clic (la plus simple, et elle vous permet de revenir à Claude à tout moment), ou un fichier de configuration modifié manuellement. Ce guide couvre les deux, sur macOS, Windows et Linux, ainsi que la façon de revenir à Claude lorsque vous en avez besoin.
Le moyen le plus rapide : CC Switch
Si vous jonglez déjà avec plus d’un fournisseur, passez la configuration manuelle et utilisez CC Switch (open-source, sous licence MIT, Windows/macOS/Linux). C’est une application de bureau qui gère les configurations des fournisseurs pour Claude Code, Codex, Gemini CLI et quelques autres CLIs, afin que vous n’ayez pas à modifier le JSON à la main.
1. Installez CC Switch depuis ccswitch.io ou depuis son dépôt GitHub. Cliquez sur le bouton orange + en haut à droite de la fenêtre principale pour ouvrir Add Provider, puis sélectionnez l’onglet Claude Provider. 2. Tapez zhipu dans la recherche de préréglages. Deux préréglages apparaissent — Zhipu GLM (point de terminaison du continent) et Zhipu GLM en. En dehors de la Chine continentale, choisissez Zhipu GLM en pour le point de terminaison international.
3. Faites défiler vers le bas et collez votre clé API z.ai dans le champ API Key. Le preset remplit automatiquement le reste : le format Anthropic Messages (Native), le champ d'authentification ANTHROPIC_AUTH_TOKEN et l'URL de base.
4. Dans Model Mapping, définissez le modèle demandé pour chaque rôle — Sonnet, Opus, Fable et Haiku — sur glm-5.2, afin que chaque requête soit acheminée vers GLM, quel que soit le niveau auquel Claude Code fait appel. Cochez la case 1M pour un rôle afin d’indiquer à Claude Code le contexte d’un million de tokens. Enregistrez.
5. De retour dans la liste des fournisseurs, cliquez sur Enable sur l’entrée Zhipu GLM (un fournisseur existant comme Claude Official peut rester dans la liste pour y revenir plus tard), puis redémarrez Claude Code pour vous assurer qu’il prend en compte le nouveau fournisseur. Exécutez /status pour confirmer que le modèle affiche glm-5.2.
Pourquoi se donner la peine d’utiliser l’application plutôt qu’une configuration statique : elle fournit des préréglages pour la plupart des fournisseurs que vous voudriez essayer — Kimi, MiniMax, MiMo, Qwen, DeepSeek, et plus encore — de sorte que chacun n’est qu’une affaire de préréglage et de clé plutôt qu’une réécriture de la configuration, et passer de l’un à l’autre (ou revenir à Claude) ne prend que quelques clics. C’est la base pratique du flux de travail hybride ci-dessous.
Configuration manuelle avec settings.json
Préférez-vous le configurer vous-même, ou mettre en place une machine CI sans interface graphique ? Modifiez le fichier directement.
1. Obtenez une clé API depuis la console API Z.AI. Une clé pay-as-you-go ou une clé d’abonnement GLM Coding Plan fonctionnent toutes deux. 2. Fusionnez ce bloc env dans votre fichier de paramètres Claude Code (conservez les clés existantes — n’écrasez pas le fichier entier). Le bloc est identique sur toutes les plateformes ; seul le chemin diffère : - 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"
}
}3. Redémarrez Claude Code, puis exécutez /status. La ligne du modèle devrait indiquer glm-5.2 (ou glm-5.2[1m] pour la variante à un million de tokens). Si elle affiche encore un modèle Claude, le fichier n’a pas été pris en compte — vérifiez les erreurs de syntaxe JSON et confirmez le chemin.
Deux alternatives basées sur le shell si vous préférez ne pas modifier le fichier :
macOS / Linux — exportez les variables (bash/zsh) pour une session ponctuelle, 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"
claudeFermez le terminal et vous retrouvez votre configuration normale.
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_* remappent les rôles de modèle vers lesquels Claude Code achemine — Opus, Sonnet et Haiku (les versions plus récentes ajoutent un rôle Fable, également exposé par CC Switch). Les définir toutes sur glm-5.2 envoie chaque requête à GLM ; si vous préférez garder les tâches en arrière-plan peu coûteuses et rapides, pointez plutôt l’emplacement Haiku vers glm-4.5-air. Utilisez glm-5.2[1m] pour la fenêtre complète d’un million de jetons. Le long API_TIMEOUT_MS compte plus qu’il n’y paraît : les réponses GLM sont souvent plus lentes que celles de Claude, et le délai d’attente par défaut interrompra les générations longues.
Quel chemin : z.ai natif, un proxy, ou le plan Coding ?
Trois façons pratiques d’alimenter Claude Code avec GLM-5.2, et elles ne sont pas interchangeables.
Point de terminaison natif z.ai (recommandé). L’URL https://api.z.ai/api/anthropic ci-dessus. Il parle le protocole Anthropic, donc Claude Code se connecte sans middleware — le choix par défaut.
Un proxy de traduction. D’autres hébergeurs (Fireworks, NVIDIA NIM, poids auto-hébergés) fournissent GLM-5.2 via une API compatible OpenAI que Claude Code ne peut pas lire directement, ils ont donc besoin d’un proxy qui convertit les formats. claude-code-router s’en charge. Cela n’en vaut la peine que si vous avez déjà des crédits ou du matériel sur l’une de ces plateformes.
Abonnement GLM Coding Plan. Un forfait mensuel fixe (à partir de 18 $/mois, selon la page d’abonnement de z.ai) qui utilise le même endpoint z.ai mais facture des frais fixes au lieu d’une facturation au token. Si vous codez quotidiennement dans Claude Code, un abonnement est généralement moins cher et plus prévisible que des tokens facturés à l’usage ; faites le calcul par rapport à votre dépense mensuelle en tokens pour trouver le seuil de rentabilité. Si votre utilisation est irrégulière, le paiement à l’usage est plus avantageux.
Passer de GLM-5.2 à Claude
Claude Code utilise un seul fournisseur actif à la fois, donc vous *basculez* plutôt que de répartir les emplacements : exécutez GLM-5.2 pour le volume courant, et activez votre fournisseur Claude Official dans CC Switch lorsque vous avez besoin de Claude pour l’architecture, le code sensible à la sécurité ou la relecture. Tout endpoint compatible avec Anthropic fonctionne pour la partie Claude — votre compte Anthropic, ou un relais tel que AIReiter, une option parmi plusieurs. Pour le routage automatique par requête entre fournisseurs, une gateway comme claude-code-router se charge de la répartition.
Dépannage
Symptôme | Cause probable | Correction |
|---|---|---|
| settings.json non chargé | Vérifiez que le JSON est valide ; confirmez que vous avez modifié |
erreur | ID de modèle incorrect (sensible à la casse) | Utilisez exactement |
401 / authentification échouée | Incompatibilité entre la clé et le point de terminaison | Ne faites pas correspondre une clé OpenRouter avec l'URL z.ai ; régénérez la clé si nécessaire |
Les générations longues sont coupées | Timeout trop faible | Définissez |
Les appels d'outil échouent ou bouclent | JSON d'outil mal formé | Réduisez les sous-agents parallèles ; réessayez ; simplifiez l'instruction |
Questions fréquemment posées
GLM-5.2 est-il gratuit dans Claude Code ?
Pas sans limite, toutefois z.ai a proposé des fenêtres gratuites à durée limitée sur GLM-5.2, et le plan Coding commence à 18 $/mois. Même aux tarifs complets à l’usage ($1.40 / $4.40 par million), une utilisation légère ne coûte que quelques centimes.
GLM-5.2 prend-il en charge le contexte d’un million de tokens dans Claude Code ?
Oui. Définissez l’ID du modèle sur glm-5.2[1m] au lieu de glm-5.2 dans vos variables ANTHROPIC_DEFAULT_* et Claude Code utilise la fenêtre d’un million de tokens.
GLM-5.2 ou Claude est-il meilleur pour le codage dans Claude Code ?
Pour les modifications routinières et séquentielles, la différence de prix fait de GLM-5.2 le choix par défaut le plus rationnel. Claude tend à prendre l’avantage sur l’architecture multi-étapes, les tâches sensibles à la sécurité et les workflows de sous-agents à forte concurrence. La configuration de basculement vous permet d’utiliser chacun là où il est le plus performant, au lieu d’en choisir un seul.
Puis-je utiliser GLM-5.2 dans d’autres outils 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.
Ai-je besoin d’un abonnement Claude payant pour utiliser GLM-5.2 dans Claude Code ?
Non. Claude Code n’est que le client ; une fois que vous le pointez vers z.ai, vous êtes facturé par z.ai, pas par Anthropic. Vous n’avez besoin d’un compte Claude que si vous gardez Claude disponible comme fournisseur vers lequel basculer.
Dois-je redémarrer Claude Code après avoir changé de fournisseur dans CC Switch ?
Selon la documentation de CC Switch, Claude Code prend en charge le changement à chaud des données du fournisseur sans redémarrage, tandis que la plupart des autres outils CLI nécessitent effectivement un redémarrage du terminal ou de l’application. En pratique, redémarrer Claude Code est la méthode fiable pour s’assurer qu’un changement a bien pris effet.
Comment revenir à Claude (connexion officielle) dans CC Switch ?
Ajoutez un fournisseur officiel Claude à partir de la liste prédéfinie, activez-le, puis exécutez une fois le flux normal de déconnexion / connexion (OAuth) de Claude Code. Après cela, vous pourrez basculer librement entre votre connexion officielle Claude et des fournisseurs tiers comme z.ai.
CC Switch est-il gratuit et sûr à utiliser ?
Oui — c’est open-source sous licence MIT et gratuit. Vos configurations résident localement dans une base de données SQLite avec des écritures atomiques, et par conception, cela apporte des modifications minimales à la configuration propre de chaque outil, de sorte que vos CLIs continuent à fonctionner normalement même si vous désinstallez l’application.