Cómo instalar Pi coding agent en Linux (Ubuntu, Debian, Fedora)

Respuesta rápida: instala Pi en Linux

# Instalador oficial para macOS y Linux
curl -fsSL https://pi.dev/install.sh | sh

# O con npm (Node.js 22.19 o posterior)
npm install -g --ignore-scripts @earendil-works/pi-coding-agent

# Comprueba la instalación
pi --version

Todos los comandos de esta guía salen de la guía de inicio rápido oficial de Pi.

Requisitos

• Una máquina Linux con terminal. El instalador oficial es para macOS y Linux.
• Node.js 22.19 o posterior si instalas con npm. CodeAgentSwarm verificó Pi 0.85.1 con esa versión de Node.
• Acceso a un modelo: una suscripción, una API key o un modelo local a través de un proveedor compatible.

Instalar con npm o con el instalador oficial

Los dos métodos te dejan el mismo comando pi. Usa el instalador si quieres que te guíe. Usa npm si ya gestionas Node.js con tu distro o con un gestor de versiones y quieres tener Pi junto al resto de paquetes globales.

node --version
npm --version
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
pi --version

El flag --ignore-scripts forma parte del comando oficial: Pi no necesita los scripts de ciclo de vida de sus dependencias para una instalación normal con npm. Algunos tutoriales antiguos todavía usan el nombre anterior del paquete, @mariozechner.

Para quitar Pi más adelante, ejecuta npm uninstall -g @earendil-works/pi-coding-agent, o vuelve a lanzar el instalador y elige Uninstall Pi si lo usaste.

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

cd ~/mi-proyecto
pi

• Dentro de Pi, ejecuta /login, elige un proveedor y sigue su flujo de suscripción o de API key.
• Ejecuta /model para elegir un modelo al que tenga acceso tu cuenta.
• En un servidor o por SSH, puede que la redirección de OAuth no llegue a Pi. Cuando te lo pida, pega en Pi la URL de redirección final o el código de autorización.
• También puedes saltarte /login y definir la clave del proveedor como variable de entorno, por ejemplo ANTHROPIC_API_KEY u OPENAI_API_KEY.

Pi guarda las credenciales en auth.json, dentro de su directorio de agente. Ese archivo puede contener API keys y tokens de OAuth, así que mantenlo privado y no lo subas nunca al repositorio. Tienes los detalles en la página oficial de autenticación de proveedores.

Pi guarda las sesiones automáticamente. Ejecuta pi --continue para retomar la última sesión de la misma carpeta, o /resume para elegir otra.

Errores comunes en Linux y cómo solucionarlos

• "pi: command not found" tras instalar: abre primero un terminal nuevo. Si sigue fallando, ejecuta command -v pi y npm config get prefix y comprueba que la carpeta bin global de npm está en tu PATH.
• Pi instalado con otro Node: los gestores de versiones como nvm tienen paquetes globales distintos para cada versión de Node. Revisa node --version y reinstala Pi en el Node que usas de verdad.
• Node.js demasiado antiguo: el paquete de npm necesita Node.js 22.19 o posterior. Los paquetes de las distros suelen ir por detrás, así que comprueba la versión antes de instalar.
• El login se queda colgado en una máquina remota: la redirección del navegador no llega al servidor. Pega en Pi la URL de redirección o el código cuando te lo pida, o usa una API key en una variable de entorno.
• Shift+Enter envía el mensaje dentro de tmux: tmux puede confundir las teclas modificadas con un Enter normal. Activa las teclas extendidas como explica la página oficial sobre tmux.

Las herramientas de Pi se ejecutan con los permisos del proceso de Pi, y Pi no te pide confirmación antes de cada una. Para repositorios que no sean de confianza o trabajo desatendido, ejecútalo en un contenedor u otro sandbox.

Varias sesiones de Pi en Linux

Cuando Pi ya funciona, el siguiente límite es el tiempo: un terminal solo hace una tarea a la vez. Abrir más pestañas o paneles de tmux ayuda hasta que pierdes la pista de qué sesión ha terminado, cuál te necesita y qué ha cambiado cada una.

CodeAgentSwarm es una app de escritorio gratuita pensada para eso, y ya funciona en Linux como .deb (Ubuntu, Debian y derivadas) o como AppImage (Fedora y la mayoría de las demás distros), para x64 y ARM64. Pone varios terminales de Pi en paralelo, con notificaciones de escritorio cuando un agente termina o necesita tu respuesta, historial buscable de todas las sesiones y un diff en tiempo real de lo que ha cambiado cada terminal. Puedes combinar Pi con Claude Code, Codex y otros agentes en la misma ventana.

En Linux, CodeAgentSwarm instala Pi con su propio Node incluido en x64 y ARM64, usando el mismo paquete oficial: npm install -g --ignore-scripts @earendil-works/pi-coding-agent. Las credenciales siguen saliendo del /login de Pi.

Siguientes pasos: cómo usar Pi coding agent para tu primera tarea real, y modelos y suscripciones de Pi para elegir proveedor.

Conclusión

En Linux, Pi se instala con un solo comando del instalador oficial o con npm. Comprueba tu versión de Node, ejecuta /login y pega la URL de redirección cuando trabajes por SSH. Cuando un solo terminal ya no te baste, CodeAgentSwarm ejecuta varias sesiones de Pi a la vez.