Skip to content

Connect your ChatGPT or Claude subscription

View as Markdown

Connect your ChatGPT subscription to Codex CoAgents, or your Claude subscription to Claude Code CoAgents. Create a connection in Admin, then choose which compatible CoAgents use it.

For complete instructions, follow Connect CoAgents to your ChatGPT or Claude subscription. The guide covers required permissions, sign-in, CoAgent assignment, verification and recovery.

Connect in Admin

You need an Account owner or admin role and a supported provider subscription. Each CoAgent's computer must be Sleeping or Paused when you assign the connection.

Each CoAgent must use the matching runtime: Codex for ChatGPT, Claude Code for Claude. If you need to create a CoAgent, an Account Owner can select either provider in Create a CoAgent in Admin. Run socra agent create --help or socra agent update --help for CLI options. When switching runtimes, first pause the CoAgent and unassign its previous connection.

An assigned CoAgent uses the connection on its next session. Existing identity, permissions, and home files remain separate from the provider sign-in.

Sign in on one Codex CoAgent's computer

A Codex CoAgent can use its own ChatGPT sign-in instead of a shared connection. This sign-in applies to that CoAgent. It still uses the ChatGPT account's usage allowance.

ChatGPT must allow device-code sign-in for the account you connect. Enable Enable device code sign-in for Codex, Excel, PowerPoint, and Word in the intended account’s ChatGPT Security Settings before starting. If you already started a code, select Cancel sign-in on the CoAgent’s page and start sign-in again after enabling the setting.

If the CoAgent already uses a shared connection, remove that assignment while the computer is sleeping or paused before starting this alternative. See Remove a CoAgent from a connection.

  1. Open the CoAgent in Admin. If it is Paused, select Resume work under Computer before starting local sign-in. Resuming permits queued work to run.
  2. Under AI, select Choose connection.
  3. Select Sign in on this computer instead. Admin starts the CoAgent's computer to prepare sign-in. Running time incurs Socra charges; see How CoAgent billing works.
  4. Select Copy code, then Go to ChatGPT.
  5. Select or sign in to the ChatGPT account with Codex access. When ChatGPT asks, enter the code from Admin.
  6. Return to Admin and confirm Connected.
  7. Follow Verify a task to check that the sign-in works.

Shared usage and credentials

CoAgents assigned to one connection share the provider account’s usage limits. Adding CoAgents does not increase that allowance. The provider controls the allowance and reset times; its terms apply.

For Claude, the subscription token is available to the assigned CoAgent process. Only assign CoAgents you trust with that credential. ChatGPT refresh credentials stay in the CoAgent service.

Reconnect or remove a connection

If sign-in expires or is revoked, the connection shows Reconnect required. For a ChatGPT connection, sign in again on the connection's page in Admin. The CoAgents can stay on the connection. For a Claude connection, first remove every CoAgent from the connection. Then sign in again, and choose the connection on each CoAgent again. Follow The connection shows Reconnect required. Remove all CoAgent assignments before disconnecting or deleting a connection. Never change a running CoAgent’s connection; wait for it to sleep or pause it first.

See Fix a problem if a connection doesn't connect, and Troubleshooting if a CoAgent can't start work.

See also