From 04e3bfed35d85a35f962a0bc799dcf00012855e0 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Fri, 16 Jan 2026 02:19:54 +0000
Subject: [PATCH] docs: clarify Anthropic setup-token

---
 docs/providers/anthropic.md | 16 ++++++++++++++++
 docs/start/faq.md           | 11 +++++++++++
 2 files changed, 27 insertions(+)

diff --git a/docs/providers/anthropic.md b/docs/providers/anthropic.md
index 3d957f9a2..0c77144f5 100644
--- a/docs/providers/anthropic.md
+++ b/docs/providers/anthropic.md
@@ -38,6 +38,22 @@ clawdbot onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
 
 **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. Run this on the **gateway host**:
+
+```bash
+claude setup-token
+```
+
+Paste the token into Clawdbot (wizard: **Anthropic token (paste setup-token)**), or let Clawdbot run the command for you:
+
+```bash
+clawdbot onboard --auth-choice setup-token
+# or
+clawdbot models auth setup-token --provider anthropic
+```
+
 ### CLI setup
 
 ```bash
diff --git a/docs/start/faq.md b/docs/start/faq.md
index c92a2c236..02b56061f 100644
--- a/docs/start/faq.md
+++ b/docs/start/faq.md
@@ -16,6 +16,7 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
   - [What runtime do I need?](#what-runtime-do-i-need)
   - [What does the onboarding wizard actually do?](#what-does-the-onboarding-wizard-actually-do)
   - [How does Anthropic "setup-token" auth work?](#how-does-anthropic-setup-token-auth-work)
+  - [Where do I find an Anthropic setup-token?](#where-do-i-find-an-anthropic-setup-token)
   - [Do you support Claude subscription auth (Claude Code OAuth)?](#do-you-support-claude-subscription-auth-claude-code-oauth)
   - [Is AWS Bedrock supported?](#is-aws-bedrock-supported)
   - [How does Codex auth work?](#how-does-codex-auth-work)
@@ -245,6 +246,16 @@ Clawdbot keeps `auth.profiles["anthropic:claude-cli"].mode` set to `"oauth"` so
 the profile accepts both OAuth and setup-token credentials; older `"token"` mode
 entries auto-migrate.
 
+### Where do I find an Anthropic setup-token?
+
+It is **not** in the Anthropic Console. The setup-token is generated by the **Claude Code CLI** on the **gateway host**:
+
+```bash
+claude setup-token
+```
+
+Copy the token it prints, then choose **Anthropic token (paste setup-token)** in the wizard. If you want Clawdbot to run the command for you, use `clawdbot onboard --auth-choice setup-token` or `clawdbot models auth setup-token --provider anthropic`. See [Anthropic](/providers/anthropic).
+
 ### Do you support Claude subscription auth (Claude Code OAuth)?
 
 Yes. Clawdbot can **reuse Claude Code CLI credentials** (OAuth) and also supports **setup-token**. If you have a Claude subscription, we recommend **setup-token** on the gateway host for the most reliable long‑running setup (requires Claude Pro/Max + the `claude` CLI). OAuth reuse is supported, but avoid logging in separately via Clawdbot and Claude Code to prevent token conflicts. See [Anthropic](/providers/anthropic) and [OAuth](/concepts/oauth).