Claude Code 使用 GPT88 API
把 Claude Code 配置为 OpenAI 兼容 API,快速验证 API Key、模型和端点。
Claude Code 这里最容易出错的是“把模型接入”和“把插件登录”混成一件事。 如果目标只是让模型可用,API Key 就够了;如果目标是插件与账号权益,必须走 OAuth。
先理解这页讲什么
- 模型调用怎么接 gpt88.cc。
- 插件能力为什么会和 OAuth 绑定。
- 切换时要先清理什么。
准备工作
checklisttext
1. 先判断你要的是模型调用还是插件能力
2. 模型调用优先走 API Key
3. 插件能力优先走 OAuth
4. 切换前先清理旧环境变量
5. 用最小任务验证切换是否成功快速配置
setuptext
1. 安装 Claude Code
2. 准备 API Key 或 OAuth 登录
3. 如果用 gpt88.cc,中转站走 OpenAI/Claude 兼容配置
4. 如果需要插件能力,改用 OAuth 登录
5. 先跑一条最小任务验证工具链模式差异
- API Key 模式:更适合直接调用模型。
- OAuth 模式:更适合插件、扩展能力和账号权益。
验证方法
- 先跑一条简单任务,看模型输出是否正常。
- 如果插件面板不可见,再切换到 OAuth 流程。
- 切换后重启会话,确认环境变量没有残留。
排障清单
troubleshootingtext
1. 插件不可用
- 先确认是不是 API Key 模式
- 如果要插件,改用 OAuth
2. 反复 reconnect
- 检查代理变量
- 检查会话是否被旧配置污染
3. 模型调用失败
- 先检查 Base URL 和 Key
- 再确认模型名下一步
问题是什么
Claude Code 需要区分模型调用和 OAuth 插件能力。模型调用至少需要 OpenAI 兼容地址、API Key 和模型名。
最短可用配置
.envbash
export OPENAI_API_KEY=sk-替换为你创建的Key
export OPENAI_BASE_URL=https://api.gpt88.cc/v1
export OPENAI_MODEL=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);常见错误
- 变量缺失:在启动 Claude Code 的同一个 shell 中检查环境变量。
- 401:重新复制 API Key,不要填网页登录密码。
- 404 model:从 GPT88 模型目录复制可用模型名。
- 工具调用失败:先用纯文本请求验证端点,再确认客户端版本和协议支持。
价格和计费说明
Claude Code 的多轮上下文会增加输入用量。GPT88 按人民币余额和当前模型/分组倍率结算,最终以使用记录为准。