> ## 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 Claude

> Use your Claude subscription or Anthropic API key as Voyager's agent: install Claude Code and sign in from the Connect providers step.

When you finish, Voyager's agent runs on your own Claude account, through Claude Code. This is part of step 2 of 5, **Connect providers**.

<Note>
  **Before you start**

  * **A Claude plan that includes Claude Code**, such as Pro or Max (see [Claude's plans](https://claude.com/pricing)), **or an Anthropic API key**. Claude Code can sign in with either.
  * **Cost:** nothing extra from Voyager. With a subscription, usage counts against your Claude plan's own limits. With an API key, Anthropic bills you per use.
  * You don't need to install anything yourself. If Claude Code isn't on your computer, Voyager opens a terminal with the official installer ready to run. It doesn't need Node or any other developer tools.
  * Prefer ChatGPT? See [Connect ChatGPT](/setup/connect-chatgpt). You can connect both.
</Note>

## What the Claude row shows

On **Connect providers**, the **Agent** section lists **Claude** first, described as **Your Claude subscription, through Claude Code**. The right side of the row tells you what to do:

| You see | It means | Do this |
| - | - | - |
| A green check (**Detected**) | Claude Code is installed and signed in. | Nothing. Skip to [Check it worked](#check-it-worked). |
| **Install** | Claude Code isn't on this computer yet. | Follow all the steps below. |
| **Sign in** | Claude Code is installed but not signed in. | Start at step 3 below. |
| A spinner | Voyager is still checking. | Wait a moment, or click **Refresh** above the list. |
| **Turned off in Settings** | Claude is switched off in Voyager. | Turn it back on in **Settings → Accounts**, then click **Refresh**. |

<Frame caption="Connect providers with Claude already detected: its row shows a green Detected badge.">
  <img className="block dark:hidden" src="https://mintcdn.com/voyager/dzNfJ3ErXafJEG4z/images/screenshots/setup-wizard-providers.light.png?fit=max&auto=format&n=dzNfJ3ErXafJEG4z&q=85&s=70e6d7e43a86b842745457712d208085" alt="The Connect providers step. Under Agent: Claude (Your Claude subscription, through Claude Code) marked Detected, ChatGPT with a Sign in button, and Voyager (Open models like DeepSeek V4.1 Flash and GLM, from your plan credits) with a green check. Under Media: Voyager (Creator plan) with a check, Higgsfield with Sign in, and FAL, Google and ElevenLabs with Add key." width="2880" height="1800" data-path="images/screenshots/setup-wizard-providers.light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/voyager/dzNfJ3ErXafJEG4z/images/screenshots/setup-wizard-providers.dark.png?fit=max&auto=format&n=dzNfJ3ErXafJEG4z&q=85&s=9ae746e7efe04b19b78c252d9774704e" alt="The Connect providers step. Under Agent: Claude (Your Claude subscription, through Claude Code) marked Detected, ChatGPT with a Sign in button, and Voyager (Open models like DeepSeek V4.1 Flash and GLM, from your plan credits) with a green check. Under Media: Voyager (Creator plan) with a check, Higgsfield with Sign in, and FAL, Google and ElevenLabs with Add key." width="2880" height="1800" data-path="images/screenshots/setup-wizard-providers.dark.png" />
</Frame>

## Install Claude Code and sign in

<Steps>
  <Step title="Click Install">
    On the **Claude** row, click **Install**. A terminal opens under the agent list with the official Claude Code installer already typed in. Nothing runs until you press Enter.

    <Frame caption="The setup terminal, with the installer typed in and waiting for you to press Enter.">
      <img className="block dark:hidden" src="https://mintcdn.com/voyager/dzNfJ3ErXafJEG4z/images/screenshots/setup-wizard-providers-terminal.light.png?fit=max&auto=format&n=dzNfJ3ErXafJEG4z&q=85&s=8f89af8c829a688d762e64509449e4a2" alt="The Connect providers step with Claude showing an Install button and a terminal open under the agent list. Its status line reads Run the command below with Enter. Voyager checks setup automatically., with a Close link, and the Claude Code install command is typed at the prompt." width="2880" height="1800" data-path="images/screenshots/setup-wizard-providers-terminal.light.png" />

      <img className="hidden dark:block" src="https://mintcdn.com/voyager/dzNfJ3ErXafJEG4z/images/screenshots/setup-wizard-providers-terminal.dark.png?fit=max&auto=format&n=dzNfJ3ErXafJEG4z&q=85&s=17dcf6fdadb8c05cbfdffddb49cfc149" alt="The Connect providers step with Claude showing an Install button and a terminal open under the agent list. Its status line reads Run the command below with Enter. Voyager checks setup automatically., with a Close link, and the Claude Code install command is typed at the prompt." width="2880" height="1800" data-path="images/screenshots/setup-wizard-providers-terminal.dark.png" />
    </Frame>
  </Step>

  <Step title="Press Enter to install">
    Click in the terminal and press Enter. The installer downloads Claude Code. When it's done, the status line changes to **Installed. Continue to sign in to your account.**

    The command is Anthropic's own installer:

    <CodeGroup>
      ```bash macOS and Linux theme={"system"}
      curl -fsSL https://claude.ai/install.sh | bash
      ```

      ```powershell Windows theme={"system"}
      irm https://claude.ai/install.ps1 | iex
      ```
    </CodeGroup>
  </Step>

  <Step title="Click Continue to sign in">
    Click **Continue to sign in**. The terminal now has the sign-in command typed in: `claude auth login`. (If the row showed **Sign in** to begin with, clicking it opens this same terminal.)
  </Step>

  <Step title="Press Enter and sign in to Claude">
    Press Enter. Claude Code opens your browser so you can sign in with your Claude subscription or your Anthropic Console account (for API billing). Follow the prompts there, then come back to Voyager.

    Voyager checks every few seconds. When it sees you're signed in, the status line reads **Connected. Your subscription is ready to use.**
  </Step>

  <Step title="Click Use subscription">
    Click **Use subscription** to close the terminal. The Claude row now shows a green check.
  </Step>

  <Step title="Click Continue">
    Click **Continue** at the bottom right. Voyager saves your setup and moves on to **Creative apps**.
  </Step>
</Steps>

<Tip>
  Closing the terminal stops anything still running in it. If you close it mid-install, click **Install** again to start over.
</Tip>

## Which model Voyager uses

Setup doesn't ask you to pick a model. If Claude is connected, Voyager starts new chats on **Claude Opus 5.5**, even if you also connect ChatGPT or have a Voyager plan.

To use something else, pick a different model in the chat box, or change the default in **Settings → General**, under **Conversations → Model**.

## Check it worked

* The **Claude** row on **Connect providers** shows a green check, and **Continue** is available.
* After setup, **Settings → Accounts** lists Claude as signed in.
* Your first chat opens on a Claude model.

## If something went wrong

<AccordionGroup>
  <Accordion title="The terminal says “Could not open the setup terminal.”">
    Click **Retry** in the terminal's header. If it still fails, install Claude Code in your own terminal with the command above, run `claude auth login`, then click **Refresh** above the agent list.
  </Accordion>

  <Accordion title="Sign-in finished, but the row still says Sign in">
    Click **Refresh** above the agent list. Voyager re-checks Claude Code. If the row still doesn't change, run `claude auth login` again and make sure you signed in with the Claude account that has your plan.
  </Accordion>

  <Accordion title="The row shows a warning instead of a check">
    Claude Code is installed but something needs attention, for example an expired sign-in. The warning text says what. Usually clicking **Sign in** and signing in again fixes it.
  </Accordion>

  <Accordion title="Continue stays off: “Connect at least one agent to continue.”">
    No agent is ready yet. Finish signing in to Claude, [connect ChatGPT](/setup/connect-chatgpt), or use a Voyager plan ([Voyager models and media](/setup/voyager-models)).
  </Accordion>
</AccordionGroup>

Not adding ChatGPT? Skip ahead to [Voyager models and media](/setup/voyager-models).

<Card title="Next: Connect ChatGPT (optional)" icon="arrow-right" href="/setup/connect-chatgpt">
  Add your ChatGPT account too.
</Card>


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