自動化・配布・応用

Section 8.1

8.1Hooks — ライフサイクルイベントへの自動処理

なぜHooksが必要か

Claude Codeはエージェントとして自律動作するが、「ファイル保存後に必ずフォーマッタを実行する」「特定のファイルへの書き込みを絶対に禁止する」といった例外なく守るべきルールは、LLMの判断に委ねるべきではない。Hooksは、こうしたルールを強制するための仕組みだ。

たとえば、PostToolUseイベントにprettier --writeを登録すれば、Claudeがファイルを編集するたびにPrettierが自動で走る。LLMに「フォーマットしてね」と頼む必要がない。

4種類のHook Type

主要なHookイベント一覧

設定例：ファイル編集後に自動フォーマット

.claude/settings.json

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

matcherは正規表現パターンで、ここではEditかWriteツールの実行後だけに絞っている。Hookはstdinで実行コンテキストのJSONを受け取り、jqで必要なフィールドを抽出する設計になっている。

入出力の仕組み

Hookスコープの使い分け

Section 8.3

8.3Marketplaces — プラグインの発見と配布

マーケットプレイスの3層構造

公式マーケットプレイスの主要カテゴリ

インストールスコープ

Section 8.5

8.5CLI自動化 — パイプラインとSDK

gh pr diff "$PR" | claude -p \
  --append-system-prompt "Security review" \
  --output-format json --allowedTools "Bash(git *),Read"

基本コマンド

# ワンショット実行
claude -p "auth.pyのバグを見つけて修正して"

# ツール自動承認付き
claude -p "テストを実行して失敗を修正" --allowedTools "Bash,Read,Edit"

# 構造化出力（JSONスキーマ指定）
claude -p "関数名を抽出" --output-format json \
  --json-schema '{"type":"object","properties":{"functions":{"type":"array","items":{"type":"string"}}}}'

# 会話の継続
claude -p "コードベースをレビューして"
claude -p "DBクエリに絞って深掘り" --continue

セッション管理

--output-format jsonで得られるレスポンスにはsession_idが含まれる。これを--resumeに渡せば、複数の会話を並列に維持して任意のタイミングで再開できる。たとえば、GitHub Actionsのジョブ間でセッションIDを受け渡し、マルチステップのレビューパイプラインを構成できる。

Section 8.7

8.7トラブルシューティング

Claude Codeの問題はほとんどの場合、インストール / 認証 / 設定ファイル / パフォーマンスの4カテゴリに分類できる。まずは/doctorコマンドを実行し、自動診断を確認するのが第一歩。

/doctor が検査する項目

よくある問題と対処法

インストール系

認証系

パフォーマンス系

設定ファイルの場所

Support

homulaの支援体制

Claude Codeの自動化・プラグイン開発・CI/CD統合を含むAIエージェント導入を、homulaは包括的に支援しています。

よくある質問