常见问题（FAQ）

账号与 Key

可以开发票吗？

支持普通发票和专用发票。实际消费满 ¥500 可提交开发票需求。

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

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

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

登录控制台可以查看：

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

---

网站访问

网站进入为什么白屏？

很可能由广告过滤插件导致。需要将域名添加到白名单。

常见的广告过滤插件：AdBlock、uBlock Origin、AdGuard

解决方法：

1. 打开插件设置
2. 添加 api.codekey.cc 到白名单
3. 刷新页面

---

环境与安装

npm 安装很慢/失败？

使用国内镜像加速：

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

Node.js 版本过低怎么办？

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

升级方法：

• Windows：重新安装最新 LTS 版本
• 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 的令牌不通用？

是的，不同工具需要不同的令牌组。在 CodeKey 平台创建对应的专用令牌。

---

计费相关

如何计费？

按实际使用量计费，不同模型价格不同。

余额不足会怎样？

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

支持退款吗？

• 未使用的余额可申请退款
• 已使用部分不支持退款

---

技术问题

代码会被保存吗？

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

是否支持企业使用？

支持。企业用户可联系客服获取企业方案，支持大额充值和发票。

如何获得技术支持？

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

---

更多问题

如遇技术难题，查看 疑难杂症排查指南。

若仍未解决：

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