Skip to main content
The features in this guide are only available in the Subframe desktop app. Download the desktop app for macOS or Windows ↗.
Agent chat 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.

​
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.

​
Connecting your Claude Code or Codex subscription

Connecting a subscription lets you use its models inside Subframe. This requires the desktop app.
  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

​
Using your local Claude Code and Codex settings

By default, a connected subscription loads your own MCP servers, skills, plugins, hooks, CLAUDE.md or AGENTS.md, and shell environment, so the agent works with the same setup you use in the terminal. Subframe’s own tools stay available. To use only Subframe’s setup, click the model name, select Manage agents, and turn off Use local Claude Code and Codex settings. The switch appears once you connect Claude Code or Codex. Chats that use Subframe AI credits never load your local settings.

​
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 use a coding agent in Cursor or another tool outside Subframe, connect through the Subframe MCP server.
Last modified on October 23, 2026