Cline
在 Cline 中配置和使用 AGTCloud。
Cline 是运行在 IDE 中的编程智能体，可以读取项目文件、执行命令并在获得允许后修改代码。通过配置 OpenAI Compatible Provider，可以让 Cline 使用 AGTCloud 的 Chat Completions 兼容入口。
本教程介绍 Cline IDE 扩展。不同模型对工具调用、图像输入、Computer Use 和上下文长度的支持范围可能不同，请选择当前 API Key 可见且支持 Chat Completions 与工具调用的模型。
准备工作
开始前，请确认你已经：
- 安装受支持的 VS Code 兼容编辑器或 JetBrains IDE；
- 注册并登录 AGTCloud；
- 在 API Keys 页面创建令牌；
- 从模型广场复制当前令牌可用且支持 Chat Completions 的模型 ID；
- 准备一个不包含敏感代码的测试项目。
安装 Cline
选择与你使用的 IDE 对应的安装方式。Cline 也提供 CLI、SDK 和 Kanban 等形态，本教程不展开这些用法。
适用于 VS Code、Cursor、Windsurf、VSCodium 等编辑器：
- 打开扩展市场，或按
Ctrl/Cmd + Shift + X； - 搜索
Cline； - 选择 Cline 官方扩展并点击安装；
- 点击活动栏中的 Cline 图标，或从命令面板执行
Cline: Open In New Tab。
Windsurf 和 VSCodium 使用 Open VSX，安装流程基本相同。
如果首次打开时出现 Cline 授权或初始化提示，请按照当前版本界面完成。其他安装方式请查看 Cline 官方安装文档。
配置 AGTCloud
打开 API Configuration
打开 Cline 面板，点击设置图标，然后进入 API Configuration。不同 IDE 和 Cline 版本中的设置入口位置可能略有不同。
选择兼容 Provider
在 API Provider 中选择 OpenAI Compatible。不要选择内置的 OpenAI Provider。
填写连接信息
| Cline 字段 | 填写内容 |
|---|---|
API Provider | OpenAI Compatible |
Base URL | https://api.agtcloud.cn/v1 |
OpenAI Compatible API Key | your-api-key |
Model ID 或 Model | MODEL_ID |
Custom Headers | 默认留空 |
请将 your-api-key 和 MODEL_ID 替换为自己的令牌和模型 ID。
验证并保存
如果当前版本提供 Verify 按钮，请先验证连接。验证通过后，点击 Done 或当前界面的保存按钮完成配置。
Base URL 必须包含 /v1
Cline 的 OpenAI Compatible Provider 需要填写完整 API Base URL。请使用 https://api.agtcloud.cn/v1，不要只填写 API Origin，也不要额外追加 /v1 形成 /v1/v1。
选择和配置模型
MODEL_ID 是需要替换的占位符，不是真实模型名称。请从模型广场复制当前 API Key 可见且支持 Chat Completions 与工具调用的模型 ID。
Cline 的 Model Configuration 可能提供 Context Window、Max Output Tokens、Image Support、Computer Use、Input Price 和 Output Price 等高级选项。首次连接时建议保持默认值；只有掌握目标模型的真实限制和能力时再进行调整。
高级配置不是模型能力来源
在 Cline 中勾选图像或 Computer Use 支持，不会让不具备该能力的模型获得新能力。价格字段主要用于 Cline 的本地用量估算，不代表 AGTCloud 最终计费结果。
启动并验证连接
打开测试项目
使用不包含敏感代码的项目，并确认其中存在可安全读取的 README.md。
保持自动批准关闭
首次验证时不要启用 Auto Approve。Cline 准备读取文件、执行命令或修改代码时，先检查操作内容再决定是否允许。
检查结果
Cline 能够读取文件并正常返回概括，且没有发生未授权修改，说明基础连接已经建立。本步会产生正常的 API 用量。
常见问题
| 现象 | 优先检查 | 处理方式 |
|---|---|---|
| Cline 扩展未显示 | 安装来源、IDE 兼容性和重启状态 | 确认安装的是 Cline 官方扩展，重新加载或重启 IDE |
Verify 连接失败 | 网络和 Base URL | 确认本机可访问 AGTCloud，并使用完整的 https://api.agtcloud.cn/v1 |
返回 401 | API Key 内容和令牌状态 | 重新复制有效 API Key，并确认填写内容没有多余空格 |
返回 403 | 令牌权限、模型权限和账户状态 | 在控制台检查令牌状态及当前账户的模型可用范围 |
返回 404 | Base URL、重复 /v1 和模型 ID | 确认没有形成 /v1/v1，并重新复制完整模型 ID |
| 提示 Model Not Found | 当前 Key 可见模型和协议支持 | 选择当前 API Key 可见且支持 Chat Completions 的模型 |
| 对话正常但工具失败 | 工具调用能力和高级配置 | 换用支持工具调用的模型，并检查上下文和输出上限配置 |
| 图片或 Computer Use 失败 | 模型真实能力 | 不要只依赖 Cline 选项；以目标模型实际支持范围为准 |
| 结果异常或连接中断 | 网络代理、模型参数和上下文限制 | 先恢复默认高级配置，再检查代理、防火墙和模型上下文限制 |
遇到无法定位的问题时，请记录请求时间、模型 ID、HTTP 状态和脱敏错误信息，然后查看错误与排障。不要提交完整 API Key。
安全建议
- 不要把 API Key 写入项目文件、Git 仓库、截图、日志或共享配置；
- 不要在包含生产凭证、私有数据或未公开源码的项目中进行首次验证；
- 首次使用保持 Auto Approve 关闭，确认每项操作后再允许执行；
- 多人共用设备时，使用完毕后清除 Cline 中保存的 API Key。