Cómo instalar Grok Build en Linux (Ubuntu, Debian, Fedora)

Respuesta rápida: instala Grok Build en Linux en una línea

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

# Comprueba la instalación
grok --version

# Arráncalo dentro de un proyecto
cd ~/mi-proyecto
grok

Para actualizar más adelante, usa grok update. Los comandos de esta guía salen de la documentación oficial de Grok Build y del repositorio oficial grok-build, donde está la guía de usuario completa.

Requisitos

• Un Linux de 64 bits en x64 (x86_64) o ARM64 (aarch64). El instalador se detiene con cualquier otra arquitectura.
• curl o wget, además de Bash para ejecutar el script.
• Una cuenta de grok.com para el login en el navegador, o una API key de xAI sacada de console.x.ai.
• Conexión a internet.

Qué cambia el instalador en tu sistema

• Descarga el binario para tu arquitectura y lo enlaza como ~/.grok/bin/grok, junto con un alias agent.
• Añade ~/.grok/bin a tu PATH en ~/.bashrc, ~/.zshrc o la configuración de fish, según tu shell, e instala el autocompletado.
• Si ~/.local/bin o /usr/local/bin ya están en tu PATH y puedes escribir en ellos, también crea ahí un enlace, así que grok funciona al momento.
• La configuración, las credenciales y las sesiones van en ~/.grok/. Si quieres moverlas a otro sitio, define GROK_HOME.

Primer arranque e inicio de sesión (también por SSH)

• Abre un terminal en la carpeta de un proyecto y escribe grok.
• Se abre el navegador para que entres con tu cuenta de grok.com. Las credenciales se guardan en ~/.grok/auth.json y se renuevan solas.
• En un servidor, por SSH o dentro de un contenedor, ejecuta grok login --device-auth. Te muestra una URL y un código: abre la URL en cualquier otro dispositivo, introduce el código y Grok Build detecta el login.
• Para CI o scripts, exporta XAI_API_KEY. Grok Build la usa cuando no hay una sesión activa.

# Login sin navegador con código de dispositivo
grok login --device-auth

# O usa una API key
export XAI_API_KEY="xai-..."
grok

La guía oficial de autenticación explica también el SSO de empresa con OIDC y los scripts de autenticación externos.

Errores comunes en Linux y cómo arreglarlos

• "grok: command not found" tras instalar: tu shell actual todavía no ha leído el nuevo PATH. Abre un terminal nuevo o ejecuta export PATH="$HOME/.grok/bin:$PATH".
• "Either curl or wget is required but neither is installed": las imágenes mínimas suelen venir sin ninguno de los dos. Instala uno con tu gestor de paquetes y repite la instalación.
• "Unsupported architecture" o "Grok is not yet available for your system": no hay binario para tu máquina. Solo se publican versiones de 64 bits para x86_64 y aarch64.
• "Authentication failed": ejecuta grok logout para borrar las credenciales guardadas y después grok login (o grok login --device-auth por SSH).
• Copiar y pegar, los colores o las teclas fallan en tmux, por SSH o en Wayland: ejecuta grok doctor en tu shell, o /doctor dentro de Grok Build. Revisa el terminal, el multiplexor y el portapapeles y te dice cómo arreglar lo que encuentre.

Varias sesiones de Grok Build en Linux

Con Grok Build funcionando, el siguiente límite llega rápido: un terminal solo lleva una tarea a la vez. Le das un trabajo a Grok y esperas. Abrir más pestañas en GNOME Terminal o en tmux ayuda, hasta que pierdes la cuenta de qué sesión ha terminado, cuál espera tu aprobación y qué ha cambiado cada una.

CodeAgentSwarm es una app de escritorio pensada justo para eso, y ya funciona en Linux como .deb (Ubuntu, Debian y derivadas) o AppImage (Fedora y la mayoría de las demás distros), en x64 y ARM64. Se descarga gratis. Elige Grok Build en cualquier terminal y úsalo junto a Claude Code, Codex y otros agentes, con notificaciones cuando un agente termina o necesita algo, historial buscable de todas las sesiones y un diff en tiempo real de lo que ha cambiado cada terminal.

Siguientes pasos: cómo usar Grok Build para los comandos del día a día, y Grok Build en modo headless y CI si tu máquina Linux es un servidor de builds.

Conclusión

En Linux, Grok Build está a un comando curl, y grok login --device-auth resuelve los servidores sin navegador. Ejecuta grok doctor si algo falla, y cuando un solo terminal se te quede corto, CodeAgentSwarm te deja usar varios a la vez.