# Cline 配置第三方 API：OpenAI Compatible 与 Base URL 设置

> 在 VS Code 的 Cline 扩展中选择 OpenAI Compatible，配置 Base URL、API Key 与模型 ID，并核对 Plan / Act 模型设置。以 TokenDance 为例。

- 原文：https://token.help/articles/cline-third-party-api
- 作者：词元有方编辑部
- 成稿时间：2026-09-28T10:11:25.000Z
- 发布时间：2026-09-29T07:58:49.000Z
- 最后更新：2026-09-29T07:58:49.000Z
- 分类：接入教程
- 核验方式：已核对官方文档
- 核验时间：2026-09-28T00:00:00.000Z

引用本文请使用上方原文链接；配置与结论以文中版本和核验时间为准。来源内容的许可说明保留在正文中。

在 Cline 中配置第三方 API，需要先确认服务提供 OpenAI 兼容接口，再到 **Cline 自己的设置面板**选择 OpenAI Compatible，填写 Base URL、API Key 和模型 ID。下面以 TokenDance 为例。

这篇教程针对 VS Code 中的 Cline 扩展，先配置连接，再让它完成一个范围很小的文件任务。

## 1. 安装扩展，准备可用模型

通过 [Cline 官方安装入口](https://cline.bot/install)安装 VS Code 扩展。打开一个专门用于练习的空文件夹，然后进入 Cline 侧栏。

在 TokenDance 的 [API 密钥页](https://tokendance.space/keys?utm_source=journal\&utm_medium=content\&utm_content=cline-third-party-api)创建专用密钥，并到[模型列表](https://tokendance.space/models?utm_source=journal\&utm_medium=content\&utm_content=cline-third-party-api)选择支持 OpenAI Chat Completions、适合工具任务的模型。复制完整 ID，同时查看上下文长度、最大输出和价格。

编程助手可能连续发起多次请求，所以第一轮先做小任务，确认调用与用量后再处理整个项目。

## 2. 选择 OpenAI Compatible

点击 Cline 面板中的设置齿轮，在 `API Provider` 中选择 **OpenAI Compatible**。

这里需要能填写自定义 `Base URL` 的兼容入口。不要因为 API 协议名称相同，就直接选成默认指向 OpenAI 官方服务的其他入口。

| 字段           | 填写内容                                  |
| ------------ | ------------------------------------- |
| API Provider | `OpenAI Compatible`                   |
| Base URL     | `https://tokendance.space/gateway/v1` |
| API Key      | 你的 TokenDance API Key                 |
| Model ID     | 从 TokenDance 复制的完整 ID                 |

![Cline 的 OpenAI Compatible 配置示例，展示 Base URL、API Key 和 Model ID](https://watcha.tos-cn-beijing.volces.com/docs/integrations/cline/cline-2.png)

*配图来自 TokenDance 文档，具体布局可能随扩展版本变化，图中的模型仅作示例。*

`Base URL` 到 `/v1` 为止，客户端会生成聊天接口请求；不要再加 `/chat/completions`。

## 3. 核对模型配置后保存

如果 `Model Configuration` 要求填写上下文窗口、最大输出或图像支持，按**当前模型详情**填写。不要套用另一个模型的参数，也不要为了通过检测随意放大上限。

如果启用了 Plan 与 Act 使用不同模型，分别确认两个模式的服务商和模型配置，避免计划阶段能用、执行阶段切到了未配置的服务。

保存配置；若当前版本有 `Verify`，可以先验证连接。最终仍要用实际对话和平台调用日志确认。

## 4. 用一个小任务验证工具能力

在练习目录里新建 `notes.txt`，写入三行示例内容：

```text
周二：梳理首页问题
周三：评审改版草稿
周五：确认开发范围
```

切换到 Act 模式，把这个文件作为上下文交给 Cline，然后输入：

> 读取 notes.txt，将内容整理成 Markdown 清单，保存为 notes-summary.md。不要改动原文件，不安装依赖，不执行其他命令。

查看它给出的文件操作，确认符合预期后批准。完成后检查三个结果：

1. `notes-summary.md` 中有原来的三项内容，没有编造时间或负责人。
2. 原始 `notes.txt` 没有变化。
3. TokenDance [调用日志](https://tokendance.space/activity?utm_source=journal\&utm_medium=content\&utm_content=cline-third-party-api)出现对应模型的请求，并能查看用量。

任务完成可能涉及多次模型调用，不能把“一次任务”简单理解成“一次 API 请求”。

## 常见问题

| 问题              | 处理顺序                                      |
| --------------- | ----------------------------------------- |
| Invalid API Key | 检查服务商类型和密钥；确认不是其他平台的 Key                  |
| Model Not Found | 重新复制模型 ID，检查是否支持所选协议                      |
| 404 / 连接错误      | 核对 `/gateway/v1`，不要使用 WorkBuddy 的完整请求 URL |
| 能聊天但文件操作失败      | 检查模型工具能力、Cline 的报错和待批准操作                  |
| Plan 能用，Act 不能用 | 检查是否为两种模式分别配置了模型                          |

如果暂时分不清是客户端还是接口问题，先用 [curl 最小请求](https://token.help/articles/api-first-request)测试同一个模型，再回来核对 Cline 配置。

## 参考资料

配置核对日期：2026-09-28；操作流程依据官方资料整理，未进行真实 Agent 调用实测。

- [TokenDance：Cline 接入与配图](https://tokendance.space/docs/cline)
- [Cline：OpenAI Compatible 配置](https://docs.cline.bot/provider-config/openai-compatible)
- [Cline：Plan 与 Act 模式](https://docs.cline.bot/core-workflows/plan-and-act)

## 核验参考来源

- https://watcha.tos-cn-beijing.volces.com/docs/integrations/cline/cline-2.png
- https://tokendance.space/docs/cline
- https://docs.cline.bot/provider-config/openai-compatible
- https://docs.cline.bot/core-workflows/plan-and-act