控制台使用指南
QCode.cc 控制台的用法:API 接入地址、创建与复制 API Key、用量统计、充值、购买套餐、团队子 key 与 Open API 访问令牌
本页目录
先在 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。 如果你在中国大陆以外,请看中国大陆以外用户上手。
控制台里有什么¶
| 区块 | 在这里做什么 |
|---|---|
| 右上角用户条 | 看到登录邮箱与 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。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(开始使用)。
- 先在 qcode.cc/recharge 充值(见 付款方式总览)。
- 在 qcode.cc/subscribe 选套餐——Recommended Plans(推荐套餐)或 Custom Configuration(自定义配置)——然后确认。购买成功的提示是 “Subscription Activated — Your API Key is created and ready to use”,页面上会显示 key,带复制按钮 和 Go to Dashboard 链接。
- 回到控制台后,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 按钮:
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 手动刷新。
| 小节 | 显示什么 |
|---|---|
| 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;钱是怎么算出来的见
计费说明。
充值、套餐、加速包与升级¶
-
余额按货币分开。 “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,让我们关掉旧套餐并把未使用部分折回余额。
子 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,以及 Max X20 团队版的 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 访问会一直关闭,直到你重新生成令牌。
客服与订单问题¶
-
控制台的 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