# Codex

Use your own Codex subscription in every Klarety <Term id="studio">Studio</Term>. It works on your code next to Klarety AI and reaches your data through the built-in [Klarety MCP](/docs/ai-harness/mcp), with your own access. Sign in once and it is ready in every <Term id="project">project</Term>.

## Before you start [#before-you-start]

- You need your own Codex subscription. Use it as Codex's own terms allow.
- Your <Term id="workspace">workspace</Term> must allow Codex. An Owner or Admin controls this in <AppLink to="settings.organization" /> under **AI tools**. If it is not allowed, the Studio says "Your workspace does not allow Codex."
- You need a project you can open. See [Create a project](/docs/projects/create-a-project).

## Connect Codex [#connect-codex]

<Steps>
<Step>
### Open a Studio [#open-a-studio]
Open the project and start its Studio. Wait until it shows **Running**.
</Step>
<Step>
### Open an AI tool [#open-an-ai-tool]
In the **AI** tab, select **+** (**Open an AI tool**). Until you sign in, Codex shows **Sign in** beside its name. Choose **Codex**.
</Step>
<Step>
### Sign in in your own terminal [#sign-in-in-your-own-terminal]
Codex starts in your own terminal in the Studio with its usual sign-in. Sign in with your own Codex account. Nobody else in the Studio sees or types in this terminal.
</Step>
<Step>
### Start working [#start-working]
Once signed in, ask Codex to do something in your project.
</Step>
</Steps>

<Screenshot src="/docs/_media/project-page-codex-new-session.png" alt="The Open an AI tool menu with Codex ready to sign in" />

Or start from <AppLink to="connectors" />: find **Codex** under **AI harness**, select **Connect**, and pick a project under **Sign in from**. Klarety opens that Studio with Codex ready to sign in.

## Check that it worked [#check-that-it-worked]

- In <AppLink to="connectors" />, Codex shows **Connected**, with "works in all your projects".
- While Codex runs in one of your Studios, its page shows your **Plan usage** (how much of your Codex plan is used, and when it resets). Only you see it, and it comes from Codex itself, never your account.
- Open Codex in another project's Studio: it starts without asking you to sign in.

## Use it in another project [#use-it-in-another-project]

Codex runs in one of your projects at a time. If it is open in another of your projects, the Studio says "Codex is open in another of your projects. Move it here to use it in this one." **Move here** closes it there and opens it here, still signed in.

If you turned Codex off for one project, the Studio says so and offers **Turn on for this project**.

## Close, reopen and continue [#close-reopen-and-continue]

Closing the Codex tab does not stop it. Open it again from **+** to pick up where it left off. Earlier conversations are under **AI sessions** in the side panel, where you can **Continue** one.

## Disconnect [#disconnect]

<Callout type="warn" title="Disconnect applies everywhere">
Disconnecting removes your sign-in from every project and ends it in any open Studio.
</Callout>

Go to <AppLink to="settings.connected-accounts" />, find **Codex** under **Your AI tools**, and select **Disconnect**. Your sign-in is deleted from Klarety. You can connect again any time.

<Screenshot src="/docs/_media/connected-accounts.png" alt="Connected accounts with Codex under Your AI tools and its Disconnect button" />

## If something goes wrong [#if-something-goes-wrong]

<Accordions>
<Accordion title="Codex shows Sign in again">
Its sign-in ended, for example because it expired at Codex. Open it in a Studio and sign in again.
</Accordion>
<Accordion title="Your workspace does not allow Codex">
A workspace Owner or Admin has turned it off. Ask them to allow it in <AppLink to="settings.organization" />, under **AI tools**.
</Accordion>
<Accordion title="Codex is in another project">
Select **Move here** to bring it to this project.
</Accordion>
</Accordions>

## Next steps [#next-steps]

- [How the AI harness works](/docs/ai-harness)
- [Your sign-in stays yours](/docs/ai-harness/privacy)
- [Copies and second opinions](/docs/ai-harness/copies)
- [Work together](/docs/ai-harness/working-together)