# 常见问题（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>)联系客服