常见问题
Claude Code、Codex 与 Gemini CLI 排查指南
通用问题
401 或 403
- 确认 API Key 完整且未被吊销。
- 确认请求实际发送到
api.tokenbyte.ai。 - 检查 Key 的模型白名单和分组权限。
模型名称怎么填？
从模型列表或模型市场复制完整 ID，不要根据厂商官网名称猜测。
429 请求过多
降低并发，检查余额及 Key 的 RPM/TPM 设置，并对重试使用指数退避。
Claude Code
- Base URL：
https://api.tokenbyte.ai，不要追加/v1。 - Key 使用
ANTHROPIC_AUTH_TOKEN。 - 协议详情见 Claude Code / Messages。
Codex
- Base URL：
https://api.tokenbyte.ai/v1。 - 自定义 Provider 使用
wire_api = "responses"。 OPENAI_API_KEY与配置中的env_key必须一致。
Gemini CLI
- 使用
GEMINI_API_KEY保存 TokenByte Key。 - 使用
GOOGLE_GEMINI_BASE_URL=https://api.tokenbyte.ai。 - 启动时选择 Use Gemini API key。