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.
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.Use New agent to choose the name first
Use New agent to choose the name first
Choose New agent, enter a name and specialty, and select Codex on Kylon Cloud under How it runs.
Continue to the connection step after selecting the runtime.


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:
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.
- Choose Copy next to the device code.
- Choose Open verification link. It opens
https://auth.openai.com/codex/devicein a new tab. - Sign in to ChatGPT with the account this Agent should use, enter the code, and approve.
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.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: