Para usar Cline CLI, lo instalas con npm install -g cline, ejecutas cline auth para iniciar sesión o añadir una clave de proveedor, y luego ejecutas cline dentro de un proyecto y describes la tarea. A diferencia de la mayoría de las CLI de programación, Cline aprueba sus propias llamadas a herramientas por defecto, así que pasa --auto-approve false en cualquier repositorio que te importe.
Esta guía cubre Cline CLI 3.0 a noviembre de 2026 (versión 3.0.74): instalación, inicio de sesión, Plan y Act, aprobaciones, ejecuciones sin interfaz con --json, sesiones, modelos, reglas, MCP y lo que cuesta.
Qué es Cline CLI
Cline nació como extensión de VS Code y es uno de los agentes de programación abiertos más usados. Cline CLI lleva ese mismo agente a la terminal. La versión 3.0, publicada en mayo de 2026, fue una reescritura sobre el nuevo SDK de Cline con una interfaz de terminal nueva, así que las guías escritas para la CLI 2.x están desactualizadas.
Cline no está atado a ningún modelo. Puedes usar una cuenta de Cline con créditos, una suscripción a ClinePass o tu propia clave para Anthropic, OpenAI, Gemini, OpenRouter, Bedrock, Vertex, DeepSeek, un modelo local a través de Ollama o LM Studio, y más de treinta proveedores más.
Paso 1: instalar la CLI
npm install -g cline
Es el único método de instalación oficial. Hay binarios precompilados para macOS, Linux y Windows, tanto en arm64 como en x64; usa Node 22 para ir sobre seguro, porque la documentación y el paquete no coinciden en la versión mínima. Para actualizar más adelante, cline update. Si quieres la compilación más reciente, npm install -g cline@nightly instala el canal nightly.
Paso 2: iniciar sesión o añadir una clave
cline auth
Esto abre una configuración interactiva. cline auth cline inicia sesión en una cuenta de Cline desde el navegador. Para fijar un proveedor sin preguntas, por ejemplo en un servidor:
cline auth -p anthropic -k "$ANTHROPIC_API_KEY" -m claude-sonnet-5-5
Cline también lee claves del entorno (ANTHROPIC_API_KEY, OPENAI_API_KEY, OPENROUTER_API_KEY, CLINE_API_KEY y otras). Las credenciales guardadas van a ~/.cline/data/settings/providers.json.
Paso 3: trabajar en la vista interactiva
cd my-project
cline
Describe la tarea con tus palabras, o arranca directamente con una: cline -i "add tests for the price formatter". Teclas y comandos útiles:
Tabalterna entre Plan y Act. El modo Plan lee y discute pero no puede editar archivos; el modo Act, el predeterminado, aplica los cambios.cline -parranca en Plan.Shift+Tabactiva o desactiva la aprobación automática.@fileañade un archivo (o una imagen) al mensaje./modely/settingscambian la configuración;/mcpgestiona los servidores;/compactacorta una conversación larga;/undorevierte el último cambio;/historyabre sesiones anteriores.Ctrl+Cdetiene el turno actual; púlsalo dos veces, oCtrl+D, para salir.
Un buen hábito para tareas grandes: empieza en Plan, acuerda los pasos con Cline y luego cambia a Act.
Paso 4: decidir cuánto puede hacer Cline por su cuenta
Este es el ajuste que más sorprende. En Cline CLI:
| Situación | Qué ocurre |
|---|---|
cline (interactivo) | --auto-approve está activado salvo que lo desactives |
cline --auto-approve false | Pregunta Approve tool …? [y/N] antes de cada herramienta |
cline "task" (una sola tarea) o entrada por pipe | Se ejecuta en modo yolo |
cline -y | Modo yolo; la propia ayuda de Cline lo califica de peligroso fuera de un sandbox |
No hay lista de permitidos o denegados para comandos de shell. Para bloquear un comando, añade un hook PreToolUse (paso 7). En un repositorio real, empieza con --auto-approve false o trabaja en una rama limpia para poder descartar cualquier cambio con facilidad.
Paso 5: ejecuciones sin interfaz y CI
Cline funciona sin la vista interactiva cuando pasas --json, le envías algo por pipe o rediriges su salida:
git diff | cline "review this diff for bugs"
cline --json "summarize the changes on this branch" | jq -r 'select(.type=="run_result") | .text'
--json imprime un evento JSON por línea y termina con un run_result que contiene el texto final, el motivo de finalización y el uso de tokens. Otros flags que conviene conocer: -c fija la carpeta de trabajo, --worktree ejecuta en un git worktree, -t pone un tiempo límite en segundos y --data-dir guarda el estado en una carpeta aislada.
En CI, instala con npm, ejecuta cline auth con una clave del almacén de secretos y luego lanza la tarea. Recuerda que las ejecuciones de una sola tarea lo aprueban todo, así que da al job solo los permisos que necesita.
Paso 6: sesiones y modelos
cline history muestra las sesiones anteriores en un selector donde puedes retomarlas o borrarlas. Para reabrir una directamente:
cline history --json --limit 10
cline --id <session-id>
Las sesiones se guardan en ~/.cline/data/sessions/. cline history export <session-id> -o session.html guarda una como página.
Para elegir modelo en una sola ejecución, usa -P para el proveedor y -m para el modelo; --thinking acepta none, low, medium, high o xhigh. En la vista interactiva, usa /model. Con una cuenta de Cline y sin modelo elegido, el predeterminado es Claude Sonnet 5.5 desde la versión 3.0.73.
Paso 7: reglas, hooks y servidores MCP
Reglas. Pon las reglas del proyecto en .clinerules/ o .cline/rules/, y las globales en ~/.cline/rules. Cline también lee AGENTS.md en la raíz del proyecto, así que un archivo que ya mantienes para Codex u otros agentes funciona tal cual. Nuestra guía sobre CLAUDE.md y AGENTS.md explica qué poner en él.
Skills y hooks. Los skills viven en .cline/skills/ o .agents/skills/ y se ejecutan como /skill-name; cline skill add <owner/repo> instala uno. Los hooks son scripts ejecutables con el nombre del evento, como .cline/hooks/PreToolUse.sh, y son la forma de bloquear comandos arriesgados.
MCP. Añade servidores desde la línea de comandos:
cline mcp add memory --yes -- npx -y @modelcontextprotocol/server-memory
cline mcp add docs https://example.com/mcp --transport http --yes
Se guardan en mcpServers dentro de ~/.cline/data/settings/cline_mcp_settings.json. cline mcp abre un menú y cline mcp remove <name> elimina uno.
Lo que cuesta Cline CLI (a noviembre de 2026)
| Opción | Precio | Notas |
|---|---|---|
| Cline CLI | Gratis | La herramienta en sí |
| Créditos de Cline | Pago por uso | Se compran en app.cline.bot; algunos modelos gratuitos con una cuota pequeña |
| ClinePass | 9,99 $/mes | Límites más altos en modelos abiertos seleccionados |
| Tu propia clave | El precio de tu proveedor | Anthropic, OpenAI, OpenRouter, modelos locales y más |
| Enterprise | A medida | SSO, SLA, acceso por roles, facturación centralizada |
Consulta la página de precios de Cline antes de decidir.
Errores habituales
- Aprobación automática activada por defecto. Desactívala con
--auto-approve falsehasta que confíes en la configuración. - Seguir guías de la 2.x. La reescritura 3.0 cambió comandos y flags. Si tienes dudas, ejecuta
cline --helpen tu versión; algunos flags, como-y, no aparecen en la referencia online. - OAuth sin interfaz. Los proveedores OAuth nunca abren un navegador en ejecuciones sin interfaz. Ejecuta antes
cline auth <provider>una vez en esa máquina. - Procesos en segundo plano atascados.
cline doctorrevisa la configuración ycline doctor fixdetiene los procesos colgados. .clineignoreva de salida. Usa un hookPreToolUsepara mantener a Cline lejos de ciertos archivos.
Ejecutar Cline CLI junto a otras CLI en AgentVera
Si Cline es el único agente que usas, puede que su propia interfaz te baste. La cosa se complica cuando Cline trabaja junto a Claude Code, Codex o Gemini CLI en el mismo proyecto. AgentVera es una app de escritorio que ejecuta estas CLI lado a lado en terminales reales, con tus propias instalaciones y claves. El soporte de Cline funciona así:
- Una sesión por agente. AgentVera encuentra la sesión que crea Cline mediante
cline history --jsony la reabre concline --id <id>en los siguientes arranques, así que la conversación sobrevive a un reinicio de la app. - Modelo y esfuerzo. El modelo que eliges se pasa con
--modely el nivel de esfuerzo con--thinking. - Una cuenta por agente. En Ajustes → Cuentas puedes añadir claves de Anthropic, OpenAI u OpenRouter; cada cuenta de Cline recibe su propio archivo de proveedores y todo lo demás se comparte.
- MCP y tokens. Los servidores del gestor de MCP de AgentVera llegan a Cline a través de su archivo de ajustes MCP, y AgentVera lee el uso de tokens de Cline para los presupuestos de tokens.
- Paneles y revisión. Ejecuta Cline en la cuadrícula del workspace junto a otros agentes y comprueba sus cambios con la revisión de código.
El plan gratuito ejecuta 2 agentes a la vez e incluye MCP, Git, Docker, SSH, revisión de código y ahorro de tokens. Pro cuesta 9,99 $ al mes y no tiene límite de agentes; si nunca has tenido una prueba, tu primer inicio de sesión en la app activa Pro durante 7 días sin tarjeta. Para probarlo, descarga AgentVera.
Conclusión
Para empezar con Cline CLI bastan tres comandos: npm install -g cline, cline auth y cline. Las decisiones importantes vienen justo después: desactiva la aprobación automática en trabajo real, planifica antes de actuar en tareas grandes, mantén las reglas del proyecto en AGENTS.md o .clinerules/ y da a las ejecuciones de CI de una sola tarea solo el acceso que necesitan.
Fuentes: referencia de Cline CLI, visión general de la CLI, autorización, reglas de Cline, MCP, changelog de la CLI.