Skip to content

Commit ee39fea

Browse files
docs: document connecting a ChatGPT subscription
Sign in with ChatGPT shipped in v0.2026.09.30.08.29.stable_01 and is GA in the public client repo (chatgpt_subscription is a default cargo feature). Adds a page for it alongside the SuperGrok equivalent and corrects the BYOK page, which asserted the feature did not exist. Co-Authored-By: Warp <agent@warp.dev>
1 parent dbaf7ae commit ee39fea

3 files changed

Lines changed: 104 additions & 3 deletions

File tree

‎src/content/docs/agents/inference/bring-your-own-api-key.mdx‎

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,13 +8,13 @@ import VideoEmbed from '@components/VideoEmbed.astro';
88

99
Warp supports **Bring Your Own API Key (BYOK)** for users who want to connect agents to their own Anthropic, OpenAI, or Google API accounts.
1010

11-
This lets you use your own API keys for model access, giving you control over model selection, billing, and data routing. See [Model Choice](/agents/inference/model-choice/) for a list of supported models. For xAI's Grok models, you connect a [SuperGrok subscription](/agents/inference/grok-subscription/) instead of adding an API key.
11+
This lets you use your own API keys for model access, giving you control over model selection, billing, and data routing. See [Model Choice](/agents/inference/model-choice/) for a list of supported models. For xAI's Grok models, you connect a [SuperGrok subscription](/agents/inference/grok-subscription/) instead of adding an API key. For OpenAI models, you can add an API key or connect a [ChatGPT subscription](/agents/inference/chatgpt-subscription/).
1212

1313
BYOK provides greater flexibility in model access and ensures Warp **never consumes your** [AI credits](/support-and-community/plans-and-billing/credits/) for requests routed through your own keys.
1414

1515
<VideoEmbed url="https://youtu.be/jbSBnbPzQwY" title="How to BYOK to the Warp Agent" />
1616

17-
For xAI's Grok models, you can also connect your SuperGrok subscription instead of entering an API key. In the Warp app, go to **Settings** > **Agents** > **Warp Agent** and choose to connect your SuperGrok subscription — Warp opens your browser to complete the connection.
17+
For xAI's Grok models, you can also connect your SuperGrok subscription instead of entering an API key. In the Warp app, go to **Settings** > **Agents** > **Warp Agent** and choose to connect your SuperGrok subscription — Warp opens your browser to complete the connection. The same section offers **Continue with ChatGPT** for an OpenAI [ChatGPT subscription](/agents/inference/chatgpt-subscription/).
1818

1919
:::note
2020
BYOK is available on Free and all eligible paid plans for individual users and organizations with 10 or fewer employees, subject to Warp's [Terms of Service](https://www.warp.dev/legal/terms-of-service). Larger organizations need a Business or Enterprise plan. See [Warp pricing](https://www.warp.dev/pricing) for current availability.
@@ -30,13 +30,14 @@ Warp offers several ways to bring your own AI infrastructure. Use this table to
3030
| **[Custom inference endpoint](/agents/inference/custom-inference-endpoint/)** | Connect Warp to an OpenAI-compatible endpoint such as OpenRouter, LiteLLM, z.ai, or an internal gateway. | Free and all eligible paid plans |
3131
| **[Bring Your Own LLM](/enterprise/enterprise-features/bring-your-own-llm/)** (BYOLLM) | Enterprise-managed inference through your cloud provider (AWS Bedrock and Gemini Enterprise Agent Platform (Vertex AI) today; Azure Foundry coming soon), with Warp handling routing, orchestration, governance, and observability. | Enterprise only |
3232
| **[SuperGrok subscription](/agents/inference/grok-subscription/)** | Connect your SuperGrok subscription to use Grok models through your xAI account. Tokens are stored locally on your device. | Free and all eligible paid plans |
33+
| **[ChatGPT subscription](/agents/inference/chatgpt-subscription/)** | Connect your ChatGPT plan to use OpenAI models through your OpenAI account. The connection is held for your Warp account on Warp's backend. | Plans that allow member-provided keys |
3334

3435
See [Warp pricing](https://www.warp.dev/pricing) for current plan availability.
3536

3637
Platform credits apply to every cloud agent run on any plan, and to local agent runs on Business and Enterprise when using BYOK, a custom inference endpoint, or BYOLLM. See [platform credits](/support-and-community/plans-and-billing/platform-credits/) for the full breakdown.
3738

3839
:::note
39-
**Can I sign in with a ChatGPT or Claude subscription?** No. A ChatGPT (OpenAI) or Claude (Anthropic) consumer subscription can't be connected to Warp the way a [SuperGrok subscription](/agents/inference/grok-subscription/) can. OpenAI and Anthropic don't currently allow their subscription plans to be used in third-party clients like Warp. To use your own OpenAI or Anthropic account, add an API key with BYOK and pay your provider directly. A subscription and API access are billed separately by the provider.
40+
**Can I sign in with a Claude subscription?** No. A Claude (Anthropic) consumer subscription can't be connected to Warp the way a [ChatGPT](/agents/inference/chatgpt-subscription/) or [SuperGrok](/agents/inference/grok-subscription/) subscription can. To use your own Anthropic account, add an API key with BYOK and pay Anthropic directly. A subscription and API access are billed separately.
4041
:::
4142

4243
## How BYOK works
@@ -160,5 +161,6 @@ Enterprise teams can also configure **team-managed API keys** centrally: an admi
160161
* [Custom inference endpoint](/agents/inference/custom-inference-endpoint/) — Route Warp through any OpenAI-compatible endpoint, such as OpenRouter, LiteLLM, z.ai, or an internal gateway.
161162
* [Bring Your Own LLM](/enterprise/enterprise-features/bring-your-own-llm/) — Enterprise-managed inference through your cloud provider or approved infrastructure.
162163
* [SuperGrok subscription](/agents/inference/grok-subscription/) — Use Grok models through your xAI account instead of Warp credits.
164+
* [ChatGPT subscription](/agents/inference/chatgpt-subscription/) — Use OpenAI models through your ChatGPT plan instead of Warp credits.
163165
* [Model Choice](/agents/inference/model-choice/) — Full list of supported models and `model_id` values.
164166
* [Credits](/support-and-community/plans-and-billing/credits/) — How Warp credits work and when they're consumed.
Lines changed: 98 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,98 @@
1+
---
2+
title: ChatGPT subscription
3+
description: >-
4+
Connect your ChatGPT plan to run OpenAI models in Warp through your OpenAI
5+
account instead of spending Warp credits.
6+
sidebar:
7+
label: "ChatGPT subscription"
8+
---
9+
10+
Warp lets you connect your **ChatGPT plan** so OpenAI models run through your own OpenAI account. If you already pay for ChatGPT, you can use OpenAI models in Warp without spending your Warp [credits](/support-and-community/plans-and-billing/credits/). OpenAI determines which plan tiers are eligible and how much usage they include.
11+
12+
Connecting a plan works like [Bring Your Own API Key (BYOK)](/agents/inference/bring-your-own-api-key/), except you sign in to your OpenAI account instead of pasting an API key. It covers OpenAI models only — Anthropic, Google, and xAI models are unaffected.
13+
14+
:::note
15+
Like BYOK, connecting a ChatGPT plan requires that your team allows members to bring their own keys. See [Warp pricing](https://www.warp.dev/pricing) for current availability.
16+
:::
17+
18+
## How it works
19+
20+
When you connect your plan, Warp opens your browser to OpenAI's Sign in with ChatGPT consent screen. Approving it links your ChatGPT account to your Warp account and authorizes OpenAI to share a delegated credential with Warp. Unlike a BYOK API key or a [SuperGrok subscription](/agents/inference/grok-subscription/), that credential is held for your account by Warp's backend rather than in your device's keychain, so you connect once per Warp account rather than once per device.
21+
22+
With a plan connected, Warp attaches the delegated credential to OpenAI requests the Warp Agent makes on your behalf, and OpenAI bills them to your ChatGPT plan. A pasted OpenAI API key takes precedence: if you have both, the key wins and the plan goes unused.
23+
24+
Connecting also changes which models you see. The server recomputes your model catalog when the connection starts or stops, and OpenAI models that your Warp plan would otherwise gate behind an upgrade become selectable, since you are paying OpenAI for them directly.
25+
26+
### What OpenAI sees
27+
28+
Each subscription-billed request carries two fixed labels that OpenAI requires: an activity name and a short purpose string, such as "Generate the agent's next response in a Warp agent conversation." The labels are fixed per request type and never derived from your prompt. OpenAI stores them separately from the request content and can surface them in your ChatGPT usage settings.
29+
30+
Agent turns are not the only requests that carry them. Background work the agent does for you — generating a conversation title, compacting earlier history to free context-window space, condensing a large tool result — is also billed to your plan and labeled the same way.
31+
32+
:::caution
33+
Data retention on OpenAI's side is governed by your own OpenAI account and its terms. Warp's Zero Data Retention agreements cover Warp-managed inference, so they do not apply to requests billed to your plan. See [Zero Data Retention and BYOK](/agents/inference/bring-your-own-api-key/#zero-data-retention-zdr-and-byok).
34+
:::
35+
36+
## Connecting your ChatGPT plan
37+
38+
1. In the Warp app, go to **Settings** > **Agents** > **Warp Agent** and find the "Use OpenAI ChatGPT plan" row under **Custom Inference**.
39+
2. Click **Continue with ChatGPT**. Warp opens your browser and shows a toast confirming the attempt. Click **Cancel** in Warp if you want to abandon it.
40+
3. Approve the connection in your browser. Back in Warp, the row shows a green check with "Connected as YOUR_EMAIL on DATE," where YOUR_EMAIL is the address on your ChatGPT account.
41+
4. Select an OpenAI model from the model picker in your prompt input. Connecting a plan doesn't change your selected model, so this step is what actually routes requests through your plan.
42+
43+
The first time a connected plan funds a request, Warp shows a one-time notice titled "You're using your ChatGPT plan" with a **Manage usage** button that opens your [ChatGPT usage settings](https://chatgpt.com/settings/usage). OpenAI's Sign in with ChatGPT guidelines require it.
44+
45+
If the row shows "Reconnect to use your plan for requests" next to the connected timestamp, the link still exists but OpenAI is no longer sharing a credential. Disconnect and connect again.
46+
47+
Connecting is only available in the Warp app. The [Warp Agent CLI](/agents/cli/) has no equivalent command, unlike `/connect-grok` for a SuperGrok subscription.
48+
49+
## Usage and billing behavior
50+
51+
When an OpenAI model runs on your connected plan:
52+
53+
* Warp **does not consume** any of your [credits](/support-and-community/plans-and-billing/credits/) for the request.
54+
* Inference is billed to your ChatGPT plan, within OpenAI's usage limits for that plan.
55+
* Review and manage that usage in your [ChatGPT usage settings](https://chatgpt.com/settings/usage), not in Warp. The **Billing and Usage** settings page links out to the same place.
56+
57+
### When OpenAI refuses a request
58+
59+
OpenAI can reject a subscription-billed request — for example, when your plan runs out of shared usage. Warp surfaces OpenAI's own message along with the recovery options OpenAI offers, which can include:
60+
61+
* **Retry** - Send the turn again, still billed to your plan.
62+
* **Continue with Warp credits** - Switch the rest of this conversation to Warp-funded inference and resume. This applies to that conversation only; new conversations go back to using your plan.
63+
* A link to an OpenAI page, such as your usage settings.
64+
65+
Choosing **Continue with Warp credits** is one-way for that conversation. Later failures in it are shown as a short disclosure line rather than an error, because the conversation is no longer using your plan.
66+
67+
### Auto models
68+
69+
Warp's **Auto** models always use Warp's own inference and **always consume Warp credits**, even with a ChatGPT plan connected. To use your plan, select a specific OpenAI model from the model picker.
70+
71+
## Disconnecting
72+
73+
In the Warp app, go to **Settings** > **Agents** > **Warp Agent**, find the "Use OpenAI ChatGPT plan" row, and click **Disconnect**. Warp unlinks the account on its servers, and OpenAI models go back to running on Warp credits. Connecting again re-shows the one-time plan notice.
74+
75+
## Troubleshooting
76+
77+
### "That ChatGPT account is already connected to another Warp account"
78+
79+
Each ChatGPT account links to one Warp account, and each Warp account links to one ChatGPT account. Disconnect the existing link first, then connect again.
80+
81+
### "Verify the email on your ChatGPT account, then try again"
82+
83+
OpenAI refuses to share a plan from an account with an unverified email. Verify it with OpenAI and retry.
84+
85+
### "Your browser is signed in to a different ChatGPT account"
86+
87+
The browser completed the flow as an account other than the one you intended. Sign out of ChatGPT in your browser, or use a private window, then click **Continue with ChatGPT** again.
88+
89+
### "Warp needs your permission in the browser"
90+
91+
The consent screen was dismissed or denied. Click **Continue with ChatGPT** and approve it.
92+
93+
## Related pages
94+
95+
* [Bring Your Own API Key](/agents/inference/bring-your-own-api-key/) — Use your own Anthropic, OpenAI, or Google API keys.
96+
* [SuperGrok subscription](/agents/inference/grok-subscription/) — Use Grok models through your xAI account.
97+
* [Model choice](/agents/inference/model-choice/) — Full list of supported models and `model_id` values.
98+
* [Credits](/support-and-community/plans-and-billing/credits/) — How Warp credits work and when they're consumed.

‎src/sidebar.ts‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -321,6 +321,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
321321
'agents/inference/bring-your-own-api-key',
322322
{ slug: 'agents/inference/custom-inference-endpoint', label: 'Custom inference endpoint' },
323323
{ slug: 'agents/inference/grok-subscription', label: 'SuperGrok subscription' },
324+
{ slug: 'agents/inference/chatgpt-subscription', label: 'ChatGPT subscription' },
324325
],
325326
},
326327
{ slug: 'agents/local-agents/interactive-code-review', label: 'Interactive code review' },

0 commit comments

Comments
 (0)