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

# Connect Claude Code or Codex

> Sign in to Claude Code or Codex in the Wonder desktop app, use an API key or a cloud provider, add more accounts, and let Wonder install and update the agents.

Wonder Chat runs on your own Claude Code or Codex account. Sign in once and every chat can use it, with your plan's models and limits.

**Before you start** · Desktop app · Free plan

## Where you connect an agent

Open **Settings** > **Agents**. Under **Provider accounts** there's a row for each built-in agent:

* **Claude Code**: sign in with your claude.ai account.
* **Codex**: sign in with your ChatGPT account.

![Settings, Agents, Provider accounts with View usage, and the Claude Code row with 1 account connected, Add account, a Default account on Claude Ultra, and Sign out](https://mintcdn.com/wonder-0722b0f6/Ig4tBDjfjeU3SKs6/images/connect-claude-code-or-codex/provider-accounts.light.webp?fit=max\&auto=format\&n=Ig4tBDjfjeU3SKs6\&q=85\&s=c8c15795dfbe3aab168b4b8e0e84ea1b)

![Settings, Agents, Provider accounts with View usage, and the Claude Code row with 1 account connected, Add account, a Default account on Claude Ultra, and Sign out](https://mintcdn.com/wonder-0722b0f6/Ig4tBDjfjeU3SKs6/images/connect-claude-code-or-codex/provider-accounts.dark.webp?fit=max\&auto=format\&n=Ig4tBDjfjeU3SKs6\&q=85\&s=828bceb2a8895af33961b737a5cb858a)

Each row says how many accounts are connected, such as **1 account connected**, and lists them with the plan each is on, such as **Claude Max** or **ChatGPT Plus**. Click **View usage**, next to **Provider accounts**, to see how much of each plan's limits you've used. See [Your agents' own plans](https://wonder.design/docs/plans-and-limits.md#your-agents’-own-plans).

When you first open the desktop app, the **Bring your own agent** step offers the same sign-in. Choose **Continue without an agent** to skip it and connect later in **Settings** > **Agents**.

## Sign in

1. In **Settings** > **Agents**, click **Connect Claude** or **Connect Codex**.
2. Your browser opens on claude.ai or ChatGPT. Sign in with the account you want to use. If your browser is signed in to another account, switch or sign out there first.
3. Come back to Wonder. The row shows **1 account connected** and the account with its plan.

While Wonder waits, the button reads **Continue in your browser…**. Click **Cancel** to stop. A sign-in you don't finish within five minutes stops on its own: **Sign-in did not finish. Try again and continue in your browser.**

You can also sign in from a chat. When no agent is connected, the model picker under the message box shows **Not connected**. Open it and click **Connect**.

The account you sign in with is this computer's Claude Code or Codex login, so your terminal and other apps that use it share it. Signing out of it in Wonder signs them out too.

## Other ways to sign in

Instead of a plan sign-in, Claude Code can use an Anthropic API key, AWS Bedrock or Google Vertex AI, and Codex an OpenAI API key or the model provider in your Codex configuration. Wonder doesn't ask for keys itself: it uses the ones this computer's agent is set up with.

| Agent | Set up with | The account shows |
| - | - | - |
| Claude Code | `ANTHROPIC_API_KEY` | **Anthropic API key** |
| Claude Code | `CLAUDE_CODE_USE_BEDROCK` | **AWS Bedrock** |
| Claude Code | `CLAUDE_CODE_USE_VERTEX` | **Google Vertex AI** |
| Codex | `OPENAI_API_KEY` | **OpenAI API key** |
| Codex | Amazon Bedrock as the model provider in your Codex configuration | **AWS Bedrock**, **Set in your Codex configuration** |

Wonder reads these variables from the environment it was started with, not from your shell profile. When both Bedrock and Vertex AI are set, Claude Code uses Bedrock, and either one comes before an API key.

If you have both a key and a saved sign-in, chats keep using the sign-in until you pick the key. Pick which one chats use from the account's menu: **Use ANTHROPIC\_API\_KEY instead** (or **Use OPENAI\_API\_KEY instead**), or **Use your saved Claude Code sign-in instead** (or **Codex**).

## Add another account Pro

To use more than one Claude or ChatGPT account, for example a personal and a work account:

1. In **Settings** > **Agents**, click **Add account** under Claude Code or Codex.
2. Sign in to the other account in your browser.

To make an account the one new chats start on, open its menu and choose **Set as default**. It shows **Default**. To move a chat to another account, pick a model under that account in the chat's model picker. See [Choose which account a chat uses](https://wonder.design/docs/choose-models-and-reviewers.md#choose-which-account-a-chat-uses).

On the Free plan, Wonder keeps one account per agent signed in. To connect more, you need an owner, admin or editor seat in a Pro workspace. Until then, once an agent has one account, **Add account** is hidden and **Provider accounts** shows **Connect more agent accounts**, with **View Pro**. If you go back to Free, Wonder signs out the accounts you added, never this computer's own login. Accounts on an API key or a cloud provider don't count toward the limit. See [Plans and limits](https://wonder.design/docs/plans-and-limits.md#pro).

## Sign out or remove an account

From an account's row:

* **Sign out** signs a claude.ai or ChatGPT account out. For this computer's login, that also signs you out of the agent in your terminal and other apps that use it. Accounts on an API key or a cloud provider have no **Sign out**.
* **Remove** takes the account off the list. For this computer's login, it shows once another account is the default:
  * On a claude.ai or ChatGPT sign-in, removing it also signs you out of the agent in your terminal and other apps that use it.
  * On an API key or a cloud provider, Wonder stops listing it and your terminal stays signed in.

To list this computer's login again, choose **Show this computer’s login** from an account's menu.

## Wonder installs and updates the agents

You don't need Claude Code or Codex installed. Wonder sets up its own copy of each agent and checks it before it runs. While it does, the row shows **Installing…**, with how far along it is once the download starts, or after a Wonder update, **Updating…**. The connection menu (**…**) shows the agent's version followed by **Ready**.

Your sign-in is shared with the agents you've installed yourself, but chats always run on Wonder's copy, so a newer or older version in your terminal doesn't change them. To get a newer agent, update Wonder. See [Update the desktop app](https://wonder.design/docs/desktop-app-and-browser.md#update-the-desktop-app).

Wonder's built-in agents are Claude Code and Codex. To work from another agent, connect it over [Wonder MCP](https://wonder.design/docs/wonder-mcp.md).

## Tools and agent settings

The rest of **Settings** > **Agents** sets how your agents work:

* **Tools** lists the MCP servers from your agents' own settings on this computer. See [Tools and MCP servers](https://wonder.design/docs/tools-and-mcp-servers.md).
* **Access**, **Chat** and **Response preferences** hold the shared settings and the extras for one agent, such as **Claude connectors** or **Codex personality**. See [Agent and chat preferences](https://wonder.design/docs/agent-and-chat-preferences.md).
* The mode new chats start in and what's allowed without asking are in [Permission modes and approvals](https://wonder.design/docs/permission-modes-and-approvals.md).

## If something goes wrong

* **The row says Not installed on this computer, or shows why an install failed.** Click **Install** or **Retry install**. See [Claude Code isn't installed on this computer](https://wonder.design/docs/fix-a-stopped-chat.md#claude-code-isn’t-installed-on-this-computer).
* **"Sign-in did not finish."** Start the sign-in again from the row and finish it in your browser within five minutes.
* **An account shows Account changed.** Its login changed outside Wonder, for example in your terminal, and the row says **Now signed in as** the new account and which one it was. Click **Sign in as** the old account to switch back, or **Keep** the new one.
* **Your browser signed in as an account that's already added.** Switch accounts on claude.ai or ChatGPT, then try again.
* **Claude Code can't sign in from Wonder.** Open a terminal, run `claude`, type `/login` and follow the sign-in. Then choose **Check again** from the connection menu.
* **A chat says Claude Code isn't signed in, or Codex isn't signed in.** Click **Sign in to Claude** or **Sign in to Codex** in the chat, or sign in again in **Settings** > **Agents**. See [Fix a stopped chat](https://wonder.design/docs/fix-a-stopped-chat.md#claude-code-isn’t-signed-in).

## Related

* [Wonder Chat](https://wonder.design/docs/wonder-chat.md)
* [Choose models and reviewers](https://wonder.design/docs/choose-models-and-reviewers.md)
* [Plans and limits](https://wonder.design/docs/plans-and-limits.md)
* [Fix a stopped chat](https://wonder.design/docs/fix-a-stopped-chat.md)


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