Using ChatGPT subscriptions with Kilo Code

You can use your ChatGPT account to sign in to Kilo and your subscription to run supported OpenAI models. Signing in and connecting your subscription are separate options. You can sign in with ChatGPT without using it for model requests, or connect a ChatGPT subscription to your existing Kilo account.

Your ChatGPT plan determines which models and how much usage are included. Check OpenAI's current plan details for details.

Sign in to Kilo with ChatGPT

1. Open Kilo. Scroll down to the alternative login methods.
2. Choose Continue with ChatGPT.
3. Sign in to OpenAI, review the permissions shown, and return to Kilo.

To use your subscription for model requests, complete the BYOK connection below as well. You do not have to use ChatGPT as your Kilo login method: if you already use email, GitHub, or another method, sign in as usual and connect your subscription from BYOK.

Connect your subscription to Kilo

Connect your subscription in the BYOK section to use it for supported model requests through the Kilo Gateway, rather than connecting OpenAI directly on each device.

1. Sign in to Kilo and select the personal account or organization where you want to use the subscription.
2. Open the Bring Your Own Key (BYOK) page.
3. Find OpenAI (ChatGPT subscription) and choose Sign in with ChatGPT. Do not enter an API key in the OpenAI API-key section; that uses pay-as-you-go token pricing instead of your subscription.
4. Sign in to the OpenAI account you want to use and approve the subscription permissions. This approval is separate from permission to sign in to Kilo.
5. Return to BYOK and confirm that the card shows Connected and the expected account next to Connected as.

Personal and organization connections

Connect in the same account context where you will run your tasks:

• Personal account: The connection applies to your personal Kilo usage. It does not carry over to organization requests.
• Organization: Each member can connect their own ChatGPT account for their own usage in that organization. Connecting yours does not share it with every member.
• Organization shared services: Owners and admins can use OpenAI (ChatGPT) for shared services and choose Connect an OpenAI account. This connection is for eligible automation requests, such as Code Reviews or the Slack bot, rather than every member's chats. It can consume the connected ChatGPT account's allowance.

Connect separately for each organization where you need access. If you connect the same ChatGPT subscription in multiple places, those connections still use the same OpenAI account's allowance; connecting again does not give you a separate quota.

Choose a model

In a Kilo client such as the VS Code extension or CLI, sign in to the same Kilo account and use the Kilo Gateway provider. For Cloud Agents, use the account or organization where you connected the subscription.

The subscription does not cover every OpenAI model or every kind of request. Kilo uses OpenAI's available-model list to determine eligible models, for example GPT-OSS models are not included in this route. For API integrations, the subscription route supports the Responses API, not Chat Completions requests.

For eligible requests, Kilo uses your connected ChatGPT subscription instead of a saved OpenAI API key or Kilo credits. Reaching your subscription limit does not automatically switch those requests to paid usage.

Costs and usage limits

Requests served through the subscription use your ChatGPT allowance rather than Kilo credits for model inference. Other costs are separate: Cloud Agent compute, Kilo Deploy, and other paid services are not included in your ChatGPT subscription.

When you reach your ChatGPT usage limit, the request stops with an error. Kilo does not retry it using a saved API key or Kilo credits. Retrying the same eligible request with the same connection still uses ChatGPT, so buying Kilo credits alone does not bypass the limit.

Open BYOK and use Manage usage to check your allowance and reset time. Wait for the limit to reset, or disconnect the applicable subscription connection to use your saved API key or Kilo credits for subsequent requests.

Manage the connection

Return to the BYOK page in the account or organization where you connected:

• Connected: Use View and manage your ChatGPT usage to open OpenAI's usage settings. Kilo's usage-limit notice reports a recent limit error; it is not a live remaining-quota meter.
• Needs reconnect: Choose Reconnect with ChatGPT and approve access again. Kilo normally refreshes access automatically, but an expired or revoked connection can require another sign-in.
• Disconnect: Removes that subscription connection from Kilo. It does not cancel your ChatGPT subscription or remove ChatGPT as a Kilo login method. Subsequent requests may use a saved API key or Kilo credits.

Signing out of Kilo does not disconnect your subscription. Manage each personal, organization-member, and shared-services connection separately.

What you authorize

The browser-based authorization uses OAuth: you sign in on OpenAI's site rather than giving Kilo your ChatGPT password. The BYOK flow asks for permission to use your allowance and renew access without asking you to sign in for every request.

Kilo stores the connection credentials encrypted. Requests and their code context pass through the Kilo Gateway before reaching OpenAI.

Connect directly in VS Code or the CLI

Use this option when you want the local OpenAI provider to use your subscription directly, without the Kilo Gateway. It does not create a BYOK connection for Cloud Agents.

Check local Codex usage

When you connect the local OpenAI provider with ChatGPT, Kilo reports your Codex quota alongside your other connected providers:

• VS Code: open the Profile view and find the Plans & usage section.
• CLI: run /usage (aliases /plans and /quota) and press ctrl+r to refresh.

Codex shows its plan and each usage window — for example, a five-hour and a weekly limit — with the percentage used and the reset time. The Manage link opens your Codex usage settings at chatgpt.com. If your ChatGPT sign-in has expired, you can reconnect from the provider settings.

The local provider only exposes models in Kilo Code's Codex catalog, not every model available through the OpenAI API.

Troubleshooting

I signed in with ChatGPT, but my subscription is not connected. Kilo account login and subscription authorization are separate. Open BYOK in the correct personal account or organization and connect OpenAI (ChatGPT subscription).

My personal connection does not work in an organization. Switch to that organization and connect your ChatGPT account on its BYOK page. Your personal connection is not reused for organization traffic.

The connection attempt timed out or failed. Return to the correct BYOK page and choose Try again. Complete OpenAI's consent flow without leaving it open for more than 15 minutes. If the card cannot load your connection status, Try again reloads it.

I reconnected, but OpenAI still says I reached my limit. Reconnecting renews access; it does not replenish your subscription allowance. Check Manage usage for the limit and reset time.

I want to use a different ChatGPT account. Disconnecting BYOK alone does not remove the ChatGPT identity linked to your Kilo login. Kilo allows one linked ChatGPT identity per user. Check Connected Accounts before trying to link another identity, and make sure you have another sign-in method available before unlinking your current one.

My local browser sign-in fails with a CSRF or callback error. The direct VS Code and CLI flow uses local port 1455. Check that another application is not using it. On macOS or Linux, run lsof -i :1455. This does not apply to the dashboard BYOK flow.

How do I disconnect the local provider? In VS Code, choose Disconnect in the provider settings. In the CLI, run kilo auth logout and choose OpenAI. This is separate from managing the connection on Kilo's BYOK page.

You can still switch to another provider or an API-key configuration. Check that provider's billing before sending requests.