Add Claude to your GitHub pull requests

The steps

One step at a time. When a step’s check matches, tick it and the next one opens.

1. 01

   Step 1 of 3: Run /install-github-app

   Let Claude Code install the GitHub App, save the secret and prepare the workflow.

   Start claude in your local clone of the repository and run /install-github-app. Follow the prompts, choosing an API key or a subscription token.

   Note: The kit already holds .github/workflows/claude.yml, copied from the docs. If the command offers Update workflow file with latest version, pick it.

   In order:

   1. Claude

      Install the GitHub App

   2. Claude

      Save the secret

      ANTHROPIC_API_KEY or CLAUDE_CODE_OAUTH_TOKEN

   3. Claude

      Push a workflow branch

   4. You

      Create the pull request

   Check it worked

   GitHub opens in your browser with a pull request ready to create.

   If it didn’t work

   The command fails, or your remote isn’t on github.com

   It works only with github.com. Set up by hand: install the Claude GitHub App, add the secret, and keep the kit’s claude.yml. On GitLab, see GitLab CI/CD.

   It worked — next step Not yet
2. 02

   Step 2 of 3: Create and merge the workflow pull request

   Mentions start working once the workflow is merged.

   Create the pull request, then merge it. The workflow runs when a new comment or review comment contains @claude.

   .github/workflows/claude.yml · YAMLCopy

   # Day 23: Claude replies when someone mentions @claude in an issue or
   # pull request comment.
   # Copied from https://code.claude.com/docs/en/github-actions on 9 October 2026
   # ("Respond to @claude mentions"). Only these comment lines are ours.
   #
   # Using a Claude subscription instead of an API key? Replace the
   # anthropic_api_key line at the bottom with:
   #   claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
   name: Claude Code
   on:
     issue_comment:
       types: [created]
     pull_request_review_comment:
       types: [created]
   jobs:
     claude:
       if: contains(github.event.comment.body, '@claude')
       runs-on: ubuntu-latest
       permissions:
         contents: write
         pull-requests: write
         issues: write
         id-token: write
         actions: read
       steps:
         - uses: actions/checkout@v6
           with:
             fetch-depth: 1
         - uses: anthropics/claude-code-action@v1
           with:
             anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
   

   With a subscription token, swap the last line as the comment at the top says.

   your-repo/

   • folder .github
     • folder workflows
       • claude.ymlNewanswers @claude in comments

   Check it worked

   .github/workflows/claude.yml shows on your default branch on GitHub.

   It worked — next step Not yet Back
3. 03

   Step 3 of 3: Mention @claude on a pull request

   Open a small pull request and ask Claude something in a comment.

   Open any small pull request, such as a one-line README edit. Then comment:

   Pull request commentCopy

   @claude review this change and tell me if anything could break the tests

   In order:

   1. You

      You comment

      @claude plus a request

   2. Tool

      The workflow starts

      on a GitHub-hosted runner

   3. Claude

      Claude replies

      in a comment it updates as it works

   Check it worked

   A run appears in the repository’s Actions tab, and Claude replies in a comment on the same pull request.

   If it didn’t work

   Nothing happens after your comment

   Check that the workflow is merged, the secret exists and the comment contains @claude.

   It worked — finish Not yet Back