文档
Cline
Cline 的 OpenAI Compatible 提供方需要基础 URL、密钥和模型 ID。下方的价格字段用于计算任务运行期间显示的成本,因此应正确填写。
Cline 的 OpenAI Compatible 提供商需要基础 URL、密钥和模型 ID,还需要每个模型的价格,以显示实时会话成本。
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)/app/usage 上的金额为准。/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 没问题,是密钥不对。sk-kn- 开头),并充值 $10 起——调用费用从该余额中扣除,失败的调用不会收费。随后,控制台会打开 Cline 设置页面。分步操作
- 在
/app/keys创建密钥并复制——它只会显示一次。 - 打开 Cline 设置面板(⚙︎ 图标),并将
OpenAI Compatible选为 API Provider。 - 输入 Base URL、API Key 和 Model ID。
- 展开 Model Configuration,设置上下文窗口、最大输出 token 数、图像支持以及两个价格字段。
- 开始一个任务。Plan/Act 可以使用不同模型,因此可为规划搭配更便宜的执行模型,避免每次编辑都按规划模型的费率付费。
已于 2026年9月6日对照 Cline 的 OpenAI Compatible 提供方页面检查。第三方设置会发生变化;如果这里的字段名称不再与你看到的内容一致,应以该页面为准,而不是本页。
调试客户端前先验证
一个请求即可确定故障来自端点、密钥还是配置文件。如果返回 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 的美元,格式为输入 / 输出。
| 模型 ID | Kunavo 输入 / 输出 | 它在 Cline 中的位置 |
|---|---|---|
claude-sonnet-5 | $1.40 / $7.00 | Act 模式——默认工作模型 |
claude-opus-5 | $3.50 / $17.50 | Plan 模式,后续任务的费用取决于这里使用的规划模型 |
claude-haiku-4-5 | $0.70 / $3.50 | 用于廉价读取和反复检查文件 |
gpt-5-6-terra | $0.70 / $4.20 | 在同一个密钥后接入另一模型系列,以获取第二种意见 |
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 则指向密钥的问题。