Start for free

Claude subscription

Connect your Claude Pro or Max subscription to use supported Anthropic models in Alloy without consuming Alloy credits for those iterations.

This integration requires an Alloy Pro subscription. Your connection is personal to your Alloy account and works in both prototype and dev sessions. The connection uses a Claude setup token generated by Claude Code — Anthropic API keys are not accepted.

Before you connect

You need:

  • An active Alloy Pro subscription.
  • An active Claude Pro or Max subscription.
  • Claude Code installed on your computer.
  • Claude Code signed in to the Claude account whose subscription you want to use.

Usage routed through Alloy counts against your Claude subscription's usage limits. For current plan behavior, see Use the Claude Agent SDK with your Claude plan.

How to connect Claude

1. Sign in to Claude Code

Open a terminal and run:

claude

If Claude Code asks you to authenticate, sign in with the Claude account that has your Pro or Max subscription. If you need to change accounts, run /login inside Claude Code and select the correct subscription account.

2. Generate a setup token

Exit the interactive Claude Code session, then run:

claude setup-token

Complete the authorization flow if prompted. Claude Code prints a token beginning with sk-ant-oat. Copy the complete token.

Treat the setup token like a password. Do not paste it into chat messages, source code, shared documents, or project environment variables.

3. Open the Claude integration in Alloy

Open Claude subscription settings, or open your Alloy settings and select Claude under Integrations.

Alloy Claude subscription settings before a subscription is connected

Paste the setup token into Token, then click Connect. Alloy encrypts the token when it is saved and does not display it again.

4. Confirm the connection

The Claude subscription settings show Connected and Ready for Claude sessions when the token has been saved.

Alloy Claude subscription settings showing a connected subscription

You can disconnect the subscription at any time from the same settings page.

How to use your Claude subscription

Once connected, choose a supported Anthropic model in Alloy as usual. Alloy routes the iteration through the Claude Agent SDK using your connected Claude subscription.

Supported subscription models include:

  • Fable 5
  • Opus 5
  • Sonnet 5

The available models can change as Anthropic releases or retires models. Keep in mind:

  • Usage is subject to the limits of your Claude plan.
  • Iterations routed through your Claude subscription do not consume Alloy credits.
  • If you reach your Claude usage limit, Alloy does not automatically spend Alloy credits or switch providers.
  • The subscription connection belongs to you and is not shared with your workspace.
  • Models the integration does not support continue to use their existing usage path.

Security and access

Your Claude connection is associated with your individual Alloy account. Other members of your workspace cannot use, view, or manage it.

How to disconnect Claude

  1. Open Claude subscription settings.
  2. Click Disconnect next to the connected account.
  3. Confirm that the token form appears again.

Disconnecting prevents new Alloy sessions from using your Claude subscription. You can reconnect at any time with a new token from claude setup-token.

Troubleshooting

The claude command is not available

Install Claude Code using Anthropic's Claude Code setup guide, then open a new terminal and run claude --version to confirm the command is available.

The setup token is rejected

Run claude setup-token again and copy the complete token without surrounding spaces. Setup tokens begin with sk-ant-oat; Anthropic API keys are not accepted by this integration.

If the token came from the wrong account, run /login inside Claude Code, sign in to the account with the intended subscription, then generate a new setup token.

Alloy shows an upgrade message

The Claude subscription integration requires an active Alloy Pro workspace. Open Settings > Billing to confirm the workspace subscription is active.

Claude reached its usage limit

Wait for your Claude allowance to reset. Alloy does not switch the iteration to Alloy credits automatically when a connected Claude subscription reaches its limit.

The connection expired or was revoked

Open the Claude integration in Alloy, disconnect the existing connection, and connect again using a newly generated setup token.