> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pullfrog.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Claude subscription
> Run Anthropic models on your Claude Pro or Max plan instead of paying for API tokens.
Run Pullfrog on the Claude Pro or Max plan you already pay for, with no Anthropic API bill on top. One command stores the token, and every run on an Anthropic model uses it.
A Claude subscription covers the Anthropic models: Claude Fable, Claude Opus, Claude Sonnet and Claude Haiku. For other providers, see [Model access](/model-access).
## Setup
Run this inside a clone of the repository. The CLI uses the [GitHub CLI](https://cli.github.com) to sign you in, so run `gh auth login` first if you have not.
```bash theme={null}
npx pullfrog auth claude
```
The CLI:
1. Opens a Claude sign-in in your browser. Sign in with the account on the Pro or Max plan and approve it.
2. Receives the token `claude setup-token` would print: inference-only, valid for a year, starting with `sk-ant-oat`. Claude Code does not need to be installed.
3. Saves it to Pullfrog's encrypted store. Pullfrog refuses a token that Anthropic rejects.
The CLI shows which account signed in. A browser signs in as the account it already holds, so to connect a different one, sign out of Claude in that browser or open the sign-in link in a private window.
### Remote machines
The sign-in finishes on `localhost`, so the browser must be on the machine that runs the CLI. Over SSH, or on Linux with no display, the CLI asks for a token instead: run `claude setup-token` from [Claude Code](https://code.claude.com/docs) on any machine with a browser, and paste the token it prints. Pass `--paste-token` to choose this yourself:
```bash theme={null}
npx pullfrog auth claude --paste-token
```
The next run on an Anthropic model uses the subscription. Run the command again to add another account or replace one. Each connection is labelled with the last six characters of its token. With several connections, or an `ANTHROPIC_API_KEY` beside them, Pullfrog moves to the next credential when one is rejected or out of quota; see [multiple subscriptions and fallback](/keys#multiple-subscriptions-and-fallback).
## Scope
On an organization repository, the CLI asks where to store the token:
| Option | Scope | Who can save it |
| - | - | - |
| **`` organization** | Every repository in the organization | Organization owner |
| **`/` only** | This repository | Repository admin |
A personal account has only the account scope, so the CLI does not ask. To skip the prompt or run outside a checkout, pass the scope as a flag:
```bash theme={null}
npx pullfrog auth claude --org my-org # organization scope
npx pullfrog auth claude --repo my-org/my-repo # one repository
```
## Credential refresh
The token is static and lasts a year. Pullfrog stores no refresh token, so nothing rotates between runs. Run `npx pullfrog auth claude` again when the token expires or you revoke it, and pick the old connection to replace.
## Troubleshooting
| Symptom | Fix |
| - | - |
| The CLI waits after you approve in a browser on another machine | The sign-in returns to `localhost` on the machine that ran it. Cancel, and run `npx pullfrog auth claude --paste-token`. |
| `claude: command not found` while using `--paste-token` | Install [Claude Code](https://code.claude.com/docs) on the machine with the browser, then run `claude setup-token` there. |
| Run comment: "Your Claude Pro/Max subscription was rejected by its provider" | The token expired or was revoked. Run `npx pullfrog auth claude` and replace the old connection. |
| Run comment: "Your Claude subscription has hit its usage limit" | The plan's usage window is spent. Re-trigger after the reset, or add an `ANTHROPIC_API_KEY` so runs continue on the API key until then. |
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.