[deep-report] Quick-start docs: note CLAUDE_CODE_OAUTH_TOKEN unsupported + surface `gh aw init --engine claude`

[github-actions]

Description

The Quick Start guide (docs/src/content/docs/setup/quick-start.mdx) is Copilot-first and never surfaces two facts a Claude Code user needs:

1. CLAUDE_CODE_OAUTH_TOKEN is silently unsupported — only ANTHROPIC_API_KEY works (the caveat currently lives in reference/auth.mdx:~199, not on the quick-start path). A Claude Code user typically has an OAuth token (Claude Max/Teams), which is rejected with no inline guidance.
2. gh aw init / add-wizard default to Copilot artifacts — --engine claude exists (setup/cli.md:139, "Skip Copilot-specific artifacts") but is never shown in quick-start, so a Claude user generates Copilot scaffolding by default.

Fix: add a short NOTE in quick-start.mdx ("Claude Max/Teams OAuth tokens are not supported — create an ANTHROPIC_API_KEY in the Anthropic Console") and show gh aw init --engine claude in the quick-start steps; state the silent Copilot default explicitly.

Expected Impact

Removes the top persona-relevant onboarding friction for Claude Code users (0 critical blockers, but this is the #1 recurring gap). Pure docs edit, no code.

Suggested Agent

Claude Code User Documentation Review agent (or a docs-edit workflow).

Estimated Effort

Fast (< 30 min)

Data Source

DeepReport 2026-06-16 · Claude Code User Documentation Review #39557 (Major #1–#3). Verified: CLAUDE_CODE_OAUTH_TOKEN not present in quick-start.mdx.

Generated by 🔬 DeepReport - Intelligence Gathering Agent · 321.6 AIC · ⌖ 18.6 AIC · ⊞ 10K · ◷

• expires on Jun 18, 2026, 8:25 AM UTC-08:00

[github-actions]

This issue was automatically closed because it expired on 2026-06-18T16:25:43.939Z.

Closed by Workflow

[github-actions]

This issue was automatically closed because it expired on 2026-06-18T16:25:43.939Z.

Closed by Workflow