错误排查
先记录 HTTP 状态码、错误体中的 code 或 type，以及响应中的 request-id
或 x-request-id。不要在截图或工单中包含 API Key。
无法注册或邀请码不可用
生产环境只允许邀请制注册：没有邀请码不能注册，每个邀请码只能成功兑换一次。
请检查邀请码是否完整、是否已经被成功兑换；不要在公开群聊、截图或工单中粘贴
完整邀请码。注册成功时账户获得 8.00 USD 试用额度，7 天试用期从兑换成功时
开始计算，且只能调用全局试用白名单模型。
401：认证失败
检查：
- Key 是否完整、是否已在控制台吊销。
- OpenAI 接口是否使用
Authorization: Bearer ...。 - Anthropic 接口的
x-api-key与 Bearer 是否冲突。 - Key 是否被意外放进 URL；敏感查询参数会被拒绝。
不要通过在聊天中粘贴完整 Key 来验证。直接吊销并新建通常更安全。
402 / 429：余额或额度不足
insufficient_quota：账户可用余额不足以预留本次请求的费用上限。rate_limit_error：可能来自网关或上游限速，请参考retry-after后重试。
当前没有 Stripe Checkout、在线支付或自动充值。控制台 余额与用量 页面中的
充值入口只用于联系管理员，不会创建支付订单。试用额度耗尽或 7 天试用期结束后，
请联系管理员；余额、用量和账本时间按 UTC+8（Asia/Shanghai）展示。
404：模型不存在
确认模型名位于模型列表的受支持范围。模型可能在上游可见，但 尚未由管理员创建并启用价格版本；此时同样无法调用。试用账户还必须确认该模型 已经加入全局试用白名单，普通上架模型不会自动开放给试用账户。
400：流式请求缺少用量
Chat Completions 流式请求需设置：
{
"stream": true,
"stream_options": {"include_usage": true}
}
错误码为 stream_usage_required 时，补上该字段后重试。
501：Responses API 不可用
当前模型没有开放 Responses 能力。普通 SDK 可切换到
/v1/chat/completions；Codex CLI 必须切换到 YiJue 已发布且支持 Codex
Responses 的模型。
Codex CLI 提示缺少 YIJUE_API_KEY
每个新终端都需要先加载安装器生成的私有环境脚本：
source "${CODEX_HOME:-$HOME/.codex}/yijue-api-key-env.sh"
codex
脚本从 macOS Keychain 或 Linux Secret Service 读取 Key，不包含明文 Key。
也可以运行安装器的 status 检查配置、脚本与系统凭据状态：
curl -fsSL https://yijue.ai/docs/install/yijue-codex-setup.py | python3 - status
Claude Code 仍在使用旧服务
查看环境变量：
env | grep -E '^ANTHROPIC_(AUTH_TOKEN|API_KEY|BASE_URL)='
Shell 中的 ANTHROPIC_AUTH_TOKEN 与 ANTHROPIC_API_KEY 可能覆盖一键配置
写入的凭据。确认来源后，从对应的 Shell 配置文件或启动环境中移除旧值，再重新
打开终端。
查看安装器状态：
curl -fsSL https://yijue.ai/docs/install/yijue-claude-setup.py | python3 - status
Claude Code 提示 count_tokens
/v1/messages/count_tokens 暂未实现。Claude Code 通常会本地估算；如果第三方
客户端强制依赖该接口，目前不在兼容范围内。
/model 仍显示旧模型
完全退出所有 Claude Code 进程后重新启动。正常情况下 Claude Code 会重新请求
YiJue 的模型列表，显示名称为真实模型名，调用 ID 以 claude-yijue/ 开头。
如果仍有旧的手写条目，重新执行一键安装器以升级默认映射；旧版安装器创建的
apiKeyHelper 会自动迁移。你自己添加的 ANTHROPIC_CUSTOM_MODEL_OPTION 不属于
安装器所有，请确认后手动移除。不要同时保留旧的 Shell 鉴权变量。
收集最小诊断信息
可以提供：
- UTC 时间与请求路径，不含查询中的敏感值；
- HTTP 状态码、错误
code/type； request-id/x-request-id；- 客户端名称与版本；
- 是否为流式请求。
不要提供完整 API Key、Authorization 请求头、系统钥匙串内容或包含 Key 的环境 变量输出。