Cline 使用方法——为 Plan 和 Act 分配不同模型，并计算单个任务的成本

Cline 是一个在 VS Code 等编辑器中运行的开源 AI 编码代理。使用分为 3 个阶段——安装扩展、设置 API 提供商和密钥（Cline 本身不包含模型）、在 Plan 模式中制定计划，然后在 Act 模式中执行。费用取决于分配给 Plan 和 Act 的模型：启用设置中的“Use different models for Plan and Act”，用同一个密钥将claude-opus-5分配给 Plan、将claude-haiku-4-5分配给 Act，20 步任务的费用就会从全部使用 Opus 5 时的约$2.17降至约$0.69（按 Kunavo 费率计算）。

许多日语说明文章只介绍安装和首次请求，并一直固定使用免费模型或一个付费模型。本页面进一步介绍——为 Plan 和 Act 分配不同模型的设置以及计算单个任务的费用——并通过一个密钥完成整个流程。

Cline 是什么——Plan 和 Act 两种模式

Cline 会循环执行以下流程：读取文件、提出差异、在终端中运行命令、读取结果，然后再次修改。它有两种模式，Cline 官方文档将其区分如下。

• 计划模式：读取代码库、搜索并讨论方案。不能修改文件或执行命令。
• 执行模式：在保留计划模式对话上下文的同时，修改文件并执行命令。

这种划分也直接对应费用的划分。计划模式往返次数少，而这里的判断质量会影响后续十几个步骤。执行模式往返次数多，每次都会重新发送任务上下文，因此令牌单价会逐步累积。计划模式使用强模型，执行模式使用低价模型——Cline 文档本身也建议将推理能力强的模型用于规划，将速度快的模型用于实现。

安装与初始设置

1. 在 VS Code 中打开扩展视图（Ctrl / Cmd + Shift + X），搜索“Cline”并安装。Cursor、Windsurf、JetBrains IDE 等也支持安装。
2. 打开侧边栏中的 Cline，在设置（⚙︎）中将 API Provider 设为“OpenAI Compatible”。
3. 填写 Base URL、API Key 和 Model ID，并完成 Model Configuration 中的字段（上下文长度、最大输出、图像支持、输入与输出单价）。

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

Base URL 请填写到 /v1。Cline 会在其后追加路径，因此缺少 /v1 会导致 404。如果返回 401，说明 URL 正确，但密钥不正确。不要一开始就让它负责编辑，先用“解释这个文件”之类的小请求确认连接更安全。密钥在 /app/keys 中生成，显示只会出现一次，因此请当场保存。

Model Configuration 中的 Input Price / Output Price 是 Cline 计算任务期间显示费用的依据。它不会从端点自动获取，因此留空或使用默认值会导致显示的费用不准确。请填写所用模型每 1M 个令牌的单价。设置项列表见 Cline 集成文档。

为计划模式和执行模式分别选择模型

在设置中勾选“Use different models for Plan and Act”后，即可为计划模式和执行模式分别选择模型。两者使用相同的 Base URL 和密钥，只需更改 Model ID 和单价。

[✓] 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

将 Opus 5 用于计划模式的理由很简单：计划模式只占总令牌的一小部分，但如果这里的方案出错，执行模式的步骤可能全部浪费。将 Haiku 4.5 用于执行模式，是因为计划具体明确后，剩下的就是反复编辑和执行，而令牌单价在这里影响最大。

将 Plan 设为 Sonnet 5 时，每一步约为 $0.0434；使用 Opus 5 时约为 $0.11。Claude Sonnet 5 的价格为每 1M token $1.40 / $7.00。

如果 Act 模式卡住，只针对该任务将 Act 使用的模型升级为 Opus 5。同一个错误重复两次，就是切换的信号。试图用 Haiku 硬撑而导致步骤数增加，最终反而会花费更多。只需更改设置中的一个 Model ID，密钥和端点都无需改变。

计算单个任务的费用

Cline 会在每个步骤中重新发送系统提示、任务历史记录和已读取的文件，因此费用取决于步骤数，而不是时间。与本网站其他价格页面一样，我们按每个步骤输入 25,000 / 输出 1,200 个令牌、每个任务 20 个步骤（计划模式 3 个 + 执行模式 17 个）计算。

将计划模式和执行模式分开后，只需支付全部使用 Opus 5 时的约 32%费用，同时保留 Opus 5 的规划质量。全部使用 Haiku 会更便宜，但考虑到规划错误会导致返工，差额 $0.26 作为计划模式的保险费仍然更划算。用于核算的代码只有这些。

# 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

如何选择模型

如果提示词超过 272K 个令牌，GPT-5.6 Sol 会按输入 2 倍、输出 1.5 倍对整个请求收费。如果用于计划模式，将 Context Window 设置为小于 272K 更安全。如需进一步了解 Opus 与 Sonnet 的区别，请参阅 Claude Opus 与 Sonnet 的区别；Claude 全部模型的单价见 Claude 定价。

降低费用的 5 个习惯

1. 不要拉长任务，分段后创建新任务。每个步骤都会重新发送完整历史记录，因此任务越长，每个步骤的费用越高。这是最有效的习惯。
2. 如果要使用提示词缓存，请通过 Anthropic 提供商。将 API Provider 设为“Anthropic”，勾选“Use custom base URL”，并指定 https://api.kunavo.com（不要添加 /v1，客户端会自动追加 /v1/messages）。Claude 的缓存读取费用为输入单价的 10%，写入费用为输入单价的 1.25 倍。机制说明见 缓存文档。 即使继续使用 OpenAI Compatible，提示词缓存也会生效。提示词较长时，Kunavo 会在系统提示词和工具定义上自行设置缓存断点；对话中已有助手回合时，也会设在最后一条消息上。在代理循环中，第 2 步起的每一步都是如此。Cline 添加的 cache_control 也会原样保留。通过 Anthropic 提供商时，请求按 Cline 发送的原样转发，不会添加断点，因此缓存哪些内容取决于 Cline 设置的断点。
3. 将约定写入 .clinerules/。这是放在项目根目录中的 Markdown 文件，会对所有对话生效。它会包含在每次请求中，因此应保持简短，只写约定（Cline 规则文档）。
4. 仅对读取类操作启用自动批准。在 Auto Approve 中允许读取文件等操作可以减少确认。正如 Cline 文档明确指出的那样，会自动批准所有操作的 YOLO 模式只能用于一次性环境。可以通过 Checkpoints 回滚更改。
5. 创建专用于 Cline 的密钥，并设置月度上限。/app/keys支持按密钥设置月度使用上限（达到后返回 402）和 IP 允许列表。需要停止编辑器时，只需禁用该密钥即可。

坦率地说——适合订阅或直接签约的情况

如果你订阅了 Claude Pro / Max，也可以在 Cline 中选择“Claude Code”提供商。它会通过已安装的 Claude Code CLI 使用订阅配额，而不是按令牌计费。根据 Cline 文档，这种方式会限制图像上传和提示词缓存，并且响应可能不会按令牌逐个流式传输。由于配额上限与聊天和 Claude Code 共享，请参阅 Claude Pro 限制了解机制。

使用 API 密钥时，Kunavo 通过共享容量运行，并且不提供专用配额或合同级 SLA。需要保证的团队应直接与 Anthropic 签约。对于个人或小型团队运行 Cline，按量计费更合适，因为可以使用一个密钥分别配置计划模式和执行模式。

与 Roo Code 用法的区别

Roo Code 是从 Cline 派生的扩展，OpenAI Compatible 设置（Base URL、密钥、模型）可以直接使用。区别在于模式结构：它不是计划模式 / 执行模式，而是 Architect、Code、Ask、Debug 等模式，并为每个模式分配 API 设置配置文件。Architect 使用 Opus 5、Code 使用低价模型的思路同样适用。步骤见 Roo Code 设置文档和 Roo Code + Claude API（英文）。

更详细的英文说明见 Cline + Claude API 指南；如需与终端型代理比较，请参阅 Cline 与 Claude Code 的比较和 Claude Code 使用方法；全部模型的单价见 价格页面。

常见问题