Claude CodeのAskUserQuestionとは?AI任せにせず人間の判断を入れる方法|Human in the Loop入門

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エージェントとして活用しやすくなります。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

目次