常见问题（FAQ）

Claude Code 与 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: 常见原因：

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

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

A: 分两种密钥：

• 主 API Key（cr_ 开头）：目前没有自助重置入口，请尽快联系在线客服或发邮件到 hi@qcode.cc 处理。同时按 安全最佳实践 检查密钥有没有进过 Git 历史或日志。
• 开放 API 访问令牌（rsk_ 开头，合作伙伴用）：在控制台「开放 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: 每个套餐的并发限制和时间窗口限制是怎样的？¶

A:

并发限制：

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

4 小时时间窗口限制：

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

Q: 是否支持退款？¶

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

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

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

Q: 支持开发票吗？¶

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

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

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

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

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

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

快速参考¶

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

A: 三步，大约 60 秒：

1. 拿 Key：登录 控制台 →「API Key 管理」，复制 cr_ 开头的密钥。
2. 配置：跑 一键配置脚本，或手工设 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN（见 接入点与 API 格式）。
3. 选工具：在 接入你的工具 里找到你的 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 两次，或在 .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 图像生成与编辑。

更多帮助¶

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

联系支持：网站右下角在线客服，或发邮件至 hi@qcode.cc