Elegir un entorno de agentes de código en Linux, macOS o Windows
- Publicado el
Elige el instalador de Paneflow para el sistema y la CPU que ejecutarán la aplicación, e instala después los agentes en el shell donde vive el proyecto. Una aplicación de terminal compatible no hace compatible cualquier combinación de agente, runtime y shell.
Matriz de instalación de Paneflow 0.17.4
Estos archivos se comprobaron en la versión 0.17.4 el 1 de octubre de 2026. Su disponibilidad no equivale a una prueba de instalación en cada máquina. Paneflow es software libre y gratuito bajo GPL-3.0-or-later.
| Sistema | CPU | Referencia de instalación | Requisitos de ejecución |
|---|---|---|---|
| Linux | x86_64 o ARM64 (aarch64) | Linux: AppImage, .deb, .rpm, .tar.gz | Controlador y cargador Vulkan funcionales; siguen aplicándose las dependencias del paquete o instalación independiente. |
| macOS 13+ | Apple Silicon (aarch64) | macOS: .dmg o Homebrew | Compilación Apple Silicon, no binario Intel. |
| Windows 10 1809+ o Windows 11 | x64 (x86_64) | Windows: .msi | Controlador GPU funcional, DirectX 11 nivel de características 10+, runtime de terminal ConPTY. |
| macOS Intel | x86_64 | Sin archivo nativo en esta versión | El DMG Apple Silicon no es un instalador compatible. |
| Windows ARM | ARM64 | Sin archivo nativo en esta versión | El MSI x64 no es una instalación ARM verificada. |
La matriz se apoya en los destinos de compilación, las dependencias Linux y la referencia Windows de la versión. El espejo Windows conserva un ejemplo de instalador antiguo; usa la página actual para los nombres de archivo. Una AppImage incluye la aplicación, no un controlador GPU que falte.
Comprueba el agente en el shell elegido
| Agente | Comprobado para esta guía | Documentación oficial |
|---|---|---|
| Claude Code | Windows x64: claude --version muestra 2.1.286; claude --help confirma el inicio interactivo | Instalación documenta macOS, Linux, Windows nativo y WSL. Git for Windows habilita Bash; sin él, la documentación actual describe la herramienta PowerShell. No admite sandbox en Windows nativo según esa documentación. |
| Codex CLI | Windows x64: codex --version muestra 0.159.2; codex --help confirma el inicio interactivo | CLI y sandbox Windows documentan Windows nativo y macOS/Linux. Windows 11 es lo recomendado; Windows 10 actualizado tiene soporte de mejor esfuerzo. La sandbox nativa puede depender de cambios aprobados por un administrador y políticas del equipo. |
Fuentes consultadas el 1 de octubre de 2026. Las comprobaciones de versión y ayuda no certifican autenticación, ejecución de modelos, sandbox, todos los shells, Linux ni macOS. No se probaron otros agentes para esta guía. Separa los permisos y requisitos de cada agente de la matriz Paneflow.
¿Windows nativo o WSL?
Para repositorios y herramientas Windows, inicia la aplicación instalada por MSI desde Inicio o un shell Windows nativo. Elige el shell en Settings y verifica el PATH del agente. Instalarlo en WSL no lo instala en PowerShell, ni al revés.
Si la cadena de herramientas Linux ya vive en WSL2, mantén repositorio, dependencias y agentes allí. La referencia Windows describe la compilación Linux dentro de WSL2 con WSLg; siguen vigentes los requisitos gráficos. Un shell WSL en un panel Paneflow nativo no es lo mismo que ejecutar la aplicación Linux. No inicies la aplicación Windows nativa desde un shell anfitrión WSL. Esta guía no ejecutó ninguna de las dos configuraciones WSL.
La guía WSL de Codex ofrece esa vía para herramientas Linux o necesidades que la sandbox nativa no cubre. No implica que todos los agentes requieran WSL en Windows. Las capacidades de sandbox de Claude Code también difieren entre ambos entornos; sigue su referencia sin suponer que el terminal proporciona ese aislamiento.
Diagnostica la capa que falla
- Comprueba sistema y CPU en la información del equipo. En macOS Intel o Windows ARM, el límite es la ausencia de un archivo nativo; consulta la referencia de instalación en lugar de adivinar un instalador.
- Si Paneflow no abre una ventana, revisa los requisitos GPU/runtime de la plataforma y la resolución de problemas. Cambiar de agente no arregla un controlador gráfico ausente.
- Si abre la aplicación pero no aparece
claudeocodex, ejecuta su comando de versión en ese panel exacto. Comprueba PATH y si lo instalaste en Windows nativo o WSL, siguiendo las instrucciones del agente. - Si la CLI inicia pero falla al autenticarse o ejecutar una tarea de modelo, revisa credenciales, permisos, red y acceso al proveedor. Reinstalar Paneflow no establece esos requisitos.
Cuando aplicación y agente funcionen en el entorno elegido, consulta la referencia de worktrees para separar cambios paralelos. Conserva los detalles de instalación en la referencia de plataforma, sin duplicar procedimientos para cada distribución o agente.