Tutorial de configuración de ZCode: conectar con la API de NextHub
ZCode es el entorno de desarrollo de agentes (ADE) lanzado por Zhipu; permite añadir cualquier servicio de modelos compatible con los protocolos Anthropic / OpenAI como proveedor personalizado. Una vez configurado NextHub, puedes usar directamente los modelos Claude y GPT en ZCode.
Pasos de conexión
1. Instala ZCode
Ve a la web oficial de ZCode para descargar el instalador de Windows / macOS / Linux y completa la instalación. En la página de bienvenida del primer arranque puedes saltarte la conexión de la cuenta y entrar directamente en la interfaz principal.
2. Entra en los ajustes de modelos
Haz clic en el nombre del modelo que hay en el campo de entrada → Gestionar modelos (o entra en el panel de Ajustes de modelos desde los ajustes) y pulsa Añadir proveedor al final de la lista de proveedores de la izquierda.
3. Rellena la información del proveedor (canal Claude)
| Campo | Contenido |
|---|---|
| Nombre | NextHub |
| Protocolo de la interfaz | Anthropic |
| Dirección de la interfaz (Base URL) | https://api.nexthub.cc |
| API Key | tu ApiKey de NextHub (grupo de la familia Claude) |
No pongas /v1 en la Base URL
La dirección de la interfaz del protocolo Anthropic sigue el mismo criterio que ANTHROPIC_BASE_URL de Claude Code: escribe el dominio desnudo https://api.nexthub.cc, sin añadir /v1 al final; ZCode ensambla automáticamente la ruta de la interfaz Messages.
4. Añade modelos y habilítalos
Pulsa Añadir modelo, escribe a mano los ID de los modelos que admite el servicio, por ejemplo claude-opus-5-5 y claude-fable-5 (la lista completa está en canales y modelos; mandan los datos en tiempo real de la Plaza de Modelos). Después de guardar, abre el interruptor de habilitación del proveedor.
5. Verificación
Vuelve al cuadro de diálogo, selecciona en el selector de modelos el que acabas de añadir y envía un mensaje: si recibes respuesta, la conexión se ha realizado correctamente.
También puedes conectar el canal GPT
Añade un proveedor más: elige OpenAI como protocolo de la interfaz, escribe https://api.nexthub.cc/v1 como dirección (con /v1), usa como API Key la clave del grupo GPT-Azure (0.47x) o GPT-Pro (0.11x) y escribe gpt-5.6, gpt-6-astra, etc. como ID de modelo. Los dos proveedores pueden coexistir y puedes cambiar entre ellos en cualquier momento desde el selector de modelos.
Problemas frecuentes
La configuración de proveedores de ZCode y las variables de entorno del terminal son dos entradas independientes que no se sincronizan entre sí. Si la conexión se queda girando sin parar, comprueba primero si has escrito algún camino de más en la dirección de la interfaz: con el protocolo OpenAI, ZCode ensambla automáticamente /chat/completions, y un camino sobrante en la dirección dará 404; el ID del modelo debe coincidir exactamente con el de la lista de modelos.