Claude Code › 設定・拡張

AskUserQuestionの使い方|頼み方・設定・出ない場面まで

Claude Code に頼みごとをするとき、長い指示を書くのは大変ですよね。

AskUserQuestion を使うと、Claude のほうから選択肢つきで聞いてくれます。こちらは押して選ぶだけです。

この記事の結論

頼み方の最後に「AskUserQuestion で聞いて」と1文足せば、選択肢の質問が出やすくなります。毎回聞いてほしいなら CLAUDE.md に書いておくのが近道です。

ただし、ふつうのサブエージェントからは使えません。答えを受け取る仕組みの無い自動の実行でも使えないので、そこでは「聞かずに進める条件」を書いておきます。

AskUserQuestionとは|選択肢で聞いてくれる機能

AskUserQuestion は、Claude Code に最初から入っているツール(Claude が作業に使う機能)の1つです。決めることや、はっきりしないことがあるときに、選択肢つきの質問を出します。

使う前の設定は要りません。公式のツール一覧でも、使う前の許可は「要らない」になっています(2026年10月31日に確認)。

画面ではこう出る

デスクトップアプリの Code タブでは、こんな質問の枠が出ます。

Code タブで Claude が選択肢つきの質問を出した画面。質問文の下に説明つきの選択肢が3つと「その他」が並び、右下に「スキップ」と「送信」のボタンがある

選択肢ごとに1行の説明が付き、最後に「その他」の行があります。

選ぶだけなら、文章を打たずに答えられます。

初心者

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

芝田

既定では、答えるまで待ってくれます。待ち時間の決め方は、あとの節で書きます。

許可の確認との違い

「このコマンドを実行してよいですか」という許可の確認とは、別のものです。

許可の確認は、操作をしてよいかを聞きます。AskUserQuestion は、どちらの方向で進めるかを聞きます。

許可の確認は「この操作をしてよいか」を はい・いいえで聞き、AskUserQuestion は「どの案で進めるか」を選択肢で聞く、という違いの図

公式では、AskUserQuestion はどの権限モードでも自動では通りません。許可の確認を飛ばすモード(bypassPermissions)でも、答えるのはあなたです。

機能の紹介は、こちらの記事にもまとめています。

出し方|頼み方に1文を足す

Claude が自分から出すとき

Claude は、決めることがあると判断すると、頼まなくても自分から質問を出すことがあります。

ただし、いつも出るとは限りません。

auto mode では止まりにくい

公式によると、auto mode(Claude が自分で判断して進めるモード)では、質問で止まらず進むよう促されます。

それでも、頼み方やスキルが質問を求めていれば、聞いてくれます。

1文で頼む

確実に聞いてほしいときは、頼み方の最後に1文を足します。

AskUserQuestion で、決めることを選択肢つきで聞いてから進めて。

頼みごとの文の最後に「AskUserQuestion で聞いて」の1文を足すと、Claude が選択肢の質問を出し、選んだ答えで作業を進める、という流れの図

X では、しらすさんが要件を決めるときに似た1文を最後に足し、選択式で詰められて楽だと書いています(2026年5月13日)。

Claude Code チームの Thariq さんも、大きな機能を作るときの好きなやり方として、こう書いています。

Thariq@trq212

start with a minimal spec or prompt and ask Claude to interview you using the AskUserQuestionTool

X で見る

短い仕様か頼み方から始めて、AskUserQuestion で自分に聞き取りをさせる、という意味です。投稿では、そのあと新しいセッションで仕様を実行するとも書いています。

選択肢に良い点と弱い点を書かせる

選択肢が「する/しない」だけだと、選ぶ材料がありません。

選択肢ごとに、良い点と弱い点を書いてもらうと、比べやすくなります。

ふぇね | 山中裕貴@0xfene

プロンプトに「選択肢にはトレードオフを必ず明記してください」と入れるだけで、質問の質が一気に上がります。

X で見る
AskUserQuestion で聞いて。選択肢には、それぞれの良い点と弱い点を1行で書いて。おすすめには印を付けて。

毎回聞いてほしいならCLAUDE.mdに書く

毎回1文を打つのが面倒なら、CLAUDE.md(Claude が毎回読む決まりのファイル)に書いておきます。

書き方

  1. CLAUDE.md を開く

    Code タブで「CLAUDE.md に聞き方の決まりを足したい」と頼むと、Claude に足してもらえます。

  2. 聞き方の決まりを3行足す

    下のコピー欄をそのまま使えます。

  3. 新しいセッションで試す

    決めることがある頼みごとをして、選択肢の質問が出るかを見ます。

## 確認の聞き方
- 判断を求めるときは AskUserQuestion を使う
- 選ぶ案の中身は、質問の手前の本文に表で示す。質問の枠は短くし、選択肢の説明は1行にする
- 選択肢には、それぞれの良い点と弱い点を書き、おすすめに印を付ける

CLAUDE.md に聞き方の決まりを3行書いておくと、毎回の頼み方に1文を足さなくても、決める場面で選択肢の質問が出やすくなる、という図

私の CLAUDE.md にも、判断を求めるときは AskUserQuestion を使う、と書いています。

書いておいても、毎回必ず出るとは限りません。出なかったときは、頼み方に1文を足します。

CLAUDE.md そのものの書き方は、こちらにまとめています。

スキルの中で聞かせる

決まった作業の手順書(スキル)にも、聞く場所を書けます。

記事づくりの手順書には「各小工程の終わりで AskUserQuestion で止まる」と書いています。

手順のどこで止まって聞くかを書いておくと、作業のたびに頼み直さずに済みます。

答え方は3つ|選ぶ・書く・メモする

公式では、答え方は3つです。

答え方は3つ。選択肢を押して選ぶ、「その他」に自分の言葉で書く、メモの欄に補足を書く、という図

  1. 選択肢を押して選ぶ
  2. 「その他」の行に、自分の言葉で書く
  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日の時点で確かめていません。

質問が出て、設定の時間の残り20秒でカウントダウンが出て、時間に達するとそれまでに選んだ答えだけを送る、という時間の流れの図

時間が来ると、それまでに選んだ答えだけを送り、「離席中かもしれない」と Claude に伝えます。Claude は自分の判断で進み、あとで聞き直すこともあります。

最後の20秒はカウントダウンが出ます。何かキーを押すと、時計は最初に戻ります。

時計が止まる場面

次のときは、設定していても時計が動かず、答えるまで待ちます。

  • バックグラウンドのセッション
  • 画面の読み上げのモード
  • リモートコントロールでつないでいる間

また、ターミナルのウィンドウが手前にある(選ばれている)と伝わっている間も、時計は進みません。

「実行してよいですか」の許可の確認と、計画の承認は、待ち時間の設定があっても自動では閉じません。待ち時間で閉じるのは、AskUserQuestion の選択肢の質問だけです。

出ない・使えない場面

初心者

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

芝田

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

AskUserQuestion が使える場面と使えない場面の早見。使えるのは本体の会話。使えないのはふつうのサブエージェント、答える人がいない自動の実行、dontAsk モード

ふつうのサブエージェントからは使えない

サブエージェント(作業を手分けする別の 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 が止まる場所。キーワード、読者、タイトル、見出し、レビューの各段階で選択肢の質問が出て、選んでから次へ進む流れの図

著者の意見

AskUserQuestion は、とても重宝しています。良いところは、頼み方を考えずに済むこと、選ぶだけで決まること、勝手に進まないこと、スマホから答えられることの4つです。

私にとって、いちばんの神機能も AskUserQuestion と CLAUDE.md です。選択肢が出ない環境では、AIが提案してくれる最大限を活かせないと感じています。

選択肢の質問で楽になった4つ。頼み方を考えずに済む、選ぶだけで決まる、勝手に進まない、スマホから答えられる

案が見えなかったときの直し方

一度、選ぶ案が見えずに困ったことがあります。

質問の手前の本文に書いた案が、私の画面には出ませんでした。選択肢のプレビュー欄に書いた見出しも、出ませんでした(2026年10月10日)。

そこで案を全部、質問の枠に書いてもらいました。今度は枠が文章で埋まって、読みにくくなりました。

今は、案の中身を質問の手前の本文に表で置き、質問の枠は短い1文と札、1行の説明だけにしています。

案の中身は質問の手前の本文に表で置き、質問の枠には短い1文と札と1行の説明だけを置く。説明の1行は、本文が見えない端末向けの保険になる、という図

説明の1行は、本文が見えない端末向けの保険です。札と説明だけでも、何を選ぶのかが分かるように書いてもらいます。

質問機能を Codex と比べた話は、こちらに書いています。

よくある質問

許可の確認とは何が違いますか?

許可の確認は「操作してよいか」を、AskUserQuestion は「どの案で進めるか」を聞きます。

待ち時間の設定で自動で閉じるのも、AskUserQuestion の質問だけです。

質問させないようにできますか?

いちばん手軽なのは、頼み方に「質問せずに、迷ったらおすすめの案で進めて」と書くことです。

AskUserQuestion そのものを外すなら、許可の設定の deny にツールの名前だけを書く方法が公式の決まりにあります。AskUserQuestion に当てはめたときの動きは、この記事では確かめていません。

質問の画面が出ずに、空の答えで進んでしまいました。

GitHub では、2026年2〜4月の版で、質問の画面が出ずに空の答えで進む不具合が報告されています(10月31日の時点で、報告は閉じられていません)。

起きたら、答えたい内容をふつうのメッセージで送り、もう一度聞き直してもらいます。

スマホからも答えられますか?

リモートコントロールでつないでいる間も、質問は答えるまで開いたままです。

ただ、端末によっては、質問の手前の本文が見えないことがあります。スマホで答える日は、案の中身も質問文に書いてもらうと迷いません。

まとめ

  • 出すなら、頼み方の最後に「AskUserQuestion で聞いて」の1文
  • 毎回なら、CLAUDE.md に聞き方の決まりを3行。選択肢には良い点と弱い点を書いてもらう
  • 既定では答えるまで待つ。ふつうのサブエージェントと、答える人がいない自動の実行では使えないので、聞かずに進める条件を書く

参考資料・出典

確かめた日:2026年10月31日

公式資料

利用者の実践と報告

企業・事業者のかたへ

自社の業務に AI エージェントを取り入れたい企業・事業者のかた向けに、無料の AI 業務診断を行っています。

無料のAI業務診断を申し込む

個人で学びたいかたへ

Claude Code を自分の仕事で使えるようになるまで、1対1で伴走します。

個別伴走の申込ページへ

この記事を書いた人

芝田拓望のイラスト芝田拓望DevAIse 代表

DevAIse(ディバイズ)代表。毎日5〜15時間、Claude Code と Codex を使い、記事づくり・情報の整理・毎朝のまとめを AI の仕組みにしています。コードを書かずに作ってきたやり方を、1対1の個別伴走でもお伝えしています。

著者ページへ

関連記事

URL をコピーしました