[DOCS] `/install-github-app` docs omit optional GitHub App-only setup path

Open 💬 0 comments Opened Jun 23, 2026 by coygeek

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/github-actions
https://code.claude.com/docs/en/commands

Section/Topic

Setup -> Quick setup and Manual setup for /install-github-app.

Current Documentation

The current quick setup text says:

The easiest way to set up this action is through Claude Code in the terminal. Just open claude and run /install-github-app. This command will guide you through setting up the GitHub app and required secrets.

Local evidence: docs/code.claude.com/docs/en/github-actions.md:37-39

The note still presents secrets as part of the required setup path:

You must be a repository admin to install the GitHub app and add secrets

Local evidence: docs/code.claude.com/docs/en/github-actions.md:41-43

The commands reference describes /install-github-app only as GitHub Actions setup:

/install-github-app | Set up the Claude GitHub Actions app for a repository. Walks you through selecting a repo and configuring the integration

Local evidence: docs/code.claude.com/docs/en/commands.md:87

What's Wrong or Missing?

Claude Code v2.1.187 changed /install-github-app so GitHub Actions workflow setup is optional. Users can install just the GitHub App and skip the workflow and secret steps.

The current docs still imply that /install-github-app always guides users through GitHub App setup plus required secrets, and the manual setup path still presents ANTHROPIC_API_KEY and .github/workflows/ setup as mandatory follow-on steps. That omits the new App-only path.

Suggested Improvement

Update the GitHub Actions quick setup section to distinguish the two setup choices. For example:

Run /install-github-app from Claude Code to install the Claude GitHub App for a repository. During setup, you can choose whether to also configure the GitHub Actions workflow. If you only need the GitHub App, you can skip the workflow and repository-secret steps.

Then update the note and manual setup steps so ANTHROPIC_API_KEY and workflow-file creation are described as required only when configuring GitHub Actions workflows, not when installing only the GitHub App. Also update the /install-github-app row in the commands reference to mention that workflow setup is optional.

Impact

Medium - Makes feature difficult to understand

Additional Context

Release context: Claude Code v2.1.187 release note says: Improved /install-github-app: GitHub Actions workflow setup is now optional — you can install just the GitHub App and skip the workflow/secret steps.

Duplicate check found no open issue titles matching install-github-app, workflow setup, secret steps, or optional workflow.

View original on GitHub ↗