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

# aether codex

> Connect Codex provider auth with a subscription or API key

Manage authentication for the Codex agent provider. Connect a ChatGPT subscription with a device-login flow, or set an API key instead. Once connected, the Codex agent uses your account when it runs in workspaces. See [connect agent providers](/guides/connect-agent-providers).

## Usage

```bash theme={null}
aether codex <subcommand> [flags]
```

## Subcommands

| Subcommand                | Description                                    |
| ------------------------- | ---------------------------------------------- |
| `connect` (alias `login`) | Connect a Codex subscription with device login |
| `api-key`                 | Set Codex API-key auth instead                 |
| `status`                  | Show Codex auth status                         |
| `logout`                  | Remove Codex auth                              |

## aether codex connect

Start the device-authorization flow. The command prints a verification URL and a user code, opens the URL in your browser, and polls until you authorize (up to 10 minutes). If a subscription is already connected, it exits. If an API key is currently stored, connecting replaces it with subscription auth.

```bash theme={null}
aether codex connect
```

```
Open this URL and enter the code:
  https://...
  Code: ABCD-1234
Waiting for Codex authorization...

Codex subscription auth connected.
  Email: you@example.com
  Plan:  plus
```

## aether codex api-key

Set API-key auth instead of a subscription. Omit `--api-key` to enter the key at a secure prompt.

```bash theme={null}
aether codex api-key
```

| Flag        | Description                                        |
| ----------- | -------------------------------------------------- |
| `--api-key` | Codex API key. Omit to enter it at a secure prompt |

## aether codex status

Show the current Codex auth: type (`subscription` or `apiKey`), email, and plan when available.

```bash theme={null}
aether codex status
```

```
Codex: configured (subscription)
  Email: you@example.com
  Plan:  plus
```

When nothing is configured, the command prints `Codex: not configured` and points you to `connect` or `api-key`.

## aether codex logout

Remove the stored Codex auth.

```bash theme={null}
aether codex logout [flags]
```

| Flag      | Description                  |
| --------- | ---------------------------- |
| `--force` | Skip the confirmation prompt |

## See also

* [Connect agent providers](/guides/connect-agent-providers)
* [Agents and models](/concepts/agents-and-models)