Claude Codeで自動化できること完全ガイド【2026年最新】：Hooks・GitHub Actions・スケジュール実行・headlessモードまで徹底解説

Claude Codeの自動化、どこから始めればいい？

---

Hooksとは？Claude Codeのライフサイクルに割り込む仕組み

Hooksで使える主なイベント

Hooksの設定ファイルはどこに書く？

• ~/.claude/settings.json：全プロジェクト共通のグローバル設定
• .claude/settings.json：プロジェクト固有（リポジトリにコミット可能）
• .claude/settings.local.json：プロジェクト固有のローカル専用（gitignored）

実用的なHooks設定例

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  }
}

スクリプトファイル（.claude/hooks/protect-files.sh）をこう書きます：

#!/bin/bash
INPUT=$(cat)
FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')

PROTECTED_PATTERNS=(".env" "package-lock.json" ".git/")

for pattern in "${PROTECTED_PATTERNS[@]}"; do
  if [[ "$FILE_PATH" == *"$pattern"* ]]; then
    echo "Blocked: $FILE_PATH is protected" >&2
    exit 2
  fi
done

exit 0

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Claude Codeが入力を待っています\" with title \"Claude Code\"'"
          }
        ]
      }
    ]
  }
}

---

GitHub Actionsでの自動化：PRに@claudeとメンションするだけ

セットアップ方法

1. https://github.com/apps/claude からGitHub AppをリポジトリにInstall
2. リポジトリのSecretsにANTHROPIC_API_KEYを追加
3. .github/workflows/にワークフローファイルをコピー

基本的なワークフローファイル

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]

jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

カスタム自動化プロンプト

name: Auto Security Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  security-review:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "このPRのコードをセキュリティの観点でレビューしてください。SQLインジェクション、XSS、認証の不備などの問題があれば具体的に指摘してください。"

---

スケジュール実行：/loopとCronで定期タスクを自動化する

/loopの使い方

/loop 5m check if the deployment finished

こう書くと5分ごとにデプロイの状況をチェックしてくれます。デプロイを待ちながら別の作業に集中できますね。

/loop check whether CI passed and address any review comments

スケジュールタスクのCron式

---

Claude Codeをプログラムから使う：パイプとheadlessモード

claude -p "このコードを最適化して" --allowedTools "Edit,Read,Bash" < source.py

cat error.log | claude -p "このエラーの原因を特定して修正コードを提案して"

claude -p "このコードをレビューして" --output-format json source.py

---

実践ガイド：よく使われる自動化パターン5選

パターン1：コード品質の自動担保

パターン2：PRの自動レビュー

パターン3：CI/CDパイプラインへの組み込み

パターン4：定期的なコードベースのメンテナンス

パターン5：ドキュメントの自動生成・更新

---

CLAUDE.mdで自動化ルールを固定する

• 使用するパッケージマネージャー（npm/yarn/bun）
• コミット・PRの規約（Conventional Commits等）
• テストを実行すべきタイミングのルール
• 変更してはいけないファイルやディレクトリ
• コードスタイルとフォーマット設定

---

許可モードとセキュリティ：自動化時の注意点

---

よくある疑問

Q：HooksとCLAUDE.mdの指示、どちらが優先？

Q：GitHub ActionsでClaude Codeを使うとコストはどのくらい？

Q：/loopはセッションを終了したら止まってしまう？

Q：Hooksのスクリプトがエラーになったらどうなる？

---

まとめ：Claude Codeの自動化、どこから始めるべきか

• Hooks：ライフサイクルの特定タイミングでスクリプトを自動実行
• GitHub Actions：GitHubのIssue/PRに@claudeでClaude Codeが動く
• スケジュール実行：/loopやCronで定期タスクを自動化
• プログラムからの利用：--printフラグ等でCLIをスクリプトに組み込む

---

出典

• Claude Code 公式ドキュメント - 一般的なワークフロー
• Claude Code 公式ドキュメント - Hooksガイド
• Claude Code 公式ドキュメント - Hooksリファレンス
• Claude Code 公式ドキュメント - GitHub Actions
• Claude Code 公式ドキュメント - スケジュール実行