GLM (Z.ai)

Éditeur : Z.ai Nom d'installation : glm Statut : GA Configuration native : <project>/.apothem/providers/glm.toml

L'adaptateur glm configure GLM (Z.ai) en tant que backend de modèle. Un outil parlant le protocole compatible Anthropic ou compatible OpenAI est dirigé vers GLM en définissant une URL de base de backend et une clé, et vous sélectionnez l'adaptateur avec --harness glm, comme n'importe quel autre. Il écrit un fichier de configuration de fournisseur qui consigne les deux surfaces de compatibilité, afin que tout outil compatible puisse être raccordé à la famille de modèles GLM.

Z.ai fournit aussi un outil de codage officiel en propre, ZCode, que la documentation de Z.ai qualifie d'« Agentic Development Environment ». Cet adaptateur ne configure pas ZCode. Apothem n'a pas examiné la surface de configuration propre à ZCode ; l'adaptateur n'écrit donc rien pour lui.

InstallationCopy Anchor Link

apothem install --harness glm --project /path/to/project

L'adaptateur écrit un seul fichier de fournisseur de portée projet, qui consigne les points de terminaison du backend GLM et des espaces réservés configurables par l'opérateur.

Fichiers écrits : <project>/.apothem/providers/glm.toml

Correspondance entre le profil et la configuration nativeCopy Anchor Link

Le fichier de fournisseur consigne deux backends. Le backend compatible Anthropic utilise l'URL de base https://api.z.ai/api/anthropic ; un outil qui parle le protocole Anthropic est routé vers GLM en définissant ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN et, en option, API_TIMEOUT_MS. La table [backends.anthropic_compatible.env] du fichier liste ces variables ainsi que ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL et ANTHROPIC_DEFAULT_HAIKU_MODEL, qui associent les rôles opus, sonnet et haiku de l'outil à des modèles GLM. Le backend compatible OpenAI utilise l'URL de base https://api.z.ai/api/coding/paas/v4. Le jeton d'authentification est un espace réservé que vous remplacez par votre propre clé Z.ai — Apothem n'écrit jamais de véritable secret. Les identifiants de modèle changent d'une version à l'autre ; Apothem n'en épingle donc aucun, et le fichier porte des espaces réservés <GLM_MODEL_ID> que vous renseignez à partir de la documentation de Z.ai actuelle. Rien du profil partagé n'entre dans ce fichier ; c'est un template fixe.

Correspondance entre rôles et modèlesCopy Anchor Link

Les indications de Z.ai elles-mêmes sur la correspondance entre rôles et modèles divergent ; le fichier laisse donc les trois valeurs ANTHROPIC_DEFAULT_*_MODEL sous forme d'espaces réservés et porte un commentaire TODO(clarify) au-dessus d'elles. C'est à vous de choisir la correspondance à utiliser :

• L'exemple manuel de settings.json du guide de configuration compatible Anthropic de l'éditeur associe opus et sonnet à glm-5.3[1m] et haiku à glm-5.3-flash[1m], et fixe CLAUDE_CODE_AUTO_COMPACT_WINDOW à 1000000.
• La correspondance par défaut énoncée dans ce même guide indique GLM-5.3-Flash pour les trois rôles.
• L'outil @z_ai/coding-helper de Z.ai utilise glm-5.3-flash par défaut, ajoute [1m] aux trois rôles et écrit une fenêtre de compaction de 1048576.

Apothem n'épingle aucune de ces valeurs et ne tranche pas entre elles.

Notes de compatibilitéCopy Anchor Link

Le backend GLM n'expose aucune surface pour les règles, les commandes, les skills ou les hooks ; l'adaptateur n'écrit donc que le fichier de fournisseur du backend et rien d'autre. Apothem n'a pas vérifié si ZCode expose de telles surfaces. Votre clé Z.ai et vos choix d'identifiants de modèle restent détenus par l'opérateur. Les conventions de la surface éditeur sur lesquelles l'adaptateur s'appuie sont épinglées dans src/apothem/harnesses/glm/STANDARD-CONVENTION-PIN.md, dont l'instantané a été pris par rapport à la documentation en ligne de Z.ai.

GLM exécute la famille de modèles GLM de Z.ai ; consultez la référence de configuration de l'éditeur pour connaître le backend, les modèles et la surface de configuration compatible Anthropic actuels.

VérificationCopy Anchor Link

apothem verify --harness glm --project /path/to/project

La commande verify confirme que :

1. La configuration native existe au chemin attendu.
2. Le fichier de fournisseur est présent et non vide.
3. La routine de vérification propre à l'adaptateur signale un succès.

Mise à jourCopy Anchor Link

apothem update --harness glm --project /path/to/project

Le fichier de fournisseur vous appartient dès qu'il existe. install et update n'écrivent tous deux le template que lorsque .apothem/providers/glm.toml est absent, et ni l'un ni l'autre ne l'écrase jamais par la suite ; votre référence de clé et vos choix de modèles survivent donc à chaque nouvelle exécution. Pour récupérer un template plus récent, mettez votre fichier de côté, exécutez update, puis recopiez vos valeurs dans le nouveau fichier.

DésinstallationCopy Anchor Link

apothem uninstall --harness glm --project /path/to/project

Ne supprime le fichier de fournisseur que si Apothem l'a créé et qu'il s'agit toujours d'un template non modifié, en le sauvegardant d'abord sous la racine de sauvegarde d'Apothem. Un fichier non modifié écrit par une version antérieure compte lorsque l'enregistrement d'installation d'Apothem pour le projet montre qu'il a écrit le fichier : le manifeste consigne l'empreinte de chaque template que le projet a livré. Sans enregistrement d'installation, seule une copie exacte du template actuel est supprimée. Un fichier que vous avez créé ou modifié est laissé en place. Le YAML du profil partagé et le moteur Apothem ne sont pas affectés.

Portail de conformitéCopy Anchor Link

python -m apothem.conformity.gate --all .

DépannageCopy Anchor Link

Paramètres de configurationCopy Anchor Link

Voir aussiCopy Anchor Link

• Tous les environnements — le catalogue complet des outils pris en charge
• Guide d'installation — installer Apothem dans cet environnement
• Référence de apothem harnesses — lister et inspecter les adaptateurs depuis la CLI