主题切换
疑难杂症
当你遇到工具无法调用、认证失败或结果异常时，建议先不要立刻更换工具或重装环境，先按本页的顺序定位问题。
先做三件事定位问题
1. 检查账户与余额
确认你已经：
- 成功登录 https://luminatoken.cc
- 创建了可用 API Key
- 账户余额足以支撑当前调用
2. 检查地址与认证
确认你当前工具使用的是正确地址：
- OpenAI 兼容：
https://api.luminatoken.cc/v1 - Anthropic 风格：
https://api.luminatoken.cc或对应 SDK 配置的根地址
同时确认 Key 没有复制错误、空格或换行。
3. 检查工具是否真的读取到了配置
很多问题不是 Key 错了，而是工具没有读到你设置的环境变量或配置文件。请确认：
- shell 配置是否已重新加载
- 配置文件路径是否正确
- 没有旧配置覆盖新配置
Claude Code 常见问题
安装后找不到命令
- 确认
npm install -g @anthropic-ai/claude-code已成功执行 - 确认全局 npm bin 目录在
PATH中 - 重新打开终端再试
配置了环境变量但仍然请求失败
检查：
bash
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN常见原因：
ANTHROPIC_BASE_URL写错ANTHROPIC_AUTH_TOKEN不是 LuminaToken 的 Key- shell 没重新加载
Claude Code 可以启动，但模型调用超时
优先检查：
- 网络是否正常
- Key 是否有效
- 账户是否有余额
- 当前请求是否过大，导致等待时间过长
Codex 常见问题
config.toml 与 auth.json 都写了，但请求没走 LuminaToken
优先检查：
base_url是否为https://api.luminatoken.cc/v1- 是否存在项目级局部配置覆盖全局配置
- 当前 Codex 版本字段名是否发生变化
认证失败
优先检查：
auth.json是否是合法 JSON- API Key 是否复制完整
- 是否仍保留了其他旧认证方式
模型名报错
示例中的模型名称仅用于演示。实际请替换成你当前账号可用模型。
Gemini CLI 常见问题
为什么按文档配置了还不工作
最常见原因是你当前版本并不支持自定义兼容网关。Gemini CLI 的不同版本差异较大，本页文档给出的是“支持自定义 provider 时”的通用接入思路。
如何判断是不是版本能力问题
可以检查：
- 官方文档是否提到自定义 endpoint
- 是否支持 OpenAI 兼容配置
- 是否支持从环境变量读取自定义 provider
如果这些都不支持，建议不要继续强行配置。
更稳妥的替代方案
对于代码任务和工程接入，优先使用 Claude Code 或 Codex。
通用排查模板
当你联系客服（QQ：1580925976@qq.com）时，建议一次性提供这些信息：
| 信息 | 示例 |
|---|---|
| 使用工具 | Claude Code / Codex / Gemini CLI |
| 操作系统 | macOS / Windows / Linux |
| 请求时间 | 例如 2026-05-10 14:30 |
| 配置方式 | 环境变量 / 配置文件 |
| Base URL | 你实际填写的地址 |
| 错误信息 | 完整报错原文 |
处理原则
排障时最有效的方式不是反复改很多地方，而是一次只验证一个变量：
- 先验证 CLI 是否安装正常
- 再验证环境变量或配置文件
- 再验证最小请求
- 最后才检查复杂业务逻辑
这样最容易快速定位问题根源。