ChatGPT API credits and Codex on API keys
ChatGPT Pro and Business include monthly API credits, but a user reports that claiming them blocks Codex on the linked API keys. Here is what OpenAI documents.
What the ChatGPT API credits benefit is
ChatGPT API credits are a monthly grant of free OpenAI API credit that comes with paid ChatGPT Pro and Business subscriptions. You link one API organization to your subscription, and the credit is added to that organization. The problem is Codex. OpenAI says the benefit does not cover Codex usage through API keys. One user now reports that claiming it also stops the linked organization's keys from working in Codex at all.
This guide keeps two things apart: what OpenAI documents, and what users report. The documented parts come from OpenAI's developer guide to ChatGPT API credits, the ChatGPT pricing page and the Codex docs, all read on 20 November 2026. The reports come from a public GitHub issue on the Codex repository. At the end you will find the decision this leaves you with, and what each choice costs.
Which ChatGPT plans get API credits, and how much
Only Pro and Business subscriptions are eligible. The pricing page marks "Monthly API credits" as No for Free, Go and Plus. Enterprise is not eligible either. If you are on Plus and wonder whether Pro is worth it for this, the price and limits of ChatGPT Plus and the price and limits of ChatGPT Pro cover the rest of the difference between the two plans.
The data behind this chart
[
{
"plan": "Pro 100",
"monthly_credit_usd": 100,
"notes": "per subscription"
},
{
"plan": "Pro 200",
"monthly_credit_usd": 200,
"notes": "per subscription"
},
{
"plan": "Pro 500",
"monthly_credit_usd": 500,
"notes": "per subscription"
},
{
"plan": "Business Standard",
"monthly_credit_usd": 20,
"notes": "per paid Standard seat, pooled, workspace cap 500"
},
{
"plan": "Business Premium",
"monthly_credit_usd": 100,
"notes": "per paid Premium seat, pooled, workspace cap 500"
}
]On Pro the grant follows the tier. Pro 100 gets $100 a month, Pro 200 gets $200, and Pro 500 gets $500. On Business the grant is per paid seat: $20 for each Standard seat and $100 for each Premium seat. Business credits are pooled across the workspace and capped at $500 per workspace per month. A Business plan paid annually and upfront receives the whole year's grant in one issuance.
These rules apply to every eligible plan:
- The first grant is prorated, so your first month can be smaller than the figures above.
- Unused credits expire at the end of the billing cycle. They do not roll over.
- You do not need a payment method on the API account to receive the credits.
- The pricing page says the benefit "is subject to change or discontinuation, including credit amounts and future renewals."
To claim, the subscription must be active, paid, and at least seven days old. Free trials and complimentary subscriptions do not qualify. You must own both the ChatGPT subscription (or the Business workspace) and the API organization. Both accounts must use the same email address.
How to claim the credits, and why the choice of organization matters
There are two ways in, and both end at the same confirmation step:
- From ChatGPT. On Pro, open Settings, then Billing. On Business, use the workspace billing page or the Admin Console.
- From the API Platform. Open Billing and select the eligible subscription.
The last step reads "Confirm to activate the benefit." If you own more than one eligible API organization, you choose which one to link. Choose carefully. The guide says to contact support if you need to change the linked organization, so there is no self-serve way to move it.
After linking, the credits apply only to that organization. Your requests must use one of that organization's project API keys. Free credits are spent before any credits you bought. When no credit is left at all, requests fail with HTTP 429 and the error code credit_balance_exhausted. The guide lists two fixes: add paid credits, or set up Auto Recharge.
Does the ChatGPT API credits benefit work with Codex?
OpenAI's answer is no. The developer guide says: "Codex usage through API keys is not supported by this benefit. These API credits also don't increase your ChatGPT or signed-in Codex usage limits." That passage makes two separate points.
First, the credits do not pay for Codex. When Codex runs on an API key, it is billed at standard API pricing. The Codex docs say API-key sessions "use separate API pricing, not your ChatGPT allowance." Second, the credits do not raise the Codex usage that comes with your plan. Codex signed in with ChatGPT draws on your plan's included usage, which works the way ChatGPT usage limits and their reset windows describes.
What the guide does not say is that claiming the credits switches off Codex for the linked organization's keys. "Not supported by this benefit" reads as a billing statement: the free credit will not be spent on Codex. One user reports something stronger.
What users report about Codex on API keys after claiming
Issue #58005 on the openai/codex GitHub repository was opened on 29 October 2026 by a user, not by OpenAI. Its title asks OpenAI to clarify whether the subscription credits can fund Codex API-key usage, because "docs exclude it, desktop requests succeed". The reporter signed in to the Codex desktop app on Windows with an API key from a linked organization whose only balance was the subscription credit. Work ran, and the API dashboard showed a nonzero cost. So at the end of October, API-key Codex still worked from a linked organization.
A comment on the same issue, dated 17 November 2026, reports something different. It says that claiming the credits disables Codex access through that organization's API keys, including usage paid with purchased credits, until the benefit is cancelled. The commenter asks OpenAI to "make the tradeoff clearer before users claim the credits." As of 20 November the issue is still open, with no reply from OpenAI staff.
Read together, the two reports suggest the block is newer than the docs. The part of the Codex changelog read for this guide showed no entry about it. Treat the block as a user report, not as OpenAI policy. If your claim screen shows a warning about Codex and API keys, read it before you confirm, because that text describes your account today. OpenAI's public pages do not publish the wording of that dialog, so this guide does not quote it.
Two things carry on either way. Codex signed in with ChatGPT keeps working on your plan's usage, and Codex cloud features need that sign-in anyway. Ordinary API requests made with the linked organization's project keys keep working, and they spend the free credit first.
Check which sign-in your Codex CLI is using
Before you decide anything, find out how your Codex is signed in. The CLI prints the active authentication mode:
codex login statusIf it reports ChatGPT sign-in, Codex runs on your plan's usage and the credits benefit does not touch it. If it reports an API key, Codex bills to that key's organization at API pricing. That is the setup the reported block affects.
To switch to ChatGPT sign-in, run codex login with no options. By default it opens a browser for the ChatGPT sign-in. To switch to an API key, pipe the key in on standard input:
codex login
printenv OPENAI_API_KEY | codex login --with-api-keyPiping the key means it never appears as a command-line argument. After either change, run codex login status again to confirm the mode. Then run one small task. If it fails on an API key from the linked organization, while plain API requests with the same key still work, you have most likely hit the block the 17 November comment describes. API-key mode covers Codex in the CLI, the SDK and the IDE extension, but not the cloud features such as GitHub code review. For the full picture of plan-based Codex, see using Codex with a ChatGPT subscription.
Can you use a key from a second, unlinked organization?
OpenAI does not document this. The guide says the grants apply only to the linked organization, and it says nothing about Codex in any other organization. One part follows from that rule: a second organization gets none of the free credit, so any Codex usage there is paid from that organization's own purchased balance at API pricing.
Whether the reported block reaches a second organization is something you can only test. If you already have another API organization with a paid balance, create a project key there, sign in to Codex with it as shown above, and run one small task. Check the usage page of that organization afterwards, because the test spends real money.
What happens to the link when you downgrade, cancel or switch plans
The guide covers plan changes, and these are documented:
- Downgrade to Plus, Go or Free. The API organization link is removed at the end of the billing cycle.
- Move from Business to Enterprise. Enterprise is not eligible, so the link is also removed at the end of the cycle.
- Cancel the subscription. New grants stop. Cancellation alone does not revoke credits already issued, so you can use them until they expire.
- Move from Pro to Business. The Pro link ends. A Business owner can create a new link once the Business subscription has been active for seven days.
The guide does not cover unlinking while you keep the same plan, and it does not say what happens to unused credits in that case. If a dialog or a support reply gives you rules about unlinking, such as losing unused credit or waiting before you can link again, save a copy. Those rules are not in OpenAI's public guide, so the message you received is your only record of them.
Keep the credits or get API-key Codex back: the decision
If the reported block applies to your account, you have two real choices.
Keep the credits. You get your plan's monthly API grant for ordinary API work, such as scripts, apps and batch jobs. You run Codex through the ChatGPT sign-in, inside your plan's limits. The cost is Codex on the linked organization's keys. That matters if you run Codex headless with an API key, for example in a CI (continuous integration) job. It also matters if you planned to pay for extra Codex at API prices once your plan's limit runs out.
Give up the benefit to get API-key Codex back. You lose the monthly grant, up to $500 on Pro 500. You gain nothing on Codex cost, because the credits never paid for Codex in the first place: API-key Codex is billed at API pricing either way. The guide describes no self-serve switch for the benefit alone. The documented exits are a downgrade or a cancellation, which end the link at the end of the cycle, and a support request. Whether API-key Codex returns at once after the benefit ends is not documented. The 17 November comment says access returns when the benefit is cancelled, but OpenAI has not confirmed it or given a timing. Test with codex login status and one small task once the change goes through.
A simple rule helps. If your Codex work fits inside your plan's signed-in limits, keep the credits, because you lose nothing you use. If your workflow depends on Codex with an API key, the access is worth more than the grant. In that case, do not claim, or end the benefit if you already did. If you have not claimed yet, read your claim dialog first. It is the only place that states the current trade for your account.
FAQ
Does ChatGPT Plus include monthly API credits?
No. OpenAI's pricing page lists monthly API credits as No for Free, Go and Plus. Only paid Pro and Business subscriptions are eligible, and Enterprise is not. On Pro the monthly grant is $100, $200 or $500 depending on the tier. Business gets $20 per paid Standard seat or $100 per paid Premium seat, capped at $500 per workspace per month.
Can I use the free ChatGPT API credits to pay for Codex?
No. OpenAI's developer guide says Codex usage through API keys is not supported by the benefit. The credits do not raise your ChatGPT or signed-in Codex usage limits either. Codex on an API key is billed at standard API pricing. Codex signed in with ChatGPT uses your plan's included usage.
Why did Codex stop working with my API key after I claimed the credits?
One user reports that claiming the credits disables Codex access through the linked organization's API keys, even for usage paid with purchased credit, until the benefit is cancelled. OpenAI has not documented this as of 20 November 2026. The report comes from a comment on issue #58005 in the openai/codex repository. Run codex login status to confirm Codex is on an API key. Then switch to ChatGPT sign-in with codex login if you want to keep the credits.
What happens to my API credits if I cancel ChatGPT Pro?
New grants stop, but cancelling does not revoke credits already issued. You can use them until they expire at the end of the billing cycle, since unused credits never roll over. If you downgrade to Plus, Go or Free instead, the link to your API organization is removed at the end of the billing cycle.