AIREITER

Cómo usar GLM-5.2 en Claude Code (configuración completa)

Última actualización: 2026-07-29 11:03:42

GLM-5.2 ya se puede usar en Claude Code y dejarlo funcionando lleva unos dos minutos. Claude Code es compatible con cualquier endpoint que implemente la API Messages de Anthropic, y Zhipu ofrece esa compatibilidad para GLM. Solo tienes que apuntarlo a z.ai. Puedes hacerlo de dos formas: con una app para cambiar de proveedor en un clic —la opción más sencilla y reversible— o editando la configuración a mano. Aquí van ambos métodos para macOS, Windows y Linux, además de cómo recuperar Claude cuando te haga falta.

La vía rápida: CC Switch

Si alternas entre varios proveedores, evita tocar JSON a mano y utiliza CC Switch. Es una aplicación de escritorio de código abierto, con licencia MIT y disponible para Windows, macOS y Linux. Gestiona las configuraciones de proveedores para Claude Code, Codex, Gemini CLI y algunas otras CLI.

  1. Instala CC Switch desde ccswitch.io o desde su repositorio de GitHub. En la ventana principal, pulsa el botón naranja + de la esquina superior derecha para abrir Add Provider y entra en la pestaña Claude Provider.
  2. Escribe zhipu en la búsqueda de presets. Verás dos opciones: Zhipu GLM, para el endpoint de China continental, y Zhipu GLM en. Si estás fuera de China continental, elige Zhipu GLM en para usar el endpoint internacional.
Pantalla Add New Provider de CC Switch con "zhipu" escrito en el cuadro de búsqueda de presets, mostrando los presets Zhipu GLM y Zhipu GLM en en la pestaña Claude Provider
  1. Desplázate hacia abajo y pega tu clave de API de z.ai en el campo API Key. El preset completa automáticamente el resto: el formato Anthropic Messages (Native), el campo de autenticación ANTHROPIC_AUTH_TOKEN y la URL base.
  2. En Model Mapping, asigna glm-5.2 como modelo solicitado para todos los roles: Sonnet, Opus, Fable y Haiku. Así, todas las peticiones irán a GLM independientemente de la gama a la que recurra Claude Code. Marca la casilla 1M en un rol para indicar a Claude Code que dispone de un contexto de un millón de tokens. Guarda los cambios.
Tabla de mapeo de modelos de Edit Provider en CC Switch, con los roles Sonnet, Opus, Fable y Haiku configurados como glm-5.2, usando el formato Anthropic Messages Native y ANTHROPIC_AUTH_TOKEN
  1. De vuelta en la lista de proveedores, pulsa Enable en la entrada de Zhipu GLM. Puedes mantener en la lista otro proveedor, como Claude Official, para volver a él más tarde. Reinicia Claude Code para asegurarte de que carga el nuevo proveedor y ejecuta /status para comprobar que aparece el modelo glm-5.2.
Lista de proveedores de CC Switch mostrando Zhipu GLM con su botón Enable, junto a un proveedor Claude Official al que se puede volver

La ventaja de la app frente a una configuración estática es que incluye presets para la mayoría de proveedores que querrías probar: Kimi, MiniMax, MiMo, Qwen, DeepSeek y otros. En lugar de rehacer la configuración, basta con elegir el preset e introducir la clave; cambiar entre ellos, o regresar a Claude, requiere solo un par de clics. Esa es la base práctica del flujo híbrido que veremos más adelante.

Configuración manual con settings.json

Si prefieres configurarlo por tu cuenta o vas a preparar una máquina de CI sin interfaz gráfica, puedes editar el archivo directamente.

  1. Obtén una clave de API en la consola de API de Z.AI. Funcionan tanto una clave de pago por uso como una clave de suscripción al GLM Coding Plan.
  2. Integra este bloque env en el archivo de configuración de Claude Code. Conserva cualquier clave existente; no sobrescribas el archivo entero. El bloque es idéntico en todas las plataformas; solo cambia la ruta:

- 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. Reinicia Claude Code y ejecuta /status. La línea del modelo debería mostrar glm-5.2, o glm-5.2[1m] para la variante con un millón de tokens. Si sigue apareciendo un modelo de Claude, el archivo no se ha cargado: revisa que el JSON no tenga errores de sintaxis y confirma la ruta.

También tienes dos alternativas basadas en la terminal si prefieres no modificar el archivo:

  • macOS / Linux — exporta las variables para una sesión puntual en bash/zsh y después inicia la herramienta:
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

Al cerrar la terminal, volverás a tu configuración habitual.

  • Windows — define variables de entorno persistentes de usuario en PowerShell y reinicia la 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"

Las variables ANTHROPIC_DEFAULT_* reasignan los roles de modelo a los que Claude Code envía las peticiones: Opus, Sonnet y Haiku. Las versiones más recientes añaden el rol Fable, que CC Switch también expone. Si todos apuntan a glm-5.2, cada solicitud irá a GLM. Si prefieres reservar las tareas en segundo plano para un modelo rápido y económico, asigna glm-4.5-air a Haiku. Para utilizar la ventana completa de un millón de tokens, usa glm-5.2[1m]. El valor alto de API_TIMEOUT_MS importa más de lo que parece: las respuestas de GLM suelen ser más lentas que las de Claude y el tiempo de espera predeterminado puede cortar generaciones largas.

Endpoint nativo de z.ai, proxy o Coding Plan: qué elegir

Hay tres formas prácticas de usar GLM-5.2 con Claude Code, y no son equivalentes.

Endpoint nativo de z.ai (recomendado). Es la URL https://api.z.ai/api/anthropic utilizada arriba. Habla el protocolo de Anthropic, por lo que Claude Code se conecta sin middleware. Es la opción predeterminada.

Proxy de traducción. Otros servicios, como Fireworks, NVIDIA NIM o pesos autoalojados, ofrecen GLM-5.2 mediante una API compatible con OpenAI que Claude Code no puede interpretar directamente. Por ello necesitan un proxy que convierta entre formatos. claude-code-router cumple esa función. Solo merece la pena si ya tienes créditos o hardware en alguna de esas plataformas.

Suscripción GLM Coding Plan. Es un plan mensual de tarifa plana, desde $18/mes según la página de suscripción de z.ai, que utiliza el mismo endpoint de z.ai pero cobra una cuota fija en lugar de hacerlo por token. Si programas a diario con Claude Code, una suscripción normalmente será más barata y predecible que el consumo medido. Compara el coste con tu gasto mensual de tokens para encontrar el punto de equilibrio. Si tu uso tiene picos, el pago por uso sale mejor.

Cómo alternar entre GLM-5.2 y Claude

Claude Code utiliza un único proveedor activo cada vez, así que debes cambiar entre ellos en lugar de repartir los roles: usa GLM-5.2 para el volumen de trabajo cotidiano y activa Claude Official en CC Switch cuando necesites Claude para arquitectura, código sensible desde el punto de vista de seguridad o revisiones. Para el lado de Claude sirve cualquier endpoint compatible con Anthropic: tu cuenta de Anthropic o un relay como AIReiter, entre otras alternativas. Si necesitas enrutamiento automático por solicitud entre proveedores, un gateway como claude-code-router puede encargarse de distribuirlas.

Resolución de problemas

SíntomaCausa probableSolución
/status sigue mostrando un modelo de Claudesettings.json no se ha cargadoComprueba que el JSON sea válido, confirma que editaste ~/.claude/settings.json y reinicia Claude Code
Error model not foundID de modelo incorrecto; distingue mayúsculas y minúsculasUsa exactamente glm-5.2, glm-5.2[1m] o glm-4.5-air
401 / error de autenticaciónLa clave no corresponde con el endpointNo combines una clave de OpenRouter con la URL de z.ai; vuelve a generar la clave si es necesario
Las generaciones largas se cortanTiempo de espera demasiado bajoConfigura un valor alto para API_TIMEOUT_MS, por ejemplo 3000000
Las llamadas a herramientas fallan o entran en bucleJSON de herramientas mal formadoReduce los subagentes en paralelo, vuelve a intentarlo y simplifica la instrucción

Preguntas frecuentes

¿GLM-5.2 es gratis en Claude Code?

No de forma indefinida, aunque z.ai ha ofrecido ventanas gratuitas por tiempo limitado para GLM-5.2 y el Coding Plan parte de $18/mes. Incluso con las tarifas completas de pago por uso, $1.40 / $4.40 por millón, un uso ligero cuesta unos céntimos.

¿GLM-5.2 admite el contexto de 1M de tokens en Claude Code?

Sí. Cambia el ID de modelo de glm-5.2 a glm-5.2[1m] en las variables ANTHROPIC_DEFAULT_* y Claude Code utilizará la ventana de un millón de tokens.

¿Qué es mejor para programar en Claude Code: GLM-5.2 o Claude?

Para ediciones rutinarias y secuenciales, la diferencia de precio hace de GLM-5.2 la opción predeterminada más razonable. Claude suele destacar más en arquitectura de varios pasos, trabajo sensible desde el punto de vista de seguridad y flujos con subagentes de alta concurrencia. La configuración para alternar entre proveedores permite usar cada uno en aquello que mejor resuelve, en vez de tener que elegir solo uno.

¿Puedo usar GLM-5.2 en herramientas aparte de Claude Code?

Sí. El mismo endpoint y las mismas claves de z.ai funcionan con otras CLI de agentes: OpenCode, Cline y Kilo Code aceptan una URL base personalizada, y CC Switch gestiona presets para varias de ellas.

¿Necesito una suscripción de pago de Claude para usar GLM-5.2 en Claude Code?

No. Claude Code es solo el cliente; al apuntarlo a z.ai, la facturación corresponde a z.ai, no a Anthropic. Solo necesitas una cuenta de Claude si quieres mantener Claude disponible como proveedor al que cambiar.

¿Tengo que reiniciar Claude Code tras cambiar de proveedor en CC Switch?

Según la documentación de CC Switch, Claude Code permite cambiar en caliente los datos del proveedor sin reiniciar, mientras que la mayoría de las demás herramientas CLI sí necesitan reiniciar la terminal o la aplicación. En la práctica, reiniciar Claude Code es la forma fiable de asegurarte de que el cambio se ha aplicado.

¿Cómo vuelvo a Claude con el inicio de sesión oficial en CC Switch?

Añade un proveedor Claude Official desde la lista de presets, actívalo y realiza una vez el flujo habitual de cierre e inicio de sesión de Claude Code mediante OAuth. Después podrás alternar libremente entre tu inicio de sesión oficial de Claude y proveedores de terceros como z.ai.

¿CC Switch es gratuito y seguro?

Sí: es gratuito, de código abierto y tiene licencia MIT. Tus configuraciones se guardan localmente en una base de datos SQLite con escrituras atómicas y, por diseño, solo realiza cambios mínimos en la configuración propia de cada herramienta. Por eso, tus CLI seguirán funcionando con normalidad incluso si desinstalas la aplicación.

Lecturas relacionadas