GLM (Z.ai)

Proveedor: Z.ai Nombre de instalación: glm Estado: GA Configuración nativa: <project>/.apothem/providers/glm.toml

El adaptador glm configura GLM (Z.ai) como un backend de modelos. Una herramienta que habla el protocolo compatible con Anthropic o el compatible con OpenAI se dirige a GLM estableciendo una URL base de backend y una clave, y seleccionas el adaptador con --harness glm como a cualquier otro. Escribe un archivo de configuración de proveedor que registra ambas superficies de compatibilidad, de modo que cualquier herramienta compatible pueda conectarse a la familia de modelos GLM.

Z.ai también distribuye una herramienta de programación propia, ZCode, que la documentación de Z.ai llama un "Agentic Development Environment" (entorno de desarrollo agéntico). Este adaptador no configura ZCode. Apothem no ha revisado la superficie de configuración propia de ZCode, así que el adaptador no escribe nada para ella.

InstalaciónCopy Anchor Link

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

El adaptador escribe un archivo de proveedor con alcance de proyecto que registra los endpoints del backend de GLM y marcadores de posición que el operador puede configurar.

Archivos escritos: <project>/.apothem/providers/glm.toml

Asignación del perfil a la configuración nativaCopy Anchor Link

El archivo de proveedor registra dos backends. El backend compatible con Anthropic usa la URL base https://api.z.ai/api/anthropic; una herramienta que habla el protocolo de Anthropic se enruta a GLM estableciendo ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN y, opcionalmente, API_TIMEOUT_MS. La tabla [backends.anthropic_compatible.env] del archivo lista esas variables y también ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL y ANTHROPIC_DEFAULT_HAIKU_MODEL, que asignan los roles opus, sonnet y haiku de la herramienta a modelos GLM. El backend compatible con OpenAI usa la URL base https://api.z.ai/api/coding/paas/v4. El token de autenticación es un marcador de posición que reemplazas con tu propia clave de Z.ai: Apothem nunca escribe un secreto real. Los ID de modelo cambian entre versiones, así que Apothem no fija ninguno; el archivo lleva marcadores de posición <GLM_MODEL_ID> que completas a partir de la documentación de Z.ai actual. Nada del perfil compartido se incorpora a este archivo; es una plantilla fija.

Asignación de roles a modelosCopy Anchor Link

Las propias indicaciones de Z.ai sobre la asignación de roles a modelos no coinciden, así que el archivo deja los tres valores ANTHROPIC_DEFAULT_*_MODEL como marcadores de posición y lleva un comentario TODO(clarify) encima de ellos. Tú decides qué asignación usar:

• El ejemplo manual de settings.json de la guía de configuración compatible con Anthropic del proveedor asigna opus y sonnet a glm-5.3[1m] y haiku a glm-5.3-flash[1m], y establece CLAUDE_CODE_AUTO_COMPACT_WINDOW en 1000000.
• La asignación predeterminada que indica esa misma guía lista GLM-5.3-Flash para los tres roles.
• La herramienta @z_ai/coding-helper de Z.ai usa glm-5.3-flash por defecto, añade [1m] a los tres roles y escribe una ventana de compactación de 1048576.

Apothem no fija ninguno de estos valores y no elige entre ellos.

Notas de compatibilidadCopy Anchor Link

El backend de GLM no expone ninguna superficie para reglas, comandos, skills ni hooks, así que el adaptador escribe solo el archivo de proveedor del backend y nada más. Apothem no ha comprobado si ZCode expone tales superficies. Tu clave de Z.ai y tus elecciones de ID de modelo siguen siendo propiedad del operador. Las convenciones de la superficie del proveedor en las que se apoya el adaptador están fijadas en src/apothem/harnesses/glm/STANDARD-CONVENTION-PIN.md, capturadas en una instantánea frente a la documentación en vivo de Z.ai.

GLM ejecuta la familia de modelos GLM de Z.ai; consulta la referencia de configuración del proveedor para conocer la superficie actual de configuración del backend, de los modelos y de la compatibilidad con Anthropic.

VerificaciónCopy Anchor Link

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

El comando verify confirma que:

1. La configuración nativa existe en la ruta esperada.
2. El archivo de proveedor está presente y no está vacío.
3. La rutina de verificación específica del adaptador informa éxito.

ActualizaciónCopy Anchor Link

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

El archivo de proveedor es tuyo una vez que existe. install y update escriben la plantilla solo cuando .apothem/providers/glm.toml no existe, y ninguno de los dos lo sobrescribe nunca después, así que tu referencia de clave y tus elecciones de modelo se conservan en cada nueva ejecución. Para obtener una plantilla más reciente, aparta tu archivo, ejecuta update y copia tus valores en el archivo nuevo.

DesinstalaciónCopy Anchor Link

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

Elimina el archivo de proveedor solo cuando Apothem lo creó y sigue siendo una plantilla sin editar, y antes lo respalda bajo la raíz de respaldos de Apothem. Un archivo sin editar escrito por una versión anterior cuenta cuando el registro de instalación de Apothem para el proyecto muestra que lo escribió: el manifiesto registra el resumen criptográfico de cada plantilla que el proyecto ha distribuido. Sin un registro de instalación, solo se elimina una copia exacta de la plantilla actual. Un archivo que creaste o editaste se deja en su lugar. El YAML del perfil compartido y el motor de Apothem no se ven afectados.

Puerta de conformidadCopy Anchor Link

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

Solución de problemasCopy Anchor Link

Opciones de configuraciónCopy Anchor Link

Véase tambiénCopy Anchor Link

• Todos los entornos — el catálogo completo de herramientas compatibles
• Guía de instalación — instala Apothem en este entorno
• Referencia de apothem harnesses — lista e inspecciona adaptadores desde la CLI