An AI Agent that operates Claude Code on GitHub Actions. By using this action, you can directly invoke Claude Code from GitHub Issues or Pull Request comments and automate code changes.

• Start Claude Code with the /claude command from GitHub Issues or PR comments
• Automatically create a Pull Request or commit changes if Claude Code modifies code
• Post Claude Code's output as a comment if there are no changes

• Permission Checks: Before executing core logic, the action verifies if the triggering user (github.context.actor) has write or admin permissions for the repository.
• Sensitive Information Masking: Any occurrences of the provided github-token and anthropic-api-key, AWS Credentials within the output posted to GitHub are automatically masked (replaced with ***) to prevent accidental exposure.

• Read and write permissions
• ✔ Allow GitHub Actions to create and approve pull requests

• Repository secrets Set ANTHROPIC_API_KEY

name: Code Agent

permissions:
  contents: write
  pull-requests: write
  issues: write

on:
  issues:
    types: [opened]
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]

jobs:
  code-agent:
    runs-on: ubuntu-latest
    if: ${{ github.event.sender.type != 'Bot' }}
    steps:
      - uses: potproject/code-agent@main
        with:
          github-token: ${{ secrets.GITHUB_TOKEN }}
          anthropic-api-key: ${{ secrets.ANTHROPIC_API_KEY }}
          # Optional settings
          # anthropic-base-url: "https://api.anthropic.com"
          # anthropic-model: "claude-3-7-sonnet-20250219"
          # anthropic-small-fast-model: "claude-3-5-haiku-20241022"
          # claude-code-use-bedrock: "1"
          # anthropic-bedrock-base-url: "https://bedrock.us-east-1.amazonaws.com"
          # aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
          # aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
          # aws-region: "us-east-1"
          # disable-prompt-caching: "1"

View on code-agent-example Issues / code-agent-example Pulls

Create a new Issue and add the following to the body:

/claude Please create a new API endpoint. This should be an endpoint that handles GET requests to retrieve user information.

Claude will then generate the necessary code according to the instructions and propose it as a Pull Request.

Comment on an existing Pull Request to request code modifications:

/claude Please add unit tests to this code.

Claude will analyze the comment and add test code to the existing PR branch.

You can customize the behavior of Claude Code using the following environment variables: