客户端接入

不想写代码？大部分支持「自定义 OpenAI 接口」的软件都能直接接。

通用配置

任何这类软件，只要找到「自定义 API 地址 / Base URL」的地方，填这两项：

配置项	值
API 地址 / Base URL	`https://api.blueworkshop.top/v1`
API Key / 令牌	你的 `sk-` 开头密钥

地址要带 /v1

有的软件叫 Base URL，有的叫 API Host。统一填到 /v1 结尾。如果软件自动补 /v1，那你就只填 https://api.blueworkshop.top。

桌面客户端

软件	平台	说明
Cherry Studio	Windows / macOS	设置 → 模型服务 → 添加「OpenAI」类型，填地址和密钥
LobeChat	网页 / 桌面	设置 → 语言模型 → OpenAI → 填入自定义接口地址
ChatBox	全平台	设置 → 模型提供方 → OpenAI API → API 域名填我们的地址
NextChat	网页 / 桌面	设置 → 自定义接口 → 填地址和密钥
OpenCat	macOS / iOS	添加自定义服务商

浏览器插件

插件	用途
沉浸式翻译	设置 → 翻译服务 → OpenAI → 填地址和密钥，用它翻译网页
Sider / Monica 类	选「自定义 OpenAI」，填入地址

沉浸式翻译省钱技巧

它调用量大但每段很短。建议单独建一个令牌，模型选便宜的（如 gemini-2.0-flash），额度设上限，避免不知不觉花超。

IDE / 编辑器

工具	配置位置
Cursor	Settings → Models → Override OpenAI Base URL
Cline（VSCode 插件）	选「OpenAI Compatible」，填 Base URL 和 Key
Continue（VSCode / JetBrains）	`config.json` 里加一个 `provider: "openai"` 的模型，填 `apiBase`
Zed	settings.json 里配 `openai_compatible`

以 Cline 为例，配置大概长这样：

json

{
  "apiProvider": "openai",
  "openAiBaseUrl": "https://api.blueworkshop.top/v1",
  "openAiApiKey": "sk-你的密钥",
  "openAiModelId": "claude-3-5-sonnet-20241022"
}

命令行工具

bash

# 通用：很多 CLI 认这两个环境变量
export OPENAI_BASE_URL="https://api.blueworkshop.top/v1"
export OPENAI_API_KEY="sk-你的密钥"

有些工具写死了官方地址

如果它不认 OPENAI_BASE_URL，就看它有没有 --base-url 参数。还是没有的话，用 SDK 自己包一层更省事。

接不上时的排查顺序

地址带没带 /v1 —— 最常见的错
密钥前后有没有空格 —— 复制时容易带上
模型名对不对 —— 用 /v1/models 查到的 id，别自己拼
软件是不是强制走了官方域名的代理 —— 检查系统代理设置
看具体报错 → 错误码

还是不行的话，把软件的报错原文发到交流群（QQ 群 956766495），一般看一眼就知道卡在哪。

客户端接入 ​

通用配置 ​

桌面客户端 ​

浏览器插件 ​

IDE / 编辑器 ​

命令行工具 ​