Cline 配置 OpenAI 兼容 API
Cline 自定义 OpenAI 兼容提供商的配置、最短请求和常见错误排查。
配置方法
flowtext
1. 打开 VS Code
2. 打开 Cline 设置
3. Provider 选择 OpenAI Compatible
4. 填入 Base URL 和 API Key
5. 添加默认模型
6. 先让 Cline 读取一个小文件验证工具链setuptext
Provider: OpenAI Compatible
Base URL: https://api.gpt88.cc
API Key: sk-你的-gpt88-api-key
Model: claude-sonnet-4-6验证方式
- 让 Cline 解释当前项目 README。
- 让它修改一个无风险的小文件。
- 确认文件确实落盘,再执行复杂任务。
排障清单
troubleshootingtext
1. Cline 不调用工具
- 先确认 VS Code 权限和工作区是否正常
2. 模型连接失败
- 先用 curl 验证 gpt88.cc
3. 输出成本偏高
- 降低上下文范围
- 先用小模型做简单任务下一步
问题是什么
Cline 的 Provider、Base URL、Model ID 和 API Key 必须同时匹配。建议先发一个短问题,再开启长上下文和工具。
最短可用配置
.envbash
Provider: OpenAI Compatible
Base URL: https://api.gpt88.cc/v1
API Key: sk-替换为你创建的Key
Model ID: gpt-5.6-solAPI Key 只放在服务端环境变量或密钥管理器中,不要提交到 Git、截图、浏览器前端或公开 issue。
完整示例(curl / Python / Node.js)
request.shbash
curl https://api.gpt88.cc/v1/chat/completions \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"返回 OK"}],"max_tokens":32}'request.pypython
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["OPENAI_API_KEY"],
base_url=os.getenv("OPENAI_BASE_URL", "https://api.gpt88.cc/v1"),
)
response = client.chat.completions.create(
model=os.getenv("OPENAI_MODEL", "gpt-5.6-sol"),
messages=[{"role": "user", "content": "返回 OK"}],
max_tokens=32,
)
print(response.choices[0].message.content)request.mjsjavascript
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.OPENAI_API_KEY,
baseURL: process.env.OPENAI_BASE_URL ?? "https://api.gpt88.cc/v1",
});
const response = await client.chat.completions.create({
model: process.env.OPENAI_MODEL ?? "gpt-5.6-sol",
messages: [{ role: "user", content: "返回 OK" }],
max_tokens: 32,
});
console.log(response.choices[0].message.content);常见错误
- 401:确认粘贴的是 API Key,不是账户密码或带空格的文本。
- 404:检查 Base URL 是否只有 https://api.gpt88.cc/v1。
- model_not_found:Model ID 必须与模型目录完全一致。
- 工具任务失败:先关闭自动批准,用短文本验证后再逐项开启工具。
价格和计费说明
Cline 不改变 GPT88 的计费规则。请求按人民币余额、模型、分组倍率及输入输出用量结算,长上下文和工具循环会增加消耗。