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

验证方式

  1. 让 Cline 解释当前项目 README。
  2. 让它修改一个无风险的小文件。
  3. 确认文件确实落盘,再执行复杂任务。

排障清单

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-sol

API 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 的计费规则。请求按人民币余额、模型、分组倍率及输入输出用量结算,长上下文和工具循环会增加消耗。

立即创建 API Key