[deep-report] Cross-reference CLAUDE_CODE_OAUTH_TOKEN gotcha into quick-start.mdx Claude setup section

Inizia da docs/src/content/docs/setup/quick-start.mdx, nella sezione relativa alla configurazione di Claude, e controlla l’avviso esistente in docs/src/content/docs/setup/cli.md:240. Aggiungi un riferimento incrociato di una riga dopo i passaggi relativi a ANTHROPIC_API_KEY e prima del link Using Claude Code, spiegando dove trovare l’avvertenza importante relativa a CLAUDE_CODE_OAUTH_TOKEN. Il lavoro è completato quando la sezione di avvio rapido rimanda all’avviso esistente senza duplicarne il contenuto.

Description: docs/src/content/docs/setup/cli.md:240 already documents that CLAUDE_CODE_OAUTH_TOKEN (the token from claude login, likely already held by subscription-based Claude Code users) is silently ignored, and the run instead fails with a generic Claude CLI authentication error that never names the token. However, this warning is not cross-referenced from docs/src/content/docs/setup/quick-start.mdx (Claude setup section, lines ~145-153) or docs/src/content/docs/introduction/how-they-work.mdx (engine auth table, ~line 33) — the two places a new Claude Code user actually looks first when setting up authentication. Confirmed via direct read: the quick-start.mdx Claude section only documents ANTHROPIC_API_KEY setup and Anthropic WIF, with no mention of the OAuth-token pitfall.

Suggested fix: Add a one-line cross-reference/callout in quick-start.mdx's Claude setup section (after the ANTHROPIC_API_KEY steps, before "Follow [Using Claude Code...]") pointing to the cli.md:240 gotcha, so a subscription-only Claude Code user sees it before attempting setup rather than after a cryptic failure.

Expected Impact: Prevents a known, already-documented authentication trap from surfacing as a confusing CLI error for new Claude Code users — the fix is purely relocating/cross-referencing existing accurate documentation, not new research.

Suggested Agent: Documentation update, low-risk.

Estimated Effort: Quick (< 30 min)

Data Source: DeepReport Intelligence Briefing analysis (2026-09-24), sourced from Claude Code User Documentation Review #63180.

[!WARNING]

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

• api.anthropic.com

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "api.anthropic.com"

See Network Configuration for more information.

Generated by 🔬 Deep Report · claude · agent · 205 AIC · ⌖ 9.57 AIC · ⊞ 13K · ◷

• expires on Sep 26, 2026, 10:40 AM UTC-08:00