Cline: guía práctica del agente de IA en el editor y la terminal

Cline es un agente de código en el editor y la terminal: lee y escribe archivos, corre comandos, usa el navegador y pide tu aprobación antes de actuar. El núcleo es el mismo en VS Code, JetBrains, CLI y SDK. Cada acción requiere aprobación salvo que aflojes Auto Approve o actives YOLO.

Esta guía cubre el flujo de la serie de agentes del hub Construir agentes: instalar, autenticar, Plan vs Act, checkpoints, CLI headless y reglas persistentes. Si ya usas un CLI puro, contrástalo con OpenCode, Aider o Kimi Code CLI. Las reglas del repo van en AGENTS.md; Cline también las lee.

Qué es Cline (y qué no)

Cline no es un chat al lado del código. Es un agente con tools: archivos, terminal, browser y MCP. El overview oficial lo resume así: read files, write code, run commands, all with your approval.

Cuatro superficies sobre el mismo núcleo:

Superficie	Cómo se instala	Para qué
Extensión IDE	Marketplace de VS Code / Open VSX / JetBrains	Trabajo diario con diffs y aprobación en el panel
CLI	npm i -g cline (Node 20+, 22 recomendado)	TUI, una tarea, CI y pipes
Kanban (preview)	npx kanban	Varios agentes en paralelo con worktrees por tarjeta
SDK	npm install @cline/sdk	Empaquetar el mismo runtime en tu app

También corre en Cursor, Windsurf, VSCodium, Antigravity y, vía ACP, en Zed o Neovim. Esta guía no es la de Cursor ni la de un CLI de un solo vendor: Cline es agnóstico de modelo.

Instalación: elige una superficie

Extensión (VS Code, Cursor, Windsurf, VSCodium, Antigravity)

1. Ctrl/Cmd + Shift + X, busca Cline, instala.
2. Abre el panel de Cline en la barra lateral.
3. Autoriza un proveedor (abajo).

Windsurf y VSCodium usan Open VSX. En JetBrains: Settings → Plugins → Marketplace, instala, reinicia y ábrelo en View → Tool Windows → Cline (plugin 28247). En VS Code el id histórico es saoudrizwan.claude-dev.

CLI

npm install -g cline
cline auth
cline
# o una tarea:
cline "resume qué hace este módulo"

cline doctor diagnostica config rota. cline --version confirma el binario.

Kanban y SDK son caminos aparte: tablero con worktrees, o runtime embebido. No los mezcles con el primer día.

Autenticación: tres caminos de modelo

Cline no te ata a un lab. Eliges el acceso:

1. Cline (usage-billing): un login, cobro por uso y modelos free temporales. El camino más corto.
2. ClinePass: suscripción opcional de USD 9.99/mes (docs oficiales, 2026-09-07) con 2–5× de uso en modelos open de coding frente a la tarifa API estándar. Es un provider aparte: en la extensión lo eliges como API Provider; en el CLI, /settings. El catálogo oficial incluye slugs cline-pass/... (GLM, Kimi, DeepSeek, Qwen, MiniMax, MiMo).
3. Bring Your Own Key: Anthropic, OpenAI/Codex, Gemini, OpenRouter, Bedrock, Vertex, compatibles OpenAI u Ollama/LM Studio en local.

cline auth configura proveedor y modelo. -P / -m los pisan en una corrida. No pongas la API key en el prompt; el CLI acepta -k para un override puntual, no para documentar secretos.

Plan vs Act: pensar y luego tocar

El dual-mode es el hábito que más ahorra tokens y reverts. En Plan, Cline lee, busca y discute; no modifica archivos ni ejecuta comandos. En Act conserva el hilo y ya puede escribir y correr.

Flujo típico: Plan → explorar → acordar enfoque → Act → implementar. Si aparece complejidad inesperada, vuelve a Plan; no empujes a ciegas.

Escenario	Modo
Feature con enfoque poco claro, debug, arquitectura, review, codebase nuevo	Plan
Solución ya planeada, cambio rutinario, tests y ajustes, fix obvio	Act

Tareas chicas: Act directo. Medianas: Plan → Act. Grandes: /deep-planning. Puedes usar un modelo distinto por modo (razonador en Plan, rápido en Act). En CLI: cline -p "diseña la migración" vs cline "aplica la migración". Mismo criterio que plan vs agent mode.

Checkpoints: el safety net del Act

Cada tool use (edit o comando) guarda un snapshot en un shadow git aparte del historial de tu repo. Tu git log sigue limpio; los checkpoints cubren incluso untracked. Tras cada paso ves Compare (diff) y Restore:

Restore	Efecto	Cuándo
Files	Revierte disco, deja el chat	El código rompió, la conversación sirve
Task only	Recorta mensajes, no toca disco	El código está bien, el hilo se desvió
Files & Task	Ambos	Empezar de un estado conocido

Actívalos (vienen on). En repos enormes el shadow git pesa: si nota lentitud, apágalos. No sustituyen a una rama: para experimentos paralelos usa worktrees.

Auto Approve, YOLO y el default del CLI

En el IDE, Auto Approve es por categoría: leer proyecto, editar proyecto, comandos “safe”, browser, MCP. “Read/Edit all files” y “Execute all commands” solo extienden el toggle base; si el base está off, no hacen nada. Default sano: solo Read project files. Si aflojas edits, deja checkpoints on.

YOLO auto-aprueba todo, incluido el salto Plan→Act. Docs: dangerous. Solo sandbox o demos.

En el CLI el default es distinto y fácil de pasar por alto: --auto-approve vale true (en ACP, false). Una tarea cline "run tests and fix failures" puede escribir y ejecutar sin más prompts. Para supervisión humana: --auto-approve false. Para desatendido, el flag explícito y una rama limpia:

cline --auto-approve true "run tests and fix failures"

Restringe shell con CLINE_COMMAND_PERMISSIONS (allow npm * / git *, deny rm -rf * / sudo *). Headless se activa con --json, stdin pipe o stdout redirigido:

git diff | cline "review these changes"
cline --json "list TODO comments"
cline --timeout 600 "run full test suite"

--thinking (none|low|medium|high|xhigh, default medium) y --retries recortan vueltas inútiles. cline history retoma; --id reabre.

Reglas, skills y MCP

No repitas el estilo del repo en cada chat. Cline junta:

Tipo	Dónde
Cline Rules	.clinerules/*.md o *.txt en el proyecto
Cursor / Windsurf	.cursorrules / .windsurfrules (detectados)
AGENTS.md	raíz del repo y ~/.agents/AGENTS.md

Workspace gana a global. Globales: ~/Documents/Cline/Rules (Linux a veces ~/Cline/Rules). Skills = paquetes por tarea; MCP con cline mcp. .clineignore está deprecado.

Checklist antes de soltarlo en el repo

• Extensión o cline --version + cline doctor en verde.
• Proveedor autenticado; ClinePass o BYOK elegido a propósito, no por default ciego.
• Tareas no obvias empiezan en Plan (-p o el toggle); Act solo con plan o ticket trivial.
• Checkpoints on; Restore Files vs Task lo tienes claro.
• IDE: Auto Approve mínimo (read). CLI: sabes que --auto-approve default es true; en código vivo usa false.
• YOLO off salvo sandbox. Sin rm -rf ni sudo en allow.
• .clinerules/ o AGENTS.md versionados. Trabajo paralelo en worktrees, no en main.
• Diff y tests los revisas tú; el agente reporta, no firma el merge.

Si estás armando tu primer agente, el curso de instalar un agente cubre el loop; Cline es la superficie sobre un repo real.

FAQ

¿Cline es solo para VS Code? No. Extensión en VS Code/Cursor/Windsurf/VSCodium/Antigravity, plugin JetBrains, CLI, Kanban, SDK y ACP para Zed/Neovim.

¿Necesito pagar ClinePass? No. Es opcional (USD 9.99/mes). Puedes ir usage-billing o BYOK. ClinePass es un provider aparte, no reemplaza al billing por uso.

¿El CLI pide confirmación como el IDE? No por defecto. --auto-approve es true salvo ACP. En repos que te importan, pásalo a false.

¿Checkpoints ensucian git? No. Viven en un shadow repo. Tu historial lo controlas tú.

¿Puedo usarlo en CI? Sí: cline --json, pipes y --timeout. Aísla --data-dir, restringe CLINE_COMMAND_PERMISSIONS y no dejes YOLO ni auto-approve amplio sobre secretos.

¿Compite con Aider u OpenCode? Misma familia, distinta UX: Cline = Plan/Act + checkpoints en el editor; Aider commitea cada edit; OpenCode es TUI agnóstica.