Cline OpenAI 兼容接口配置第三方指南

更新于 2026-10-18 · laozhang.cfd

简答：在 Cline 的设置面板中选择 OpenAI Compatible，填写接口服务方提供的 Base URL、API Key 和 Model ID；Base URL 应以“请求 Base URL 后能正确访问 /chat/completions”为准，不要机械重复添加 /v1。保存后用一个简单文本任务验证，而不是依赖未在通用文档中确认的 Verify 按钮。

定义：OpenAI 兼容接口是使用相近请求格式提供 Chat Completions 等能力的接口，Cline 可通过 OpenAI Compatible 配置连接这类服务，但具体 Base URL、模型 ID、鉴权方式和工具调用能力仍以接口提供方文档为准。

先确认 Cline 需要哪些配置

本文是第三方配置指南，不是 Cline 官方页面，也不代表任何接口服务方。根据 Cline 的 OpenAI Compatible 配置文档，截至 2026-10-18，核心字段包括 API Provider、Base URL、API Key 和 Model ID。Cline 官方说明中，OpenAI Compatible 适用于提供 OpenAI API 兼容端点的服务；官方 OpenAI 接口则使用单独的 OpenAI 配置入口。可查看 Cline OpenAI Compatible 配置文档核对当前字段名称。

模型 ID 不是随意写的显示名称。Cline 的配置文档明确提示，不同 OpenAI 兼容服务支持的模型 ID 会不同；如果列表中没有目标模型，可在当前版本的 Model 区域选择或手动输入自定义模型标识。界面是否显示特定的 Add model 按钮，以你安装的 Cline 版本为准，不应把某个版本的按钮名称当成所有版本都相同。

Base URL 要不要带 /v1：用请求路径判断

最容易出错的是 Base URL 末尾是否带 /v1。不要同时套用多个服务商的示例，也不要把完整的 /chat/completions 地址直接填入 Base URL。实际判断方法是：先查看接口服务方文档，确认它要求的基础路径；再把 Cline 或 OpenAI SDK 会追加的资源路径接在后面，检查最终是否应当访问 /chat/completions。

1. 如果服务方文档把基础地址写成类似 https://api.example.com/v1，通常将这一整段作为 Base URL，不再额外添加第二个 /v1。
2. 如果服务方文档把基础地址写成类似 https://api.example.com，则按其接口说明确认是否由客户端或兼容层补上版本路径。
3. 如果文档只给出了完整请求地址，例如包含 /chat/completions，需要先拆出基础部分；不要把资源路径重复拼接。
4. 最后用脱敏的最小请求测试最终路径。出现 404 时，优先检查路径层级；出现 401 或 403 时，再检查 Key 和模型权限。

Cline 官方示例把 Base URL 作为供应商的接口基础地址，并提醒它不是官方 OpenAI 地址；但不同服务的路径设计可能不同，因此最终仍应以接口服务方文档为准。Cline SDK 文档也使用了带版本路径的 baseUrl 示例，可参考 Cline SDK 模型供应商配置说明。

在 Cline 中逐步配置 OpenAI Compatible

1. 在 VS Code 中打开 Cline 面板，进入设置，找到 API Provider 或 API Configuration 区域。
2. 将 API Provider 设置为 OpenAI Compatible。
3. 在 Base URL 中填写接口服务方给出的基础地址。只填写基础地址，不要把 Key、中文说明或完整 JSON 请求粘贴进去。
4. 在 API Key 字段填写密钥。建议直接从密码管理器粘贴，避免把 Key 写入项目文件、聊天记录或截图。
5. 在 Model 区域选择服务方支持的模型；如果下拉列表没有目标模型，按当前版本提供的自定义输入方式填写准确的 Model ID。
6. 如果 Cline 显示模型配置项，可根据服务方文档填写 Context Window、Max Output Tokens、图片支持或工具调用能力。没有可靠资料时保留默认值，并以官方为准。
7. 保存配置后，先切换到一个简单任务，例如要求模型用英文回答 Reply with exactly: CLINE_OK。
8. 确认任务能够返回文本，再逐步测试代码读取、文件修改或其他工具调用。普通文本成功不等于模型一定支持 Cline 所需的工具调用。

Cline 官方的 Plan and Act 文档说明，可以启用 “Use different models for Plan and Act”，分别为规划和执行选择模型；切换模式时会使用对应配置。相关入口和行为可能随版本调整，建议以 Cline Plan 与 Act 模式文档为准。

可复制的最小接口验证示例

下面的示例只验证 OpenAI 兼容 Chat Completions 是否可用，依赖 curl 和可选的 jq。示例不写死域名，Key 只从环境变量读取，也不会在命令中重复拼接 /v1。请将 BASE_URL 设置为你在 Cline 中准备填写的同一个基础地址，将 MODEL_ID 设置为接口服务方实际支持的模型。

# macOS / Linux / Git Bash
export BASE_URL='https://your-provider.example/v1'
export KEY='replace-with-your-key'
export MODEL_ID='replace-with-supported-model-id'

curl --fail-with-body "$BASE_URL/chat/completions" \
  -H "Authorization: Bearer $KEY" \
  -H 'Content-Type: application/json' \
  -d "{\"model\":\"$MODEL_ID\",\"messages\":[{\"role\":\"user\",\"content\":\"Reply with exactly: CLINE_OK\"}],\"stream\":false}" \
| jq '{id, model, content: .choices[0].message.content}'

预期成功响应至少应包含可识别的 id、model 和 choices[0].message.content 字段；实际字段以接口服务方返回格式为准。如果没有安装 jq，可以删除管道部分，直接查看 JSON 响应。

Windows PowerShell 可使用以下写法。这里把请求体中的提示词设为英文，减少 Windows PowerShell 5.1 的编码差异；-ContentType 明确指定 JSON 编码。

$env:BASE_URL = 'https://your-provider.example/v1'
$env:KEY = 'replace-with-your-key'
$env:MODEL_ID = 'replace-with-supported-model-id'

$body = @{
  model = $env:MODEL_ID
  messages = @(
    @{ role = 'user'; content = 'Reply with exactly: CLINE_OK' }
  )
  stream = $false
} | ConvertTo-Json -Depth 5

Invoke-RestMethod -Method Post `
  -Uri ($env:BASE_URL + '/chat/completions') `
  -Headers @{ Authorization = "Bearer $env:KEY" } `
  -ContentType 'application/json; charset=utf-8' `
  -Body $body

如果该请求成功但 Cline 失败，优先对照 Cline 中的 Provider、Base URL、Model ID 和 Key 是否完全一致；如果请求本身失败，则先按接口服务方返回的 HTTP 状态码排查。

Plan 和 Act 怎么选模型

Plan 模式更适合拆解任务、分析代码库和制定执行方案，Act 模式更适合修改文件、执行测试和完成已有计划。Cline 官方文档允许为两种模式配置不同模型，因此可以把更擅长分析的模型放在 Plan，把工具调用稳定、响应更快的模型放在 Act。选择前应核对三个条件：

• 上下文窗口：项目文件、历史消息和工具结果会共同占用上下文，模型可用上下文不足时可能截断或失败。
• 工具调用能力：能返回普通文本，不代表一定能正确处理 Cline 所需的工具或函数调用。
• 模型 ID 与权限：Plan 和 Act 使用不同模型时，两个模型都必须在同一接口配置下可用；如果接口权限不同，应分别确认服务方规则。

Cline 的模型供应商文档列出了模型配置中的上下文窗口、最大输出、图片支持和 Computer Use 等配置概念；这些能力不是 Cline 单方面保证，仍需以具体模型和接口服务方文档为准。配置完成后，分别在 Plan 和 Act 中发送一个简单任务，确认当前模式确实能完成预期操作。

常见配置问题的快速定位

如果错误涉及具体 HTTP 状态码，建议单独查看对应的错误排查指南；本文只聚焦 Cline OpenAI Compatible 的首次配置，不把所有错误码混在同一套流程里。

参考资料

本文核对日期为 2026-10-18，主要依据 Cline 公开仓库中的配置与工作流文档整理：

• Cline OpenAI Compatible 配置文档：核对 Provider、Base URL、API Key、Model ID 和模型配置字段。
• Cline SDK 模型供应商配置说明：核对 openai-compatible 的 providerId、baseUrl 和 modelId 示例。
• Cline Plan 与 Act 模式文档：核对两种模式分别使用模型的配置方式。
• Cline API 示例文档：核对 OpenAI 兼容 Chat Completions 的请求结构和响应读取方式。

常见问题

Cline 的 Base URL 是否一定要带 /v1？

不一定。应先看接口服务方文档，再确认 Base URL 与 /chat/completions 拼接后的最终地址。文档要求基础地址带 /v1 时就填写 /v1；已经包含版本路径时不要再次添加。不要把完整的 /chat/completions 地址直接填入 Base URL。

Cline OpenAI Compatible 配置后，应该用 Verify 按钮测试吗？

不要把 Verify 当作所有 OpenAI Compatible 配置都存在的通用按钮。本文采用更稳妥的方法：保存配置后运行一个简单文本任务，或先用最小 curl 请求确认返回了 id、model 和 choices[0].message.content。具体界面按钮以当前 Cline 版本为准。

Model 下拉列表没有我要的模型怎么办？

先从接口服务方的模型列表或文档复制准确的 Model ID，再在当前版本的 Model 区域使用手动输入或自定义模型入口。不要把模型宣传名称、别名或带说明文字的整行内容直接填写。

为什么普通文本请求成功，但 Cline 工具调用失败？

普通文本只说明基础对话请求能够返回，不代表模型和接口完整支持工具调用。请核对模型的工具或函数调用能力、上下文窗口、接口是否兼容相关字段，以及 Cline 中的模型能力配置。

Plan 和 Act 可以使用不同的模型吗？

可以。Cline 官方 Plan and Act 文档说明，启用 “Use different models for Plan and Act” 后，可以分别选择规划模型和执行模型。切换后应分别运行简单任务确认配置生效；若界面表现与文档不一致，先更新 Cline 并以当前版本界面为准。

相关阅读

• 本站教程：Claude Code 版本升级后的报错排查

参考资料

1. Cline OpenAI Compatible 配置文档
2. Cline SDK 模型供应商配置说明
3. Cline Plan 与 Act 模式文档
4. Cline API 示例文档