Claude CodeとGitHub Actions連携で自動化を極める【コードレビュー・デプロイ・テストを全自動に】
「コードをコミットするたびに誰かがレビューしなければいけない」
開発チームが抱える共通の悩みだ。プルリクエストが積み上がり、レビュー待ちのコードがボトルネックになる。レビュアーが多忙なとき、品質チェックなしでマージされてしまうことも起きる。
Claude Code と GitHub Actions を組み合わせると、この「人間がやらなければいけなかったレビュー・チェック・文書生成」の多くを自動化できる。コードがコミットされた瞬間に AI がレビューを開始し、問題点を指摘し、ドキュメントを更新し、テストを走らせる——このパイプラインが動き続ける。
この記事では、非エンジニアでも概念を理解できるよう丁寧に解説しながら、実際に動くコードを紹介する。
1. GitHub Actions の基礎——「何かが起きたら何かをする」自動化
GitHub Actions とは何か
GitHub Actions は、GitHub リポジトリ上のイベント（コードのプッシュ・プルリクエストの作成・定期実行など）をトリガーに、あらかじめ定義した処理を自動実行する仕組みだ。
非エンジニア向けに例えるなら「条件反射の自動化」だ。「コードがプッシュされたら（条件）→ テストを実行する（反射）」「プルリクエストが作られたら（条件）→ コードレビューのコメントを投稿する（反射）」という形で、人間が忘れずに行っていた作業を自動化できる。
設定は YAML という形式のファイルで書く。このファイルを .github/workflows/ ディレクトリに置くだけで動作する。
基本的な構造
name: ワークフローの名前
on:
push:
branches: [main] # main ブランチへのプッシュで実行
jobs:
job-name:
runs-on: ubuntu-latest # 実行環境
steps:
- name: コードを取得
uses: actions/checkout@v4
- name: 処理を実行
run: echo "処理の内容"
この骨格を理解した上で、Claude API との連携を追加していく。
2. Claude API を GitHub Actions で呼ぶ方法
準備：API キーの安全な管理
GitHub Actions から Claude API を呼ぶためには、Anthropic の API キーが必要だ。このキーはコードに直接書いてはならない——セキュリティリスクになる。
代わりに GitHub の「Secrets」機能を使う。リポジトリの Settings → Secrets and variables → Actions で ANTHROPIC_API_KEY という名前で API キーを登録すると、ワークフロー内で ${{ secrets.ANTHROPIC_API_KEY }} という形で安全に参照できる。
Claude API を呼ぶ基本的なシェルコマンド
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-opus-4-5",
"max_tokens": 1024,
"messages": [
{"role": "user", "content": "レビューしたい内容"}
]
}'
このコマンドを GitHub Actions のステップの中に組み込むことで、特定のイベントが起きたタイミングで Claude API を呼び出せる。
3. 自動コードレビューの実装
プルリクエスト作成時に自動でコードレビューを実行する
以下のワークフローは、プルリクエストが作成・更新されたタイミングで、変更されたコードを Claude に送り、レビューコメントを PR に自動投稿する。
name: AI Code Review
on:
pull_request:
types: [opened, synchronize]
jobs:
code-review:
runs-on: ubuntu-latest
permissions:
pull-requests: write
contents: read
steps:
- name: コードを取得
uses: actions/checkout@v4
with:
fetch-depth: 0
- name: 変更差分を取得
id: diff
run: |
git diff origin/main...HEAD > diff.txt
echo "diff_content=$(cat diff.txt | head -c 3000)" >> $GITHUB_OUTPUT
- name: Claude でコードレビュー
id: review
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
run: |
DIFF=$(cat diff.txt | head -c 3000)
REVIEW=$(curl -s https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d "{
\"model\": \"claude-opus-4-5\",
\"max_tokens\": 1024,
\"messages\": [{
\"role\": \"user\",
\"content\": \"以下のコード差分をレビューしてください。バグの可能性・パフォーマンスの問題・セキュリティリスク・可読性の改善点を日本語で箇条書きにしてください。\\n\\n${DIFF}\"
}]
}" | python3 -c "import sys,json; print(json.load(sys.stdin)['content'][0]['text'])")
echo "review=$REVIEW" >> $GITHUB_OUTPUT
- name: PR にレビューコメントを投稿
uses: actions/github-script@v7
with:
script: |
const review = `${{ steps.review.outputs.review }}`;
github.rest.issues.createComment({
issue_number: context.issue.number,
owner: context.repo.owner,
repo: context.repo.repo,
body: `## AI コードレビュー結果\n\n${review}`
});
このワークフローが動作すると、プルリクエストを作成するたびに Claude がコードの差分を自動でレビューし、コメントとして投稿する。人間のレビュアーが確認する前に「明らかな問題点」が自動で指摘される状態になる。
### 実際の運用効果
あるスタートアップの開発チーム（3名）では、この自動レビューを導入してから「小さなバグの見落とし」が50%以上減少した。特に「セキュリティ関連の問題」（APIキーのハードコード・SQLインジェクションのリスク・不適切なエラーハンドリング）を Claude が自動で指摘するようになり、本番環境への問題流出が大幅に減った。
---
## 4. 自動ドキュメント生成の実装
### コードとドキュメントのズレを自動解消する
コードを変更したのにドキュメント（README・API仕様書・関数説明）を更新し忘れる——これは開発現場での慢性的な問題だ。Claude Code と GitHub Actions を組み合わせると、コードが変更されるたびにドキュメントを自動生成・更新できる。
```yaml
name: Auto Documentation
on:
push:
branches: [main]
paths:
- 'src/**/*.py' # Pythonファイルが変更されたとき
jobs:
generate-docs:
runs-on: ubuntu-latest
permissions:
contents: write
steps:
- uses: actions/checkout@v4
- name: 変更されたファイルを取得
id: changed_files
run: |
echo "files=$(git diff HEAD~1 --name-only | grep '\.py$' | tr '\n' ' ')" >> $GITHUB_OUTPUT
- name: ドキュメントを生成
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
run: |
for file in ${{ steps.changed_files.outputs.files }}; do
if [ -f "$file" ]; then
CODE=$(cat "$file")
DOC=$(curl -s https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d "{
\"model\": \"claude-haiku-4-5\",
\"max_tokens\": 2048,
\"messages\": [{
\"role\": \"user\",
\"content\": \"以下のPythonコードのドキュメントをMarkdown形式で生成してください。各関数の説明・引数・戻り値・使用例を含めてください。\\n\\n${CODE}\"
}]
}" | python3 -c "import sys,json; print(json.load(sys.stdin)['content'][0]['text'])")
# ドキュメントを docs/ ディレクトリに保存
DOC_FILE="docs/$(basename $file .py).md"
echo "$DOC" > "$DOC_FILE"
fi
done
- name: ドキュメントをコミット
run: |
git config --global user.name 'GitHub Actions'
git config --global user.email 'actions@github.com'
git add docs/
git diff --staged --quiet || git commit -m "docs: Auto-generate documentation"
git push
このワークフローを導入すると、Pythonファイルが変更されるたびに対応するドキュメントが自動的に生成・更新される。「ドキュメントが古くなっている」という状況が自動的に解消される。
5. 非エンジニアが活用できる「テキスト処理の自動化」
コードレビューだけじゃない——テキスト処理自動化の可能性
GitHub Actions は開発者向けのツールだが、Claude API との組み合わせで「テキスト処理の自動化」に使える点は、非エンジニアにとっても価値がある。
例えば、以下のような用途が考えられる。
定期実行でのレポート自動生成: GitHub の Issues やコメントを集計して、プロジェクトの週次サマリーを自動生成し、Slack や Email に送信する。
PR マージ時の変更ログ自動作成: プルリクエストがマージされるたびに、変更内容を要約した CHANGELOG を自動更新する。ソフトウェアのバージョンアップを顧客に伝える「リリースノート」の下書きが自動で出来上がる。
コミットメッセージの品質チェック: コミットメッセージが不明瞭な場合に、より具体的な書き方を提案するコメントを自動投稿する。
非エンジニアが関わる形
GitHub Actions を直接書くのはエンジニアの仕事だが、「何を自動化するか」「Claude にどんな指示を与えるか」という部分は非エンジニアも参加できる。
「この業務を自動化したい」というアイデアを持つ担当者が Claude に「GitHub Actionsでこれを自動化するにはどうすればよいか」と相談すると、実装の骨格を示してくれる。そのアイデアをエンジニアと共有して実装を依頼する——この「企画・設計フェーズ」における Claude の活用は、非エンジニアでも十分に実践できる。
6. Claude Code との組み合わせでできること
Claude Code（ターミナル上で動くAIアシスタント）と GitHub Actions を組み合わせると、開発ワークフロー全体を AI が補助する体制を作れる。
開発者がローカルで Claude Code を使ってコードを書き、コミット・プッシュすると、GitHub Actions が起動して Claude API が自動でレビュー・テスト・ドキュメント生成を実行する。人間が確認するのは「AIがフラグを立てた問題点」だけでよい状態になる。
この体制での効果として、開発チームからは「コードレビューにかかる時間が週20時間から8時間に減少した」「ドキュメントの最新性が大幅に改善した」という声が届いている。削減された12時間が新機能の開発に使えるようになったことで、開発速度が向上している。
Claude Code道場で学ぶ
GitHub ActionsとClaude APIの連携は、開発チームの生産性を大幅に向上させる強力な組み合わせです。「コードレビューを自動化したい」「ドキュメント更新の手間をなくしたい」という課題を持つ開発者・エンジニアにとって、具体的な実装パターンを学ぶことが第一歩です。
Claude Code道場では、こうした高度な自動化の手順を含め、Claude Codeを業務で活用するための全19章のカリキュラムを提供しています。期間限定で全章無料公開中です。
