ChatGPT Subscription
Connect your existing ChatGPT Plus or Pro subscription to AdaL via OAuth. No API key needed — just log in with your ChatGPT account and start using GPT Codex models with your existing subscription credits.
Connect Your Subscription
- Run
/modelto open model selection - Scroll to Third Party Subscriptions → select ChatGPT Subscription
- Select Connect ChatGPT Account — your browser will open
- Log in with your ChatGPT account (Plus or Pro required)
- Once authorized, the dashboard will show Connected with your account email
On AdaL Desktop, press Model under the message box — or type /model, which opens the same section — and pick ChatGPT Subscription. Connect ChatGPT there opens the browser sign-in; once connected, that box lists the subscription's models and a Disconnect row that opens the Settings window at 3rd Party Plan → ChatGPT subscription. Settings in the sidebar opens the same place, where you connect, refresh, disconnect and read usage.
Two other places in Desktop offer the connection:
- A new, empty chat shows a card above the message box: Have ChatGPT Plus or Pro?, with Connect ChatGPT and Not now. Not now hides the card for good on that computer. The card never appears once ChatGPT is connected.
- When a chat stops because your AdaL credits ran out, the error row carries a Connect ChatGPT button that opens Settings → 3rd Party Plan → ChatGPT subscription. It shows only while ChatGPT is not connected, and only when the error came from your AdaL plan. A payment or balance error raised by your own API key reads the same way to the app, so that row shows no button.
The ChatGPT subscription card in Settings also shows how much of the subscription you have used: your plan as a badge next to the account email, and a 5-hour and a Weekly meter with the percentage used and the reset time. The numbers are ChatGPT's own limits, not AdaL credits or AdaL plan usage. The refresh button re-reads the connection and then the usage, and a successful usage read is reused for 60 seconds.
Available Models
When connected, the following models appear under ChatGPT Subscription in /model:
| Model | Best For |
|---|---|
| GPT-6 Astra | Frontier — hardest end-to-end reasoning and coding work |
| GPT-6 Sol | Complex coding and agentic workflows |
| GPT-6 Luna | Focused, high-volume tasks at the lowest cost |
| GPT-5.6 Sol | Frontier — complex professional work |
| GPT-5.6 Terra | Balances intelligence and cost |
| GPT-5.6 Luna | Cost-sensitive, high-volume work |
Select any model from the dashboard to switch to it.
GPT-6 Astra is gated by your ChatGPT plan: a Plus account may not have it in Codex, in which case it fails when you send a prompt. Pick GPT-6 Sol or GPT-6 Luna if that happens — OpenAI lists both in Codex for Plus, Pro, Business, Enterprise and Edu plans.
Manage Connection
From /model → Third Party Subscriptions → ChatGPT Subscription, you can:
- Refresh Status — Re-check connection and token validity
- Disconnect — Remove OAuth tokens from your machine (your ChatGPT subscription stays active)
Tokens refresh automatically in the background. You only need to reconnect if your session fully expires.
Troubleshooting
| Issue | Solution |
|---|---|
| "Not connected" after login | Wait a few seconds for authorization to complete, then try again |
| Connection expired | Go to /model → ChatGPT Subscription → reconnect |
| Authorization error in a Desktop chat | The error notice carries a Connect ChatGPT button that opens Settings → 3rd Party Plan → ChatGPT subscription, or pick another model |
| Out of AdaL credits in a Desktop chat | The error row carries a Connect ChatGPT button when the error came from your AdaL plan. Chats on a ChatGPT plan do not spend AdaL credits; every model in the AdaL catalog does, so switching model does not help |
| No models shown | Ensure you have ChatGPT Plus or Pro (free tier not supported) |
Security
- OAuth tokens are stored locally in
~/.adal/openai_oauth.json - Only your account email is stored — no passwords
- When you connect, AdaL sends your AdaL account one field: the plan code the ChatGPT login carries, such as
plusorprolite. Never the ChatGPT email, account id or tokens. Nothing is sent on a token refresh or on disconnect - Disconnect anytime to revoke access
Related: Models · BYOAK · Slash Commands