Claude Code asking with AskUserQuestion which build to ship, next to a Notifex batch question on an iPhone.

AskUserQuestion is the Claude Code tool that asks you multiple-choice questions in the terminal. It waits until you answer. There are three ways to answer it from your phone. Use Remote Control in the Claude app, or a PreToolUse hook that answers through your own UI. Or tell Claude to ask through an MCP tool such as Notifex instead.

This post explains how AskUserQuestion behaves, what each route needs, and which one fits how you work. Claude Code facts come from Anthropic's docs, read 2026-11-19.

What is AskUserQuestion in Claude Code?

The Claude Code tools reference describes it as the tool Claude uses to ask you multiple-choice questions when it needs a decision or a clarification. You answer by picking an option, or you type your own text in the Other row or the notes field.

The Agent SDK guide to user input gives the shape. Each call carries one to four questions. Each question has a short header of up to 12 characters, two to four options with a label and a description, and a multiSelect flag. The same guide notes that AskUserQuestion is not available in subagents spawned with the Agent tool.

Claude Code asking with AskUserQuestion which build to ship, 413 from main or 412 from the release branch, with tabs for Build and Target and a Type something row.
AskUserQuestion in Claude Code 2.1.328 in a terminal on a Mac, demo project, captured 2026-11-19.

What happens if you are not at the terminal?

The question stays open. By default, Claude Code waits as long as it takes. You can change that with the askUserQuestionTimeout setting: 60s, 5m or 10m. When the time runs out, the dialog submits any options you had already selected. It tells Claude you may be away, and Claude carries on with its own judgment.

The timer does not start for a question asked in a background session, in screen reader mode, or while the session is connected to Remote Control. Those questions wait for you. The timeout also never applies to permission prompts.

So without a phone route, an unanswered question means one of two things. The run stops until you come back, or Claude decides without you after the timeout.

The Claude Code tools reference page on AskUserQuestion tool behavior and the question auto-continue timeout.
Claude Code tools reference at code.claude.com, captured 2026-11-19. Apps and logos belong to their owners.

Route 1: Can Remote Control send AskUserQuestion to your phone?

Yes. Remote Control connects the Claude app on iOS or Android, or claude.ai/code, to the session running on your machine. Run /config and turn on Push when actions required. Anthropic's docs say it covers permission prompts and questions.

Check the requirements first. Remote Control works on Pro, Max, Ultra, Team and Enterprise plans, and API keys are not supported. On Team and Enterprise an Owner turns it on. The claude process must keep running on your machine. Claude Code also skips the push while you are typing in or focused on the connected terminal.

Remote Control gives you the whole session on the phone, not only the question. That is its strength. We compare it in detail in Claude Code Remote Control vs asking you over MCP.

Route 2: Can a hook answer AskUserQuestion?

Yes, with your own plumbing. The hooks reference says a PreToolUse hook can match AskUserQuestion, collect the answer through your own UI, and return permissionDecision: "allow" with an updatedInput. That input echoes the questions and adds an answers object, keyed by question text. Returning allow alone is not enough for this tool.

The hard part is the middle step. The hook has to send the questions to your phone, wait for a reply, and read it back. That is a small service you build and run yourself. It suits teams that already have an approval system to plug in. If you would rather buy hook-based approvals than build them, see Notifex vs Pushary for tool call approvals.

Route 3: How does Claude ask you through an MCP tool instead?

Give Claude a second way to ask, and tell it when to use it. Notifex is a remote MCP server for this. Claude calls ask_questions with the same kind of choices, your phone gets one push, and the call waits until you answer. The answers return to Claude as the tool result.

  1. Install Notifex on your iPhone or Android device. It is free on both stores.
  2. Create a project and copy its secret key. It is shown once.
  3. Add the server with the command below, using your key.
  4. Run /mcp and check that notifex is connected.
  5. Add a rule to CLAUDE.md, such as the line after the command.

claude mcp add --transport http notifex https://mcp.notifexapp.com/mcp \
--header "Authorization: Bearer <YOUR_API_KEY>"

A rule that works: "For deploys, migrations and design choices, ask me with Notifex instead of AskUserQuestion, and wait." The Claude Code setup page has the same entry as JSON for .mcp.json.

One Claude Code detail helps here. Its MCP docs say an MCP call that runs longer than two minutes moves to a background task, so you can keep using the session while the question waits. If a call ever drops, the question stays open, and wait_for_answer picks it up again.

AskUserQuestion vs Notifex ask_questions (Claude Code docs and Notifex server code, checked 2026-11-19)
AskUserQuestionNotifex ask_questions
Questions per call1 to 4Up to 10 in one push
Options per question2 to 4, plus your own textUp to 20, or free text, plus your own text
Where you answerThe terminal, or the Claude app with Remote ControlThe Notifex app on iPhone or Android
Who can answerYou, in that sessionAny member of the project; the first answer wins
Files with the questionText options; the Agent SDK can add option previewsImages, video or PDFs the agent uploads
Works in other clientsClaude Code and the Agent SDKAny MCP client, such as Codex, Cursor or ChatGPT
Two iPhone screens: a Notifex question shown as 1 of 3 in a batch with two options, and the same question with a field to type an answer.
Notifex on an iPhone 17 Pro simulator with demo fixture data, captured October 2026.

Which route should you pick?

  • You want to steer the whole session from your phone: Remote Control. It is Anthropic's own feature, needs no extra server, and handles permission prompts as well as questions. Where it fits, it is the better choice.
  • You already run an approval system: a PreToolUse hook that forwards AskUserQuestion to it.
  • You want only the decisions on your phone, from any MCP client: Notifex ask_questions. It also covers teammates who answer for you, and files the agent wants you to see.

You can mix them. Some people keep AskUserQuestion for quick choices while they sit at the desk, and a CLAUDE.md rule sends the important ones to Notifex when they step away. For other ways to reach your phone, see Claude Code on your phone. Notifex also connects to Cursor, Codex and ChatGPT, as listed on the setup page for other agents.

Quick answers

  • It is a built-in tool that asks you one to four multiple-choice questions in the terminal. You pick an option or type your own answer.

Give your agent someone to ask

Free on the App Store and Google Play. Then add one MCP entry and let your agent ask.

Download on the App StoreGet it on Google Play