常见问题

本页汇总 LuminaToken 使用过程中最常见的问题，按主题分类整理。

账号与 API Key

注册后第一步做什么

先登录控制台，确认可以进入 API Key 管理页面，然后创建一个专门用于当前工具的 Key。

一个账号可以创建多个 Key 吗

通常建议创建多个 Key，并按设备、工具或项目拆分使用，这样更安全，也更方便排查消费来源。

API Key 泄露了怎么办

立即在控制台删除原 Key，并重新创建新 Key。不要继续依赖可能已经泄露的旧 Key。

Key 可以直接写进代码仓库吗

不建议。推荐使用环境变量、密钥管理工具或本机认证文件。

Base URL 应该填什么

• OpenAI 兼容场景：https://api.luminatoken.cc/v1
• Anthropic 风格场景：通常使用 https://api.luminatoken.cc 或 SDK 兼容的根地址配置

如果文档中对某个工具有专门说明，请优先按对应工具页配置。

充值相关

充值汇率是多少

充值汇率以控制台充值页面实时显示为准，请登录 控制台 查看。

支持什么支付方式

当前支持支付宝扫码支付。

充值后多久到账

通常在支付成功后较快到账。若未及时显示，请先刷新控制台页面，再联系客服（QQ：1580925976@qq.com）。

建议一次充多少

如果你是首次使用，建议先小额充值，先完成接入和链路验证，再根据实际消耗决定后续额度。

工具使用相关

Claude Code 配置后没有生效怎么办

优先检查：

1. ANTHROPIC_BASE_URL 是否正确
2. ANTHROPIC_AUTH_TOKEN 是否正确
3. shell 配置文件是否已重新加载

Codex 为什么提示认证失败

优先检查：

• ~/.codex/auth.json 中的 Key 是否完整
• ~/.codex/config.toml 是否指向 https://api.luminatoken.cc/v1
• 是否存在其他冲突配置

Gemini CLI 一定能接入吗

不一定。Gemini CLI 的不同版本对自定义兼容网关支持差异较大。若你的版本支持 OpenAI 兼容或自定义 provider，则可以按文档思路配置；否则建议优先使用 Claude Code 或 Codex。

直接调 API 应该选哪种格式

• 使用 OpenAI SDK 或兼容工具，选 OpenAI 格式
• 使用 Claude 风格 SDK 或工具，选 Anthropic 格式

还有问题怎么办

如果以上问题没有覆盖你的情况，请阅读 疑难杂症；如果仍无法解决，请前往 获取支持。