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

# Connect your agent

> Set up Claude Code or Codex once so the HyperFrames Studio app can build and change your videos.

The app makes your videos with an agent that runs on your computer: **Claude Code** or **Codex**. You set one up
once. After that, every request you send goes to it.

| Agent | You need |
| - | - |
| Claude Code | A Claude account or an Anthropic Console account. The app installs it for you. |
| Codex | A ChatGPT account. You install it and sign in with two commands. |

Runs bill to the plan of the account your agent is signed in with. To use an API key instead, change **Bill runs
to** in **Settings** > **Permissions**.

If both are ready and you have not picked one, the app uses Claude Code.

## Claude Code

The first time you send a request without an agent, the **Connect Claude Code** screen opens with three steps.

<Steps>
  <Step title="Install Claude Code">
    Choose **Install Claude Code**, then **Install** in the dialog. The app runs Anthropic's official installer,
    which puts Claude Code in your home folder. It takes about a minute.
  </Step>

  <Step title="Sign in">
    Choose **Sign in to Claude**. Your browser opens Claude's sign-in. Use your Claude account or an Anthropic Console
    account, then come back to the app.
  </Step>

  <Step title="Check that it answers">
    The app checks that Claude Code runs. When it shows **Claude Code is connected**, it sends the request you
    started with.
  </Step>
</Steps>

If a step fails, the app shows a command you can run yourself. Choose **Copy command**, then **Open Terminal**, and
paste it:

```bash theme={null}
# Install Claude Code
curl -fsSL https://claude.ai/install.sh | bash

# Sign in
claude auth login
```

## Codex

The app does not install Codex for you. Open **Settings** > **Agent** or the agent picker in the chat header, find
Codex, and use its buttons:

1. **Copy install command**, then paste it into a terminal:
   ```bash theme={null}
   curl -fsSL https://chatgpt.com/codex/install.sh | sh
   ```
2. **Copy sign-in command** (`codex`), run it in a terminal, and sign in with your ChatGPT account.
3. Back in the app, choose **Check again**. Codex shows **Ready**.

## Switch agents

Use the agent picker in the chat header, or **Settings** > **Agent**, and choose **Use** next to the agent you want.
The choice applies to your next request.

Each agent row shows its state: **Ready**, **Not signed in**, **Not installed**, or **Installed, but won't start**,
with the button that fixes it.

## Related topics

* [Make your first video](/studio-app/first-video)
* [Updates and troubleshooting](/studio-app/troubleshooting)


## Related topics

- [Make your first video](/studio-app/first-video.md)
- [Updates and troubleshooting](/studio-app/troubleshooting.md)
- [Get the HyperFrames Studio app](/studio-app/index.md)


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