160 lines
3.4 KiB
Markdown
Raw Normal View History

# 常见问题FAQ
## 账号与 Key
### 1\. 可以开发票对吧?
对。支持普票、专票。累计充值满500元可提交开发票需求。
### 2\. Key 无效/鉴权失败怎么办?
* 检查是否复制了多余空格
* 检查 Key 是否过期/被禁用
* 检查请求是否使用了正确的 Header/参数
* 确认使用了对应工具的专用令牌组
### 3\. 如何查看余额和消费记录?
登录控制台即可查看:
* 当前余额
* 充值记录
* 消费明细
* 账单详情
## 网站访问
### 网站进入为什么白屏?
很有可能是你的广告过滤插件导致,请手动将我们的域名添加到白名单。
常见的广告过滤插件:
* AdBlock
* uBlock Origin
* AdGuard
解决方法:
1. 打开插件设置
2. 添加 `api.ikuncode.cc` 到白名单
3. 刷新页面
4. 尝试浏览器强制刷新Windows`Ctrl + Shift + R`macOS`Cmd + Shift + R`
## 环境与安装
### npm 安装很慢/失败?
可以使用国内镜像:
bash
# 设置淘宝镜像
npm config set registry https://registry.npmmirror.com
# 验证配置
npm config get registry
1
2
3
4
5
### 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 令牌组
请在 IkunCode 平台创建对应的专用令牌。
## 计费相关
### 如何计费?
* 按实际使用量计费
* 不同模型价格不同
* 详细计费规则请查看控制台
### 余额不足会怎样?
* 服务会暂停
* 请及时充值以继续使用
* 充值后立即恢复服务
### 支持退款吗?
* 未使用的余额可以申请退款
* 已使用的部分不支持退款
* 具体政策请咨询客服
## 技术问题
### 代码会被保存吗?
不会。我们不会存储您的代码内容,仅转发请求和响应。
### 是否支持企业使用?
支持。企业用户可以:
* 联系客服获取企业方案
* 支持大额充值和发票
* 可能享受优惠价格
### 如何获得技术支持?
请查看[售前售后](</support/after-sales>)页面获取联系方式。
## 更多问题
### 遇到技术难题?
如果遇到启动失败、报错、超时等技术问题,请查看:
👉 **[疑难杂症排查指南](</support/troubleshooting>)** \- 详细的错误排查和解决方案
### 仍未解决?
如果上述问题没有解决您的疑问,请:
* 加入 Telegram 群组:<https://t.me/ikuncode>
* 查看[售前售后](</support/after-sales>)联系客服