Skip to content

docs: clarify Claude quick-start auth + initialization path #39638

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
Copilot wants to merge 4 commits into from
+7 −0
Closed

docs: clarify Claude quick-start auth + initialization path #39638

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
c6d22f8
Initial plan
Copilot Jun 16, 2026
4cb4312
docs: clarify Claude quick-start setup requirements
Copilot Jun 16, 2026
0f14dc2
docs: refine Claude quick-start command guidance
Copilot Jun 16, 2026
c580f07
Merge branch 'main' into copilot/deep-report-fix-quick-start-docs
pelikhan Jun 16, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions docs/src/content/docs/setup/quick-start.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -59,9 +59,15 @@ gh extension install github/gh-aw
From your repository root run:

```text wrap
# Claude users: run once per repository to skip Copilot-oriented init artifacts
gh aw init --engine claude

# Then add the sample workflow
gh aw add-wizard githubnext/agentics/daily-repo-status
```

If the repository is already initialized, or if not using Claude, skip the `gh aw init --engine claude` command. By default, `gh aw init` creates Copilot-oriented artifacts unless `--engine claude` is provided.

`add-wizard` accepts workflow references in `<owner>/<repo>/<workflow-name>` format. In this example, `githubnext/agentics/daily-repo-status` references the `daily-repo-status` workflow hosted in the public [githubnext/agentics](https://github.com/githubnext/agentics) examples repository.

This will take you through an interactive process to:
Expand All @@ -85,6 +91,7 @@ The wizard generates a compiled workflow file (`.lock.yml`) automatically — yo
> **Setting up `ANTHROPIC_API_KEY`?**
> 1. Create an API key in [Anthropic Console](https://console.anthropic.com/settings/keys).
> 2. Add it as a repository secret from your repository root with `gh secret set ANTHROPIC_API_KEY < /path/to/key.txt`, or use the GitHub UI. See [Authentication](/gh-aw/reference/auth/#anthropic_api_key) for more detail.
> `CLAUDE_CODE_OAUTH_TOKEN` (Claude Max/Teams OAuth) is not supported and is ignored by GitHub Agentic Workflows. Use `ANTHROPIC_API_KEY` instead.
>

> [!TIP]
Expand Down
Loading