Command reference ยท Claude Code
/install-github-app
Installs the Claude GitHub App for a repository, optionally including GitHub Actions workflows and secrets.
/install-github-app installs the Claude GitHub App on a repository interactively. The command first walks through repo selection and app installation; this requires admin rights on the repository, and the app requests read/write access to contents, issues, and pull requests.
It then asks whether to proceed directly with setting up GitHub Actions workflows and the API key secret. Since version 2.1.187, this step can be skipped with "Skip for now," so that only the app is installed; the workflow/secret setup can be completed later by running /install-github-app again. Before version 2.1.187, the wizard went straight into workflow selection. The command is built into the CLI and can be run again as often as needed, for example to complete missing steps.
According to the docs, the quick installation via /install-github-app is only available to users of the direct Claude API; for Amazon Bedrock or Google Cloud's Agent Platform, manual setup is required instead.
โ WHEN TO USE IT?
Set up automated PR checks or CI integration
Run /install-github-app in a team repository to enable Claude for automated PR workflows via GitHub Actions.
Install only the GitHub App, postponing workflow setup
Run /install-github-app and choose 'Skip for now' when prompted (from version 2.1.187 onward), then run /install-github-app again later for the workflow/secret setup.
โ WHEN NOT TO?
Team uses Amazon Bedrock or Google Cloud's Agent Platform instead of the direct Claude API
According to the docs, the quick installation via /install-github-app is only available to direct Claude API users.
Better: Manual setup following the Bedrock/Vertex guide in the GitHub Actions docs.
Working exclusively locally, without GitHub integration
/install-github-app sets up a connection to GitHub including optional Actions and secrets โ unnecessary effort if PRs or CI are never meant to run through GitHub.
Better: Keep working locally with Git and skip the GitHub App.
SOURCES
- Claude Code docs (official) โ code.claude.com
MORE COMMANDS ยท Claude Code