常见问题（FAQ）

Claude Code 与 QCode.cc 常见问题解答

更新于 2026-10-30

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

本页目录

QCode.cc 平台
用量与套餐
快速参考
更多帮助

QCode.cc 平台¶

Q: API Key 在哪里获取？¶

A: 登录 QCode.cc 控制台，在「API Key 管理」页面创建或查看你的 API Key。

Q: API Key 以什么开头？¶

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

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

A: 常见原因：

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

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

A: 分两种密钥：

主 API Key（cr_ 开头）：可以在控制台自助重置：在 Key 卡片「API Key:」一行右侧点「⋯」→「重置 API Key…」。重置会生成新密钥，旧密钥 1 分钟内停用，额度、用量和到期时间都不变；每次重置收取少量服务费（金额以控制台显示为准），每把 Key 3 天内最多重置 1 次。只是忘了密钥不需要重置，点密钥右边的 👁 图标就能看到。个别 Key 需要在线客服或 hi@qcode.cc 协助重置。同时按安全最佳实践检查密钥有没有进过 Git 历史或日志。
开放 API 访问令牌（qot_ 开头，个人用）：只读，在控制台的 Open API（/dashboard/openapi-token）里生成、重置或吊销，旧令牌立即失效。见控制台使用指南。
分销商接入令牌（rsk_ 开头，合作伙伴用）：在 Partner Dashboard（分销面板） 的「开放 API / 访问令牌」里生成，不在个人控制台；在那里点重置即可换发，旧令牌立即失效。见合作伙伴开放 API。

用量与套餐¶

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

A: 有两种方式：

Dashboard（推荐）：登录控制台，在「使用统计」页面查看模型调用次数、费用明细和套餐消耗情况。

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

/cost

Dashboard 的计费基于 qcode.cc/models 定价表，比 CLI 内显示更准确。

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

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

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

并发限制：

个人套餐：每个 API Key 并发 5；尊享版每个 API Key 并发 10
按量包：每个 API Key 并发 5
企业团队版：每个账号资源并发 35，建议每账号 3 人，最多 7 人共享

4 小时时间窗口限制：

个人套餐：已于 2026 年 7 月全面取消，不再有任何时间窗口限制；起作用的上限是每日额度（北京时间 0 点重置），尊享版是每月额度
企业团队版：无时间窗口限制，支持持续开发

Q: 不确定买哪一档，买小了能升级吗？¶

A: 可以。不确定要多少额度时，建议先买体验版（¥63/月）用起来，满意后随时购买更高配额的套餐，再发邮件到 hi@qcode.cc 申请关闭旧套餐——旧套餐剩余时间价值按比例折算退回 QCode 余额，1 个工作日内处理。企业团队版、分销合作也可以先用体验版把接入流程跑通再升级。

Q: 按量包和个人套餐有什么区别？¶

A: 个人套餐是日额度，北京时间 0 点重置，适合每天使用；按量包是有效期内的总额度（小包 / 中包 / 大包 / 特大包，四档都是 7 天），用完为止，适合阶段性使用。两者的 Key 用法相同，并发都是 5，模型也一致。名下有有效个人套餐时不能买按量包（个人套餐的日额度不够用时，买加油包）。完整对照见如何选方案，规则细节见按量包说明。

Q: 额度用完会怎样？¶

A: 返回 HTTP 402，error.type 为 insufficient_quota，用 code 区分是哪种额度：daily_cost_limit_exceeded 是日额度，北京时间 0 点重置，也可以买加油包；total_cost_limit_exceeded 是总额度（按量包、尊享版的月度额度），按量包续买即可继续；Claude 模型的周限额用完也是 402。Key 过期返回的是 401，不是 402，按量包续买即恢复。详见错误码参考。

Q: 是否支持退款？¶

A: 我们销售的是网络数字商品，开通后即占用账号资源，不支持退款。按量包同样不退款，过期后剩余额度作废。

唯一的例外是升级：购买更高配额的套餐后发邮件到 hi@qcode.cc，旧套餐剩余时间价值按比例折算退回 QCode 余额（退回余额，不退回原支付渠道）。

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

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

Q: 我有 Claude Pro / ChatGPT Plus 订阅，能在 QCode 用吗？¶

A: 不能。订阅是官方客户端的会员服务，不包含任何 API 额度；QCode 按 token 计费，两者互不相干、可以并存。详见订阅、官方 API 与 QCode Key。

Q: QCode 支持哪些工具？¶

A: Claude Code、Codex、各类 IDE / CLI 扩展与桌面客户端都在「接入你的工具」分类下有专页；哪个工具能接哪条协议、能不能用 Claude 模型，看工具兼容总览。

Q: 支持开发票、能报销吗？¶

A: 支持。发票可用于公司报销；开票收取工本费：票面金额不足 ¥2,000 收 ¥80，超过 ¥2,000 按票面金额的 5% 收取。申请前请确保账户余额充足，然后发邮件到 hi@qcode.cc。

企业团队版另外支持对公转账与正规增值税发票，可签正式服务协议，详见企业版指南。

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

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

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

这条提示对应 HTTP 402：响应体里 error.type 为 insufficient_quota、code 为 daily_cost_limit_exceeded（见错误码参考）。

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

Q: 提示「已达到总费用限制」是什么意思？¶

A: 这是总额度用完了：HTTP 402，响应体里 error.type 为 insufficient_quota、code 为 total_cost_limit_exceeded。总额度适用于按总额度计费的 Key，例如按量包、尊享版的月度额度。提示括号里的金额（如 $100）是这把 Key 的累计上限，不是剩余额度。

恢复方式按所属方案的规则：按量包续买即可继续使用；例如尊享版的月度额度随每月重置补充；还没到重置就用完、或不确定自己属于哪一种，请发邮件到 hi@qcode.cc 或联系在线客服。这类 402 不会因为重发而消失，不必写重试循环。详见错误码参考。

Q: 云服务器和 AI 服务是一回事吗？需要另外买 AI 套餐吗？¶

A: 不是一回事，两边独立售卖、只共用同一个账户余额。云服务器是一台带独立公网 IPv4 与完整 root 权限的海外机器，按你下单时选的时长（1、3、6 或 12 个月）从余额扣费；AI 服务按 token 计费。只买云服务器、不买 AI 套餐也可以用——在服务器上装好 Claude Code / Codex，用你的 QCode Key 调用模型即可。机器怎么选见云服务器购买与使用，服务器侧的计费与退款规则见云服务器计费与规则，装工具与长期跑 Agent 的步骤见在云服务器上跑 Agent。

快速参考¶

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

A: 三步，大约 60 秒：

拿 Key：登录控制台 →「API Key 管理」，复制 cr_ 开头的密钥。
配置：跑一键配置脚本，或手工设 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN（见接入点与 API 格式）。
选工具：在接入你的工具里找到你的 IDE / CLI，照那一页配置。

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

Q: 如何安装 Claude Code？¶

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

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

详细步骤（含三平台安装说明）→ 安装教程

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

A: 设置以下环境变量：

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

建议添加到 shell 配置文件（~/.zshrc 或 ~/.bashrc）。详见 → 安装教程

Q: 如何进入 Plan Mode？¶

A: 按 Shift+Tab 切换，直到模式指示显示 plan（从默认的 auto 出发按三次，从手动模式 default 出发按两次）；也可以启动时加 --permission-mode plan，或在 .claude/settings.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，提供复现步骤和相关错误信息。

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

A: Claude 模型本身只能理解图片，不能生成图片（图片理解见图片输入）。

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

主题	文档链接
上下文管理、/compact、长会话溢出	上下文管理
权限配置、allow/deny 规则	权限配置
CLAUDE.md 项目配置	CLAUDE.md 配置
MCP 服务器配置与调试	MCP 服务器
错误码详解与故障排查	错误码
计费原理与定价	计费说明