Instala Grok Build en macOS, Linux o Windows en dos minutos

Antes de instalar

Grok Build es una app de terminal de SpaceXSI (antes xAI). Hay binarios precompilados para macOS, Linux y Windows. Necesitas:

• Una terminal: Terminal o iTerm en macOS, cualquier shell en Linux, PowerShell o Git Bash en Windows.
• Un navegador web para el primer inicio de sesión, o una clave de API si lo configuras en un servidor.
• Una cuenta. Grok Build se puede probar gratis, y el plan Plus de The X Subscription ($8 al mes) y los niveles superiores añaden más uso.

Comandos de instalación

1. macOS, Linux o Git Bash: ejecuta curl -fsSL https://x.ai/cli/install.sh | bash
2. Windows PowerShell: ejecuta irm https://x.ai/cli/install.ps1 | iex
3. Comprueba que ha funcionado: ejecuta grok --version. Si aparece un número de versión, la instalación se completó.

Ambos comandos proceden de la página oficial de Grok Build y del repositorio de GitHub. El instalador coloca el programa en ~/.grok/bin, según una guía de instalación de terceros.

Los desarrolladores también pueden compilarlo desde el código fuente. Para ello se necesita una cadena de herramientas de Rust (instalada y fijada con rustup), DotSlash (cargo install dotslash) y protoc. macOS y Linux son los sistemas de compilación compatibles. Las compilaciones en Windows son “best-effort” (sin garantías), así que los usuarios de Windows deberían usar el binario precompilado.

Primera ejecución e inicio de sesión

1. Abre una terminal en la carpeta de tu proyecto, no en tu carpeta personal.
2. Ejecuta grok.
3. Se abre una ventana del navegador para que inicies sesión, normalmente en grok.com.
4. Tras iniciar sesión, arranca la interfaz de terminal. Las credenciales se guardan en ~/.grok/auth.json.

Por qué importa la carpeta del proyecto: en julio de 2026, ejecutar Grok Build podía subir todo el directorio actual al almacenamiento en la nube de la empresa. SpaceXSI lo desactivó ese mismo día y dice que ahora Build puede funcionar de forma totalmente local. Empezar en la carpeta del proyecto sigue siendo el hábito más seguro, porque el agente puede leer y editar archivos allí donde se ejecuta.

Por defecto, Grok Build usa el modo plan: propone un plan y no hace ningún cambio hasta que lo apruebas.

Actualizar y comprobar la configuración

• grok update actualiza Grok Build a la última versión.
• grok doctor comprueba la configuración de tu terminal e informa de los problemas.
• grok --version muestra la versión instalada.

Actualiza a menudo. SpaceXSI publica funciones rápidamente, y los nuevos modelos como Grok 4.7 llegan a Grok Build el mismo día de su lanzamiento.

Usar una clave de API en CI

El inicio de sesión por navegador no funciona en los servidores de compilación. Para CI, configura la variable de entorno XAI_API_KEY y usa el modo headless para scripts y pipelines.

1. Crea una cuenta en console.x.ai.
2. Carga crédito. La API es de prepago, y las solicitudes se rechazan cuando se acaba el crédito.
3. Genera una clave en la página API Keys.
4. Guárdala como secreto en tu sistema de CI y exponla como XAI_API_KEY.

El uso con una clave de API se factura a tarifas de API, no de la bolsa de tu suscripción. El modelo grok-build-0.1 cuesta $1 por millón de tokens de entrada y $2 por millón de tokens de salida.

Archivo de configuración y permisos

Grok Build guarda sus ajustes en ~/.grok/config.toml. Ahí es donde se configuran los servidores MCP, para conectarse a herramientas como Linear, Sentry o Postgres.

Las convenciones de cada proyecto van en un archivo AGENTS.md en cada directorio. Una guía de terceros menciona estos modos de permisos: default, acceptEdits, auto, dontAsk, bypassPermissions y plan. Entre las opciones útiles están --worktree, --no-plan y --no-subagents. Evita bypassPermissions salvo que ejecutes Build en un sandbox.

Problemas habituales

• “grok: command not found”: abre una terminal nueva para que tu shell recargue su ruta y comprueba que ~/.grok/bin está en tu PATH.
• La pantalla se ve mal: ejecuta grok doctor para comprobar la compatibilidad de la terminal.
• No se abre la ventana de inicio de sesión: en una máquina remota, usa XAI_API_KEY en su lugar.
• Clave de API rechazada: comprueba que tu cuenta de la consola tiene crédito cargado.
• Falta Grok 4.7 Fast: Fast no forma parte del nivel gratuito.
• Se acabó el uso: los planes de pago comparten una bolsa semanal con el chat de Grok y Cursor. Un uso intensivo en un sitio deja menos para los demás.

Preguntas frecuentes