# Cómo usar Cline CLI: guía paso a paso de Cline en la terminal

URL: https://agentvera.dev/es/blog/how-to-use-cline-cli/ · Publicado: 2026-11-15

Cómo usar Cline CLI: instalar con npm, entrar o usar tu propia clave, alternar Plan y Act, ejecutar sin interfaz con --json, retomar sesiones y añadir reglas y MCP.

**En resumen:**

- Instala con npm install -g cline, ejecuta cline auth para entrar en una cuenta de Cline o añadir tu propia clave de proveedor, y luego ejecuta cline en un proyecto y describe la tarea. Tab alterna entre Plan y Act.
- Las confirmaciones vienen desactivadas: --auto-approve es true, y las ejecuciones de una sola tarea o por pipe usan el modo yolo. Pasa --auto-approve false si quieres que Cline pregunte antes de cada herramienta.
- La CLI es gratis; pagas la inferencia con créditos de Cline, ClinePass (9,99 $ al mes a noviembre de 2026) o tus claves API. Las reglas van en .clinerules/ o AGENTS.md; los servidores MCP, en cline_mcp_settings.json.

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](https://cline.bot "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

```bash
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

```bash
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:

```bash
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

```bash
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:

- `Tab` alterna entre **Plan** y **Act**. El modo Plan lee y discute pero no puede editar archivos; el modo Act, el predeterminado, aplica los cambios. `cline -p` arranca en Plan.
- `Shift+Tab` activa o desactiva la aprobación automática.
- `@file` añade un archivo (o una imagen) al mensaje.
- `/model` y `/settings` cambian la configuración; `/mcp` gestiona los servidores; `/compact` acorta una conversación larga; `/undo` revierte el último cambio; `/history` abre sesiones anteriores.
- `Ctrl+C` detiene el turno actual; púlsalo dos veces, o `Ctrl+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:

```bash
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:

```bash
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](/es/blog/claude-md-agents-md/ "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:

```bash
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](https://cline.bot/pricing "Precios de Cline") antes de decidir.

## Errores habituales

- **Aprobación automática activada por defecto.** Desactívala con `--auto-approve false` hasta 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 --help` en 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 doctor` revisa la configuración y `cline doctor fix` detiene los procesos colgados.
- **`.clineignore` va de salida.** Usa un hook `PreToolUse` para 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/ "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](/es/agents/cline/ "Cline CLI en AgentVera") funciona así:

- **Una sesión por agente.** AgentVera encuentra la sesión que crea Cline mediante `cline history --json` y la reabre con `cline --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 `--model` y 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](/es/features/mcp-manager/ "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](/es/features/token-budgets/ "Presupuestos de tokens").
- **Paneles y revisión.** Ejecuta Cline en la cuadrícula del [workspace](/es/features/workspace/ "Workspace") junto a otros agentes y comprueba sus cambios con la [revisión de código](/es/features/code-review/ "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](/es/download/ "Descargar 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](https://docs.cline.bot/cli/cli-reference "Referencia de Cline CLI"), [visión general de la CLI](https://docs.cline.bot/usage/cli-overview "Visión general de Cline CLI"), [autorización](https://docs.cline.bot/getting-started/authorizing-with-cline "Autorización con Cline"), [reglas de Cline](https://docs.cline.bot/customization/cline-rules "Reglas de Cline"), [MCP](https://docs.cline.bot/mcp/mcp-overview "Cline MCP"), [changelog de la CLI](https://github.com/cline/cline/blob/main/apps/cli/CHANGELOG.md "Changelog de Cline CLI").

## Preguntas frecuentes

**¿Cline CLI es gratis?** La CLI en sí no cuesta nada. Lo que pagas es el modelo: créditos de Cline comprados en app.cline.bot, una suscripción a ClinePass (9,99 $ al mes a noviembre de 2026, para modelos abiertos seleccionados) o tu propia clave de API de Anthropic, OpenAI, OpenRouter y muchos otros proveedores. Algunos modelos gratuitos incluyen una cuota pequeña.

**¿Cline CLI pregunta antes de editar archivos?** No por defecto. --auto-approve vale true, y una ejecución de una sola tarea como cline "task" funciona en modo yolo. Arranca con --auto-approve false para recibir una pregunta de sí o no por cada herramienta, o activa y desactiva la aprobación automática con Shift+Tab en la vista interactiva.

**¿Cómo retomo una sesión de Cline CLI?** Ejecuta cline history para elegir una sesión anterior de una lista, o cline --id <session-id> para reabrirla directamente. cline history --json lista las sesiones con sus ids, algo muy útil en scripts.

**¿Cline CLI lee AGENTS.md?** Sí. Además de sus propias carpetas de reglas (.clinerules/ o .cline/rules/ en el proyecto, ~/.cline/rules a nivel global), Cline lee AGENTS.md en la raíz del proyecto, y también .cursorrules y .windsurfrules.

**¿Puedo usar mi suscripción de Claude Code o ChatGPT con Cline CLI?** Entre sus proveedores, Cline incluye un proveedor de Claude Code y un inicio de sesión con ChatGPT (openai-codex). Revisa los términos del propio proveedor antes de usar una suscripción a través de otra herramienta.

---

**Sobre AgentVera.** AgentVera es una app de escritorio para macOS, Windows y Linux, desarrollada por Solviera Teknoloji. Ejecuta 18 agentes de programación con IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) en paralelo, por proyecto, en terminales reales con las instalaciones y sesiones de CLI del propio usuario. El plan gratuito ejecuta 2 agentes a la vez. Descargar: https://agentvera.dev/es/download/ · Precios: https://agentvera.dev/es/pricing/