# 控制台使用指南

先在 [qcode.cc](https://qcode.cc) 登录，再打开控制台
[qcode.cc/dashboard](https://qcode.cc/dashboard)。它对自己的概括只有一句话——
*“Manage your API keys, top-up and usage”*（管理你的 API Key、充值与用量）——而且只有这一个页面：
key、余额、套餐、用量、邀请返佣、客服全都在上面。

> 不确定 QCode key 和 Claude / ChatGPT 订阅的区别？先看
> [Subscriptions vs API Keys vs QCode Keys](/docs/reference/subscription-vs-api-key)。
> 如果你在中国大陆以外，请看[中国大陆以外用户上手](/docs/getting-started/international-users)。

## 控制台里有什么

| 区块 | 在这里做什么 |
|---|---|
| 右上角用户条 | 看到登录邮箱与 `ID: …`、两种货币的余额，以及 **Recharge**（充值）/ **Buy Plan**（买套餐）两个按钮 |
| API Access Address（API 接入地址） | 复制要填进 `ANTHROPIC_BASE_URL` / `base_url` 的地址 |
| API Key Management（API Key 管理） | 创建 key、显示并复制 key 值、续费、展开已过期的 key |
| One-Click Setup（在每个 key 卡片内） | 复制 Claude Code 或 Codex 的安装命令 |
| Open API | 管理那个只读访问令牌，用来程序化查询 key 的到期与用量 |
| Usage Statistics（用量统计） | 当前生效 key 的额度消耗，以及当月汇总 |
| Docs & Resources（文档与资源） | IDE 接入与常用教程链接 |
| Service Guide / Referral Rewards / Quick Links | 服务规则、你的邀请链接、领取返佣、帮助文章、错误码、客服时间 |

## API 接入地址

这个区块的标题就是 **API Access Address**，每一行地址都自带复制按钮。**哪一行被标为推荐，取决于你
登录的控制台界面语言**：

- **中文界面** —— `https://asia.qcode.cc/api` 被标为推荐行，下面还有一行说明：*“Mainland China
  users should use the accelerated address; others use the global address. Both offer identical
  performance”*（中国大陆用户用加速地址，其他用户用全球地址，两者性能一致）。
- **任何非中文界面**（目前是英语、日语、俄语）—— `https://api.qcode.cc` 被标为推荐，它下面的行标成
  **Backup**（备用）：美国 `https://us.qcode.cc/api`、亚洲 `https://asia.qcode.cc/api`。

复制到的地址还要按你用的工具补上正确的**路径前缀**——见
[Endpoints & API Paths](/docs/getting-started/endpoints-and-api-paths)。Claude Code 的配置是这样一对：

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

## API Key：创建、查看、复制

带 **Create Key & Activate Service**（创建 Key 并开通服务）按钮的区块就是 **API Key Management**。
如果你还没有 key，空状态会直接把操作顺序写出来：**Top Up Balance**（充值）→ **Buy a Plan**（买套餐）
→ **Start Using**（开始使用）。

1. 先在 [qcode.cc/recharge](https://qcode.cc/recharge) 充值（见
   [付款方式总览](/docs/reference/payment-methods)）。
2. 在 [qcode.cc/subscribe](https://qcode.cc/subscribe) 选套餐——**Recommended Plans**（推荐套餐）或
   **Custom Configuration**（自定义配置）——然后确认。购买成功的提示是
   *“Subscription Activated — Your API Key is created and ready to use”*，页面上会显示 key，带复制按钮
   和 **Go to Dashboard** 链接。
3. 回到控制台后，key 的值**默认不显示**：这一行先是 *Loading…*，你要点眼睛按钮把它显示出来，再点
   **Copy**。如果值还没加载完就点复制，控制台会告诉你，而不是复制一个空串。

同一个区块里还有这些内容：

- 刚下单的 key 可能显示 *“API key is being activated, we will process it as soon as possible”*，
  并带一个联系在线客服的入口。
- 已有的 key 可能出现 **Renew**（续费）按钮，续费直接从余额扣。
- 用尽的 key 收在折叠的 **Expired keys** 列表里，标记为 *Key expired or disabled*。
- 每张卡片都链接到同一个 key 服务的三种客户端：Claude、Codex、Gemini。

## 一键安装命令

每个生效的 key 卡片里都有一个 **One-Click Setup (Recommended)** 区块，带 **macOS / Linux** 和
**Windows** 两个页签，Claude Code 与 Codex 各一行命令，每行都有 **Copy** 按钮：

```bash
curl -fsSL https://qcode.cc/install/claude-code.sh | bash
curl -fsSL https://qcode.cc/install/codex.sh | bash
```

区块下面控制台的提示原文是：*“Paste your key above when the script prompts for it.”*（脚本要到 key
时，把上面的 key 粘贴进去）。Windows 页签里是 `irm … | iex` 形式的命令，下面还有一个折叠区，为
`irm` 不可用或被执行策略拦住的机器列出 CMD 单行命令和可双击的启动脚本。完整流程——包括怎么强制脚本
的界面语言——在[一键安装脚本](/docs/getting-started/one-click-install)。

## 用量统计

**Usage Statistics** 区块对应你的生效 key（*“Quota usage for current active key”*），可以按定时器自动
刷新（Off / 5 / 10 / 30 / 60 分钟），也可以点 **Refresh** 手动刷新。

| 小节 | 显示什么 |
|---|---|
| Daily Cost Limit（每日消费上限） | 每天最多可花的金额；北京时间零点重置，花满后 API 暂停，次日自动恢复 |
| Time Window Limit（时间窗限制） | 滚动 4 小时窗口内的请求数与消费。个人套餐 *“removed the 4h rate window entirely in July 2026 — only the daily limit remains”*，因此这一栏可能显示 *No window limit* |
| Opus Weekly Limit（Opus 周限制） | Opus 档模型单独的周度额度，每周一（北京时间）重置；不含 Opus 的套餐会在这里说明 |
| Monthly Usage Overview（当月总览） | Total Tokens、Total Requests、Total Cost —— 从 key 创建那天开始统计 |
| Today's Model Calls（今日模型调用） | 当天各模型的输入 / 输出 / 缓存写 / 缓存读 token |
| Booster（加速包） | 是否已持有加速包；见下文 |

面板自带的免责声明原文：*“Data shown here may have slight variations, actual limits are based on
Claude Code responses.”* 想看当前会话的粗略花费，在 Claude Code 里用 `/cost`；钱是怎么算出来的见
[计费说明](/docs/reference/billing)。

## 充值、套餐、加速包与升级

- **余额按货币分开。** *“CNY and USD balances are separate. Recharge amount will be added to the
  corresponding currency balance.”*（人民币与美元余额互相独立，充值进入对应货币的余额。）用户条会把
  两个数字并排显示。
- **充值限额**显示在充值页上：人民币最低 **¥100**，美元最低 **$1**、最高 **$2,000**；某些通道还有
  单笔上限，超过时页面会提示，例如 *“Due to the payment channel's per-transaction limit … Please
  split it into several smaller recharges.”*
- **充值回来后**：控制台横幅写着 *“Balance received — You can activate a plan now.”*，旁边是
  **Choose a plan** 按钮。剩下的余额不会作废：*“Any balance left after your top-up isn't wasted: use
  it later toward an upgrade or a booster pack.”*
- **连续购买多个月**有折扣：*“Subscribe for 3+ months for up to 25% off (12 months).”*
- **加速包**（*Self-service Booster Pack*）可以在控制台用余额自助购买，立即放宽额度；北京时间
  凌晨 2 点（UTC+8）重置。
- **升级套餐**不是控制台上的按钮：先买更高档的套餐，再发邮件给
  [hi@qcode.cc](mailto:hi@qcode.cc)，让我们关掉旧套餐并把未使用部分折回余额。

## 子 key 与团队功能

个人控制台按**每个套餐一把主 key**来管理，里面**没有自助的子 key 界面**。子 key 属于团队型产品：

- **企业团队版**页面描述了一个 *Sub-API Key Management Center*（子 API Key 管理中心），支持
  *“fine-grained configuration and management for each team member”*，套餐对比表里写明**子 key 不限数量，每个都有独立额度**。该页面还列出 **Bank Transfer Supported**（支持对公转账）、
  **Official Invoices Available**（可开正式发票）和 **Custom Service Agreements**（可签服务合同）。
  步骤见[企业团队版指南](/docs/reference/enterprise-guide)。
- 订阅页的团队卡片写着 *“Flexible quota & sub-key mgmt”*，并引导联系
  [hi@qcode.cc](mailto:hi@qcode.cc)。
- 控制台本身只提供团队**入口**——欢迎弹窗里的 **Team / Enterprise**，以及 Max X20 团队版的
  *Team Features* 弹窗（“Multi-account management for team collaboration”“Customized service…”
  “Dedicated technical support…”）。
- **分销商**有独立的 Partner Dashboard，可以发放子 key，见
  [Partner Open API Guide](/docs/reference/partner-api)。

## Open API 访问令牌

**Open API** 卡片的说明是：*“Use an access token to query your API keys' expiry and daily usage
programmatically.”* 点 **Manage token** 进入 `/dashboard/openapi-token`，可以生成、重置或吊销令牌：

```bash
curl -H "Authorization: Bearer qot_..." \
  https://qcode.cc/api/v1/openapi/keys
```

- 该页面列出两个只读接口：一个查你所有生效 key 的到期与用量，一个查账户级的用量汇总。
- 令牌**只显示一次**：*“Your new token (shown only once) — copy it now”*，以及 *“We store only a hash —
  if you lose it, reset to get a new one (the old token stops working immediately).”*
- 重置与吊销都要二次确认；吊销后 Open API 访问会一直关闭，直到你重新生成令牌。

## 客服与订单问题

- 控制台的 **Support** 一栏：*“Weekdays 10:00 - 21:00 (UTC+8) online response”*，非工作时间消息
  *“checked intermittently, replies may be delayed”*，以及 *“Email available anytime: hi@qcode.cc”*。
- 在线支持是右下角的 **Contact Us** 按钮（Telegram 或邮件）。
- **Request Urgent Processing**（加急处理）解释了等待原因：新开上游账号需要一到小时到两小时来申请和
  配置。
- Quick Links 里还有 **Usage Help**（知识库）和 **Common Error Codes**；按症状排查见
  [故障排查指南](/docs/reference/troubleshooting)和[错误码参考](/docs/reference/errors)。

## 相关页面

- [付款方式总览](/docs/reference/payment-methods) —— 充值页支持哪些通道
- [计费说明](/docs/reference/billing) —— 用量怎么变成钱
- [Endpoints & API Paths](/docs/getting-started/endpoints-and-api-paths) —— 地址加路径前缀
- [环境变量](/docs/getting-started/environment) —— 该填在哪里
- [一键安装脚本](/docs/getting-started/one-click-install) —— 控制台那些命令做了什么
- [Subscriptions vs API Keys vs QCode Keys](/docs/reference/subscription-vs-api-key)
- [企业团队版指南](/docs/reference/enterprise-guide) —— 子 key 与发票
- [Partner Open API Guide](/docs/reference/partner-api)
- [FAQ](/docs/reference/faq)