RuntokenDocs
English打开控制台

Cline

第 1 版 · 更新于 2026-11-12 · 阅读约 3 分钟

为 Cline 的 OpenAI Compatible Provider 配置 Runtoken。

准备工作#

开始前，请准备：

  • 已安装的 Cline IDE 扩展和测试工作区。
  • Runtoken 平台 API Key。
  • 具备任务所需能力的 Chat 兼容模型 ID。

配置 Provider#

点击 Cline 设置齿轮，选择 Provider，再填写以下连接信息。

设置项配置值用途
API ProviderOpenAI Compatible使用自定义兼容接口。
Base URLhttps://api.runtoken.net/v1API 前缀，不附加聊天补全路径。
API KeyYOUR_PLATFORM_KEYRuntoken 平台凭据。
Model IDYOUR_MODEL_ID准确的 Chat 兼容模型标识。

将 YOUR_PLATFORM_KEY 和 YOUR_MODEL_ID 替换为平台 Key 和目录中的模型 ID。Key 只填入凭据字段，不写进任务提示词或工作区文件。

高级模型配置应以所选模型的实际要求为准。

模型设置如何填写
Context window使用模型支持的上下文上限，调大客户端数值不会扩大模型能力。
Maximum output tokens不超过模型的输出上限。
图像或计算机操作能力仅开启模型与接口支持的能力。

客户端价格字段不会改变平台定价。实际用量与费用应核对 Runtoken 请求及账单记录，不只依赖编辑器估算。

核对一次请求#

保存配置，新建任务并发送简短提示词。按时间、Key 和模型定位 Runtoken 中的对应请求。如果任务仍走其他 Provider，先检查当前任务或模式的选择，再处理凭据。

先在 Plan 模式讨论一个小改动，准备修改文件时再切换到 Act。

规划一个小改动text
说明如何新增 greeting.py，其中包含 greet(name) 函数。
它返回 "Hello, " 与 name 拼接后的字符串，名字为空时返回 "Hello, friend"。
不安装依赖，也不访问网络。

审阅方案，切换到 Act 后要求实施。检查拟执行的工具操作和实际文件，再要求重新读取文件，解释空名字的处理，确认工具结果能够正常返回并继续使用。

如果当前版本允许为 Plan 和 Act 分别选择模型，请分别检查。仅测试 Plan，不能确认切换模式后使用的 Provider。

工具与权限#

Cline 将模型响应与本地工具操作结合。文本请求成功，不代表所有工具或输入类型均已可用。

工作流程需要满足的条件
规划模型能够回答，并取得预期上下文。
文件修改工具调用结构、工具结果回传及工作区权限正常。
命令或浏览器操作客户端允许操作，模型具备相应能力。
长任务上下文处理、模型限额与网关请求要求相符。

配置期间保留正常的工具审批，不要为了排查 API 错误而开启广泛自动批准。Runtoken 不会转换协议，也不会授予本地文件权限。

排查问题#

修改高级选项前，先阅读错误响应并核对实际 Provider。

现象检查方向
401平台 Key、凭据字段与任务继承的设置。
404 或模型被拒绝基础地址、准确模型 ID 和所选协议。
Plan 正常，Act 失败Act 的实际模型及被拒绝的工具请求。
上下文或输出上限报错模型真实限额与 Cline 中的配置值。
费用估算不一致核对平台用量记录，客户端估算不等于结算。
429Runtoken 返回的具体限额与重置说明。

恢复配置与下一步#

在 Cline 设置中选回此前的 Provider 与模型即可恢复原有流程，只移除本次添加的凭据和地址条目。

接口说明见 OpenAI Chat，客户端说明见 Cline Provider 设置与 Plan & Act。

这篇文档有帮助吗？