常见问题（FAQ）

账号与 Key

可以开发票吗？

支持。累计充值满 500 元可提交开票需求，支持增值税普通发票和专用发票，请联系客服。

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

• 检查是否复制了多余空格
• 检查 Key 是否已过期或被禁用
• 检查请求 Header 和参数是否正确
• 确认使用了对应工具的专用令牌组（Claude Code / CodeX / Gemini 令牌不通用）

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

登录控制台即可查看：

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

网站访问

网站打开白屏？

很可能是广告过滤插件导致的。常见插件：AdBlock、uBlock Origin、AdGuard。

解决方法：

1. 打开插件设置
2. 将 www.apecode.cc 添加到白名单
3. 刷新页面
4. 如仍有问题，尝试强制刷新（Windows：Ctrl + Shift + R，macOS：Cmd + Shift + R）

环境与安装

npm 安装很慢 / 失败？

使用国内镜像：

`ash

设置淘宝镜像

npm config set registry https://registry.npmmirror.com

验证配置

npm config get registry `

Node.js 版本过低怎么办？

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

升级方法：

• Windows：重新下载安装最新版本
• macOS：rew upgrade node
• Linux：使用 nvm 安装最新 LTS 版本

环境变量设置后不生效？

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

工具使用

CC-Switch 无法启动？

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

Claude Code 提示连接失败？

检查以下项：

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

CodeX 和 Claude Code 的令牌不通用？

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

• Claude Code → 使用 Claude 令牌组
• CodeX → 使用 Codex 令牌组
• Gemini CLI → 使用 Gemini 令牌组

请在 ApeCode 控制台为每个工具分别创建对应的专用令牌。

计费相关

如何计费？

• 按实际 Token 使用量计费
• 不同模型价格不同，详见控制台价格页

余额不足会怎样？

• 服务暂停，充值后立即恢复
• 历史数据和配置不受影响

支持退款吗？

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

技术问题

代码会被保存吗？

不会。ApeCode 不存储您的任何代码内容，仅做请求转发。

是否支持企业使用？

支持，企业用户可以：

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

如何获得技术支持？

请查看联系我们页面获取联系方式。