Cline - VS Code AI 编程助手
在 Cline 中配置 88API 的地址、密钥和模型,完成首次对话与故障排查。
适用范围
Cline 是运行在 VS Code 中的 AI 编程助手,可以阅读代码、修改文件和调用终端工具。 本教程使用 Cline 官方提供的 OpenAI Compatible 接入方式连接 88API。
- 官方文档:https://docs.cline.bot
- VS Code 扩展:Cline(
saoudrizwan.claude-dev) - GitHub 仓库:https://github.com/cline/cline
使用前准备
- 登录 88API,在控制台创建 API Key,并确认账户有可用余额。
- 安装最新版 Visual Studio Code。
- 确认准备使用的模型名称。下文以
gpt-6.1-sol为例(也可以使用claude-sonnet-5-5、deepseek-v4-pro等控制台列出的模型);如果该模型不在你的可用列表中,请替换为控制台显示的完整模型 ID。
安装 Cline
- 在 VS Code 中按
Ctrl+Shift+X(macOS 为Command+Shift+X)打开扩展面板。 - 搜索
@id:saoudrizwan.claude-dev。 - 确认发布者与扩展 ID 无误后,点击 Install / 安装。
- 安装完成后,点击活动栏中的 Cline 图标打开侧边栏。
找不到 Cline 图标
可以按 Ctrl+Shift+P(macOS 为 Command+Shift+P),输入
Cline: Jump to Chat Input 打开 Cline 并聚焦输入框,或搜索其他 Cline
命令。命令名称可能随版本调整,活动栏图标始终是更直接的入口。
配置 88API
在 Cline 界面点击齿轮进入设置,然后完成以下配置:
| Cline 配置项 | 填写内容 |
|---|---|
| API Provider | OpenAI Compatible |
| Base URL | https://api.88api.ai/v1 |
| API Key | 在 88API 控制台创建的 API Key |
| Model ID | gpt-6.1-sol,或账户实际可用的完整模型 ID |

Cline 只有英文界面。图中编号依次对应:① API Provider、② Base URL、③ OpenAI Compatible API Key、 ④ Model ID。API Key 应粘贴自己的真实密钥;图中只显示遮罩圆点。
具体步骤:
- 将 API Provider 切换为 OpenAI Compatible,不要选择普通的 OpenAI。
- 在 Base URL 填写
https://api.88api.ai/v1。 - 在 API Key 粘贴 88API API Key。
- 填好 Base URL 和 API Key 后,Cline 会自动请求
https://api.88api.ai/v1/models。列表加载成功时,Model ID 会变成下拉框,直接选择账户可用的模型(例如gpt-6.1-sol);也可以在下拉框中选择 Use custom model ID… 手动输入。如果列表没有加载出来,Model ID 会显示为普通输入框,可直接填写完整模型 ID,并检查 Base URL 和 API Key 是否正确。 - 设置修改后会自动保存,点击设置页右上角的 Done 返回聊天界面。
Cline 4.x 会把 API Key 以 JSON 文件形式保存在本机用户目录:~/.cline/data/settings/providers.json 和 ~/.cline/data/secrets.json(Windows 为 %USERPROFILE%\.cline\data\ 下的同名文件),请求只发送到你填写的 Base URL。不要把 API Key 写进项目文件或提交到 Git,也不要同步、上传或分享 ~/.cline 目录。
高级参数怎么填
首次连接时建议保持默认值。如需调整,展开 MODEL CONFIGURATION:
- Supports Images:只有模型支持图片输入时才勾选;
- Context Window Size:应与实际模型上下文长度一致;
- Max Output Tokens:不能高于模型允许的最大输出;
- Temperature:一般留空,使用模型默认值。
错误地声明能力可能导致普通对话成功,但图片输入或长任务失败。
识图
将 Model ID 切换为支持图片输入的模型(例如 deepseek-v4.1-flash),点击输入框旁的 + 按钮附加图片,
再发送问题即可。
第一次调用
- 在 Cline 中新建一个任务。
- 先发送一条不会修改项目的测试消息:
请只回复“88API 已连接”,不要修改文件,也不要执行命令。- 收到正常回复后,打开 88API 控制台的使用日志,确认出现对应请求。
Cline 的 OpenAI Compatible 接入会根据 Base URL 访问兼容接口。Base URL 只填到 /v1,不要填写成 https://api.88api.ai/v1/chat/completions,否则客户端再次拼接路径时会产生错误地址。
开始编程任务
连接验证通过后,可以打开一个代码项目并尝试:
阅读当前项目的 README 和目录结构,说明如何启动项目,暂时不要修改文件。确认 Cline 能正确理解项目后,再让它执行修改、测试或终端命令。Cline 在需要使用工具时会显示具体操作,按界面提示确认即可。
常见问题
设置中没有 Base URL
确认 API Provider 选择的是 OpenAI Compatible。普通 OpenAI 提供商使用官方固定地址,不会显示相同的自定义字段。
提示 401 或 Unauthorized
重新从 88API 控制台复制 API Key,确认前后没有空格或换行。不要填写 VS Code 登录令牌、OpenAI 网页登录信息或其他服务的密钥。
提示 404 或找不到接口
Base URL 应为 https://api.88api.ai/v1。不要重复添加 /v1,也不要把 /chat/completions 写进 Base URL。
提示 Model Not Found
Model ID 必须与账户实际可用的模型名称完全一致,包括大小写、连字符和版本后缀。优先从 Model ID 下拉框中选择(列表来自 88API 的 /v1/models);手动输入时不要把示例名称当作固定值。
能聊天,但不能编辑文件或调用工具
Agent 操作依赖模型的工具调用能力。先用普通对话确认地址和密钥正确,再换用明确支持工具调用的模型;不要仅通过勾选能力开关来假定模型具备该能力。
修改配置后仍使用旧模型
点击 Done 后新建任务。仍未生效时,执行 Developer: Reload Window 或完全退出并重启 VS Code,再检查当前任务顶部显示的模型。