You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
A Claude Code user can adopt gh-aw: Claude is a first-class engine with a dedicated ANTHROPIC_API_KEY setup callout in the quick-start, 64 example workflows, and full tool parity (14/15 tools engine-agnostic). No critical blockers. The single most persona-relevant gap persists: CLAUDE_CODE_OAUTH_TOKEN is explicitly ignored/unsupported, and that caveat never appears in the quick-start — so Claude Max/Teams OAuth users hit a silent 401/403. New this run: Anthropic Workload Identity Federation (keyless OIDC auth) is now documented (auth.mdx:207-271, since v0.79.6) — a real improvement, but still not surfaced in quick-start. Overall score: 7.5/10 (stable, 7th consecutive run).
Severity Findings (Critical → Major → Minor)
🚫 Critical Blockers
None. Claude works end-to-end with documented setup.
⚠️ Major Obstacles
CLAUDE_CODE_OAUTH_TOKEN unsupported & undocumented in quick-start — Only ANTHROPIC_API_KEY (or new WIF) works; an OAuth token from a Claude Max/Teams subscription is silently ignored. Documented at auth.mdx:199-201 and faq.md:368-370, but absent from quick-start.mdx. This is the exact failure mode for the Claude Code persona, who likely has an OAuth token, not a console API key.
gh aw init / add-wizard default to Copilot artifacts — --engine claude is documented (cli.md:135,140) but not surfaced in the quick-start steps; Claude users get Copilot-specific scaffolding unless they know the flag.
Silent Copilot default + incomplete inline secrets — Omitting engine: silently selects Copilot (how-they-work.mdx:26; 35 example files rely on this). Quick-start inline secret NOTE callouts cover only Copilot + Anthropic (quick-start.mdx:77-88); Codex/Gemini secrets are mere hyperlinks (quick-start.mdx:71).
💡 Minor Confusion
Copilot-first ordering everywhere — no "why choose Claude vs Copilot?" guidance for a user deliberately avoiding Copilot.
Tools: 15 documented, 14 engine-agnostic, 0 engine-exclusive, 1 unclear (web-search — "engine-dependent"; Codex disables by default, tools.md:62-67). No Copilot-only or Claude-only tools exist — strong cross-engine parity.
Parity (examples): Copilot 131 vs Claude 64 (~2× fewer) but Claude spans the same use-case families (PR/issue triage, doc upkeep, daily reports, smoke tests, security scans), concentrated in deeper-analysis families. Claude is fewer in volume, not narrower in breadth.
Auth Gaps
CLAUDE_CODE_OAUTH_TOKEN: ignored/unsupported — documented auth.mdx:199-201, faq.md:368-370; never in quick-start.
Claude auth is surfaced in quick-start (✅ quick-start.mdx:71,84-88).
Codex (OPENAI_API_KEY) & Gemini (GEMINI_API_KEY): not shown inline, hyperlink only (quick-start.mdx:71).
Anthropic WIF keyless OIDC: documented auth.mdx:207-271 (v0.79.6+) but not in quick-start.
No custom engine auth documented anywhere (auth.mdx:17-39).
Recommended Actions
Priority 1 — Add a one-line note to quick-start.mdx Claude step: "Use an ANTHROPIC_API_KEY from the Anthropic Console — a Claude Code OAuth token (CLAUDE_CODE_OAUTH_TOKEN) is not supported." Closes the #1 persona blocker.
Priority 2 — Surface gh aw init --engine claude (and the Codex/Gemini inline secret callouts) directly in quick-start; state explicitly that omitting engine: selects Copilot.
Priority 3 — Add an engine-selection / "why Claude vs Copilot" subsection and link the new WIF keyless-auth option from quick-start; give custom engine a minimal example + auth note.
reacted with thumbs up emoji reacted with thumbs down emoji reacted with laugh emoji reacted with hooray emoji reacted with confused emoji reacted with heart emoji reacted with rocket emoji reacted with eyes emoji
Uh oh!
There was an error while loading. Please reload this page.
-
Executive Summary
A Claude Code user can adopt gh-aw: Claude is a first-class engine with a dedicated
ANTHROPIC_API_KEYsetup callout in the quick-start, 64 example workflows, and full tool parity (14/15 tools engine-agnostic). No critical blockers. The single most persona-relevant gap persists:CLAUDE_CODE_OAUTH_TOKENis explicitly ignored/unsupported, and that caveat never appears in the quick-start — so Claude Max/Teams OAuth users hit a silent 401/403. New this run: Anthropic Workload Identity Federation (keyless OIDC auth) is now documented (auth.mdx:207-271, since v0.79.6) — a real improvement, but still not surfaced in quick-start. Overall score: 7.5/10 (stable, 7th consecutive run).Severity Findings (Critical → Major → Minor)
🚫 Critical Blockers
None. Claude works end-to-end with documented setup.
CLAUDE_CODE_OAUTH_TOKENunsupported & undocumented in quick-start — OnlyANTHROPIC_API_KEY(or new WIF) works; an OAuth token from a Claude Max/Teams subscription is silently ignored. Documented atauth.mdx:199-201andfaq.md:368-370, but absent fromquick-start.mdx. This is the exact failure mode for the Claude Code persona, who likely has an OAuth token, not a console API key.gh aw init/add-wizarddefault to Copilot artifacts —--engine claudeis documented (cli.md:135,140) but not surfaced in the quick-start steps; Claude users get Copilot-specific scaffolding unless they know the flag.engine:silently selects Copilot (how-they-work.mdx:26; 35 example files rely on this). Quick-start inline secret NOTE callouts cover only Copilot + Anthropic (quick-start.mdx:77-88); Codex/Gemini secrets are mere hyperlinks (quick-start.mdx:71).💡 Minor Confusion
customengine — 0 standalone examples (only out-of-scopeshared/genaiscript.md), no dedicated auth section.auth.mdx:207-271, invisible to quick-start readers.Engine & Tool Matrix
copilot-requests:write/COPILOT_GITHUB_TOKENPATANTHROPIC_API_KEYcalloutANTHROPIC_API_KEY✅; OAuth token ❌ ignored; WIF/OIDC ✅ (auth.mdx only)OPENAI_API_KEY/CODEX_API_KEY(auth.mdx)Tools: 15 documented, 14 engine-agnostic, 0 engine-exclusive, 1 unclear (
web-search— "engine-dependent"; Codex disables by default,tools.md:62-67). No Copilot-only or Claude-only tools exist — strong cross-engine parity.Parity (examples): Copilot 131 vs Claude 64 (~2× fewer) but Claude spans the same use-case families (PR/issue triage, doc upkeep, daily reports, smoke tests, security scans), concentrated in deeper-analysis families. Claude is fewer in volume, not narrower in breadth.
Auth Gaps
CLAUDE_CODE_OAUTH_TOKEN: ignored/unsupported — documentedauth.mdx:199-201,faq.md:368-370; never in quick-start.quick-start.mdx:71,84-88).OPENAI_API_KEY) & Gemini (GEMINI_API_KEY): not shown inline, hyperlink only (quick-start.mdx:71).auth.mdx:207-271(v0.79.6+) but not in quick-start.customengine auth documented anywhere (auth.mdx:17-39).Recommended Actions
Priority 1 — Add a one-line note to
quick-start.mdxClaude step: "Use anANTHROPIC_API_KEYfrom the Anthropic Console — a Claude Code OAuth token (CLAUDE_CODE_OAUTH_TOKEN) is not supported." Closes the #1 persona blocker.Priority 2 — Surface
gh aw init --engine claude(and the Codex/Gemini inline secret callouts) directly in quick-start; state explicitly that omittingengine:selects Copilot.Priority 3 — Add an engine-selection / "why Claude vs Copilot" subsection and link the new WIF keyless-auth option from quick-start; give
customengine a minimal example + auth note.References: §27692843737
Beta Was this translation helpful? Give feedback.
All reactions