Documentation problem type
Missing documentation
Documentation location
https://opencodex.me/guides/providers/ (repository source docs-site/src/content/docs/guides/providers.md)
What is wrong or missing?
The documentation does not answer the first question subscribers ask before they connect an account: when a provider is used through OpenCodex, does the traffic draw on the subscription allowance that login already pays for, or does it bill separately per token?
Asked on X by @iGotYourBackMr on 2026-09-09: "if I use Claude through OpenCodex in the Codex app, does it use my included Claude Max allowance, or incur separate pay-per-use Anthropic API charges?" (https://x.com/iGotYourBackMr/status/2097703858159894675). The question recurs for every provider that has both a subscription login and an API key, and answering it once on X does not scale.
What should the documentation explain instead?
State the rule per authentication mode, not per vendor marketing tier: an OAuth or subscription login consumes that subscription's allowance and its quota windows, an API key bills that key's account per token, and OpenCodex does not convert one into the other. Then give the same one-line statement for each provider that supports both modes, so a reader can check their own setup without inference.
Suggested wording or example
For each provider entry, one explicit line, for example:
Anthropic (Claude subscription login): requests consume the subscription allowance attached to that login, subject to its own quota windows.
Anthropic (API key): requests bill the API account that owns the key, per token. No subscription allowance is consumed.
Plus a short note that the account card in the dashboard shows which mode an account is using, so the reader can verify rather than assume.
Additional context or attachments
Related closed issue #3777 (expose the Anthropic account subscription tier) shows the same subscription-versus-API confusion arriving through the product surface rather than the docs.
Checks
Documentation problem type
Missing documentation
Documentation location
https://opencodex.me/guides/providers/ (repository source
docs-site/src/content/docs/guides/providers.md)What is wrong or missing?
The documentation does not answer the first question subscribers ask before they connect an account: when a provider is used through OpenCodex, does the traffic draw on the subscription allowance that login already pays for, or does it bill separately per token?
Asked on X by @iGotYourBackMr on 2026-09-09: "if I use Claude through OpenCodex in the Codex app, does it use my included Claude Max allowance, or incur separate pay-per-use Anthropic API charges?" (https://x.com/iGotYourBackMr/status/2097703858159894675). The question recurs for every provider that has both a subscription login and an API key, and answering it once on X does not scale.
What should the documentation explain instead?
State the rule per authentication mode, not per vendor marketing tier: an OAuth or subscription login consumes that subscription's allowance and its quota windows, an API key bills that key's account per token, and OpenCodex does not convert one into the other. Then give the same one-line statement for each provider that supports both modes, so a reader can check their own setup without inference.
Suggested wording or example
For each provider entry, one explicit line, for example:
Plus a short note that the account card in the dashboard shows which mode an account is using, so the reader can verify rather than assume.
Additional context or attachments
Related closed issue #3777 (expose the Anthropic account subscription tier) shows the same subscription-versus-API confusion arriving through the product surface rather than the docs.
Checks