常见问题（FAQ）

账号与 Key

1. 可以开发票吗？

可以，支持普票和专票。累计充值满 500 元可提交开票需求。

2. Key 无效 / 鉴权失败怎么办？

• 检查是否复制了多余空格
• 检查 Key 是否过期或被禁用
• 检查请求是否使用了正确的 Header / 参数
• 确认使用了对应工具的专用令牌组

3. 如何查看余额和消费记录？

登录 oneinai 控制台 即可查看：

• 当前余额
• 充值记录
• 消费明细
• 账单详情

网站访问

网站打开为什么白屏？

很可能是浏览器的广告过滤插件导致，请手动将我们的域名添加到白名单。

常见的广告过滤插件：

• AdBlock
• uBlock Origin
• AdGuard

解决方法：

1. 打开插件设置
2. 将 api.oneinai.com 添加到白名单
3. 刷新页面
4. 必要时使用浏览器强制刷新（Windows：Ctrl + Shift + R，macOS：Cmd + Shift + R）

环境与安装

npm 安装很慢 / 失败？

可以切换为国内镜像：

# 设置淘宝镜像
npm config set registry https://registry.npmmirror.com

# 验证配置
npm config get registry

Node.js 版本过低怎么办？

Claude Code、CodeX 和 Gemini CLI 都需要 Node.js 18+ 版本。

升级方法：

• Windows：重新下载安装最新版本
• macOS：brew upgrade node
• Linux：使用 nvm 或 NodeSource 仓库

环境变量设置后不生效？

• Windows：重启终端窗口或重启电脑
• macOS / Linux：执行 source ~/.bashrc 或 source ~/.zshrc

工具使用

CC-Switch 无法启动？

1. 检查是否有权限问题
2. 尝试以管理员身份运行
3. 查看是否有杀毒软件拦截
4. 重新下载安装最新版本

Claude Code 提示连接失败？

请按顺序排查：

• 网络连接是否正常
• API 密钥是否正确
• 环境变量是否设置正确
• 余额是否充足

CodeX 和 Claude Code 的令牌不通用？

是的，不同工具需要不同的令牌组：

• Claude Code：使用 Claude Code 令牌组
• CodeX：使用 codex 令牌组
• Gemini CLI：使用 Gemini 令牌组

请在 oneinai 平台创建对应的专用令牌。

计费相关

如何计费？

• 按实际使用量计费
• 不同模型价格不同
• 详细计费规则请查看控制台

余额不足会怎样？

• 服务会暂停
• 请及时充值以继续使用
• 充值后立即恢复服务

支持退款吗？

• 未使用的余额可以申请退款
• 已使用的部分不支持退款
• 具体政策请咨询客服

技术问题

代码会被保存吗？

不会。我们不会存储你的代码内容，仅转发请求与响应。

是否支持企业使用？

支持。企业用户可以：

• 联系客服获取企业方案
• 支持大额充值和开票
• 可能享受优惠价格

如何获得技术支持？

请查看售前售后 页面获取联系方式。

更多问题

遇到技术难题？

如果遇到启动失败、报错、超时等技术问题，请查看：

👉 疑难杂症排查指南 - 详细的错误排查与解决方案

仍未解决？

如果上述内容没有解决你的疑问，请联系我们：

• 加入 Telegram 群组：https://t.me/oneinai
• 查看售前售后 联系客服