支持与 FAQ

这里整理了接入 HCAI 时最常见的问题。遇到报错时，建议先确认 Key、模型、令牌组、网络和余额，再联系支持。

联系支持

企业客服二维码

群二维码

QQ群二维码

一键加入 QQ 群一键联系企微客服

点击按钮可直接跳转，二维码也可长按或扫码添加。

联系时请尽量附上工具名称、模型名称、报错截图、请求时间和已打码的 Key，方便快速定位。

账号与 Key

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

• 检查复制时是否带入了空格、换行或隐藏字符。
• 确认 Key 没有过期、被禁用或被删除。
• 检查请求 Header、环境变量或配置文件中的参数名是否正确。
• 确认当前工具使用了对应的专用令牌组。
• 重新生成 Key 后，记得同步更新到工具配置中。

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

登录控制台后，可以查看当前余额、充值记录、消费明细和账单详情。若调用突然失败，也建议先确认余额和额度是否充足。

网站访问

网站打开后白屏怎么办？

白屏经常和广告过滤、脚本拦截或浏览器缓存有关。可以按下面顺序排查：

1. 暂时关闭 AdBlock、uBlock Origin、AdGuard 等广告过滤插件。
2. 将 ai.hctopup.com 加入插件白名单。
3. 刷新页面。
4. 仍未恢复时执行强制刷新：Windows 使用 Ctrl + Shift + R，macOS 使用 Cmd + Shift + R。
5. 换一个无插件浏览器窗口再次尝试。

环境与安装

Node.js 版本过低怎么办？

Claude Code 和 Codex CLI 都需要 Node.js 18+。升级方式：

• Windows：重新下载安装 Node.js LTS。
• macOS：执行 brew upgrade node，或使用官方安装包。
• Linux：使用 nvm 或 NodeSource 仓库安装新版 Node.js。

环境变量设置后不生效怎么办？

• Windows：关闭并重新打开终端，必要时重启电脑。
• macOS/Linux：执行 source ~/.bashrc 或 source ~/.zshrc，取决于你使用的 shell。
• 如果工具已启动，请完全退出后重新打开。

工具使用

Claude Code 提示连接失败怎么办？

请检查网络连接、API Key、ANTHROPIC_BASE_URL、余额和模型权限。若首次启动卡在初始化，请参考 Claude Code 部署指南 中的初始化处理说明。

Codex CLI 和 Claude Code 的令牌可以通用吗？

不建议混用。不同工具需要创建对应令牌组：

• Claude Code：使用 Claude Code 专用令牌组。
• Codex CLI：使用 codex 或平台当前标注的 Codex CLI 专用令牌组。
• OpenCode：使用兼容 OpenAI 接口的可用令牌组，并确认模型名称存在。

如果令牌组不匹配，可能出现鉴权失败、无权限访问模型或模型不存在。

模型不存在或无权限怎么办？

前往模型广场确认当前令牌组可用模型。不要手动拼接或改写模型名称，配置中必须使用列表里存在的完整模型名。

计费相关

HCAI 如何计费？

按实际使用量计费，不同模型价格不同。具体倍率、余额和消费记录以控制台显示为准。

余额不足会怎样？

余额或额度不足时，调用会暂停或失败。充值到账后通常会自动恢复。

支持退款吗？

未使用余额可联系支持咨询退款规则；已经产生消耗的部分通常不支持退回。具体处理以客服确认为准。

技术与数据

我的代码会被保存吗？

不会。HCAI 只负责请求转发、鉴权和计费统计，不会主动存储你的代码内容。

是否支持企业使用？

支持。企业用户可以联系支持咨询企业方案、大额充值、团队管理和可能的价格优惠。

更多问题

如果你遇到启动失败问题，请先查看对应的部署指南。如果遇到连接超时、鉴权报错或模型不可用，请查看接入本站 API。仍未解决时，请通过上方按钮或二维码联系支持。