FAQ

Frequently asked questions about Claude Code and QCode.cc

QCode.cc Platform¶

Q: Where do I get my API Key?¶

A: Log in to the QCode.cc Dashboard and create or view your API Key on the "API Key Management" page.

Q: What prefix does the API Key use?¶

A: QCode.cc API Keys start with cr_, e.g. cr_xxxxxxxxxxxxxx.

Q: Why is my API Key not working?¶

A: Common causes:

1. Copy error: Check for extra spaces or missing characters
2. Subscription expired: Check your account status on the Dashboard
3. Environment variable not applied: Reopen your terminal or run source ~/.zshrc
4. Wrong API endpoint: Make sure ANTHROPIC_BASE_URL is set to https://api.qcode.cc/api

Q: My API Key leaked — how do I replace it?¶

A: It depends which key:

• Main API Key (starts with cr_): there is no self-service reset today. Contact live chat or email hi@qcode.cc as soon as possible. Also follow Security Best Practices to check whether the key reached your Git history or logs.
• Open API access token (starts with rsk_, for partners): open «Open API / Access Token» in the console and click Reset. The old token stops working immediately. See Partner Open API.

Usage & Plans¶

Q: How do I check my current session usage?¶

A: Two ways:

Dashboard (recommended): Log in to the Dashboard and view model call counts, cost breakdown, and plan consumption on the "Usage Statistics" page.

Quick check in CLI: Use the /cost command to see a summary of the current session:

/cost

Dashboard billing is based on the qcode.cc/models pricing table, which is more accurate than what the CLI shows.

Q: Is there a usage cap on the Max x20 account resources for Premium and Enterprise Team plans?¶

A: Yes. Each Max x20 account has a cap of $4,000 per month (monthly reset, unused quota does not roll over; actual consumption is typically $3,500–$3,900). We schedule through an account resource pool, so the vast majority of users will never hit this limit. For unusually high usage requirements, please contact support.

Q: What are the concurrency limits and time-window limits for each plan?¶

A:

Concurrency limits:

• Personal plans (Basic / Pro / Premium): 5 concurrent requests per API Key
• Enterprise Team: 35 concurrent requests per account resource, supporting 3–5 simultaneous users

4-hour time-window limit:

• Personal plans: fully removed as of July 2026 — no time-window limit of any kind
• Enterprise Team: no time-window limit, supports continuous development

Q: Are refunds available?¶

A: We sell digital network goods. Once activated, account resources are occupied, so refunds are not supported.

Balance transfer alternative: Transfers between QCode members are supported. Once you find a buyer, send an email to hi@qcode.cc with the transfer amount and the recipient's QCode account email address. Transfers are completed within 1 business day.

Refunds may be granted on a case-by-case basis only in the following situations: a platform outage causing more than 24 hours of service interruption; the platform unilaterally terminates service while a balance remains; or a mistaken top-up is reported within 24 hours with no usage having occurred.

Q: I have a Claude Pro / ChatGPT Plus subscription — can I use it with QCode?¶

A: No. A subscription is membership in the official apps and includes no API quota; QCode bills per token. The two are independent systems and can coexist — details in Subscriptions vs API Keys vs QCode Keys.

Q: Which tools are supported?¶

A: Claude Code, Codex, IDE / CLI extensions and desktop clients all have setup pages under "Connect Your Tool"; for which protocol each tool speaks and whether Claude models work with it, see the Tool Compatibility Overview.

Q: Can I get an invoice (for expense reimbursement)?¶

A: Yes, invoices can be used for corporate expense reimbursement. An administrative fee applies: ¥80 for a face value under ¥2,000, or 5% of face value above ¥2,000. Make sure your account balance covers it, then email hi@qcode.cc.

The Enterprise Team plan additionally supports corporate bank transfer and official VAT invoices, with a formal service agreement. See the Enterprise Guide.

Q: I hit "daily cost limit reached" — what now?¶

A: The daily limit is the cap on API spend per day, and it resets at 00:00 Beijing time. Two ways out:

1. Buy a booster pack: purchase it yourself in the console to extend today's quota immediately. Booster packs reset separately at 02:00 Beijing time the next day — two hours after the daily limit, which leaves a buffer if you work past midnight.
2. Raise the daily limit: adjust your plan at qcode.cc/pricing.

The 4-hour rolling window limit was removed from all personal plans in July 2026, so this message can only come from the daily limit, never from a window limit.

Quick Reference¶

Q: I just bought a plan — how do I start using it?¶

A: Three steps, about 60 seconds:

1. Get the key: sign in to the console → "API Key Management" and copy the key that starts with cr_.
2. Configure: run the one-click setup script, or set ANTHROPIC_BASE_URL and ANTHROPIC_AUTH_TOKEN by hand (see Endpoints & API Formats).
3. Pick your tool: find your IDE or CLI under Connect Your Tool and follow that page.

One key drives Claude Code, Codex, Gemini and the Chinese models at the same time, all sharing the same plan quota.

Q: How do I install Claude Code?¶

A: Install globally via npm, then configure the environment variables:

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

Detailed steps (including instructions for all three platforms) → Installation Guide

Q: How do I configure the QCode.cc proxy?¶

A: Set the following environment variables:

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

We recommend adding these to your shell config file (~/.zshrc or ~/.bashrc). See → Installation Guide

Q: How do I enter Plan Mode?¶

A: Press Shift+Tab twice, or set the default mode in .claude/settings.json:

{ "permissions": { "defaultMode": "plan" } }

In Plan Mode, Claude analyzes your request without executing any actions.

Q: How do I switch models?¶

A: Use the /model command:

/model opus
/model sonnet

Q: How do I have Claude commit or review code for me?¶

A: Use /commit to generate a commit and /review to perform a code review. You can also just tell Claude directly: "commit these changes" or "review this PR".

Q: How do I report a bug?¶

A: Visit GitHub Issues and provide reproduction steps along with any relevant error information.

Q: Can Claude generate images?¶

A: Claude models can read images but not generate them (for image input see Image Input).

To generate images use gpt-image-2 — it shares your existing cr_ key, is fully OpenAI-compatible, and supports both text-to-image and image editing. See gpt-image-2 Image Generation and Editing.

More Help¶

Can't find what you're looking for? Check these topic-specific docs:

Contact support: Use the live chat in the bottom-right corner of the website, or email hi@qcode.cc