Cline 配置 OpenAI 兼容 API

Cline 自定义 OpenAI 兼容提供商的配置、最短请求和常见错误排查。

先让 Cline 读取一个小文件,确认 provider、model 和工具链都正常。

配置方法

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