Claude Codeでは、コードの調査、ファイル編集、テスト実行など、多くの作業をAIに任せられます。
しかし、実際の開発ではAIだけで決めてほしくない場面もあります。
例えば、既存のデータベースを変更するか、新しいテーブルを作るか。どちらも技術的には実現できても、運用方針によって適切な選択は変わります。
こうした場面で重要になるのが、Human in the Loop(HITL)という考え方です。
Claude Codeには、人間へ質問して判断を求めるためのAskUserQuestionというツールもあります。
今回は、この2つの関係と、重要な判断をAI任せにしない方法を整理します。
この記事で分かること
- Human in the Loopの基本的な考え方
- AskUserQuestionの役割
- AIが人間へ質問すべき場面
- CLAUDE.mdによる判断ルールの設定
- Plan ModeやPermissionsとの違い
Human in the Loopとは?
Human in the Loopとは、AIの処理に人間の判断や確認を組み込む設計です。
例えば、Claude Codeに機能追加を依頼すると、調査から実装、テストまで進められます。
しかし、途中で重要な設計判断が必要になる場合があります。
そのとき、AIが独自に方針を決めるのではなく、人間へ確認してから作業を再開します。
調査 → 選択肢の整理 → 人間が判断 → 実装 → テスト
という流れです。
すべての作業を人間が操作するのではなく、重要な判断だけ人間が担当する考え方です。
Claude CodeのAskUserQuestionとは?
AskUserQuestionは、Claude Codeがユーザーへ質問し、回答を受け取るためのツールです。
例えば、Claudeが既存システムを調査した結果、データ保存方法として2つの案を見つけたとします。
A案:既存テーブルを拡張する
変更箇所を抑えられる可能性がありますが、既存のデータ構造に影響します。
B案:新しいテーブルを作成する
機能を分離しやすい一方、実装や管理の対象が増えます。
どちらを選ぶかは、技術的な条件だけでなく、将来の運用方針にも関係します。
そこでClaudeが選択肢を提示し、人間に判断を求めます。
回答を受け取った後、その方針に沿って作業を進めることができます。
なお、AskUserQuestionはClaude Code内部のツール名です。通常の利用では、ユーザーがツール名を直接実行する必要はありません。
「分からないから質問する」だけではない
AskUserQuestionの重要な役割は、単にAIが知らない情報を尋ねることではありません。
AIが推測できる内容でも、人間が決めるべきことは人間へ戻すという使い方ができます。
例えば、Claudeが「一般的にはA方式が適切」と判断しても、利用者には将来B方式へ拡張する予定があるかもしれません。
その事情がコードに書かれていなければ、Claudeは正確に把握できません。
技術的に実装できることと、事業・運用上の方針を決めることは別です。
この違いを意識することが、Human in the Loopを活用する第一歩になります。
どんな場面で人間へ質問すべきか?
すべての操作で確認を求める必要はありません。
誤字修正や既存ルールに沿ったテスト追加など、作業内容が明確な場合はAIに任せやすいでしょう。
一方、次のような場面では人間の判断が重要になります。
- 複数の実装方法から一つを選ぶ
- データベースの構造を大きく変更する
- 既存データの削除や移行を決める
- 後方互換性を維持するか判断する
- 外部サービスの利用や費用発生を決める
- 要件が曖昧で、解釈によって結果が変わる
共通するのは、選択によって後の運用や成果に影響が出ることです。
AIが実装方法を考え、人間が重要な方針を決める。
この役割分担を基本にすると整理しやすくなります。
CLAUDE.mdに質問する条件を記載する
Claude Codeでは、CLAUDE.mdにプロジェクト全体の作業ルールを記載できます。
例えば、次のような指示です。
## Human Decision Rules
以下の場合は推測で実装せず、
ユーザーへ選択肢と影響を提示して確認する。
- 複数の設計案があり、判断が必要な場合
- DB構造を大きく変更する場合
- 既存データを削除・移行する場合
- 外部サービスへの書き込みが必要な場合
- 新たな費用が発生する場合
- 重要な要件が不明確な場合
これにより、Claudeへ判断の境界を伝えられます。
ただし、CLAUDE.mdはAIへの指示であり、質問や停止を必ず保証する強制的な安全装置ではありません。
重要な操作には権限設定なども組み合わせる必要があります。
質問するときは選択肢も整理してもらう
人間へ判断を求める場合、単に「どうしますか?」と質問されても困ることがあります。
そこで、Claudeには選択肢と判断材料を整理してもらうと便利です。
例えば、次の内容です。
選択肢: A案とB案
メリット: それぞれ何が優れているか
デメリット: どのような制約があるか
影響範囲: 既存機能やデータへの影響
推奨案: Claudeが適切と考える案とその理由
人間は、調査結果を確認したうえで最終判断できます。
AIに調査を任せることと、人間が判断することを両立できる方法です。
Plan Mode・Permissionsとの違い
ここまで学んだClaude Codeの機能を整理すると、役割の違いが見えてきます。
| 機能・考え方 | 主な役割 |
|---|---|
| Plan Mode | 実装前に調査・計画する |
| AskUserQuestion | 人間へ質問し回答を受け取る |
| Human in the Loop | 人間の判断を工程に組み込む |
| Permissions | ツール操作の実行権限を管理する |
| CLAUDE.md | プロジェクトの作業ルールを伝える |
例えば、Plan Modeで既存コードを調査し、複数の設計案が見つかったらAskUserQuestionで判断を求める、という使い方ができます。
人間が方針を決めた後に実装計画を確定し、実際の操作はPermissionsに従って進めます。
つまり、設計方針の判断と、操作の実行許可は別のものです。
人間への確認を増やしすぎないことも重要
Human in the Loopは便利ですが、確認を増やしすぎると作業が止まりやすくなります。
例えば、ファイルを読むたび、テストするたびに質問されると、人間が常に監視しなければなりません。
そこで、通常の調査や明確な修正はAIへ任せ、重要な判断だけ確認するようにします。
また、実行前の許可が必要な操作はPermissionsで管理します。
人間の判断が必要な場所を絞ることで、Claude Codeの自律性を活かしながら作業を進めやすくなります。
まとめ|AIに任せる作業と人間が決めることを分ける
Claude CodeのAskUserQuestionは、作業途中でユーザーへ質問し、判断や追加情報を受け取るためのツールです。
そしてHuman in the Loopは、重要な場面に人間の判断を組み込む設計思想です。
AIには調査、比較、実装、テストなどを任せられます。
一方、事業方針や重要な設計変更、費用やデータへの影響が大きい判断は、人間が確認する方が適切な場合があります。
AIが選択肢を整理し、人間が重要な判断を行い、AIが実行する。
この役割分担を意識することで、Claude Codeを単なるコード生成ツールではなく、判断を管理しながら仕事を任せるAIエージェントとして活用しやすくなります。

