# Claude Code GitHub Actions

> Claude Code that runs in a GitHub workflow when you write @claude.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** claude-code-action, anthropics/claude-code-action@v1, Claude GitHub Action

## Think of it like

It is like a helper who lives in your project. It comes when you call its name.

## Definition

Claude Code GitHub Actions runs Claude Code inside a GitHub workflow. When a comment says @claude, the workflow starts and Claude reads the request. It can answer, change code, push commits or open a pull request. A workflow can also pass its own prompt, so Claude runs on a schedule or on each new pull request. The fastest setup is the /install-github-app command.

## Example

Jack sees a bug report on GitHub. He comments @claude fix this. A few minutes later, a pull request with the fix is waiting for his review.

## Example code

```yaml
- uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
```

The step that runs Claude in a workflow.

## Why it matters

The team can give Claude work right from an issue or a pull request. No one has to open a terminal.

## Common mistake

Thinking it is the same as Code Review. The Action runs in your own workflow. Code Review is a separate service that needs no workflow.

## Three principles

- **Lives in a workflow.** In your repository.
- **Called by @claude.** Or by a prompt.
- **Answers in GitHub.** Comments, commits, pull requests.

## Related terms

- [Claude GitHub App](https://learn.benibix.com/term/ai/claude-github-app)
- [@claude Mention](https://learn.benibix.com/term/ai/claude-mention)
- [Claude Code Action Inputs](https://learn.benibix.com/term/ai/claude-code-action-inputs)
- [GitHub Actions](https://learn.benibix.com/term/development/github-actions)

## Told apart from

- [Claude Code GitHub Actions vs Code Review](https://learn.benibix.com/compare/claude-code-github-actions-vs-claude-code-review): People often think Code Review is the GitHub Action with a review prompt. It is a separate service, run by Anthropic with no workflow file. The GitHub Action runs Claude Code in your own workflow, on your runners, and you write its steps. Code Review runs on Anthropic's servers. It reviews each pull request with several agents and posts ranked findings. It needs a Team or Enterprise plan.

![A comment that says @claude starts a workflow. Claude Code runs on the runner and answers with a comment or a pull request.](https://learn.benibix.com/diagrams/ci-github-actions.svg)

---

Source: https://learn.benibix.com/term/ai/claude-code-github-actions
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-19
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
