文档导航
INTEGRATION GUIDE

Cline OpenAI 兼容接入:Plan、Act 与审批验证

依据 Cline 官方供应商及工作流文档,配置 OpenAI Compatible、核对 Plan 与 Act 模型,并以只读任务验证工具链及审批边界。

内容复核中 官方配置已核对;本站接入未实测。 图解为本站原创示意,不是客户端运行截图。

查看教程占位服务地址
控制台
https://80321.cn
创建 Key
https://80321.cn/keys
钱包充值
https://80321.cn/wallet
文档站
https://80321.cn/docs.html

以上服务地址仅为教程占位示例,不代表本站已提供控制台、密钥创建、充值或 API 服务。实际接入地址请以正式提供的配置为准。

本页目录

Cline 可以通过 OpenAI Compatible 连接外部兼容服务。接入时除了地址、密钥和模型,还要注意 Plan 与 Act 的模型选择,以及工具是否被自动批准。完成一次普通聊天,不能证明这两种模式都使用了预期供应商。

Cline 模型配置与 Plan、Act 流程原创示意图,非运行截图

选兼容供应商,不套官方模型列表

打开 Cline 面板的设置,将 API Provider 选为 OpenAI Compatible,填写服务确认的 Base URL、API Key 和模型 ID。官方明确提醒不同兼容供应商的模型名称可能不同,必须核对目标服务实际接受的 ID。

下面仅展示输入项。地址是占位,本站没有提供真实接口;密钥和模型也都是占位值。

API Provider: OpenAI Compatible
Base URL: https://80321.cn/v1
API Key: YOUR_API_KEY
Model: YOUR_MODEL_ID

能力参数不能凭显示名称填写

官方设置允许调整输出上限、上下文窗口、图片、Computer Use 和价格信息。 这些选项是客户端元数据,不会给模型增加能力。初次接入只保留已确认的文本范围;不知道定价时不要填一个好看的数字,界面估算也不能代替供应商账单。

先在 Plan 模式做只读验证

官方说明 Plan 模式能读取代码和搜索,但不能修改文件或执行命令;Act 才能实施修改。Cline 还能分别配置两种模式的模型,切换模式时也会切换相应模型。

首次评估建议先让两种模式使用同一套已确认配置,再在无敏感资料的临时项目里进入 Plan。请求读取一个简短说明文件并复述内容,观察工具请求、结果和后续回答。纯文本回复成功与读取任务成功应分别记录,不能混成一个“接通”结论。

Act 测试不要顺手打开自动执行

确认只读链路后,可以切到 Act,让模型提出一个局部修改,人工检查差异再批准。初次验证不启用 YOLO,不自动放行工作区外文件、终端和 MCP。

尤其要注意,“安全命令”并不是固定可靠白名单。官方说明命令是否需要审批由模型根据命令及参数标记,所以界面显示安全仍需要结合任务判断。 保留审核并不会影响你辨别服务是否支持工具协议。

失败要定位到具体层

模型找不到时核对服务模型 ID;Key 错误时检查凭证所属服务;连接失败时检查根地址及网络可达性。这些是官方兼容供应商页提供的排查方向。 如果 Plan 正常而 Act 失败,先确认是否启用了分模式模型,不要直接更换所有设置。

若工具结果无法被模型继续使用,或服务只支持文本而不支持所需工具调用,就停止 Agent 接入评估。不要通过复制秘密到项目、执行陌生脚本或开放全部审批来绕过问题。本文仅核验官方文档,没有运行 Cline 或请求示例接口。