Skip to content
Search

ClaudeCode:Actions

lastmod 2026-03-09created 2026-03-064 edits

A general-purpose action that supports code Q&A and automated changes in GitHub PRs and issues

About

  • A Claude-based GitHub Action that improves development workflow efficiency by automating code review and implementation
  • Intelligent mode detection lets it act appropriately for the situation, such as @claude mentions, issue assignment, or automation prompts, without extra configuration
  • Claude answers questions about code, architecture, and programming
  • Analyzes PR changes and suggests improvements
  • Automatic code writing: handles everything from simple fixes and refactoring to implementing new features
  • Integrates with GitHub comments and PR reviews, fitting naturally into the collaboration flow
  • Uses GitHub API and file manipulation permissions; additional tools can be added through configuration
  • Shows progress with checkboxes and visually tracks task completion
  • A unified configuration structure (prompt, claude_args) supports concise yet powerful setup

claude.yml — Claude Code (mention-based)

Runs only when @claude is included:

Trigger event

Condition

Issue comment created

Comment body contains @claude

PR review comment created

Comment body contains @claude

PR review submitted

Review body contains @claude

Issue opened/assigned

Title or body contains @claude

name: Claude Code

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]
  pull_request_review:
    types: [submitted]

jobs:
  claude:
    if: |
      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: read
      issues: read
      id-token: write
      actions: read # Required for Claude to read CI results on PRs
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
        with:
          fetch-depth: 1

      - name: Run Claude Code
        id: claude
        uses: anthropics/claude-code-action@v1
        with:
          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}

          # This is an optional setting that allows Claude to read CI results on PRs
          additional_permissions: |
            actions: read

          # Optional: Give a custom prompt to Claude. If this is not specified, Claude will perform the instructions specified in the comment that tagged it.
          # prompt: 'Update the pull request description to include a summary of changes.'

          # Optional: Add claude_args to customize behavior and configuration
          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
          # or https://code.claude.com/docs/en/cli-reference for available options
          # claude_args: '--allowed-tools Bash(gh pr:*)'

claude-code-review.yml — Claude Code Review (automatic)

Automatically performs a code review when a PR is opened:

Trigger event

Condition

Pull Request

opened, synchronize, ready_for_review, reopened

Runs automatically when a PR is created or updated, without an @claude mention. Uses the code-review plugin.

name: Claude Code Review

on:
  pull_request:
    types: [opened, synchronize, ready_for_review, reopened]
    # Optional: Only run on specific file changes
    # paths:
    #   - "src/**/*.ts"
    #   - "src/**/*.tsx"
    #   - "src/**/*.js"
    #   - "src/**/*.jsx"

jobs:
  claude-review:
    # Optional: Filter by PR author
    # if: |
    #   github.event.pull_request.user.login == 'external-contributor' ||
    #   github.event.pull_request.user.login == 'new-developer' ||
    #   github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR'

    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: read
      issues: read
      id-token: write

    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
        with:
          fetch-depth: 1

      - name: Run Claude Code Review
        id: claude-review
        uses: anthropics/claude-code-action@v1
        with:
          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
          plugin_marketplaces: 'https://github.com/anthropics/claude-code.git'
          plugins: 'code-review@claude-code-plugins'
          prompt: '/code-review:code-review ${{ github.repository }}/pull/${{ github.event.pull_request.number }}'
          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
          # or https://code.claude.com/docs/en/cli-reference for available options

See also

Favorite site

author Zer0 sitemap