Code Agent

Code Agent

An AI Agent that operates [Claude Code](https://github.com/anthropics/claude-code) and [Codex](https://github.com/openai/codex) on GitHub Actions. By using this action, you can directly invoke Claude Code or Codex from GitHub Issues or Pull Request comments and automate code changes.

Features

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

Usage

Project Settings

Settings -> Actions -> General -> Workflow permissions

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


Settings -> Secrets and variables -> Actions -> Secrets

• Repository secrets: Set ANTHROPIC_API_KEY (for Claude Code) or OPENAI_API_KEY (for Codex)


Workflow Configuration

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 }}

          # [Claude Code Settings]
          anthropic-api-key: ${{ secrets.ANTHROPIC_API_KEY }}

          # [Optional Claude Code 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-ur