This GitHub Action enables users to integrate Claude Code, an AI assistant for code generation and task automation, directly into their CI/CD pipelines. It allows for flexible prompting, tool selection, and model configuration, empowering developers to automate complex coding tasks, code reviews, and environment deployments within GitHub Actions workflows.

How It Works

The action leverages the Claude API to execute user-defined prompts. It supports direct prompts or prompts loaded from files, and allows fine-grained control over Claude's capabilities through allowed_tools and disallowed_tools parameters. Users can customize the AI's behavior with system prompts, environment variables, and even specify fallback models for improved resilience. The action can interface with Anthropic's direct API, Amazon Bedrock, or Google Vertex AI, offering flexibility in cloud provider integration.

Quick Start & Requirements

• Install/Run: Add uses: anthropics/claude-code-base-action@beta to your GitHub Actions workflow.
• Prerequisites: An Anthropic API key (or OIDC setup for AWS Bedrock/GCP Vertex AI) stored as a GitHub secret (ANTHROPIC_API_KEY).
• Documentation: Examples

Highlighted Details

• Supports direct Anthropic API, AWS Bedrock, and Google Vertex AI integrations.
• Allows custom system prompts, environment variables (claude_env), and tool definitions.
• Includes fallback model support for API error handling.
• Can utilize MCP (Multi-Cloud Platform) configurations for complex setups.
• Provides outputs for execution status and logs.

Maintenance & Community

The action is maintained by Anthropic. Further community engagement details are not specified in the README.

Licensing & Compatibility

• License: MIT License.
• Compatibility: Permissive MIT license allows for commercial use and integration with closed-source projects.

Limitations & Caveats

The action is tagged as @beta, indicating potential instability or ongoing development. The prompt or prompt_file input is required, but not explicitly enforced as mutually exclusive in the input table.