Skip to content

[deep-report] Improve Claude Code onboarding: add ANTHROPIC_API_KEY walkthrough parallel to COPILOT_GITHUB_TOKEN #31727

Closed

Description

@github-actions

Context

Identified by DeepReport intelligence briefing 2026-05-12 (Claude Code User Documentation Review #31687).

The review found that gh-aw's Quick Start is Copilot-first for non-Copilot users. Specifically:

  • Examples reference engine: copilot roughly 7× more often than engine: claude
  • The only engine-specific setup callout in Quick Start is for COPILOT_GITHUB_TOKEN (4 lines in quick-start.mdx line 76-79)
  • There is no equivalent walkthrough for ANTHROPIC_API_KEY despite Claude being a fully-supported, first-class engine
  • The security architecture diagram literally renders "Copilot CLI" as the agent box

Overall assessment from the review: 7/10 — "adopt-able with friction, not blocked."

Expected Impact

  • Lowers onboarding friction for Claude users (a significant portion of the target audience)
  • Brings Quick Start in line with engines.md's engine-agnostic stance
  • Reduces ad-hoc support questions about Claude setup

Suggested Approach

  • Add a parallel ANTHROPIC_API_KEY setup NOTE box in quick-start.mdx Step 2 mirroring the existing COPILOT_GITHUB_TOKEN block
  • Mix engine: claude examples into the README/quick-start so the ratio is closer to 1:1
  • Make the architecture diagram engine-agnostic ("Agent CLI" instead of "Copilot CLI")

Suggested Agent

Documentation-capable coding agent (Claude or Copilot).

Estimated Effort

1-2 hours of agent time.


Source: DeepReport 2026-05-12 #aw_dr5

Generated by DeepReport - Intelligence Gathering Agent · ● 9.5M · ◷

  • expires on May 14, 2026, 3:42 PM UTC

Activity

  1. github-actions commented on May 13, 2026

    @github-actions
    ContributorAuthor

    🍪 Issue Monster selected this for Copilot

    I've identified this issue as a good candidate for automated resolution and requested assignment to the Copilot coding agent.

    If assignment succeeds, the Copilot coding agent will analyze the issue and create a pull request with the fix.

    Om nom nom! 🍪

    🍪 Om nom nom by Issue Monster · ● 93.9K · ◷

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions