フック・自動化

CLIオプション

`claude` コマンドをターミナルから起動する際に渡すオプション。

自動化・CI/CD

-- cli

--init

初期化フック（SessionStart）を実行してインタラクティブモードを開始する。

例:claude --init

-- cli

--init-only

初期化フック（SessionStart）を実行した後、インタラクティブセッションを開始せず終了する。

例:claude --init-only

-- cli

--maintenance

メンテナンスフックを実行して終了する。

例:claude --maintenance

-- cli

--include-hook-events

全フックライフサイクルイベントを出力ストリームに含める。`--output-format stream-json` と組み合わせて使用する。

例:claude -p --output-format stream-json --include-hook-events "query"

設定オプション

`claude config set <key> <value>` または `~/.claude/settings.json` で設定する項目。

自動化・CI/CD

config

hooks

ツール呼び出しの前後（PreToolUse/PostToolUse）・通知（Notification）・セッション終了（Stop）などのイベントに対して実行するシェルコマンドを定義する。lint・フォーマット・通知の自動化に活用できる。

例:

~/.claude/settings.json: {"hooks": {"PostToolUse": [{"matcher": "Write", "hooks": [{"type": "command", "command": "npx eslint --fix"}]}]}}

config

disableAllHooks

全フックとカスタムステータスラインを一時的に無効化する。フック定義は削除せずに無効化できる。

例:~/.claude/settings.json: {"disableAllHooks": true}

config

allowManagedHooksOnly

（Managed設定専用）ユーザー・プロジェクト・プラグインのフック読み込みを禁止し、管理フックとSDKフックのみ許可する。

例:managed-settings.json: {"allowManagedHooksOnly": true}

config

allowedHttpHookUrls

HTTPフックが対象にできるURLパターンの許可リスト。`*` ワイルドカード使用可。設定時は非マッチURLへのフックがブロックされる。空配列=全HTTPフックをブロック。

例:~/.claude/settings.json: {"allowedHttpHookUrls": ["https://hooks.example.com/*"]}

config

bashEditDiffEnabled

Bashコマンドがファイルシステムに加えた変更差分を、権限モードによらず常に記録する設定。Bashによるファイル編集をフックや監査で追跡したい場合に有効化する。

例:~/.claude/settings.json: {"bashEditDiffEnabled": true}

関連記事なし

config

httpHookAllowedEnvVars

HTTPフックがヘッダー値に展開できる環境変数名を制限する。各フックの実効的な `allowedEnvVars` はフック自身の設定とこの設定の交差集合になる。

例:~/.claude/settings.json: {"httpHookAllowedEnvVars": ["MY_TOKEN", "HOOK_SECRET"]}

config

disableSkillShellExecution

スキルやカスタムコマンド内のインラインシェル実行（`!`...``・` ```! ` ブロック）を無効化する。ユーザー・プロジェクト・プラグイン・追加ディレクトリソースに適用。バンドルスキルと管理スキルには適用されない。

例:managed-settings.json: {"disableSkillShellExecution": true}

config

CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS

SessionEndフックに割り当てる実行時間の上限（ミリ秒）を設定する。フックが重い処理を行う場合は増やして使用する。

例:export CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS=30000

config

strictPluginOnlyCustomization

（Managed設定専用）ユーザー・プロジェクト・ローカル設定からのスキル・フック・MCP設定を無効化する。プラグインと管理設定からのみカスタマイズを許可する。

例:managed-settings.json: {"strictPluginOnlyCustomization": true}

config

continueOnBlock

`PostToolUse` フックの設定オプション。`true` に設定するとフックが拒否した際にターンを終了せず拒否理由をClaudeにフィードバックしてターンを継続する。

例:~/.claude/settings.json: {"hooks": {"PostToolUse": [{"matcher": "Write", "continueOnBlock": true, "hooks": [...]}]}}

config

CLAUDE_ENV_FILE

`SessionStart`・`Setup`・`CwdChanged`・`FileChanged` フックが環境変数をセッションに永続化するために書き込むファイルパス。フックからセッション全体で有効な環境変数を設定する際に使用。

例:echo "MY_VAR=value" >> "$CLAUDE_ENV_FILE"

config

CLAUDE_EFFORT

フック実行時にツール呼び出しコンテキストとして渡される現在の努力レベル（`low`・`medium`・`high`・`xhigh`・`max`）を保持する環境変数。努力レベルを設定する `CLAUDE_CODE_EFFORT_LEVEL` とは異なり読み取り専用。

例:echo "current effort: $CLAUDE_EFFORT"