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

# Connecting an agent

> Use Subframe AI credits or connect your Claude Code or Codex subscription.

<Note>
  The features in this guide are only available in the Subframe desktop app. [Download the desktop app for macOS
  ↗](https://subframe.com/downloads).
</Note>

[Agent chat](/agent/overview) works with Subframe AI credits or an existing Claude Code or Codex subscription.

To let the agent work in a local project, [connect your codebase](/agent/connecting-your-codebase).

## Using Subframe AI credits

Subframe AI credits let you use models in Agent chat without connecting another subscription.

1. Open **Agent** chat
2. Click the model name at the bottom of the chat
3. Select a model under **Subframe Credits**

Messages use the [Subframe AI credits included with your seat](/admin/pricing-and-plans#subframe-ai-credits).

## Connecting your Claude Code or Codex subscription

Connecting a subscription lets you use its models inside Subframe. This requires the [desktop app](/desktop-app).

<Tabs>
  <Tab title="Claude Code">
    1. Open **Agent** chat, click the model name, then select **Manage agents**

    2. Click **Connect** under **Claude Code**

    3. Sign in with your Anthropic subscription
  </Tab>

  <Tab title="Codex">
    1. Open **Agent** chat, click the model name, then select **Manage agents**

    2. Click **Connect** under **Codex**

    3. Sign in with your ChatGPT subscription
  </Tab>
</Tabs>

## Choosing a model and effort

1. Click the model name at the bottom of Agent chat
2. Select a model from your subscription or **Subframe Credits**
3. Select an **Effort** level if the model supports it

## Disconnecting your subscription

1. Click the model name and select **Manage agents**
2. Click **Connected** under **Claude Code** or **Codex**
3. Select **Disconnect**

## Using an external agent

To work from Cursor, Replit, or another AI tool outside Subframe, [connect it through the Subframe MCP server](/agent/mcp-server).


## Related topics

- [Connecting your codebase](/agent/connecting-your-codebase.md)
- [Troubleshooting](/agent/troubleshooting.md)
- [Managing pricing and plans](/admin/pricing-and-plans.md)