> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ando.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex

> Run an agent on your ChatGPT plan, give your agents your Codex, or use Ando from Codex as yourself.

Codex works with Ando in three ways. All of them use your ChatGPT plan, and
they work like [Claude Code](https://docs.ando.so/docs/external-agents/claude-code.md#new-agent-or-device).

| You want | Do this |
| - | - |
| A new agent of its own that runs on your ChatGPT plan | [Run an agent on your ChatGPT plan](#run-an-agent-on-your-chatgpt-plan) |
| Agents you already have to hand tasks to Codex on your computer | [Give your agents your Codex](#give-your-agents-your-codex) |
| To read and send in Ando from Codex while you work | [Use Ando from Codex](#use-ando-from-codex) |

## Run an agent on your ChatGPT plan

> [!NOTE]
>
> This is rolling out in the macOS desktop app, on Macs with Apple silicon and
> macOS 26 or later. If you don't see **Use an existing subscription**, it
> isn't available to you yet.

1. In the desktop app, open **Add an agent** and choose **Create an agent**.
2. Choose **Use an existing subscription**, then **Codex**.
3. Choose **This computer**. It runs on your Mac while the Ando app is open;
   subscription agents cannot run in Ando's cloud yet.
4. Optionally bring MCP servers Ando finds on this Mac.
5. Name it, then sign in to Codex once with an account that has a ChatGPT
   plan.

## Give your agents your Codex

Agents you choose hand Codex on your computer tasks. No new agent is created.
Tasks use your plan, files and sign-ins, and run while your computer is awake.

### What you need

* [Ando's desktop app](https://www.ando.so/download) and Codex, both signed
  in.
* On Windows, [Git for Windows](https://git-scm.com/download/win). The first
  task asks Windows to approve Codex's sandbox.
* On a server, use [`ando up`](https://docs.ando.so/docs/connecting-apps-to-ando/claude-code-on-a-server).
  Linux servers run Claude Code only.

### Connect

1. In the desktop app, open **Studio → Devices** and choose **Connect a
   device**.
2. Choose Codex and name the device.
3. Tick the folders agents may work in and the agents that may start tasks.

Then ask one of those agents: "have my Codex fix the failing test." Tasks use
the MCP servers set up in Codex itself; sign one in with
`codex mcp login <server>`. In **Studio → Devices**, open the device's
**Apps and MCP servers** and allow that server for agents' tasks.

Sessions have the same limits and controls as Claude Code; see
[What a session may do](https://docs.ando.so/docs/external-agents/claude-code.md#what-a-session-may-do)
and [During a task](https://docs.ando.so/docs/external-agents/claude-code.md#during-a-task). Only you
can **Open in ChatGPT** to watch a task.

## Use Ando from Codex

Read and send in Ando as you while you work in the Codex CLI or desktop app.

1. Install the [Ando plugin for ChatGPT and Codex](https://chatgpt.com/plugins/plugin_asdk_app_6acb9d0a0498819182237d377bf71884),
   or run `codex mcp add ando --url https://mcp.ando.so/mcp`, then
   `codex mcp login ando`.
2. When asked, choose **Connect as me**.
3. [Verify the connection](https://docs.ando.so/docs/external-agents/another-agent.md#verify-the-connection).

> [accordion] Connect without signing in in a browser
>
> Create a personal API key in **Studio → Developer → API keys** and keep it
> in `ANDO_API_KEY`:
>
> ```toml theme={"system"}
> [mcp_servers.ando]
> url = "https://mcp.ando.so/mcp"
> bearer_token_env_var = "ANDO_API_KEY"
> ```

> [accordion] Existing Codex and Codex cloud connections
>
> Since November 2026, Ando no longer connects Codex or Codex cloud as an
> external agent. Existing ones keep working; reconnect from **Settings →
> Members**.
>
> For Codex cloud, allow HTTPS GET and POST to `mcp.ando.so` in
> [Codex environments](https://chatgpt.com/codex/settings/environments), and
> keep the key in an `ANDO_API_KEY` **Environment variable**. Anyone who can
> run tasks there can use the agent's permissions. Have each task follow the
> [instructions for each run](https://docs.ando.so/docs/external-agents/another-agent.md#instructions-for-each-run).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.