# FAQ

## QCode.cc Platform

### Q: Where do I get my API Key?

**A:** Log in to the [QCode.cc Dashboard](https://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](https://qcode.cc/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](javascript:void(Tawk_API.toggle())) or email [hi@qcode.cc](mailto:hi@qcode.cc) as soon as possible. Also follow [Security Best Practices](/docs/advanced/security) 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](/docs/reference/partner-api).

---

## Usage & Plans

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

**A:** Two ways:

**Dashboard (recommended)**: Log in to the [Dashboard](https://qcode.cc/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:
```text
/cost
```

> Dashboard billing is based on the [qcode.cc/models pricing table](https://qcode.cc/models), 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](mailto: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](/docs/reference/subscription-vs-api-key).

### 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](/docs/ide/tool-compatibility).

### 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](mailto: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](/docs/reference/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](https://qcode.cc/dashboard) 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](https://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](https://qcode.cc/dashboard) → "API Key Management" and copy the key that starts with `cr_`.
2. **Configure**: run the [one-click setup script](/docs/getting-started/one-click-install), or set `ANTHROPIC_BASE_URL` and `ANTHROPIC_AUTH_TOKEN` by hand (see [Endpoints & API Formats](/docs/getting-started/endpoints-and-api-paths)).
3. **Pick your tool**: find your IDE or CLI under [Connect Your Tool](/docs/ide) 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:

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

Detailed steps (including instructions for all three platforms) → [Installation Guide](/docs/getting-started/installation)

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

**A:** Set the following environment variables:

```bash
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](/docs/getting-started/installation)

### Q: How do I enter Plan Mode?

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

```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:

```text
/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](https://github.com/anthropics/claude-code/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](/docs/usage/vision-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](/docs/usage/image-2).

---

## More Help

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

| Topic | Documentation |
|------|---------|
| Context management, /compact, long-session overflow | [Context Management](/docs/usage/context-management) |
| Permission configuration, allow/deny rules | [Permissions](/docs/usage/permissions) |
| CLAUDE.md project configuration | [CLAUDE.md Configuration](/docs/usage/claude-md) |
| MCP server configuration and debugging | [MCP Servers](/docs/advanced/mcp) |
| Error code reference and troubleshooting | [Error Codes](/docs/reference/errors) |
| Billing mechanics and pricing | [Billing](/docs/reference/billing) |

**Contact support**: Use the live chat in the bottom-right corner of the website, or email [hi@qcode.cc](mailto:hi@qcode.cc)