使用教程

把常用 AI 客户端接到本站网关。下面按「先看什么」排好了顺序，照着走就行。

优先看这 5 个

兜底教程 · 让别的 AI 手把手教你配

配置卡住了、报错看不懂、文档太乱？最省事的兜底办法——打开任意一个能用的 AI（DeepSeek 官网、豆包、Kimi、ChatGPT 都行）， 把下面这套「求助模板」发给它，它会一步一步带你点。比翻帖子快，也比自己瞎试省时间。

第一步：把「配置求助模板」整段发给 AI

先填好你的软件名和版本，其余照抄即可：

我在配置一个 AI 客户端软件，要接入一个「OpenAI 兼容」的中转接口。
接口信息：
- Base URL：https://api.juheai.shop/v1   （如果这是 Claude 系软件，改为 https://api.juheai.shop，不带 /v1）
- API Key：sk-****（我已有，完整密钥不便提供）
- 可用模型：deepseek-v4-flash、deepseek-v4-pro、gemini-3.1-pro、claude-sonnet-5-5
我用的软件是：【写软件名和版本，例如「SillyTavern 最新版」】
这个软件是图形界面，还是命令行？【按实际情况写】

请一步一步告诉我：在软件的哪个菜单、点哪个按钮、每个字段填什么。
假设我是完全没用过的小白，每一步都要具体，并告诉我做完之后怎么验证是否成功。

第二步：把报错原文喂回去

如果按它说的配完还是报错，别自己猜——把报错原文再发给它，并补上这句：

我按你说的配置后，软件报错如下：
【粘贴报错原文，或把报错截图转成文字】
我之前填的 Base URL 是 https://api.juheai.shop/v1，软件是【软件名 + 版本】。
请分析最可能的原因，并给我一步步的修复步骤；如果涉及模型名，请只使用我上一条列出的可用模型。

第三步：拿到步骤后，先核对这三件事再用

进阶：让 AI 帮你逐行核对配置文件

如果你已经有一份配置文件（config.toml / settings.json / .env 等），可以整份贴给它，让它在不泄露密钥的前提下逐行解释、指出哪里填错：

下面是我的配置文件（密钥已打码）。请逐行说明每项作用，并指出接入中转接口时哪里填错、应改成什么：
【粘贴配置文件内容，密钥打码】

问题解答 · 高频疑问

把最常遇到的「断 / 慢」放第一个，其余按错误码和常见疑问排好，点开即可看答案。

let delay = 1;
for (let attempt = 0; attempt < 5; attempt++) {
  try { return await callAPI(); }      // 成功就返回
  catch (e) {
    if (e.status === 401) throw e;     // 密钥错了别重试，直接报错
    await sleep(delay * 1000);         // 否则等一会再试
    delay *= 2;                        // 间隔翻倍：1s → 2s → 4s …
  }
}

按软件接入

每个客户端都是独立的一页，安装方式、配置位置、要填的字段都不一样，别把不同工具的做法混用。 标了「无需写代码」的是图形界面客户端——打开设置、填接口地址和密钥、选模型即可，全程点一点； 命令行类（CLI）按页内命令操作。

Claude 系

Codex 系

三个不同的东西，其中 Codex++ 是第三方工具。

统一管理 / 其他

Agent 框架

聊天 / 角色扮演

还没想好用哪个模型？

开始之前：两样东西

不管用哪个客户端，都只需要两样东西：

1. 接口地址（Base URL）

本站的接口地址是：

https://api.juheai.shop

要不要带 /v1，取决于客户端用哪种协议：

每个客户端章节里都会再写一次该填哪个。

2. API 密钥

在网站的「API 密钥」页面创建一把密钥，形如 sk-xxxxxxxx。创建后请立即复制保存 —— 离开页面后就无法再看到完整内容。