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

# Connect your accounts and choose an agent

> Understand your Voyager account, connect an agent, and choose which account powers your chat.

Your Voyager account signs you into the app; your agent account supplies the AI that works with you in chat.

Chat uses your own Claude or ChatGPT (signed in with a subscription or an API key), Voyager models on a Voyager plan, or an Anthropic or OpenAI API key you add in Voyager.

For example, you can sign in to Voyager, use your Claude subscription for chat, and generate images with your own FAL key. Each connection has its own purpose and billing.

<Note>
  A paid Voyager plan is optional. A free Voyager account plus your own Claude or ChatGPT is enough to finish setup and chat. Your own media keys generate media without a plan.
</Note>

## Know which account does what

| Connection | What it does | Where usage is billed |
| - | - | - |
| Voyager account | Signs you into Voyager and selects your workspace | Free; signing in does not require a paid plan |
| Claude | Powers the agent through Claude Code, signed in with your Claude subscription or an Anthropic API key | Your Claude plan, or Anthropic per use |
| ChatGPT | Powers the agent through Codex, signed in with your ChatGPT subscription or an OpenAI API key | Your ChatGPT plan, or OpenAI per use |
| Voyager models | Powers the agent using models available on your Voyager plan | Your workspace's Voyager credits |
| Your own API key | Powers the agent with an Anthropic or OpenAI key added in **Use your own API keys** | The provider bills your account per use |
| Generation providers | Make images, video, voices, music, and sound effects | The provider or Voyager account used for that generation |

Your Claude or ChatGPT covers agent usage under that provider's terms. It does not supply Voyager credits or pay for media generation.

## Manage your connections

Open **Settings → Accounts**. The **Voyager** card shows your sign-in, workspace, and available billing information. **Generation providers** controls media generation. The agent accounts below it control chat.

<Frame caption="Use Accounts to check your Voyager connection and find your generation providers.">
  <img className="block dark:hidden" src="https://mintcdn.com/voyager/dzNfJ3ErXafJEG4z/images/screenshots/accounts-overview.light.png?fit=max&auto=format&n=dzNfJ3ErXafJEG4z&q=85&s=0affe5dc67ddf19d75991e0b7100fc56" alt="The Settings → Accounts page. The Voyager card shows Ready, the signed-in email and workspace, the plan line with available Voyager credits and an Open billing button, and a chat line with an Upgrade for more models button. Below it, the Generation providers list starts with Higgsfield, FAL, Google, ElevenLabs and Voyager credits, each with an on/off switch and up and down arrows." width="2880" height="1800" data-path="images/screenshots/accounts-overview.light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/voyager/dzNfJ3ErXafJEG4z/images/screenshots/accounts-overview.dark.png?fit=max&auto=format&n=dzNfJ3ErXafJEG4z&q=85&s=1d2a2926b0bd9c9438264a5508e3d08e" alt="The Settings → Accounts page. The Voyager card shows Ready, the signed-in email and workspace, the plan line with available Voyager credits and an Open billing button, and a chat line with an Upgrade for more models button. Below it, the Generation providers list starts with Higgsfield, FAL, Google, ElevenLabs and Voyager credits, each with an on/off switch and up and down arrows." width="2880" height="1800" data-path="images/screenshots/accounts-overview.dark.png" />
</Frame>

If your Voyager account belongs to several workspaces, choose the workspace you intend to use. Check the workspace name before buying credits or starting paid work.

For a new connection, follow [Connect Claude](/setup/connect-claude), [Connect ChatGPT](/setup/connect-chatgpt), or [Voyager models and media](/setup/voyager-models).

To add another ChatGPT account, or to use a Codex install you already have, click the **+** button (**Add provider**) at the top of the agent accounts. In the **Add provider instance** dialog, keep the **Codex** driver selected and choose **Continue with ChatGPT** or **Use my Codex CLI**. A ChatGPT account connected through Voyager has its own sign-in.

<Frame caption="The Add provider instance dialog with the Codex driver selected.">
  <img className="block dark:hidden" src="https://mintcdn.com/voyager/dzNfJ3ErXafJEG4z/images/screenshots/accounts-add-chatgpt.light.png?fit=max&auto=format&n=dzNfJ3ErXafJEG4z&q=85&s=ca659c836ee4138f1f83842f8448440d" alt="The Add provider instance dialog at its Driver step. Codex is selected; Claude and API models are the other drivers. At the bottom are Cancel, Use my Codex CLI and Continue with ChatGPT buttons." width="1248" height="884" data-path="images/screenshots/accounts-add-chatgpt.light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/voyager/dzNfJ3ErXafJEG4z/images/screenshots/accounts-add-chatgpt.dark.png?fit=max&auto=format&n=dzNfJ3ErXafJEG4z&q=85&s=c22aabc4c54d8d16144bb225bca41082" alt="The Add provider instance dialog at its Driver step. Codex is selected; Claude and API models are the other drivers. At the bottom are Cancel, Use my Codex CLI and Continue with ChatGPT buttons." width="1248" height="884" data-path="images/screenshots/accounts-add-chatgpt.dark.png" />
</Frame>

You can add separate personal and work accounts and select them in the model picker.

To chat with your own Anthropic or OpenAI API key, open **Settings → Accounts** and expand **Use your own API keys** in the **Voyager** card. Paste the key under **Anthropic · chat** or **OpenAI · chat**, then choose **Save key**. The key's models appear under **API models**; select that account and a model in the chat's model picker.

<Warning>
  Requests through your own API key are billed per use by that provider, separately from any Claude or ChatGPT subscription.
</Warning>

To connect your own media keys, follow [Generation providers](/account/generation-providers).

## Choose the agent for a chat

Open the model picker beside the chat composer. Choose the account, then the model you want to use.

<Frame caption="Choose the account as well as the model so you know which subscription or balance you are using.">
  <img className="block dark:hidden" src="https://mintcdn.com/voyager/dzNfJ3ErXafJEG4z/images/screenshots/accounts-model-picker.light.png?fit=max&auto=format&n=dzNfJ3ErXafJEG4z&q=85&s=6b7c6af6e82c41c0fb8f43e982f8a216" alt="The open model picker. A column of account icons runs down the left (favourites, ChatGPT, Claude and others); beside it, a Search models box and a list of models such as Claude Opus 5.5, Claude Sonnet 5.5 and GPT-6 Astra, each with its account, an estimated credits per turn and a shortcut. A Not seeing the models you expect? link sits at the bottom." width="818" height="854" data-path="images/screenshots/accounts-model-picker.light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/voyager/dzNfJ3ErXafJEG4z/images/screenshots/accounts-model-picker.dark.png?fit=max&auto=format&n=dzNfJ3ErXafJEG4z&q=85&s=178d20bd0317211168a28bbe7e8fe399" alt="The open model picker. A column of account icons runs down the left (favourites, ChatGPT, Claude and others); beside it, a Search models box and a list of models such as Claude Opus 5.5, Claude Sonnet 5.5 and GPT-6 Astra, each with its account, an estimated credits per turn and a shortcut. A Not seeing the models you expect? link sits at the bottom." width="818" height="854" data-path="images/screenshots/accounts-model-picker.dark.png" />
</Frame>

Setup chooses a ready Claude account first, then ChatGPT, then Voyager models. You can change the choice. Set the default for new chats in **Settings → General → Conversations → Model**; individual projects can override it.

When you switch to a different provider in an existing chat, the picker says **Continues in a new thread**. Voyager continues in a new chat.

## Understand the limits

Available models depend on the connected account, its plan, and its installed software. **Show advanced model choices** in **Settings → Accounts** reveals the full model list and reasoning effort controls. With it off, Voyager shows a smaller selection and uses medium effort.

A plan badge on a Voyager model means that model needs a different Voyager plan. Choosing it opens billing; it does not unlock the model automatically.

The sidebar's **Usage** page shows Claude and Codex usage. Check Voyager credits in **Settings → Accounts** or [billing](https://voyager.so/dashboard/billing). If a model is missing or an account stops working, see [Setup problems](/help/setup-problems).

<Card title="Choose how media generation is paid for" href="/account/generation-providers">
  Connect your own keys and set the order Voyager tries them.
</Card>


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