文档

文档

Cline

Cline 的 OpenAI Compatible 提供方需要基础 URL、密钥和模型 ID。下方的价格字段用于计算任务运行期间显示的成本,因此应正确填写。

Cline 的 OpenAI Compatible 提供商需要基础 URL、密钥和模型 ID,还需要每个模型的价格,以显示实时会话成本。

Cline 设置 ⚙︎
API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...
Model ID       claude-sonnet-5

Model Configuration
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on
  Input Price        (from the table below)
  Output Price       (from the table below)
Cline 会在任务执行期间显示累计费用,并根据模型配置块中的 Input Price 和 Output Price 计算;它不会从端点读取费率。如果这些字段保留默认值,显示的费用就会根据默认值的设定方向而偏高或偏低。
即使两个价格都填了,这个读数也只是估算。在 Claude 模型上,Kunavo 对缓存读取按输入单价的 0.1× 计费,对缓存写入按 1.25× 计费,而 Cline 对这两项都没有字段:在下面的实测运行中,账单是 $0.0664,而用 输入 × Input Price 加 输出 × Output Price 算出来是 $0.1003。实际扣费以 /app/usage 上的金额为准。
base URL 里要保留 /v1。Cline 只追加路由,所以 https://api.kunavo.com 会产生一个提到 /chat/completions 的 404,而 https://api.kunavo.com/v1 可以正常解析。如果 404 提到的是模型(Model … is not available),说明 URL 没问题,而 Model ID 不是 Kunavo 提供的模型;401 则说明 URL 没问题,是密钥不对。
还没有密钥?创建 Kunavo 账户,创建一个密钥(以 sk-kn- 开头),并充值 $10 起——调用费用从该余额中扣除,失败的调用不会收费。随后,控制台会打开 Cline 设置页面。

分步操作

  1. 在 /app/keys 创建密钥并复制——它只会显示一次。
  2. 打开 Cline 设置面板(⚙︎ 图标),并将 OpenAI Compatible 选为 API Provider。
  3. 输入 Base URL、API Key 和 Model ID。
  4. 展开 Model Configuration,设置上下文窗口、最大输出 token 数、图像支持以及两个价格字段。
  5. 开始一个任务。Plan/Act 可以使用不同模型,因此可为规划搭配更便宜的执行模型,避免每次编辑都按规划模型的费率付费。

已于 2026年9月6日对照 Cline 的 OpenAI Compatible 提供方页面检查。第三方设置会发生变化;如果这里的字段名称不再与你看到的内容一致,应以该页面为准,而不是本页。

这是简要版本。完整教程——包括模型选择、真实会话成本和失败模式——见 Cline + Claude 操作指南。

调试客户端前先验证

一个请求即可确定故障来自端点、密钥还是配置文件。如果返回 JSON,则相同的基础 URL 和密钥可以在 Cline 中使用。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

字段中应填写哪个模型 ID

每个文本模型都可通过模型 ID 访问——实时列表见 GET /v1/models,包含价格的目录见模型页面。费率单位为每 1M token 的美元,格式为输入 / 输出。

模型 IDKunavo 输入 / 输出它在 Cline 中的位置
claude-sonnet-5$1.40 / $7.00Act 模式——默认工作模型
claude-opus-5$3.50 / $17.50Plan 模式,后续任务的费用取决于这里使用的规划模型
claude-haiku-4-5$0.70 / $3.50用于廉价读取和反复检查文件
gpt-5-6-terra$0.70 / $4.20在同一个密钥后接入另一模型系列,以获取第二种意见
计费方式是从预付余额中按 token 扣费,无月费——参见 计费。对于重复上下文——这正是编辑器或聊天客户端发送内容的大部分——提示缓存对账单的影响大于模型选择。

2026年10月10日实测。Cline CLI 3.0.70 在 claude-sonnet-5 上运行了一个小型仓库任务(让一个含六个测试的单元测试集全部通过,开始时其中五个失败):4 次模型调用,45,171 个输入 token(其中 30,855 个读自缓存,14,181 个写入缓存),5,301 个输出 token,按 Kunavo 的费率合计 $0.0664。同一任务在其他客户端上的数据见 LLM 成本计算器。

常见问题

如何让 Cline CLI 指向 Kunavo?

先运行一次 cline auth --provider openai-compatible --baseurl https://api.kunavo.com/v1 --modelid claude-sonnet-5 --apikey sk-kn-...,之后 cline "你的任务" 就会以无界面方式对它运行。CLI 把密钥保存在 ~/.cline/data/settings/providers.json(只有你可读),而不是从环境变量读取;用 -m 选择的模型会被保存为之后运行的新默认值。已于 2026-10-10 使用 Cline CLI 3.0.70 测试。

如何在 Cline 中使用自定义 OpenAI 兼容 API?

在 Cline 设置面板中,将 API Provider 设为“OpenAI Compatible”,然后输入端点的 Base URL、你的 API Key,以及所需的 Model ID。基础 URL 应为 /v1 根路径,因为 Cline 只会在其后追加路由。随后,Cline 会使用 OpenAI 线格式与该端点通信,无论实际提供模型的是哪家厂商。

Cline 能否在没有 Anthropic API 密钥的情况下使用 Claude 模型?

可以,只要模型通过 OpenAI 兼容端点提供。Cline 会原样传递 Model ID,因此 Claude ID 由端点解析,而非由扩展解析;Cline 持有的唯一凭据就是端点的凭据。这样也可以在同一个提供方条目中使用一个密钥访问 Claude 和 GPT ID。

为什么 Cline 的费用估算不准确?

因为 Cline 根据模型配置块中的 Input Price 和 Output Price 字段计算费用,而这些字段需要手动填写,不会从端点获取。如果字段仍为默认值,或复制自其他提供方,所有费用显示都会继承这一误差。请填写所选模型 ID 对应的端点实际费率。

Cline 的基础 URL 应以 /v1 结尾吗?

对于 OpenAI 兼容端点,需要。Cline 会把路由 /chat/completions 追加到你给的任何 base URL 后面,所以 https://api.example.com/v1 能正常解析,而 https://api.example.com 会把请求发到一个不存在的路径。提到 /chat/completions 的 404 指向 base URL 的问题,提到模型的 404 指向 Model ID 的问题,401 则指向密钥的问题。