# Connect your ChatGPT subscription

Source: https://www.hyperagent.com/docs/billing/plans/connect-chatgpt-subscription

> For AI agents: the documentation index is at https://www.hyperagent.com/llms.txt and the complete documentation in one file at https://www.hyperagent.com/llms-full.txt. Any docs page is also served as Markdown by appending `.md` to its URL.

Connect ChatGPT to Hyperagent with OAuth, choose fallback behavior, and see which usage is covered by ChatGPT or billed through Hyperagent.

Connect your ChatGPT subscription to run supported GPT model usage through ChatGPT instead of your Hyperagent credits. Hyperagent currently supports ChatGPT subscriptions only, and the connection uses OAuth.



## Set up your connection [#set-up-your-connection]

In your ChatGPT settings, turn on **Enable device code authorization for
Codex**. The Hyperagent sign-in flow will not appear until this setting is on.

### Start the connection in Hyperagent [#start-the-connection-in-hyperagent]

Open **Settings → AI providers** and choose **Connect a ChatGPT
subscription**. Hyperagent displays a device code and a link to the
verification page.



### Authenticate with ChatGPT [#authenticate-with-chatgpt]

Select **Open verification page** and sign in to the ChatGPT account whose
subscription you want your agents to use.

### Enter the verification code [#enter-the-verification-code]

Enter the code shown in Hyperagent to approve the connection. Hyperagent
waits for approval and marks the subscription active when verification is
complete.

## What the connection covers [#what-the-connection-covers]

When the connection is active, supported GPT model usage runs against your ChatGPT subscription instead of drawing from your Hyperagent credits.

The connection applies only to usage supported by your ChatGPT subscription. Other models, image generation, search, browser sessions, and connected-service actions continue billing through Hyperagent.

## When you reach a ChatGPT usage limit [#when-you-reach-a-chatgpt-usage-limit]

ChatGPT subscriptions can have hourly or weekly usage limits. **Use Hyperagent subscription when usage is limited** controls what happens when you reach one:

* When the setting is off, work using the limited ChatGPT connection may be interrupted.
* When the setting is on, Hyperagent can cover the excess usage and bill it to your Hyperagent subscription.

## How charges appear in a thread [#how-charges-appear-in-a-thread]

Open a thread's **Usage** tab to see where its usage was covered. **Usage Breakdown** shows metered charges billed through Hyperagent, grouped by provider and model. Switch to **Tools** to isolate tool charges.

The current thread view labels ChatGPT-subscription usage as **Tokens on your key**. This refers to tokens routed through the OAuth connection. It does not mean an API key was pasted. These tokens are not included in the Hyperagent cost above.



## If ChatGPT usage was billed through Hyperagent [#if-chatgpt-usage-was-billed-through-hyperagent]

When **Use Hyperagent subscription when usage is limited** is on, Hyperagent
covers usage after you reach a ChatGPT limit and bills that usage to your
Hyperagent subscription.

The OAuth connection covers supported GPT model usage. Other models, tools,
browser sessions, search, and media generation continue billing through
Hyperagent.

Open **Settings → AI providers** and reconnect the subscription. Usage
cannot run against ChatGPT while the OAuth connection is inactive.

No. Hyperagent currently supports ChatGPT subscriptions through OAuth. There
is no API-key entry or pasted-key billing path.

Not currently. ChatGPT subscriptions are the only supported AI provider
connection.