大约 3 分钟
常见问题（FAQ）
报错了？先别慌着改配置。90% 的问题都在这页能定位到答案。
还没完成基础接入？
这里是排障入口，不是从零教程。如果你还没注册、充值或建过令牌，先去 快速开始 走完 5 步。
一眼看懂最常踩的 3 个坑
坑 1：Base URL 三个工具填法不一样
- Claude Code：
https://www.yuzhixiaolongxia.com（不带 /v1） - Codex CLI：
https://www.yuzhixiaolongxia.com/v1（带 /v1） - Gemini CLI：
https://www.yuzhixiaolongxia.com/（末尾必须有斜杠）
填错就是 401 / 404 / connection error，几乎所有新手都在这里栽过。
坑 2：令牌分组要选对
在 /console/token 建令牌时，分组栏一定要选对应家族：
| 你要用的工具 | 必须选的分组 |
|---|---|
| Claude Code | Claude 家族 |
| Codex CLI / GPT 模型 | Codex 家族 |
| Gemini CLI / Gemini 模型 | Gemini 家族 |
| 生图模型 | 对应的图片家族分组 |
| 视频模型 | 对应的视频家族分组 |
分组错配 = 403 报错，而且这种 403 在余额充足时也会出现，最容易被误判。
坑 3：模型 ID 写死了不更新
模型版本在迭代，旧 ID 可能下线。任何时候模型报 model not found，先去 /pricing 复制最新 ID，不要凭记忆手敲。
按错误码先定位
| 报错 | 99% 是这个原因 | 怎么动手 |
|---|---|---|
| 401 Unauthorized / invalid token | 令牌没填、填错、或环境变量名搞错 | 重新复制令牌，检查 ANTHROPIC_AUTH_TOKEN / OPENAI_API_KEY / GEMINI_API_KEY 是否写对 |
| 403 余额不足 / 无权限 | 余额耗尽，或令牌分组里没这个模型 | 看 /console/personal 余额；查 /console/token 令牌分组 |
| 404 model not found | 模型 ID 写错或已下线 | /pricing 复制最新 ID |
| 429 请求太快 | 短时间并发或请求频次过高 | 等 5–10 秒再试，或降低并发 |
| 5xx | 上游短暂故障 | 等 1 分钟再试；若持续，看 监控状态 |
按工具看 FAQ
Claude Code
Claude Code 常见问题 — 装不上、command not found、401/403、回复断开、模型 ID 等
Codex CLI
Codex CLI 常见问题 — base_url 要带 /v1、配置文件路径、模型 ID、流式输出等
Gemini CLI
Gemini CLI 常见问题 — base URL 末尾斜杠、环境变量名、生图替代方案等
通用问题（5 件事都在控制台里）
| 想做的事 | 去哪里 |
|---|---|
| 充值 | /console/topup |
| 查模型 ID / 售价 | /pricing |
| 创建 / 查看令牌 | /console/token |
| 看个人余额、消耗记录 | /console/personal |
| 看分组倍率与权限 | /console/token 的"分组"列 |
几条让你少踩坑的小事
- Claude 流式断线不扣费：客户端中断、超时、
scanner_error之类的流式异常，平台已自动跳过扣费，放心重发。 - 4K 关键词自动识别：生图提示词里写"4K"会自动产出 4K 图，费用 +15%，不用再额外加参数。
- 改完环境变量记得重开终端，不然新值不会生效，这是远比配置错误更常见的"看似没生效"。
排障 5 步法（80% 的问题在前两步搞定）
- 重新复制一次令牌，确认前后没有多余的空格、换行。
- 确认令牌分组和工具家族对得上（Claude Code 用 Claude 家族，Codex 用 Codex 家族……）。
- 看
/console/personal余额够不够；令牌本身有没有单独额度上限。 - 重启终端再试一次（很多人忘了这步，旧环境变量还在内存里）。
- 同一台机器上是否还残留旧配置文件、旧环境变量（比如
OPENAI_API_KEY、ANTHROPIC_API_KEY）。
按这 5 步走，绝大多数问题在前两步就解决了。
还没解决？
- 看 监控状态页 确认平台是否有公告
- 留意主站首页公告位
- 在群里贴出错误日志 + 你的 Base URL + 模型 ID + 令牌分组这 4 项，定位很快