大约 2 分钟
常见问题
这里不是“从零开始教程”，而是“已完成基础接入后”的排障入口。
如果你还没完成注册、令牌和 CLI 基础配置，请先回到快速开始或CLI 配置。
按症状快速定位
| 你看到的症状 | 先排查什么 | 对应入口 |
|---|---|---|
401、Unauthorized、invalid token | 令牌是否正确、是否过期、是否使用了旧环境变量 | Claude Code FAQ / Codex FAQ / Gemini FAQ |
model not found、模型列表为空 | 令牌绑定分组是否匹配当前工具 | 令牌分组介绍 |
| 请求超时、连接失败、偶发 5xx | 本地网络、代理配置、请求长度与并发 | Codex FAQ / Gemini FAQ |
| 换电脑后不可用、同账号多机结果不一致 | 配置文件路径、环境变量加载顺序、终端是否重启 | CLI 配置 |
| 已充值但仍提示额度不足 | 钱包余额是否到账、令牌额度上限、分组倍率 | （3）额度说明与充值 |
| 切换令牌后仍走旧配置 | 旧变量未清理、旧进程未重启、缓存会话未刷新 | 令牌分组介绍 |
建议排障顺序
- 先确认账号余额与令牌状态正常。
- 再确认令牌绑定的分组和当前工具一致。
- 再看本地配置是否被旧环境变量覆盖。
- 最后排查网络、并发和超时参数。
多数问题都能在前 2 步定位，不建议一开始就改很多配置。
通用检查清单（先做这 5 项）
- 你当前终端使用的令牌是否就是刚创建/刚切换的那一枚。
- 该令牌绑定的分组是否支持你正在调用的模型。
- 钱包余额是否足够，且令牌没有单独额度上限。
- 切换配置后是否重启了终端或对应 CLI 进程。
- 同一台机器是否存在旧配置文件或旧代理残留。
何时不要继续刷 FAQ
遇到下面情况，先回前置文档更省时间：
- 你还不确定令牌在哪里创建、怎么绑定分组。
- 你还没做过一次最小请求验证。
- 你无法定位当前工具读取的是哪个配置文件。