Tutorial de configuración de Grok Build: conectar con la API de NextHub

Grok Build es el asistente de codificación en terminal que ha lanzado xAI. Según la documentación oficial, su principal archivo de configuración es ~/.grok/config.toml, que permite enviar las solicitudes de modelos al grupo Grok de NextHub (0.55x, canal oficial).

Pasos de conexión

1. Instala Grok Build

Windows (PowerShell)

irm https://x.ai/cli/install.ps1 | iex

macOS / Linux / WSL

curl -fsSL https://x.ai/cli/install.sh | bash

Cuando termine la instalación, vuelve a abrir la terminal y ejecuta este comando para confirmar que funciona:

grok --version

2. Abre el directorio de configuración

Windows (CMD)

start "" "%USERPROFILE%\.grok"

macOS / Linux

mkdir -p ~/.grok

Si no hay un config.toml en el directorio, crea a mano un archivo con el mismo nombre.

3. Escribe la configuración

Escribe el siguiente contenido en config.toml:

[models]
default = "grok-4.6"
web_search = "grok-4.6"

[endpoints]
models_base_url = "https://api.nexthub.cc/v1"

[model."grok-4.6"]
model = "grok-4.6"
name = "Grok 4.6"
description = "Grok 4.6 via NextHub"
api_key = "tu ApiKey de NextHub"
api_backend = "responses"
context_window = 500000
supports_backend_search = false

Dos interruptores de compatibilidad

supports_backend_search = false desactiva la búsqueda de fondo de Grok (la pasarela no ofrece esa capacidad; si no la desactivas, puede que la petición lleve añadidos parámetros de búsqueda de fondo y dé error); si quieres usar el comando /effort y el parámetro --effort para ajustar el nivel de razonamiento, añade una línea supports_reasoning_effort = true en el mismo bloque de configuración. Después de modificar la configuración hay que reiniciar Grok Build para que se recargue.

Recuerda poner /v1 en la Base URL

En models_base_url escribe el endpoint compatible con OpenAI de NextHub https://api.nexthub.cc/v1. Usa como API Key la clave del grupo Grok; actualmente el grupo Grok ofrece las series grok-4.5, grok-4.6, grok-4.3 y grok-4.20, además de modelos como grok-build-0.1; la lista completa la mandan los datos en tiempo real de la Plaza de Modelos.

Si no quieres escribir la clave directamente en el archivo de configuración, sustituye la línea api_key = "..." por env_key = "NEXTHUB_API_KEY" y configura NEXTHUB_API_KEY en las variables de entorno del sistema. Ten en cuenta que en env_key se escribe el nombre de la variable de entorno, no la clave en sí.

4. Verifica la configuración

grok inspect
grok -p "responde solo ok" -m grok-4.6

Si grok inspect puede leer la configuración y el comando de prueba recibe la respuesta ok, la conexión se ha realizado correctamente.

Problemas frecuentes

/effort no surte efecto para ajustar el nivel de razonamiento

Si el modelo no declara supports_reasoning_effort = true (ver arriba «Dos interruptores de compatibilidad»), el comando /effort y el parámetro --effort no surten efecto sobre ese modelo. Después de modificar la configuración hay que reiniciar Grok Build para que se recargue.

Aviso de que el modelo no existe o no tienes permiso

Comprueba en este orden: si el ApiKey pertenece al grupo Grok, si models_base_url es https://api.nexthub.cc/v1, si model coincide con el ID de la lista de modelos y si la clave se ha copiado completa (sin espacios de más delante ni detrás).