# 常见问题（FAQ）

## QCode.cc 平台

### Q: API Key 在哪里获取？

**A:** 登录 [QCode.cc 控制台](https://qcode.cc/dashboard)，在「API Key 管理」页面创建或查看你的 API Key。

### Q: API Key 以什么开头？

**A:** QCode.cc 的 API Key 以 `cr_` 开头，如 `cr_xxxxxxxxxxxxxx`。

### Q: 为什么我的 API Key 无法使用？

**A:** 常见原因：

1. **复制错误**：检查是否有多余空格或缺少字符
2. **订阅过期**：在 [控制台](https://qcode.cc/dashboard) 检查账户状态
3. **环境变量未生效**：重新打开终端或运行 `source ~/.zshrc`
4. **API 端点错误**：确认 `ANTHROPIC_BASE_URL` 设为 `https://api.qcode.cc/api`

### Q: API Key 泄露了，怎么换一把？

**A:** 分两种密钥：

- **主 API Key（`cr_` 开头）**：目前没有自助重置入口，请尽快联系[在线客服](javascript:void(Tawk_API.toggle()))或发邮件到 [hi@qcode.cc](mailto:hi@qcode.cc) 处理。同时按 [安全最佳实践](/docs/advanced/security) 检查密钥有没有进过 Git 历史或日志。
- **开放 API 访问令牌（`rsk_` 开头，合作伙伴用）**：在控制台「开放 API / 访问令牌」页点**重置**即可换发，**旧令牌立即失效**。见 [合作伙伴开放 API](/docs/reference/partner-api)。

---

## 用量与套餐

### Q: 如何查看当前会话的用量？

**A:** 有两种方式：

**Dashboard（推荐）**：登录 [控制台](https://qcode.cc/dashboard)，在「使用统计」页面查看模型调用次数、费用明细和套餐消耗情况。

**CLI 内快速查看**：使用 `/cost` 命令查看当前会话概况：
```
/cost
```

> Dashboard 的计费基于 [qcode.cc/models 定价表](https://qcode.cc/models)，比 CLI 内显示更准确。

### Q: 尊享版和企业团队版的 Max x20 账号资源有使用上限吗？

**A:** 有的。每个 Max x20 账号每月配额上限为 **$4,000**（月度重置，未使用不滚存；实际消耗通常 $3,500–$3,900）。我们通过账号资源池调度，绝大部分用户不会触及此上限。如有特殊高用量需求，请联系客服。

### Q: 每个套餐的并发限制和时间窗口限制是怎样的？

**A:**

**并发限制：**
- 个人套餐（基础版/进阶版/尊享版）：每个 API Key **并发 5**
- 企业团队版：每个账号资源**并发 35**，支持 3~5 人同时使用

**4 小时时间窗口限制：**
- 个人套餐：**已于 2026 年 7 月全面取消**，不再有任何时间窗口限制
- 企业团队版：**无**时间窗口限制，支持持续开发

### Q: 是否支持退款？

**A:** 我们销售的是网络数字商品，开通后即占用账号资源，**不支持退款**。

**余额转账替代方案**：支持 QCode 会员之间的余额转账。找到买家后，发送邮件至 [hi@qcode.cc](mailto:hi@qcode.cc)，注明转出金额和接收方 QCode 账户邮箱，1 个工作日内完成。

仅在以下情况可能酌情退款：平台故障导致服务中断超过 24 小时、平台单方面终止服务且有剩余余额、误充值后 24 小时内申请且未产生任何使用。

### Q: 支持开发票吗？

**A:** 支持。开票收取工本费：票面金额**不足 ¥2,000 收 ¥80**，**超过 ¥2,000 按票面金额的 5%** 收取。申请前请确保账户余额充足，然后发邮件到 [hi@qcode.cc](mailto:hi@qcode.cc)。

企业团队版另外支持**对公转账**与**正规增值税发票**，可签正式服务协议，详见 [企业版指南](/docs/reference/enterprise-guide)。

### Q: 提示「已达到每日费用限制」怎么办？

**A:** 每日限额是**每天可消耗的 API 费用上限**，按**北京时间 0 点**重置。当天不够用时有两个办法：

1. **买加油包**：在 [控制台](https://qcode.cc/dashboard) 自助购买，即时扩充当日额度。加油包按**北京时间次日凌晨 2 点**单独重置 —— 比日限额晚 2 小时，给跨零点赶工留缓冲。
2. **调高日限额**：在 [qcode.cc/pricing](https://qcode.cc/pricing) 改套餐配置。

> 个人套餐的 4 小时时间窗口限制已于 2026 年 7 月全面取消，所以这条提示只会来自日限额，不会是窗口限制。

---

## 快速参考

### Q: 买完套餐之后怎么开始用？

**A:** 三步，大约 60 秒：

1. **拿 Key**：登录 [控制台](https://qcode.cc/dashboard) →「API Key 管理」，复制 `cr_` 开头的密钥。
2. **配置**：跑 [一键配置脚本](/docs/getting-started/one-click-install)，或手工设 `ANTHROPIC_BASE_URL` 与 `ANTHROPIC_AUTH_TOKEN`（见 [接入点与 API 格式](/docs/getting-started/endpoints-and-api-paths)）。
3. **选工具**：在 [接入你的工具](/docs/ide) 里找到你的 IDE / CLI，照那一页配置。

同一把 Key 同时驱动 Claude Code、Codex、Gemini 与国产模型，共享同一份套餐配额。

### Q: 如何安装 Claude Code？

**A:** npm 全局安装，然后配置环境变量即可：

```bash
npm install -g @anthropic-ai/claude-code
```

详细步骤（含三平台安装说明）→ [安装教程](/docs/getting-started/installation)

### Q: 如何配置 QCode.cc 代理？

**A:** 设置以下环境变量：

```bash
export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_api_key"
```

建议添加到 shell 配置文件（`~/.zshrc` 或 `~/.bashrc`）。详见 → [安装教程](/docs/getting-started/installation)

### Q: 如何进入 Plan Mode？

**A:** 按 `Shift+Tab` 两次，或在 `.claude/settings.json` 中设置默认模式：

```json
{ "permissions": { "defaultMode": "plan" } }
```

Plan Mode 下 Claude 只分析不执行任何操作。

### Q: 如何切换模型？

**A:** 使用 `/model` 命令：

```
/model opus
/model sonnet
```

### Q: 如何让 Claude 帮我提交/审查代码？

**A:** 使用 `/commit` 生成提交，`/review` 进行代码审查。也可直接告诉 Claude「帮我提交这些改动」或「审查这个 PR」。

### Q: 如何报告 Bug？

**A:** 访问 [GitHub Issues](https://github.com/anthropics/claude-code/issues)，提供复现步骤和相关错误信息。

### Q: 能用 Claude 生成图片吗？

**A:** Claude 模型本身**只能理解图片，不能生成图片**（图片理解见 [图片输入](/docs/usage/vision-input)）。

要生成图片请用 `gpt-image-2` —— 与你现有的 `cr_` 密钥共用、OpenAI 完全兼容，支持文生图与图像编辑。用法见 [gpt-image-2 图像生成与编辑](/docs/usage/image-2)。

---

## 更多帮助

找不到答案？查看以下专题文档：

| 主题 | 文档链接 |
|------|---------|
| 上下文管理、/compact、长会话溢出 | [上下文管理](/docs/usage/context-management) |
| 权限配置、allow/deny 规则 | [权限配置](/docs/usage/permissions) |
| CLAUDE.md 项目配置 | [CLAUDE.md 配置](/docs/usage/claude-md) |
| MCP 服务器配置与调试 | [MCP 服务器](/docs/advanced/mcp) |
| 错误码详解与故障排查 | [错误码](/docs/reference/errors) |
| 计费原理与定价 | [计费说明](/docs/reference/billing) |

**联系支持**：网站右下角在线客服，或发邮件至 [hi@qcode.cc](mailto:hi@qcode.cc)