Aiapi-doc/support/faq.md

# 常见问题（FAQ）

## 账号与 Key

### 1. 可以开发票吗？

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

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

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

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

登录 [oneinai 控制台](https://api.oneinai.com/console/token) 即可查看：

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

## 网站访问

### 网站打开为什么白屏？

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

常见的广告过滤插件：

- AdBlock
- uBlock Origin
- AdGuard

解决方法：

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

## 环境与安装

### npm 安装很慢 / 失败？

可以切换为国内镜像：

```bash
# 设置淘宝镜像
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 平台创建对应的专用令牌。

## 计费相关

### 如何计费？

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

### 余额不足会怎样？

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

### 支持退款吗？

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

## 技术问题

### 代码会被保存吗？

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

### 是否支持企业使用？

支持。企业用户可以：

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

### 如何获得技术支持？

请查看[售前售后](/support/after-sales) 页面获取联系方式。

## 更多问题

### 遇到技术难题？

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

👉 **[疑难杂症排查指南](/support/troubleshooting)** - 详细的错误排查与解决方案

### 仍未解决？

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

- 加入 Telegram 群组：<https://t.me/oneinai>
- 查看[售前售后](/support/after-sales) 联系客服