控制台使用指南

QCode.cc 控制台的用法：API 接入地址、创建与复制 API Key、用量统计、充值、购买套餐、团队子 key 与 Open API 访问令牌

需要 API Key？ 前往注册 →·端点与 Base URL →

先在 qcode.cc 登录，再打开控制台 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。 如果你在中国大陆以外，请看中国大陆以外用户上手。

控制台里有什么¶

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。Claude Code 的配置是这样一对：

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 充值（见 付款方式总览）。
2. 在 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 卡片（只在买过按量包的账号里显示）：状态（有效 / 额度用完 / 已过期）、剩余额度、到期日和剩余天数、并发，以及 续买 和 升级个人套餐 按钮。一个账号只有一把按量包 Key，续买的额度累加在这一把上；过期后续买会恢复同一把 Key。
• 每张卡片都链接到同一个 key 服务的三种客户端：Claude、Codex、Gemini（QCode 暂不提供 Gemini 模型）。

一键安装命令¶

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

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 单行命令和可双击的启动脚本。完整流程——包括怎么强制脚本 的界面语言——在一键安装脚本。

用量统计¶

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

「今日模型调用」里出现你没选过的 claude-sonnet-5？多半是 Claude Code 在 auto 权限模式下发出的安全检查请求，见用量里为什么有 Sonnet 5。

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

充值、套餐、加油包与升级¶

• 余额按货币分开。 “CNY and USD balances are separate. Recharge amount will be added to the corresponding currency balance.”（人民币与美元余额互相独立，充值进入对应货币的余额。）用户条会把 两个数字并排显示。

• 充值限额显示在充值页上：人民币最低 ¥30，美元最低 $5、最高 $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.”

• 连续购买多个月：3 个月起月价更低（−10% / −20% / −25%），控制台原文：“From 3 months, save 10% a month; 20% at 6 months and 25% at 12 — 12 months for the price of 9. Paid once, no auto-renewal.”

• 加油包（Self-service Booster Pack）可以在控制台用余额自助购买，立即放宽额度；北京时间 凌晨 2 点（UTC+8）重置。

• 按量包：续买的额度累加在同一把按量包 Key 上，到期日取「当前到期日」与「今天 + 包天数」较晚者；之后想改用个人套餐，直接购买即可，按量包照常使用到到期。按量包不退款，规则见 按量包说明。

• 升级套餐不是控制台上的按钮：先买更高档的套餐，再发邮件给 hi@qcode.cc，让我们关掉旧套餐并把未使用部分折回余额。

子 key 与团队功能¶

个人控制台按每个套餐一把主 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（可签服务合同）。 步骤见企业团队版指南。

• 订阅页的团队卡片写着 “Flexible quota & sub-key mgmt”，并引导联系 hi@qcode.cc。

• 控制台本身只提供团队入口——欢迎弹窗里的 Team / Enterprise，以及企业团队版的 Team Features 弹窗（“Multi-account management for team collaboration”“Customized service…” “Dedicated technical support…”）。

• 分销商有独立的 Partner Dashboard，可以发放子 key，见 Partner Open API Guide。

Open API 访问令牌¶

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

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 访问会一直关闭，直到你重新生成令牌。

• 这个令牌以 qot_ 开头，是个人令牌，和分销商令牌不是一回事：分销商在 Partner Dashboard（分销面板） 的「开放 API / 访问令牌」里生成 rsk_，用于 Partner Open API（余额、用量、子 Key 管理）。两者互不通用，见 Partner Open API Guide。

客服与订单问题¶

• 控制台的 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；按症状排查见 故障排查指南和错误码参考。

相关页面¶

• 付款方式总览 —— 充值页支持哪些通道
• 计费说明 —— 用量怎么变成钱
• 按量包说明 —— 按量包的价格、续买与到期
• 如何选方案 —— 四种方案对照
• Endpoints & API Paths —— 地址加路径前缀
• 环境变量 —— 该填在哪里
• 一键安装脚本 —— 控制台那些命令做了什么
• Subscriptions vs API Keys vs QCode Keys
• 企业团队版指南 —— 子 key 与发票
• Partner Open API Guide
• FAQ

企业团队版 →