外观
Cline
应用介绍
Cline 是运行在 VS Code 等编辑器中的编程智能体，可以阅读项目文件、编写和修改代码、执行终端命令，并通过 Plan 和 Act 模式协助分析与实施开发任务。它适合希望在现有编辑器中使用 Agent 编程能力的用户。Cline 支持 OpenAI 兼容接口，可以使用模型聚合服务平台的 Base URL、API Key 和模型 ID。
本文按照 VS Code 中 Cline 的实际操作截图说明。
准备信息
text
Base URL：https://ai.example.edu.cn/v1
API Key：你的 API Key
模型 ID：以模型聚合服务平台“模型广场”中显示的模型标识为准1. 安装并打开 Cline
- 在 VS Code 中按
Ctrl+Shift+X；macOS 使用Cmd+Shift+X。 - 搜索 Cline。
- 确认发布者后点击 Install。
- 安装完成后，点击左侧活动栏中的 Cline 图标。
也可以通过 VS Code Marketplace 安装。其他 IDE 的入口请参考 Cline 官方安装文档。
2. 打开 API 配置
打开 Cline 面板，点击编号 1 标出的 齿轮图标（Settings）。
进入 Settings 后，左侧默认打开 API Configuration。截图中当前配置的是 Act Mode：
- 编号 2：选择 Act Mode。
- 编号 3：点击 API Provider，可以输入
open快速筛选。 - 编号 4：选择 OpenAI Compatible。
不要选择列表中的 OpenAI。校园模型聚合服务使用自定义 OpenAI 兼容地址，应选择：
text
OpenAI Compatible3. 填写连接信息
选择提供方后，按照编号 5～9 填写并保存：
| 编号 | Cline 字段 | 填写内容 |
|---|---|---|
| 5 | Base URL | https://ai.example.edu.cn/v1 |
| 6 | OpenAI Compatible API Key | 你的 API Key |
| 7 | Model ID | 模型广场中的完整模型标识，例如 qwen3.6-27b |
| 8 | Use different models for Plan and Act modes | 可选，见下方说明 |
| 9 | Done | 填写完成后点击 |
截图中的地址仅为拍摄环境示例
截图中显示的是测试时使用的 IP 地址。实际使用本文档对应的平台时，应填写 https://ai.example.edu.cn/v1，不要照抄截图中的 IP 地址。
填写时请注意：
- Base URL 只填写以
/v1结尾的根地址，不要追加/chat/completions。 - API Key 直接粘贴原始内容，不要添加
Bearer、引号或API_KEY=。 - Model ID 必须与模型广场完全一致，注意大小写、连字符和版本后缀。
- Custom Headers 通常留空。
- Set Azure API version 和 Use Azure Identity Authentication 均保持关闭。
4. 配置 Plan 和 Act 模型
截图中编号 8 的 Use different models for Plan and Act modes 已经勾选。这表示 Plan Mode 和 Act Mode 分别保存一套模型配置：
- 先在 Act Mode 中完成上述配置。
- 切换到顶部的 Plan Mode。
- 再为 Plan Mode 填写提供方、Base URL、API Key 和模型 ID。
如果希望 Plan 和 Act 使用同一个模型，可以取消勾选编号 8，这样不需要重复配置。
展开 Model Configuration 后还可以设置 Reasoning Effort、上下文长度和最大输出 Token。应以模型广场中的实际能力为准；不确定时先保留默认值。
5. 保存并验证
点击编号 9 的 Done 返回 Cline 主面板。打开一个不含敏感内容的测试文件，选择 Act 模式后发送任务，例如：
text
请检查这段代码是否有问题；如果有，请修复并运行验证。下面的实测截图中，Cline 找到了 Python 代码中的全角逗号，修改文件后重新运行，并获得了正确输出。面板底部同时显示 openai-compat:qwen3.6-27b，说明任务正在使用刚才配置的 OpenAI Compatible 模型。
第一次测试时建议关闭 Auto-approve，逐项确认 Cline 请求的文件读取、编辑和终端命令权限。
字段含义可参考 Cline 官方 OpenAI Compatible 文档。
配置过程中遇到账号、API Key、接口地址、模型权限、额度、限流或通用错误时，请查看常见问题（FAQ）。