GLM-5.2, GLM-5.3 y GLM-5.3-Flash en Claude Code: Configuración y cambio de modelo
Configura GLM en Claude Code usando APIMaster. Configura settings.json en Windows, macOS y Linux, inicia claude, selecciona un modelo con /model y empieza a chatear.
Configura APIMaster en settings.json, ejecuta claude y luego introduce /model MODEL_ID en la conversación para usar GLM. Los IDs disponibles que se tratan aquí son glm-5.2, glm-5.3, glm-5.3-flash. Claude Code es el cliente; GLM es el modelo que responde.
Antes de empezar
Completa la comprobación del entorno y la configuración de Claude Code. Obtén una clave de API de APIMaster con saldo suficiente y acceso a los modelos seleccionados.
claude --version
La URL base del gateway es https://apimaster.ai, sin /v1. Claude Code añade /v1/messages por sí mismo.
1. Abre el directorio de configuración
Windows
Pulsa Win + R, introduce la siguiente ruta y pulsa Enter:
%USERPROFILE%\.claude
Crea la carpeta si es necesario. Abre o crea settings.json. Asegúrate de que no se llame settings.json.txt.
macOS / Linux
En macOS, en Finder pulsa Command + Shift + G e introduce:
~/.claude
En Linux, abre el mismo directorio con tu gestor de archivos o editor. Créalo si es necesario:
mkdir -p ~/.claude
Abre o crea settings.json allí. Si configuraste un directorio de configuración personalizado para Claude Code, usa ese directorio en su lugar.
2. Edita settings.json
Windows, macOS y Linux usan la misma configuración. Reemplaza YOUR_APIMASTER_API_KEY con tu clave de APIMaster:
{
"model": "glm-5.3",
"env": {
"ANTHROPIC_BASE_URL": "https://apimaster.ai",
"ANTHROPIC_API_KEY": "YOUR_APIMASTER_API_KEY",
"ANTHROPIC_AUTH_TOKEN": "",
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
}
}
Si el archivo ya existe, haz una copia de seguridad y fusiona estos campos en el objeto JSON existente y en el objeto env. Conserva otras opciones que necesites. No añadas un segundo objeto JSON ni dupliques una clave env. JSON no permite comentarios ni comas finales.
La guía general de Claude Code muestra la autenticación por token. Esta guía usa la autenticación por clave de API que se ejercita en nuestras pruebas de integración. Mantén ANTHROPIC_AUTH_TOKEN vacío cuando uses ANTHROPIC_API_KEY, y elimina las credenciales en conflicto de otras configuraciones o de tu terminal. Usa una clave de APIMaster para este gateway.
El campo model establece el modelo inicial. Puedes seleccionar otro después del inicio. Mantén este archivo de configuración de usuario en privado; no confirmes claves reales en un repositorio compartido. Guarda el archivo y reinicia Claude Code para cargar la nueva configuración.
3. Inicia Claude Code
En una terminal abierta en el directorio de tu proyecto, ejecuta:
claude
Completa los mensajes normales de primera ejecución y revisa el mensaje de confianza del proyecto. El modelo inicial debería ser glm-5.3. Esta es una sesión interactiva normal con las herramientas habituales y la configuración del proyecto.
4. Selecciona un modelo y empieza a chatear
En la conversación de Claude Code, introduce uno de los siguientes comandos y pulsa Enter:
/model glm-5.2
/model glm-5.3
/model glm-5.3-flash
Ejecuta una línea a la vez, eligiendo el modelo que quieras. Después de que Claude Code confirme el cambio, envía un mensaje breve:
Reply with exactly OK.
Una respuesta de texto normal confirma la conexión básica. Luego puedes continuar chateando o pedirle que trabaje en tu proyecto. Para cambiar de nuevo en la misma conversación, introduce otro comando /model MODEL_ID.
Introducir /model solo abre el selector de modelos. Los IDs de gateways personalizados pueden no aparecer en su lista predeterminada. Escribe el ID completo como se muestra arriba en su lugar. El comando de barra pertenece a dentro de Claude Code, no a PowerShell ni a Bash. Los nombres de los modelos describen modelos GLM, no Claude Sonnet ni Opus.
También puedes elegir un modelo al iniciar desde la terminal. Ejecuta un comando a la vez:
claude --model glm-5.2
claude --model glm-5.3
claude --model glm-5.3-flash
Para establecer explícitamente el valor predeterminado para sesiones futuras, edita model en settings.json. Un flag de inicio, la variable de entorno ANTHROPIC_MODEL o una configuración de proyecto/gestionada pueden afectar al modelo seleccionado; revísalos si el modelo inicial difiere de tu valor guardado.
Solución de problemas
| Síntoma | Comprobación |
|---|---|
| 401 / aviso de inicio de sesión inesperado | Comprueba la clave de APIMaster, la URL base y las variables de autenticación en conflicto; reinicia la CLI después de editar la configuración. |
| 404 | Usa https://apimaster.ai, sin /v1 ni /v1/messages. |
| La configuración no surte efecto | Comprueba la ubicación del archivo, un JSON válido y las anulaciones desde configuraciones de terminal, de proyecto o gestionadas. |
| El modelo no aparece en el selector | Introduce /model MODEL_ID con el ID exacto, o inicia con claude --model MODEL_ID. |
| Modelo no disponible / 403 | Comprueba la ortografía, los modelos permitidos de la clave, el saldo de la cuenta y la disponibilidad actual de la ruta. |
unrecognized_model |
Observado con IDs personalizados en nuestras pruebas. Comprueba la respuesta real y el resultado de la herramienta; los valores predeterminados de capacidades integradas de Claude no están verificados para GLM. |
| Permiso denegado para archivo o comando | Revisa y aprueba la operación prevista a través de los avisos de permisos habituales. |
| 429 / 5xx / respuesta interrumpida | Conserva el error, el ID del modelo, la versión de la CLI, la hora UTC y el ID de solicitud si están disponibles para soporte. |
Validación y diagnósticos opcionales
Pruebas de integración registradas: 2026-09-15 UTC, Claude Code 2.1.239, Linux. Todos los modelos listados aquí devolvieron el texto esperado y leyeron un archivo local a través de una herramienta. Los tres también completaron una pequeña reparación en Python y una ejecución de pruebas, comprobada de forma independiente después. Windows y macOS no formaron parte de esas ejecuciones registradas.
Las comprobaciones automatizadas anteriores usaron el modo bare para aislar la configuración. El uso diario normal sigue los pasos de settings.json y la interacción descritos arriba. El modo bare y --setting-sources "" omiten las integraciones normales o la configuración guardada, por lo que no deben añadirse al comando de inicio diario de esta guía.
Para una comprobación rápida no interactiva usando tu configuración guardada:
claude --model glm-5.3 -p "Reply with exactly OK."
Para una comprobación de herramienta, crea probe.txt que contenga FILE_PROBE_739182, inicia Claude Code en ese directorio y pídele que lea el archivo usando una herramienta y devuelva su contenido exacto. Confirma que la herramienta realmente se ejecuta.
Estas son comprobaciones de integración acotadas, no una garantía de cada función de Claude Code, del comportamiento en sesiones largas ni del contexto máximo. La documentación del gateway de Anthropic no admite oficialmente el enrutamiento de Claude Code a modelos que no son de Claude; esta guía describe la integración de APIMaster.
FAQ
¿Mi suscripción de Claude paga estas solicitudes?
No. Con esta configuración de APIMaster, las solicitudes usan tu clave y saldo de APIMaster.
¿Puedo seguir chateando después de cambiar de modelo?
Sí, usa el comando de cambio de modelo en la conversación abierta y espera la confirmación antes de enviar el siguiente mensaje. Para una comparación limpia entre modelos, inicia una sesión aparte con claude --model MODEL_ID.