Codex

"subscription_sharing_usage_limit_exceeded" in OpenCode, Pi and other apps using your ChatGPT plan

Last checked

The error

{"type":"error","error":{"message":"The ChatGPT user has reached their Subscription Sharing usage limit. Ask the user to try again after their usage limit resets or use an API key instead.","type":"invalid_request_error","param":null,"code":"subscription_sharing_usage_limit_exceeded"}}

HTTP 429. Seen in OpenCode ("ChatGPT usage limit reached. Check ChatGPT Settings → Usage for details."), Pi, oh-my-pi and any other tool that uses your ChatGPT plan through Sign in with ChatGPT. Not seen in Codex CLI itself, which often keeps working on the same account.

The app you're using borrows your ChatGPT plan's Work-and-Codex allowance, and OpenAI gives each such app its own weekly cap: a percentage of your overall weekly usage, set in ChatGPT → Settings → Usage → App limits. This error fires when the app hits that cap or your plan hits its own five-hour/weekly/monthly limit. Open Settings → Usage, see which one it is, raise the app's percentage if it's the app cap, or wait for the reset time shown. Signing in again does not clear it.

Why it happens

An app using your ChatGPT plan through Sign in with ChatGPT is metered against your plan's Work-and-Codex allowance and against its own weekly app cap. Either one running out returns this code.

  1. The app reached its own weekly limit. OpenAI: "An app's weekly usage limit controls the percentage of your overall weekly ChatGPT usage that app can consume. The app can reach its limit while you still have ChatGPT usage remaining." That's why Codex CLI can carry on while OpenCode is blocked.
  2. Your plan reached its limit. On Plus and Business Standard that's a five-hour or weekly window; on Pro, weekly; on Go, monthly. The app shares that pool with Codex and ChatGPT Work: "An app limit is a cap - not a separate pool of usage."
  3. Credits can't be used by the app. Apps can spend your ChatGPT credits after plan limits only if you've allowed it ("This is off by default") and the app's cap is set to 100 %. A lower cap blocks credit use for that app.
  4. Known bugs (open as of 19 Nov 2026). openai/codex #61487: requests without max_output_tokens, or with large values, are rejected while small caps succeed on the same account. #61984 and opencode #64174: a re-authorised client stays blocked after the allowance resets while a fresh app registration works. #51043: a Pi user stayed blocked after using a full reset. OpenAI's guidance to developers for this code: "Do not assume the entire plan is empty or infer a reset time from this code alone; an app-specific limit can also apply."

The fix

  1. 1 Open ChatGPT → Settings → Usage. Look at the plan meters (five-hour / weekly / monthly) and the App limits section. Whichever shows 0 % left is the one that stopped you.
  2. 2 If it's the app limit: select the app → Manage limits → raise the weekly percentage → Save. Send the request again; no re-login needed.
  3. 3 If it's the plan limit: wait for the reset time shown, use a banked reset (Settings → Usage & billing, or /usage → Redeem reset in Codex CLI), buy an instant reset (Plus/Pro) or credits — and if you want the app to use credits, turn on "allow apps to use credits" and set the app cap to 100 %.
  4. 4 In the meantime, switch the app to an API key for that provider; API usage is billed separately and never touches the plan.
  5. 5 If the meters show usage remaining on both and the error persists after a fresh request, you've hit one of the open bugs: in the app, remove the ChatGPT connection and add it again as a new registration (what worked in #61984), or set a max_output_tokens cap if the app exposes one (#61487). Subscribe to the issue; don't loop on retries ("repeatedly retrying does not restore your usage").
/status

Still failing?

  • Business workspace. An admin must set "Use ChatGPT plan: Allowed" for the app under Tenant settings → External access, and the workspace's "Usage in other services" percentage applies to you. Ask the admin before debugging locally.
  • Free plan or an app on the commercial list. Plan usage in commercial partner apps needs Go, Plus, Pro or Business; open-source tools "remain available to all ChatGPT users". If you're on Free in a commercial app, the code you'll see is subscription_sharing_user_not_eligible (403), not this one.
  • Usage page itself errors. subscription_sharing_usage_unavailable (503) means OpenAI couldn't check your usage; it is not a limit. Retry later.

Related errors

Full guideCodex usage limits by planEvery error, one pageClaude Code and ChatGPT rate limit alternatives

Hit a different error?

Paste any agent error and get the cause and fix in seconds.

Open the decoder

Frequently asked questions

Is subscription_sharing_usage_limit_exceeded the same as the Codex usage limit?

Not quite. It means an app using your ChatGPT plan through Sign in with ChatGPT hit a limit, which can be the app's own weekly cap or your plan's limit. Codex CLI uses the plan directly and prints a different message ("You've hit your usage limit…").

Why does Codex CLI still work when OpenCode shows this error?

Because each app that borrows your plan has a separate weekly percentage cap set in Settings → Usage → App limits. The app can run out while your plan still has usage; Codex CLI isn't subject to that cap.

Does signing in again fix it?

No. OpenAI says "Signing in again or repeatedly retrying does not restore your usage." Raise the app limit or wait for the reset. If the meters show usage left and the error persists, re-adding the app as a new registration has worked for some users (openai/codex #61984).

Can the app use my ChatGPT credits after the limit?

Only if you've allowed apps to use credits (off by default) and that app's limit is set to 100 %. Otherwise the app stops at your included usage even if you have a credit balance.

Which plans can use their ChatGPT plan in other apps?

Go, Plus, Pro and Business for commercial partner apps (Business needs admin approval per app); supported open-source tools are available to all ChatGPT users. Free accounts in commercial apps get subscription_sharing_user_not_eligible.

Stop firefighting agent errors

Decoding errors one at a time is the manual version of what BetterClaw automates. Run your agents on a no-code AI agent platform with managed models, retries and config validation built in.

Free plan available · Pro $49/mo · BYOK · 7-day free trial