clawdbot/docs/providers/anthropic.md

summary, read_when

summary	read_when
Use Anthropic Claude via API keys or Claude Code CLI auth in Clawdbot	You want to use Anthropic models in Clawdbot You want setup-token or Claude Code CLI auth instead of API keys

Anthropic (Claude)

Anthropic builds the Claude model family and provides access via an API. In Clawdbot you can authenticate with an API key or reuse Claude Code CLI credentials (setup-token or OAuth).

Option A: Anthropic API key

Best for: standard API access and usage-based billing. Create your API key in the Anthropic Console.

CLI setup

clawdbot onboard
# choose: Anthropic API key

# or non-interactive
clawdbot onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

Config snippet

{
  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-5" } } }
}

Prompt caching (Anthropic API)

Clawdbot enables 1-hour prompt caching by default for Anthropic API keys. This is API-only; Claude Code CLI OAuth ignores TTL settings.

To override the TTL per model, set cacheControlTtl in the model params:

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-5": {
          params: { cacheControlTtl: "5m" } // or "1h"
        }
      }
    }
  }
}

Clawdbot includes the extended-cache-ttl-2025-04-11 beta flag for Anthropic API requests; keep it if you override provider headers (see /gateway/configuration).

Option B: Claude Code CLI (setup-token or OAuth)

Best for: using your Claude subscription or existing Claude Code CLI login.

Where to get a setup-token

Setup-tokens are created by the Claude Code CLI, not the Anthropic Console. You can run this on any machine:

claude setup-token

Paste the token into Clawdbot (wizard: Anthropic token (paste setup-token)), or let Clawdbot run the command locally:

clawdbot onboard --auth-choice setup-token
# or
clawdbot models auth setup-token --provider anthropic

If you generated the token on a different machine, paste it:

clawdbot models auth paste-token --provider anthropic

CLI setup

# Run setup-token locally (wizard can run it for you)
clawdbot onboard --auth-choice setup-token

# Reuse Claude Code CLI OAuth credentials if already logged in
clawdbot onboard --auth-choice claude-cli

Config snippet

{
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-5" } } }
}

Notes

• The wizard can run claude setup-token locally and store the token, or you can paste a token generated elsewhere.
• Clawdbot writes auth.profiles["anthropic:claude-cli"].mode as "oauth" so the profile accepts both OAuth and setup-token credentials. Older configs using "token" are auto-migrated on load.
• Auth details + reuse rules are in /concepts/oauth.