Puedes ejecutar GLM-5.2 en Claude Code hoy mismo, y la configuración tarda unos dos minutos. Claude Code se comunica con cualquier endpoint que hable la Messages API de Anthropic, y Zhipu ofrece exactamente eso para GLM: apunta Claude Code a z.ai y listo. Hay dos formas de hacerlo: una app con un cambiador de un clic (la más fácil, y te permite volver a Claude en cualquier momento), o un archivo de configuración editado manualmente. Esta guía cubre ambas opciones, en macOS, Windows y Linux, además de cómo volver a Claude cuando lo necesites.
La forma más rápida: CC Switch
Si ya manejas más de un proveedor, omite la configuración manual y usa CC Switch (código abierto, licencia MIT, Windows/macOS/Linux). Es una aplicación de escritorio que administra las configuraciones de proveedores para Claude Code, Codex, Gemini CLI y algunas otras CLIs, así que no tendrás que editar JSON manualmente.
1. Instala CC Switch desde ccswitch.io o su repositorio de GitHub. Haz clic en el botón naranja + en la esquina superior derecha de la ventana principal para abrir Añadir proveedor, y selecciona la pestaña Claude Provider. 2. Escribe zhipu en la búsqueda de ajustes preestablecidos. Aparecen dos ajustes preestablecidos — Zhipu GLM (endpoint de China continental) y Zhipu GLM en. Fuera de China continental, elige Zhipu GLM en para el endpoint internacional.
3. Desplázate hacia abajo y pega tu clave API de z.ai en el campo API Key. El ajuste predefinido completa automáticamente el resto: el formato Anthropic Messages (Native), el campo de autenticación ANTHROPIC_AUTH_TOKEN y la URL base.
4. En Model Mapping, configure el modelo solicitado para cada rol — Sonnet, Opus, Fable y Haiku — a glm-5.2, de modo que cada solicitud se enrute a GLM independientemente del nivel al que Claude Code recurra. Marque la casilla 1M en un rol para declarar a Claude Code el contexto de un millón de tokens. Guarde.
5. De vuelta en la lista de proveedores, haz clic en Enable en la entrada de Zhipu GLM (un proveedor existente como Claude Official puede permanecer en la lista para volver a cambiar más tarde), luego reinicia Claude Code para asegurarte de que detecte el nuevo proveedor. Ejecuta /status para confirmar que el modelo muestra glm-5.2.
¿Por qué molestarse con la app en lugar de una configuración estática? Incluye presets para la mayoría de los proveedores que querrías probar — Kimi, MiniMax, MiMo, Qwen, DeepSeek y más — así que cada uno es una tarea de preset y clave en lugar de reescribir la configuración, y cambiar entre ellos (o volver a Claude) son un par de clics. Esa es la base práctica del flujo de trabajo híbrido de abajo.
Configuración manual con settings.json
¿Prefieres configurarlo tú mismo, o configurar una caja de CI sin GUI? Edita el archivo directamente.
1. Obtén una clave API desde la consola de API de Z.AI. Sirve tanto una clave de pago por uso como una clave de suscripción de GLM Coding Plan. 2. Combina este bloque env en tu archivo de configuración de Claude Code (conserva las claves existentes — no sobrescribas todo el archivo). 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"
}
}3. Reinicia Claude Code, luego ejecuta /status. La línea del modelo debería mostrar glm-5.2 (o glm-5.2[1m] para la variante de un millón de tokens). Si todavía muestra un modelo de Claude, el archivo no se cargó — comprueba si hay errores de sintaxis JSON y confirma la ruta.
Dos alternativas basadas en shell si prefieres no tocar el archivo:
macOS / Linux — exporta las variables (bash/zsh) para una sesión única, luego inicia:
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"
claudeCierra la terminal y volverás a tu configuración normal.
Windows — establece variables de entorno persistentes del usuario en PowerShell y luego 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 del modelo a los que Claude Code enruta: Opus, Sonnet y Haiku (las compilaciones más recientes añaden un rol Fable, que CC Switch también expone). Configurarlas todas en glm-5.2 envía cada solicitud a GLM; si prefieres mantener las tareas en segundo plano baratas y rápidas, apunta el espacio de Haiku a glm-4.5-air en su lugar. Usa glm-5.2[1m] para la ventana completa de un millón de tokens. El largo API_TIMEOUT_MS importa más de lo que parece: las respuestas de GLM a menudo son más lentas que las de Claude, y el tiempo de espera predeterminado cortará las generaciones largas.
¿Qué ruta: z.ai nativo, un proxy o el Plan de Coding?
Tres formas prácticas de alimentar GLM-5.2 en Claude Code, y no son intercambiables.
punto final nativo de z.ai (recomendado). La URL https://api.z.ai/api/anthropic anterior. Habla el protocolo de Anthropic, así que Claude Code se conecta sin middleware: la opción predeterminada.
Un proxy de traducción. Otros hosts (Fireworks, NVIDIA NIM, pesos autoalojados) sirven GLM-5.2 a través de una API compatible con OpenAI que Claude Code no puede leer directamente, por lo que necesitan un proxy que convierta los formatos. claude-code-router se encarga de esto. Solo vale la pena si ya tienes créditos o hardware en una de esas plataformas.
Suscripción GLM Coding Plan. Un plan mensual fijo (desde $18/mes, en la página de suscripción de z.ai) que usa el mismo endpoint de z.ai pero cobra una tarifa fija en lugar de cobrar por token. Si programas en Claude Code a diario, una suscripción suele ser más barata y más predecible que los tokens medidos; haz las cuentas frente a tu gasto mensual en tokens para encontrar el punto de equilibrio. Si tu uso tiene picos, el pago por uso gana.
Cambiar entre GLM-5.2 y Claude
Claude Code usa un proveedor activo a la vez, así que *cambias* en lugar de dividir ranuras: ejecuta GLM-5.2 para el volumen rutinario, y habilita tu proveedor oficial de Claude en CC Switch cuando necesites Claude para arquitectura, código sensible a la seguridad o revisión. Cualquier endpoint compatible con Anthropic funciona para la parte de Claude: tu cuenta de Anthropic, o un relay como AIReiter, una opción entre varias. Para el enrutamiento automático por solicitud entre proveedores, una gateway como claude-code-router se encarga de la distribución.
Solución de problemas
Síntoma | Causa probable | Solución |
|---|---|---|
| settings.json no cargado | Comprueba que el JSON sea válido; confirma que editaste |
Error | ID de modelo incorrecto (sensible a mayúsculas y minúsculas) | Usa exactamente |
401 / autenticación fallida | Desajuste entre clave y endpoint | No combines una clave de OpenRouter con la URL de z.ai; regenera la clave si es necesario |
Las generaciones largas se cortan | Tiempo de espera demasiado bajo | Configura |
Las llamadas a herramientas fallan o entran en bucle | JSON de herramientas mal formado | Reduce los subagentes en paralelo; inténtalo de nuevo; 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 en GLM-5.2, y el Plan de Codificación comienza en $18/mes. Incluso a las tarifas completas de pago por uso ($1.40 / $4.40 por millón), el uso ligero cuesta centavos.
¿GLM-5.2 admite el contexto de 1M tokens en Claude Code?
Sí. Establece el ID del modelo en glm-5.2[1m] en lugar de glm-5.2 en tus variables ANTHROPIC_DEFAULT_* y Claude Code usará la ventana de un millón de tokens.
¿Es GLM-5.2 o Claude mejor para programar en Claude Code?
Para ediciones rutinarias y secuenciales, la diferencia de precio hace de GLM-5.2 la opción predeterminada racional. Claude suele destacar en arquitectura de múltiples pasos, trabajo sensible a la seguridad y flujos de trabajo de subagentes de alta concurrencia. La configuración de cambio te permite usar cada uno donde es más fuerte en lugar de elegir solo uno.
¿Puedo usar GLM-5.2 en herramientas distintas de Claude Code?
Sí. El mismo endpoint z.ai y las mismas claves funcionan con otras CLI agentic — OpenCode, Cline y Kilo Code aceptan una URL base personalizada, y CC Switch administra ajustes preestablecidos para varios de ellos.
¿Necesito una suscripción de pago a Claude para usar GLM-5.2 en Claude Code?
No. Claude Code es solo el cliente; una vez que lo apuntas a z.ai, te factura z.ai, no Anthropic. Solo necesitas una cuenta de Claude si mantienes Claude disponible como proveedor al que cambiar.
¿Necesito reiniciar Claude Code después de cambiar de proveedor en CC Switch?
Según la documentación de CC Switch, Claude Code admite el cambio en caliente de los datos del proveedor sin necesidad de reiniciar, mientras que la mayoría de las otras herramientas CLI sí requieren reiniciar la terminal o la aplicación. En la práctica, reiniciar Claude Code es la forma fiable de asegurarse de que un cambio surtió efecto.
¿Cómo vuelvo a Claude (inicio de sesión oficial) en CC Switch?
Añade un proveedor oficial de Claude de la lista preestablecida, actívalo y luego ejecuta una vez el flujo normal de cierre de sesión / inicio de sesión (OAuth) de Claude Code. Después de eso, podrás alternar libremente entre tu inicio de sesión oficial de Claude y proveedores de terceros como z.ai.
¿Es CC Switch gratuito y seguro de usar?
Sí — es de código abierto bajo la licencia MIT y gratuito. Tus configuraciones residen localmente en una base de datos SQLite con escrituras atómicas, y por diseño realiza cambios mínimos en la propia configuración de cada herramienta, por lo que tus CLIs siguen funcionando normalmente incluso si desinstalas la aplicación.