Subscriptions vs API Keys vs QCode Keys

What a Claude Pro / ChatGPT Plus subscription, an official API key, and a QCode cr_ key actually are, how each is billed, and where each works — three independent things that can coexist

Updated 2026-10-19

Need an API key? Sign up →Endpoints & base URLs →

On This Page

The short version: a subscription is membership in the official client apps, an official API key is the pay-as-you-go credential of the developer platforms, and a QCode key (cr_ prefix) is one gateway key that speaks several protocols. All three are independent: none of them consumes another, and they can coexist on the same machine.

What each of the three actually is

What it is How it is billed Where it works
Subscription (Claude Pro / Claude Max, ChatGPT Plus, etc.) Membership in the official chat apps and official coding products Flat monthly fee (see claude.com/pricing / chatgpt.com/pricing) Claude / ChatGPT apps; Claude Code sign-in with a Pro / Max plan
Official API key Developer key from Anthropic Console / OpenAI Platform Per token, topped up on the official platform Programs calling the official APIs directly
QCode key (cr_ prefix) This site's gateway key — one key, several protocols (Anthropic / OpenAI Chat / Responses; the Gemini protocol path is currently unavailable) Per token (qcode.cc/models for rates); personal plans have a daily cap; Pay-as-you-go Packs have a total quota for their validity period Claude Code, Codex, IDE plugins, chat clients

Both vendors state explicitly that API usage is billed separately from the subscription:

"A paid Claude subscription enhances your chat experience, and the Claude API is billed separately." —— Claude Help Center (checked 2026-10-15)

"Not included: API usage is separate and billed independently." —— OpenAI Help Center, "What is ChatGPT Plus?" (checked 2026-10-14)

So your Anthropic / OpenAI subscription cannot be used through QCode and is never consumed by it; equally, QCode usage does not touch your subscription quota. Two parallel systems.

The usual combinations

I have Claude Pro / ChatGPT Plus — can I use it with QCode or third-party tools?

No. The subscription covers the official apps only — signing in and using them (e.g. Claude Code signed in with Pro / Max). It grants no API quota that anything else could use. Running Claude / GPT models on QCode goes through our own per-token plans, independent of your subscription.

The two can coexist: the same Claude Code installation can either sign in with your subscription or point ANTHROPIC_BASE_URL at QCode with a cr_ key — whichever credential is active at the moment decides. CC Switch is the recommended way to flip between them.

Can Claude Desktop use my GPT subscription?

No. Claude Desktop's third-party inference accepts only gateways that implement the Anthropic Messages API — official wording: "The gateway must implement the Anthropic Messages API: POST /v1/messages with streaming and tool use is required." (official docs). The OpenAI protocol is out of scope for it, and a GPT subscription certainly does not fit. For GPT / Chinese models on the desktop, pick a client that speaks the OpenAI protocol (see Tool Compatibility Overview).

What happens if I set the ANTHROPIC_API_KEY environment variable while logged into Claude Code with a subscription?

It overrides the subscription sign-in and bills you per API token. From the Anthropic Help Center:

"Important: If you have an ANTHROPIC_API_KEY environment variable set on your system, Claude Code will use this API key for authentication instead of your Claude subscription (Pro, Max, Team, or Enterprise plans), resulting in API usage charges rather than using your subscription's included usage." —— Use Claude Code with your Pro or Max plan (checked 2026-10-15)

This is the most common cause of "it worked yesterday, today it wants money" or "I am signed in but get 401": a stale key in your shell config hijacks the auth path. Step 2 of the troubleshooting guide checks exactly this.

Which one do I need?

  • Just chatting / writing in the official apps: the subscription is enough, no QCode involved.
  • Calling models from your own scripts: an official API key or a QCode key — QCode covers several protocols and Chinese models with a single key.
  • Claude, GPT, GLM, Kimi side by side in Claude Code / Codex / IDE plugins: QCode key; the protocol and Base URL matrix is in Endpoints and API paths.
  • Flipping between subscription sign-in and the gateway: CC Switch.

Key settings explained: which variable decides the route

What you configure Effect Notes
Official subscription login (inside Claude Code) Uses the subscription allowance Counts against the subscription's usage limits, unrelated to QCode
ANTHROPIC_API_KEY (an official API key) Billed as official API usage Per the official text: when set it overrides the subscription login and incurs API charges
ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN (a cr_ key) Goes through QCode, billed per token Use https://api.qcode.cc/api; per-model rates are at qcode.cc/models

When several are present, which one applies depends on the active authentication path; to find out which one is in use, first look at which ANTHROPIC_* variables exist in your environment.

Common errors and how to troubleshoot

Symptom Likely cause Fix
An official API key entered in QCode gives Invalid API key Official keys and QCode keys are not interchangeable Create a cr_ key in the QCode console
Logged in with a subscription but billed as API usage, or getting 401 A stale ANTHROPIC_API_KEY remains in the environment Find it with env \| grep -i anthropic, remove it and reopen the terminal
You want QCode but Claude Code still uses the subscription ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN are not set, or set in the wrong place Check against Environment Variables; switching with CC Switch is recommended
Claude Desktop will not connect to QCode Desktop's third-party inference only accepts gateways that implement the Anthropic Messages API Follow Claude Desktop; for GPT or Chinese models pick a client that speaks the OpenAI protocol
404 Wrong Base URL Compare with Endpoints and API Formats
model_not_available_on_endpoint Protocol and model mismatch (e.g. Claude sent to the OpenAI endpoint) Change endpoint or model; this is not a key problem

FAQ

Can the API credits in a Claude Max or Team plan be used on QCode?

No. As of 2026-10-15 the same Claude Help Center page says Max and Team plans include monthly credits for the Claude API, but those credits belong to Anthropic's own API account and cannot be handed to a third-party gateway. A QCode cr_ key is billed separately per token, and the two are never converted into each other.

Can I use a subscription and QCode at the same time? Will they conflict?

You can have both, and neither consumes the other's allowance. A conflict only arises inside one client when an authentication path overrides another, for example a stale ANTHROPIC_API_KEY taking precedence over the subscription login. Switching configurations with CC Switch is the easiest way to avoid it.

Can QCode replace a subscription?

They are different kinds of product. A subscription is membership in the official apps; QCode is a per-token API gateway. The chat and document features inside the official apps are not something QCode provides. If you mainly write code in Claude Code, Codex or IDE plugins, a QCode key is all you need.

Why can't I use my ChatGPT Plus to call GPT in third-party tools?

The OpenAI Help Center states that Plus does not include API usage, which is billed separately. To use GPT in third-party tools, use a QCode cr_ key against the OpenAI endpoint, billed per token.

I only chat in the official apps. Do I need QCode?

No. For chatting and writing documents in the official apps, the subscription is enough.

Get started with QCode

One API key for Claude Code, Codex and more — billed per token, per-model prices on qcode.cc/models

Enterprise →