From e612aedbffeb9295180d5657480e9cd5ff830e19 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Fri, 9 Jan 2026 15:27:49 +0100
Subject: [PATCH] docs: prefer setup-token for Anthropic

---
 docs/start/getting-started.md | 4 +++-
 docs/start/wizard.md          | 1 +
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/docs/start/getting-started.md b/docs/start/getting-started.md
index 330a6af04..50388f91b 100644
--- a/docs/start/getting-started.md
+++ b/docs/start/getting-started.md
@@ -59,7 +59,7 @@ clawdbot onboard --install-daemon
 
 What you’ll choose:
 - **Local vs Remote** gateway
-- **Auth**: Anthropic OAuth or OpenAI OAuth (recommended), API key (optional), or skip for now
+- **Auth**: **Anthropic OAuth via Claude CLI setup-token (preferred)**, OpenAI OAuth (recommended), API key (optional), or skip for now
 - **Providers**: WhatsApp QR login, Telegram/Discord bot tokens, etc.
 - **Daemon**: background install (launchd/systemd; WSL2 uses systemd)
   - **Runtime**: Node (recommended; required for WhatsApp) or Bun (faster, but incompatible with WhatsApp)
@@ -68,6 +68,8 @@ Wizard doc: [Wizard](/start/wizard)
 
 ### Auth: where it lives (important)
 
+- **Preferred Anthropic path:** install Claude CLI on the gateway host and run `claude setup-token`. The wizard can reuse it, and `clawdbot models status` will sync it into Clawdbot auth profiles.
+
 - OAuth credentials (legacy import): `~/.clawdbot/credentials/oauth.json`
 - Auth profiles (OAuth + API keys): `~/.clawdbot/agents/<agentId>/agent/auth-profiles.json`
 
diff --git a/docs/start/wizard.md b/docs/start/wizard.md
index 652653564..eb6a4fb9a 100644
--- a/docs/start/wizard.md
+++ b/docs/start/wizard.md
@@ -70,6 +70,7 @@ Tip: `--json` does **not** imply non-interactive mode. Use `--non-interactive` (
      - Full reset (also removes workspace)
 
 2) **Model/Auth**
+   - **Preferred Anthropic setup:** install Claude CLI on the gateway host and run `claude setup-token` (the wizard can run it for you and reuse the token).
    - **Anthropic OAuth (Claude CLI)**: on macOS the wizard checks Keychain item "Claude Code-credentials" (choose "Always Allow" so launchd starts don't block); on Linux/Windows it reuses `~/.claude/.credentials.json` if present.
    - **Anthropic token (paste setup-token)**: run `claude setup-token` in your terminal, then paste the token (you can name it; blank = default).
    - **OpenAI Codex OAuth (Codex CLI)**: if `~/.codex/auth.json` exists, the wizard can reuse it.