Claude Code に頼みごとをするとき、長い指示を書くのは大変ですよね。
AskUserQuestion を使うと、Claude のほうから選択肢つきで聞いてくれます。こちらは押して選ぶだけです。
頼み方の最後に「AskUserQuestion で聞いて」と1文足せば、選択肢の質問が出やすくなります。毎回聞いてほしいなら CLAUDE.md に書いておくのが近道です。
ただし、ふつうのサブエージェントからは使えません。答えを受け取る仕組みの無い自動の実行でも使えないので、そこでは「聞かずに進める条件」を書いておきます。
目次
AskUserQuestionとは|選択肢で聞いてくれる機能
AskUserQuestion は、Claude Code に最初から入っているツール(Claude が作業に使う機能)の1つです。決めることや、はっきりしないことがあるときに、選択肢つきの質問を出します。
使う前の設定は要りません。公式のツール一覧でも、使う前の許可は「要らない」になっています(2026年10月31日に確認)。
画面ではこう出る
デスクトップアプリの Code タブでは、こんな質問の枠が出ます。

選択肢ごとに1行の説明が付き、最後に「その他」の行があります。
選ぶだけなら、文章を打たずに答えられます。

質問が出ている間に、Claude が勝手に先へ進むことはないんですか?

既定では、答えるまで待ってくれます。待ち時間の決め方は、あとの節で書きます。
許可の確認との違い
「このコマンドを実行してよいですか」という許可の確認とは、別のものです。
許可の確認は、操作をしてよいかを聞きます。AskUserQuestion は、どちらの方向で進めるかを聞きます。

公式では、AskUserQuestion はどの権限モードでも自動では通りません。許可の確認を飛ばすモード(bypassPermissions)でも、答えるのはあなたです。
機能の紹介は、こちらの記事にもまとめています。
Claude Code神機能7選|一番はCLAUDE.mdと質問機能出し方|頼み方に1文を足す
Claude が自分から出すとき
Claude は、決めることがあると判断すると、頼まなくても自分から質問を出すことがあります。
ただし、いつも出るとは限りません。
公式によると、auto mode(Claude が自分で判断して進めるモード)では、質問で止まらず進むよう促されます。
それでも、頼み方やスキルが質問を求めていれば、聞いてくれます。
1文で頼む
確実に聞いてほしいときは、頼み方の最後に1文を足します。
AskUserQuestion で、決めることを選択肢つきで聞いてから進めて。

X では、しらすさんが要件を決めるときに似た1文を最後に足し、選択式で詰められて楽だと書いています(2026年5月13日)。
Claude Code チームの Thariq さんも、大きな機能を作るときの好きなやり方として、こう書いています。
start with a minimal spec or prompt and ask Claude to interview you using the AskUserQuestionTool
短い仕様か頼み方から始めて、AskUserQuestion で自分に聞き取りをさせる、という意味です。投稿では、そのあと新しいセッションで仕様を実行するとも書いています。
選択肢に良い点と弱い点を書かせる
選択肢が「する/しない」だけだと、選ぶ材料がありません。
選択肢ごとに、良い点と弱い点を書いてもらうと、比べやすくなります。
プロンプトに「選択肢にはトレードオフを必ず明記してください」と入れるだけで、質問の質が一気に上がります。
AskUserQuestion で聞いて。選択肢には、それぞれの良い点と弱い点を1行で書いて。おすすめには印を付けて。
毎回聞いてほしいならCLAUDE.mdに書く
毎回1文を打つのが面倒なら、CLAUDE.md(Claude が毎回読む決まりのファイル)に書いておきます。
書き方
- CLAUDE.md を開く
Code タブで「CLAUDE.md に聞き方の決まりを足したい」と頼むと、Claude に足してもらえます。
- 聞き方の決まりを3行足す
下のコピー欄をそのまま使えます。
- 新しいセッションで試す
決めることがある頼みごとをして、選択肢の質問が出るかを見ます。
## 確認の聞き方
- 判断を求めるときは AskUserQuestion を使う
- 選ぶ案の中身は、質問の手前の本文に表で示す。質問の枠は短くし、選択肢の説明は1行にする
- 選択肢には、それぞれの良い点と弱い点を書き、おすすめに印を付ける

私の CLAUDE.md にも、判断を求めるときは AskUserQuestion を使う、と書いています。
書いておいても、毎回必ず出るとは限りません。出なかったときは、頼み方に1文を足します。
CLAUDE.md そのものの書き方は、こちらにまとめています。
CLAUDE.mdベストプラクティス|345行を169行に縮めた実録スキルの中で聞かせる
決まった作業の手順書(スキル)にも、聞く場所を書けます。
記事づくりの手順書には「各小工程の終わりで AskUserQuestion で止まる」と書いています。
手順のどこで止まって聞くかを書いておくと、作業のたびに頼み直さずに済みます。
答え方は3つ|選ぶ・書く・メモする
公式では、答え方は3つです。

- 選択肢を押して選ぶ
- 「その他」の行に、自分の言葉で書く
- メモの欄に、補足を書く
上の私の Code タブの画面(2026年10月19日)では、メモの欄は見えませんでした。補足を伝えたいときは「その他」に書けば届きます。
X では、スナガクさんが、表示イメージを作ってもらったときにメモの欄で注意点を一緒に伝えられた、と書いています(2026年3月4日)。
自分の言葉で「待って」も効く
「その他」に書いた答えは、中立の言い方で Claude に渡されます。
「先に説明して」「いったん待って」と書けば、それに従うように伝わります(公式・2026年10月31日に確認)。
質問が続いたら、切り上げてよい
深く聞いてもらうほど、質問は続きます。
決めることが大体そろったら、「ここまでで進めて」と書いて切り上げて大丈夫です。全部に答えなくても、作業は進められます。
ふぇねさんも、質問が長く続くと答える側が疲れるので、途中で切り上げてよいと書いています。
待ち時間の設定|既定は答えるまで待つ
既定では、答えるまで質問は開いたままです。
席を外しても、戻ってから答えれば続きから進みます。
自動で進めたいときの設定
放っておいた質問を閉じて、先に進めてほしい人だけ、設定 askUserQuestionTimeout を変えます。
値は 60s・5m・10m・never の4つで、既定は never(答えるまで待つ)です。ターミナルの /config の「Question auto-continue timeout」か、ユーザーの設定ファイル ~/.claude/settings.json で変えます。
設定ファイルに書くなら、たとえば5分にする形はこうです。
{
"askUserQuestionTimeout": "5m"
}
デスクトップアプリの Code タブでこの設定が効くかは、2026年10月31日の時点で確かめていません。

時間が来ると、それまでに選んだ答えだけを送り、「離席中かもしれない」と Claude に伝えます。Claude は自分の判断で進み、あとで聞き直すこともあります。
最後の20秒はカウントダウンが出ます。何かキーを押すと、時計は最初に戻ります。
時計が止まる場面
次のときは、設定していても時計が動かず、答えるまで待ちます。
- バックグラウンドのセッション
- 画面の読み上げのモード
- リモートコントロールでつないでいる間
また、ターミナルのウィンドウが手前にある(選ばれている)と伝わっている間も、時計は進みません。
「実行してよいですか」の許可の確認と、計画の承認は、待ち時間の設定があっても自動では閉じません。待ち時間で閉じるのは、AskUserQuestion の選択肢の質問だけです。
出ない・使えない場面

頼んだのに質問が出ないことがあります。なぜですか?

AskUserQuestion が使えない場面があります。代表的なものを並べます。

ふつうのサブエージェントからは使えない
サブエージェント(作業を手分けする別の Claude)からは、AskUserQuestion を使えません。公式の説明で、サブエージェントが使えるツールの一覧から外されるものに入っています。
例外は、今の会話をそのまま引き継ぐ fork(会話の分岐)です。公式では、fork はこの除外を通らず、本体の会話と同じツールを使えます。
手分けを頼むときは、聞きたいことを本体の会話で先に決めてから渡します。
答える人がいない自動の実行
決まった時刻に動かす実行や、claude -p のような画面の無い実行では、ふつうは質問に答える人がいません。
公式では、dontAsk モードだと、AskUserQuestion は許可のルールに入れていても断られます。--permission-prompts none を付けると、AskUserQuestion そのものが外されます。
自分で作る仕組み(Agent SDK など)で、質問を画面に出して答えを返す作りにすれば、自動の実行でも答えられます。ここでは、そうした仕組みを用意していない場合の話です。
自動で動かす頼み方に「AskUserQuestion で聞いて」と書かないでください。代わりに「迷ったら、おすすめの案で進めて、選んだ理由を最後に書いて」のように、聞かずに進める条件を書きます。
1回に聞けるのは1〜4問・2〜4択
公式の Agent SDK の説明では、1回の質問で1〜4問、それぞれ2〜4択まで出せます。
| 項目 | 上限 |
|---|---|
| 1回の質問の数 | 1〜4問 |
| 1問の選択肢 | 2〜4択(「その他」は別に付く) |
| 質問の札(見出し) | 12字まで |
選択肢を5つ以上並べたいときは、質問を分けてもらいます。
私の使い方|記事づくりは選んで決める
選ぶだけで設計を決める
この記事を含め、AIエージェントLab の記事づくりは、読者・タイトル・見出しをほぼ選択肢で決めています。
記事づくりの聞き取りの記録67件のうち、25件は AskUserQuestion の答えから作ったものです(2026年9月29日〜10月20日・10月31日に数えた)。

AskUserQuestion は、とても重宝しています。良いところは、頼み方を考えずに済むこと、選ぶだけで決まること、勝手に進まないこと、スマホから答えられることの4つです。
私にとって、いちばんの神機能も AskUserQuestion と CLAUDE.md です。選択肢が出ない環境では、AIが提案してくれる最大限を活かせないと感じています。

案が見えなかったときの直し方
一度、選ぶ案が見えずに困ったことがあります。
質問の手前の本文に書いた案が、私の画面には出ませんでした。選択肢のプレビュー欄に書いた見出しも、出ませんでした(2026年10月10日)。
そこで案を全部、質問の枠に書いてもらいました。今度は枠が文章で埋まって、読みにくくなりました。
今は、案の中身を質問の手前の本文に表で置き、質問の枠は短い1文と札、1行の説明だけにしています。

説明の1行は、本文が見えない端末向けの保険です。札と説明だけでも、何を選ぶのかが分かるように書いてもらいます。
質問機能を Codex と比べた話は、こちらに書いています。
Claude CodeとCodex|質問機能で変わる使いやすさよくある質問
許可の確認とは何が違いますか?
許可の確認は「操作してよいか」を、AskUserQuestion は「どの案で進めるか」を聞きます。
待ち時間の設定で自動で閉じるのも、AskUserQuestion の質問だけです。
質問させないようにできますか?
いちばん手軽なのは、頼み方に「質問せずに、迷ったらおすすめの案で進めて」と書くことです。
AskUserQuestion そのものを外すなら、許可の設定の deny にツールの名前だけを書く方法が公式の決まりにあります。AskUserQuestion に当てはめたときの動きは、この記事では確かめていません。
質問の画面が出ずに、空の答えで進んでしまいました。
GitHub では、2026年2〜4月の版で、質問の画面が出ずに空の答えで進む不具合が報告されています(10月31日の時点で、報告は閉じられていません)。
起きたら、答えたい内容をふつうのメッセージで送り、もう一度聞き直してもらいます。
スマホからも答えられますか?
リモートコントロールでつないでいる間も、質問は答えるまで開いたままです。
ただ、端末によっては、質問の手前の本文が見えないことがあります。スマホで答える日は、案の中身も質問文に書いてもらうと迷いません。
まとめ
- 出すなら、頼み方の最後に「AskUserQuestion で聞いて」の1文
- 毎回なら、CLAUDE.md に聞き方の決まりを3行。選択肢には良い点と弱い点を書いてもらう
- 既定では答えるまで待つ。ふつうのサブエージェントと、答える人がいない自動の実行では使えないので、聞かずに進める条件を書く
参考資料・出典
確かめた日:2026年10月31日
公式資料
- Tools reference(AskUserQuestion の動きと待ち時間):https://code.claude.com/docs/en/tools-reference
- Settings reference(askUserQuestionTimeout):https://code.claude.com/docs/en/settings-reference
- Permission modes(自動で通らないツール・auto mode・dontAsk):https://code.claude.com/docs/en/permission-modes
- Create custom subagents(サブエージェントから外されるツール):https://code.claude.com/docs/en/sub-agents
- Run Claude Code programmatically(画面の無い実行):https://code.claude.com/docs/en/headless
- Agent SDK・Handle approvals and user input(質問の数の上限):https://code.claude.com/docs/en/agent-sdk/user-input
- Configure permissions(deny の決まり):https://code.claude.com/docs/en/permissions
- Claude Code の変更履歴:https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md
利用者の実践と報告
- Thariq さんの投稿(2025年12月29日):https://x.com/trq212/status/2005315275026260309
- ふぇね(山中裕貴)さんの X の記事(2026年5月13日):https://x.com/0xfene/status/2054505601649263006
- しらすさんの投稿(2026年5月13日):https://x.com/shirasu59s/status/2054536674655551957
- スナガクさんの投稿(2026年3月4日):https://x.com/suna_gaku/status/2029138545102008676
- GitHub の不具合の報告 #29530(2026年2月28日〜4月30日):https://github.com/anthropics/claude-code/issues/29530









