Cómo instalar OpenCode en Linux (Ubuntu, Debian, Fedora, Arch)

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

# Script de instalación oficial (recomendado)
curl -fsSL https://opencode.ai/install | bash

# Comprueba la instalación
opencode --version

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

El script detecta tu arquitectura (x64 o ARM64) y si tu sistema usa musl, descarga el binario que toca y añade su carpeta al PATH en la configuración de tu shell. Es también el comando que usa CodeAgentSwarm cuando instala OpenCode por ti en Linux. Todos los comandos de esta guía salen de la documentación oficial de OpenCode.

Requisitos

• Un Linux de 64 bits en x64 o ARM64. El script funciona en distros con glibc (Ubuntu, Debian, Fedora, Arch) y con musl, como Alpine.
• curl y tar para el script de instalación. Casi todas las distros traen los dos.
• Un emulador de terminal moderno. La documentación pone como ejemplo WezTerm, Alacritty, Ghostty y Kitty.
• Una cuenta o API key de al menos un proveedor de modelos (Anthropic, OpenAI, Google, GitHub Copilot u otro). OpenCode no te ata a un único proveedor.
• En un escritorio, una herramienta de portapapeles: xclip o xsel en X11, o wl-clipboard en Wayland.

Otras formas de instalarlo: npm, Homebrew, pacman

Si prefieres un gestor de paquetes, OpenCode publica varias opciones oficiales. Elige una y quédate con ella, para no acabar con dos copias en el PATH.

# npm (también vale bun, pnpm o yarn)
npm install -g opencode-ai

# Homebrew en Linux
brew install anomalyco/tap/opencode

# Arch Linux (estable)
sudo pacman -S opencode

# Arch Linux, lo último desde AUR
paru -S opencode-bin

¿Quieres el binario en una carpeta concreta? El script mira primero $OPENCODE_INSTALL_DIR, luego $XDG_BIN_DIR, luego $HOME/bin, y si no, usa $HOME/.opencode/bin. Por ejemplo: XDG_BIN_DIR=$HOME/.local/bin curl -fsSL https://opencode.ai/install | bash. Para actualizar más adelante, ejecuta opencode upgrade.

Primer arranque y conexión de un proveedor (también por SSH)

• Abre un terminal en la carpeta de un proyecto y escribe opencode.
• Ejecuta /connect, busca tu proveedor y pega una API key, o sigue el inicio de sesión en el navegador si el proveedor lo ofrece (como ChatGPT Plus/Pro o GitHub Copilot).
• Ejecuta /models para elegir modelo y después /init para que OpenCode analice el proyecto y cree un archivo AGENTS.md.

En un servidor o por SSH, lo más sencillo es usar una API key: ejecuta opencode auth login, elige el proveedor y pega la clave. Varios proveedores también leen sus credenciales de variables de entorno, que puedes definir en el perfil de tu shell. Todo lo que añadas se guarda en ~/.local/share/opencode/auth.json, y opencode auth list te dice qué proveedores tienes conectados.

Errores comunes en Linux y cómo arreglarlos

• "opencode: command not found" tras instalar: tu shell aún no ha recargado el PATH. Abre un terminal nuevo o añade export PATH=$HOME/.opencode/bin:$PATH (o la carpeta que indicó el script) a tu ~/.bashrc o ~/.zshrc.
• "Error: 'tar' is required but not installed": pasa en imágenes mínimas y contenedores. Instala tar con tu gestor de paquetes y vuelve a lanzar el script.
• Copiar y pegar no hace nada: en Linux OpenCode necesita una herramienta de portapapeles. Instala wl-clipboard en Wayland, o xclip o xsel en X11.
• ProviderInitError o configuración rota: borra ~/.local/share/opencode y vuelve a conectar tu proveedor con /connect. Ojo, esto también borra las credenciales guardadas.
• Errores de llamadas a la API tras actualizar: puede que haya un paquete de proveedor antiguo en caché. Ejecuta rm -rf ~/.cache/opencode y vuelve a abrir OpenCode.
• No arranca: ejecuta opencode --print-logs para ver qué falla y asegúrate de tener la última versión con opencode upgrade. Los logs están en ~/.local/share/opencode/log/.

Para todo lo demás, la página oficial de problemas de OpenCode explica los logs, el almacenamiento y las soluciones conocidas.

Varias sesiones de OpenCode en Linux

Con OpenCode funcionando, el siguiente límite llega rápido: un terminal solo lleva una tarea a la vez. Le das un trabajo a OpenCode 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. Pone varios terminales de OpenCode uno al lado del otro y añade 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. Además puedes combinar OpenCode con Claude Code, Codex y otros agentes en la misma ventana.

Siguientes pasos: ejecutar múltiples sesiones de OpenCode y montar un enjambre de agentes OpenCode. ¿Vas a instalar otros agentes en la misma máquina? Mira Claude Code en Linux.

Conclusión

En Linux, OpenCode está a un comando curl, o a un npm, brew o pacman si prefieres un gestor de paquetes. Conecta un proveedor con /connect o opencode auth login, instala una herramienta de portapapeles y revisa los logs si algo falla. Cuando un solo terminal se te quede corto, CodeAgentSwarm te deja usar varios a la vez.