Skip to content

[deep-report] Add ANTHROPIC_API_KEY setup block to Quick Start (close Claude-first onboarding gap) #31528

@github-actions

Description

@github-actions

Source

DeepReport intelligence briefing — 2026-05-11. References: Claude Code User Documentation Review (discussion #31504).

Problem

The Quick Start page lists Claude as an engine choice, but the secret-setup TIP block immediately following it is Copilot-only:

Setting up COPILOT_GITHUB_TOKEN?

  1. Create a fine-grained PAT under your user account.
  2. Under Permissions → Account permissions, set Copilot Requests to Read...

There is no parallel "Setting up ANTHROPIC_API_KEY?" note. A Claude Code user has to context-switch to auth.mdx to find equivalent instructions. The README never mentions Claude at all. The asymmetry signals Copilot is the "real" path and Claude is a footnote.

Suggested fix

  1. Add a sibling NOTE block to docs/src/content/docs/setup/quick-start.mdx:75-80 for ANTHROPIC_API_KEY mirroring the Copilot one (link to Anthropic Console, scope guidance, etc.).
  2. Add a one-line callout in README.md:32-34: "gh-aw supports GitHub Copilot (default), Claude, Codex, and Gemini engines."
  3. (Optional) Refactor the secret-setup block into a tabbed/per-engine list to scale to 4 engines without prose duplication.

Effort / Impact

  • Effort: < 2 hours (docs-only PR)
  • Impact: Medium — closes a measurable onboarding asymmetry; the doc review found Claude code examples skew ~6.6:1 toward Copilot.
  • Suggested agent: Documentation-writing agent (Claude)

Success criteria

  • A Claude Code user can complete Quick Start without leaving the page.
  • README mentions all four supported engines at least once.

Related: discussion #31504

Generated by DeepReport - Intelligence Gathering Agent · ● 12.8M ·

  • expires on May 13, 2026, 3:54 PM UTC

Metadata

Metadata

Assignees

No one assigned

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions