Cline CLI en Windows y Linux: instalación, Node.js y rutas

Por CodeAgentSwarm · Actualizado el 31 de octubre de 2026

Cline CLI es un paquete de npm con binarios nativos para Windows y Linux en x64 y ARM64, así que en los dos sistemas se instala con el mismo comando. Lo que cambia es cómo está montado Node.js y npm en cada uno. Esta guía cubre los dos, más los problemas de PATH y de permisos que más se repiten. Los datos de Cline se comprobaron en su documentación oficial y en el registro de npm el 31 de octubre de 2026.

Qué necesitas

Cline
SistemaBinario nativo dentro del paquete de npm
Windows x64@cline/cli-windows-x64
Windows ARM64@cline/cli-windows-arm64
Linux x64@cline/cli-linux-x64
Linux ARM64@cline/cli-linux-arm64
Dependencias opcionales del paquete cline 3.0.74 en el registro de npm, consultado el 31 de octubre de 2026. npm solo instala la que corresponde a tu equipo.

Para instalarlo necesitas Node.js y npm. La documentación de instalación de Cline pide Node.js 20 o posterior y recomienda la 22. Comprueba qué versión tienes con node --version.

Instalar Cline CLI en Windows

powershell
node --version
npm install -g cline
cline version

Ejecútalo en PowerShell o en Windows Terminal. npm deja un lanzador cline.cmd en %APPDATA%\npm, carpeta que el instalador de Node.js añade al PATH. Si justo después de instalar no encuentra cline, abre una terminal nueva para que lea el PATH actualizado.

Cline guarda su configuración en la carpeta .cline de tu perfil de usuario. Las reglas globales también pueden ir en Documents\Cline\Rules, y Cline mira además la carpeta Documentos de OneDrive cuando Windows la redirige allí.

Instalar Cline CLI en Linux

bash
node --version
npm install -g cline
cline version

Si npm install -g falla con EACCES, tu carpeta global de npm pertenece a root. No lo arregles con sudo; apunta npm a una carpeta tuya:

bash
npm config set prefix ~/.npm-global
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
npm install -g cline

Un gestor de versiones de Node como nvm también evita el problema, porque instala Node en tu carpeta personal. En un servidor o por SSH, inicia sesión con cline auth y una clave de API de tu proveedor.

Cuando un editor o una app no encuentra cline

Las apps que lanzan Cline como servidor Agent Client Protocol no siempre heredan el PATH de tu shell. La documentación de ACP de Cline recomienda usar en ese caso la ruta absoluta que da which cline (o where cline en Windows).

CodeAgentSwarm busca solo en los sitios habituales: el PATH, la carpeta global de npm (%APPDATA%\npm en Windows, ~/.local/bin y /usr/local/bin en Linux) y el Node que gestiona la propia app.

Deja que CodeAgentSwarm lo instale

Cline seleccionado en el selector de agentes de CodeAgentSwarm
Captura real de la demo de la versión 2.5.0 de CodeAgentSwarm. Si eliges un agente que no está instalado, se abre su instalador.

En CodeAgentSwarm 2.5.0, donde Cline está en beta, elige Cline en el selector de agentes o pulsa Install en Settings > Providers. En Windows y Linux la app puede descargar su propio Node.js si el tuyo falta o es anterior a la 22.19, instala el paquete oficial cline con el binario de tu equipo y lo comprueba con cline --version.

Durante el desarrollo de la 2.5.0 el instalador se probó en Windows ARM64 y Linux ARM64. Si ves algo raro en un equipo x64, cuéntanoslo desde Settings > Feedback.

Siguientes pasos: conecta un proveedor y aprende las opciones del día a día o ejecuta varias sesiones de Cline en paralelo. ¿Usas más agentes en Linux? Mira GitHub Copilot CLI en Linux.

Preguntas frecuentes

¿Cline CLI funciona en Windows?

Sí. El paquete de npm incluye binarios nativos de Windows para x64 y ARM64. Instálalo con npm install -g cline desde PowerShell o Windows Terminal.

¿Cline CLI funciona en Linux ARM64?

Sí. El paquete trae un binario para Linux ARM64, y npm lo elige solo en equipos ARM64.

¿Qué versión de Node.js necesita Cline CLI?

La documentación de instalación de Cline pide Node.js 20 o posterior y recomienda la 22. CodeAgentSwarm usa Node.js 22.19 o posterior cuando instala Cline.

¿Cómo actualizo Cline CLI?

Ejecuta cline update, o vuelve a lanzar npm install -g cline. Usa cline@nightly si quieres la versión nightly.

¿Por qué npm install -g cline falla con EACCES en Linux?

Tu carpeta global de npm pertenece a root. Fija un prefijo de usuario con npm config set prefix ~/.npm-global y añade su carpeta bin al PATH, o usa un gestor de versiones de Node como nvm.