快速自查清单
报错了先看这页：按你看到的现象找到对应的专题，能省掉大部分来回。
📌
三步走，先别急着提问
- 看服务状态页 https://status.fluxtoken.ai/ —— 各分组实时可用率。 如果整个分组都在波动，那不是你的配置问题，等或换分组。
- 对着报错原文查 —— 报错原文索引。 搜你屏幕上具体那行字，不要搜「Gemini 报错」。
- 还没解决再进群 —— QQ 群
1108757955或 Telegram https://t.me/fluxtokengroup。
症状 → 去哪个页面
| 你看到的 / 你的情况 | 去这里 |
|---|---|
模型不存在、model not found | 模型不存在 / 分组选错 |
401、Invalid API key、令牌已过期、余额不足 | 认证与 401 |
| 扣费比预期多、余额没变但请求失败、充值没到账 | 余额与扣费 |
ETIMEDOUT、ECONNREFUSED、SSL certificate problem、stream error、首字慢 | 连接与超时 |
| Claude Code 相关的报错 | Claude Code 专题 |
| Codex / Codex CLI 相关的报错 | Codex 专题 |
| Gemini 相关的报错、Gemini CLI 怎么配 | Gemini 专题 |
| 想在 Claude Desktop 里用、外接失败 | Claude Desktop 专题 |
不知道 404 是什么意思 | 错误码对照 |
| 只是不知道选哪个分组 | 怎么选分组 |
| 想知道某模型多少钱 | 模型价格表 |
通用排查顺序
不管什么报错，按这个顺序走。每一步都比上一步更具体，别跳步：
- 看服务状态页 https://status.fluxtoken.ai/ 确认是不是上游渠道在波动。是波动 → 等一会，或换分组，不用改配置。
- 打出报错原文 多数客户端把错误折叠了。在终端里跑一次原命令，或让客户端显示完整错误。 没有原文，什么也判断不了。
- 核对端点地址 OpenAI 兼容要带
/v1，Anthropic 兼容不带。这是最高频的低级错误。 对照接口总览里的「/v1该怎么给」表。 - 核对模型名与分组 模型名逐字对照模型列表。 确认令牌所属分组里确实有这个模型 —— 没有就是
模型不存在。 - 核对令牌本身 控制台 → 令牌管理：令牌还在吗？过期了吗？额度上限到了吗？ IP 白名单、模型限制有没有卡住？
- 改完要重启客户端 改分组、改环境变量之后，正在运行的程序不会自动重连。 关掉终端重开，或重启客户端。
- 看控制台的错误请求记录 平台允许用户查看自己的错误请求，里面有失败原因和时间。
- 换一个分组试 能通 → 是渠道问题；还不通 → 是配置问题。这一步能把问题范围砍一半。
- 带齐信息进群 见下节。
进群提问该带什么
信息不全的提问通常要来回好几轮，附上这几项基本一次就能判断：
| 项 | 从哪拿 |
|---|---|
| 发生时间（含时区） | 你本机时间即可，站点时区是 Asia/Shanghai |
| 模型名 | 你填进客户端的那一串，逐字复制 |
| 分组名 | 控制台令牌管理里显示的完整分组名，含 【】 |
| 完整报错原文 | 别截图半截，把整段文字贴出来 |
| 请求 ID | 响应头 x-request-id / x-client-request-id，或控制台的错误请求记录 |
| 用的客户端与版本 | 例如「Claude Code 2.x」「Cherry Studio 1.x」 |
| 端点地址 | 你填的是 cn 还是 api 那个地址 |
报错原文里的请求 ID 很有用
排查渠道问题时，服务端凭 x-request-id 能直接定位到那一次请求的日志。 带上它，效率完全不同。
两件必须先搞懂的事
80% 的「文档说的和实际不一样」都来自这两条，先花两分钟建立印象：
一、实付价 = 基准价 × 分组倍率模型广场展示的是基准价，不含倍率。 你真正被扣的钱是「基准价 × 该分组倍率」。 要看乘好的数字，去模型价格表。
二、令牌绑定了分组，分组决定了能用哪些模型 同一个平台账号下，令牌 A 能用 Claude，令牌 B 只能用 Codex，这是正常的 —— 它们分组不同。 换分组之后，记得重启客户端。
还不行怎么办
- 服务状态页：https://status.fluxtoken.ai/
- 报错原文索引 —— 再搜一遍你的报错原文
- QQ 群
1108757955· Telegram https://t.me/fluxtokengroup（进群可领免费试用额度） - 涉及账务的争议，按服务特定条款里的流程走官方客服渠道
群里的口头说法不算政策
非官方人员、群聊成员的说法不构成对条款的修改。 涉及退款、费用、地区限制这类事，以条款与政策和官方客服的答复为准。