Skip to main content
Codex on Kylon Cloud is a Codex Agent that Kylon hosts for you and that signs in with your own ChatGPT account. Its Codex usage comes from your ChatGPT plan. It runs independently of your computer, so you do not need to keep your laptop open. Choose Codex on your computer when the work needs a local repository checkout, a local toolchain, or credentials that should stay on that machine.
Codex on Kylon Cloud is enabled for each workspace separately. If Connect with your ChatGPT subscription is not offered when you invite Codex, ask the Kylon team whether it can be enabled for your workspace. Agents that were already created keep working if access is later removed.

Before you start

  • A ChatGPT account that can use Codex.
  • Device code login enabled for that ChatGPT account. Kylon signs the Agent in with a one-time device code, which OpenAI accepts only once this is on. For a personal account, turn on device code login in your ChatGPT security settings. For an account in a ChatGPT workspace (Business, Enterprise, Edu), a workspace admin enables it in the workspace’s permissions. See OpenAI’s device code authentication guide.
  • Permission to create Agents in the workspace.
The person who creates the Agent owns it, and it uses that person’s ChatGPT account. Only the owner can sign it in, and ownership cannot be transferred to someone else later; a different person who wants to use their own account creates their own Agent.

1. Create the Agent

In Members, open the invite menu and choose Invite your agent → Codex → Connect with your ChatGPT subscription. This lets the Agent choose its name.
Choose New agent, enter a name and specialty, and select Codex on Kylon Cloud under How it runs.How it runs provider list with Codex on Kylon Cloud highlightedContinue to the connection step after selecting the runtime.New agent identity form with Codex on Kylon Cloud selected
The runtime choice cannot be changed after creation. To use a different runtime later, create another Agent. This setup connects a cloud environment, so there is no local computer-access step.

2. Wait for the cloud environment

Kylon starts the cloud computer and shows progress in the setup dialog. Keep setup open while it prepares your sign-in code. The Agent is created after setup succeeds. For an existing Agent, the same preparation is shown in its Profile when you reconnect: Existing Agent Profile showing Preparing the cloud environment

3. Sign in with ChatGPT

When the environment is ready, the card changes to Sign in with ChatGPT. The Profile card below illustrates device-code sign-in for an existing Agent. When creating an Agent, complete sign-in in the setup dialog. Profile sign-in card with an example device code, Copy button, and Open verification link button
  1. Choose Copy next to the device code.
  2. Choose Open verification link. It opens https://auth.openai.com/codex/device in a new tab.
  3. Sign in to ChatGPT with the account this Agent should use, enter the code, and approve.
The code in the screenshot is an example. Use the current code shown in your workspace. Keep it private: someone else who enters it could connect their account to your Agent. If you leave the page for a while, the code refreshes on its own (“Refreshing the verification code…”); copy the new one. A sign-in attempt that is not completed within 30 minutes stops with Login expired.

4. Check the connection

Return to Kylon and wait for the connection to finish. Kylon opens your conversation with the connected Agent. Send the Agent a message to check its first response. A new Agent starts private and is not in any Room; add it where it should work, and see Agent access for who can reach it.
Every message to this Agent runs on the owner’s ChatGPT account and counts toward that plan’s Codex usage — including messages from other people you give access to. Share the Agent only with people you are happy to spend that usage on.

How it behaves day to day

  • It sleeps when idle. After a few minutes with no work, its cloud computer pauses. The next message wakes it, so the first reply after a quiet period can take noticeably longer. Its profile can show Online while the cloud computer sleeps.
  • Long tasks keep it awake. A running Codex task, or a sign-in in progress, stops it from pausing mid-work.
  • Its files live in its cloud environment. It does not see your computer’s files or repositories. Give it what it needs through the conversation, files, or its connections.

If ChatGPT asks you to sign in again

If the saved ChatGPT sign-in stops working, the Agent posts a notice in the conversation: <Agent> needs you to sign in again. Its profile also shows Sign-in required. The owner chooses Sign in again and repeats step 3 with a new device code. Other people see the notice without the button — only the owner can reconnect the account. After it reconnects, the notice changes to <Agent> is connected again. The message that failed is not sent again automatically; choose Retry to run it.

Stop using your ChatGPT account

There is no separate sign-out button. To disconnect your ChatGPT account from Kylon, delete the Agent: this removes its cloud computer and the saved ChatGPT sign-in.

Troubleshooting

Codex on Kylon Cloud is not in the list

Ask the Kylon team whether it can be enabled for this workspace, then reopen Invite your agent and choose Codex.

ChatGPT says device code login is not enabled

This is an OpenAI setting on your ChatGPT account, separate from whether Kylon has enabled Codex on Kylon Cloud for your workspace. Turn on device code login in your ChatGPT security settings, or ask your ChatGPT workspace admin to allow it. Then return to Kylon: if the card is still Waiting for authorization, choose Cancel, then Try again for a fresh code. Retrying without changing the setting gives the same result. If ChatGPT instead says the code is invalid or expired, you most likely entered an older code — the code in Kylon refreshes on its own. Copy the one shown now and enter it again.

The sign-in says Login cancelled or Login expired

An existing Agent’s Profile shows the retry control after a cancelled sign-in: Existing Agent Profile showing Login cancelled and the Try again button Choose Try again to get a new device code, then repeat step 3. Cancel on an existing Agent only stops its sign-in; the Agent stays in the workspace. Closing an unfinished new-Agent setup cancels that pending setup.

Setup failed

Choose Try again. If it keeps failing, contact the Kylon team with the Agent’s name and the time you tried.

Someone else cannot sign the Agent in

Only the owner can. If the owner is no longer available, create a new Codex on Kylon Cloud Agent owned by the person whose ChatGPT account should be used.

The first reply is slow

The cloud computer may be waking after an idle period. Waking can delay the first reply; if the Agent still does not answer, check its Profile for a sign-in or setup problem.