Skip to main content
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.

​
Usage

​
Subcommands

​
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.

​
aether codex api-key

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

​
aether codex status

Show the current Codex auth: type (subscription or apiKey), email, and plan when available.
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.

​
See also