Cómo usar Cline — separar los modelos entre Plan y Act y calcular el coste de una tarea

Cline es un agente de programación de IA de código abierto que funciona en editores como VS Code. Su uso tiene 3 pasos: instalar la extensión, configurar el proveedor de API y la clave (Cline no incluye modelos), y planificar en el modo Plan antes de ejecutar en el modo Act. El coste lo determinan los modelos asignados a Plan y Act. Si activas «Use different models for Plan and Act» en la configuración y asignas claude-opus-5 a Plan y claude-haiku-4-5 a Act con la misma clave, una tarea de 20 pasos baja de aproximadamente $2.17 usando Opus 5 en todo a aproximadamente $0.69 (calculado con las tarifas de Kunavo).

Muchos artículos explicativos en japonés terminan después de la instalación y la primera solicitud, y dejan fijado un modelo gratuito o un único modelo de pago. Esta página llega al siguiente paso: configurar modelos distintos para Plan y Act y calcular el coste de una tarea, todo con una sola clave.

Qué es Cline: los dos modos Plan y Act

Cline es un agente que lee archivos, propone diferencias, ejecuta comandos en el terminal, lee los resultados y vuelve a corregir en un ciclo. Tiene dos modos y la documentación oficial de Cline los distingue de la siguiente manera.

• Modo Plan: lee y busca en el código y consulta el enfoque. No puede modificar archivos ni ejecutar comandos.
• Modo Act: conserva el contexto de la conversación de Plan, modifica archivos y ejecuta comandos.

Esta división se convierte directamente en una división de costes. Plan implica menos intercambios, y la calidad de sus decisiones determina los siguientes diez o más pasos. Act implica más intercambios y reenvía el contexto de la tarea cada vez, por lo que se acumula el precio por token. Usa un modelo potente para Plan y uno barato para Act; la propia documentación de Cline propone combinar un modelo con gran capacidad de razonamiento para la planificación y uno rápido para la implementación.

Instalación y configuración inicial

1. En VS Code, abre la vista de extensiones (Ctrl / Cmd + Shift + X), busca «Cline» e instálalo. También funciona en Cursor, Windsurf y los IDE de JetBrains.
2. Abre Cline en la barra lateral y, en la configuración (⚙︎), selecciona «OpenAI Compatible» en API Provider.
3. Introduce Base URL, API Key y Model ID, y completa los campos de Model Configuration (longitud de contexto, salida máxima, compatibilidad con imágenes y precios de entrada y salida).

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1   # /v1 まで入れる
API Key        sk-kn-...                    # /app/keys で発行（表示は一度きり）
Model ID       claude-opus-5

Introduce Base URL hasta /v1.Cline añadirá la ruta después de esa dirección, por lo que si falta /v1 obtendrás un 404. Si recibes un 401, la URL es correcta y la clave es distinta. Antes de confiarle ediciones, comprueba la conexión con una solicitud pequeña como «explica este archivo». Crea la clave en /app/keys y guárdala en ese momento, ya que solo se muestra una vez.

Input Price / Output Price en Model Configuration son la base del cálculo del coste que Cline muestra durante una tarea. No se obtienen automáticamente del endpoint, por lo que si los dejas vacíos o con los valores predeterminados, el coste mostrado será incorrecto. Introduce el precio por 1M de tokens del modelo que utilices. La lista de campos de configuración está en la documentación de integración de Cline.

Separar los modelos de Plan y Act

Al marcar «Use different models for Plan and Act» en la configuración, puedes elegir modelos distintos para Plan y Act. La Base URL y la clave son las mismas en ambos; solo cambian el Model ID y las tarifas.

[✓] Use different models for Plan and Act

── Plan Mode ─────────────────────────────
API Provider       OpenAI Compatible
Base URL           https://api.kunavo.com/v1
API Key            sk-kn-...
Model ID           claude-opus-5
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on
  Input Price        3.50      # 1M トークンあたり USD
  Output Price       17.50

── Act Mode ──────────────────────────────
API Provider       OpenAI Compatible
Base URL           https://api.kunavo.com/v1
API Key            sk-kn-...            # Plan と同じキーでよい
Model ID           claude-haiku-4-5
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on
  Input Price        0.70
  Output Price       3.50

El motivo para poner Opus 5 en Plan es sencillo. Plan representa una parte muy pequeña de los tokens totales, pero si el enfoque es incorrecto, los pasos de Act se desperdician por completo. Haiku 4.5 en Act tiene sentido porque, cuando el plan es concreto, el resto consiste en repetir ediciones y ejecuciones, y ahí el precio por token influye más.

Un paso con el Plan configurado en Sonnet 5 cuesta aproximadamente $0.0434, y con Opus 5, aproximadamente $0.11.Claude Sonnet 5 cuesta $1.40 / $7.00 por cada 1 M de tokens.

Si Act se atasca, sube Act a Opus 5 solo para esa tarea. Repetir el mismo error dos veces es una señal para cambiar. Intentar seguir adelante con Haiku y hacer crecer el número de pasos acaba costando más. Solo tienes que cambiar un Model ID en la configuración; la clave y el endpoint permanecen iguales.

Calcular el coste de una tarea

Cline reenvía en cada paso el prompt del sistema, el historial de la tarea y los archivos leídos, por lo que el coste depende del número de pasos, no del tiempo. Como en las demás páginas de precios de este sitio, calculamos un paso con 25.000 tokens de entrada y 1.200 de salida, y una tarea de 20 pasos (Plan 3 + Act 17).

Al separar Plan y Act, el coste es aproximadamente el 32% del de ejecutar todo con Opus 5, mientras la calidad de la planificación sigue siendo la de Opus 5. Usar Haiku en todo resulta aún más barato, pero teniendo en cuenta que los errores de planificación pueden provocar repeticiones, la diferencia de $0.26 es un precio bajo por el seguro de Plan. Este es todo el código necesario para verificar el cálculo.

# 1 タスクの費用を、ステップ数から出す。
# 単価は Kunavo の 1M トークンあたり USD (input, output)。
RATES = {
    "claude-opus-5":    (3.50, 17.50),
    "claude-haiku-4-5": (0.70, 3.50),
}

def step(model, inp=25_000, out=1_200):
    i, o = RATES[model]
    return inp / 1e6 * i + out / 1e6 * o

all_opus = 20 * step("claude-opus-5")
split = 3 * step("claude-opus-5") + 17 * step("claude-haiku-4-5")

print(round(all_opus, 2))   # -> 2.17  全部 Opus 5
print(round(split, 2))      # -> 0.69  Plan = Opus 5 / Act = Haiku 4.5

Cómo elegir los modelos

GPT-5.6 Sol se factura por toda la solicitud con el doble del precio de entrada y 1,5 veces el precio de salida cuando el prompt supera los 272K tokens. Si lo usas para Plan, es más seguro mantener Context Window por debajo de 272K. Para conocer mejor la diferencia entre Opus y Sonnet, consulta diferencias entre Claude Opus y Sonnet; las tarifas de todos los modelos Claude están reunidas en precios de Claude.

5 hábitos para reducir costes

1. No alargues una tarea: divídela y empieza una nueva. Como el historial completo se reenvía en cada paso, cada paso de una tarea larga cuesta más. Es el hábito más eficaz.
2. Si usas la caché de prompts, hazlo mediante el proveedor Anthropic. Establece API Provider en «Anthropic», marca «Use custom base URL» y especifica https://api.kunavo.com (no añadas /v1; el cliente añadirá /v1/messages). Las lecturas de caché de Claude cuestan el 10% del precio de entrada y las escrituras, 1,25 veces el precio de entrada. Consulta el funcionamiento en la documentación de la caché.
3. Escribe las reglas en .clinerules/. Es un archivo Markdown en la raíz del proyecto cuyas instrucciones se aplican a todas las conversaciones. Como se incluye en cada solicitud, debe ser breve y contener solo reglas (documentación de reglas de Cline).
4. Limita la aprobación automática a operaciones de lectura. Con Auto Approve puedes reducir las confirmaciones permitiendo lecturas de archivos y acciones similares. El modo YOLO, que aprueba todo automáticamente, debe usarse solo en entornos desechables, tal como advierte expresamente la propia documentación de Cline. Puedes deshacer los cambios mediante Checkpoints.
5. Crea una clave exclusiva para Cline y establece un límite mensual. En /app/keys puedes configurar por clave un límite mensual de uso (cuando se alcanza, devuelve 402) y una lista de IP permitidas. Si necesitas detener el editor, basta con desactivar esa clave.

Con franqueza: cuándo convienen una suscripción o un contrato directo

Si tienes Claude Pro / Max, también puedes elegir el proveedor «Claude Code» de Cline. Funciona mediante la CLI instalada de Claude Code y utiliza la cuota de la suscripción en lugar de facturar por tokens. Según la documentación de Cline, este método limita la carga de imágenes y la caché de prompts, y las respuestas quizá no se transmitan en streaming por token. Los límites de la cuota se comparten con el chat y Claude Code; consulta límites de Claude Pro para conocer el funcionamiento.

Si usas una clave de API, Kunavo funciona con capacidad compartida y no ofrece una cuota dedicada ni un SLA contractual. Los equipos que necesiten garantías deben contratar directamente con Anthropic. Para particulares o equipos pequeños que ejecuten Cline, la facturación por uso, que permite separar Plan y Act con una sola clave, suele ser adecuada.

Diferencias con el uso de Roo Code

Roo Code es una extensión derivada de Cline y permite usar directamente la configuración de OpenAI Compatible (Base URL, clave y modelo). La diferencia está en la estructura de modos: en lugar de Plan / Act, tiene modos como Architect, Code, Ask y Debug, y permite asignar un perfil de configuración de API a cada modo. Puedes aplicar directamente el mismo enfoque: Opus 5 para Architect y un modelo barato para Code. Encontrarás los pasos en la documentación de configuración de Roo Code y en Roo Code + Claude API (en inglés).

Para una explicación aún más detallada en inglés, consulta la guía de Cline + Claude API. Si quieres compararlo con agentes de terminal, consulta Cline y Claude Code: comparación y cómo usar Claude Code. Para las tarifas de todos los modelos, consulta la página de precios.

Preguntas frecuentes