Follow Discord
Sweep 22 Oct 2026 · 21:04Z Build v2.1.309 528 read Stable v2.1.308 Latest v2.1.309 Next v2.1.309 Feeds RSS JSON llms.txt llms-full.txt Unofficial
HomeDocsSearch
Search the documentation

34 pages for askuserquestion.

Titles and paths first, then pages whose text carries it. Each row opens that page as this site last read it.

Plugins Claude Developer Platform · in the page api/beta/organization/plugins …tools` with any value other than an empty one or one that names only `AskUserQuestion`, `TodoWrite`, and `ToolSearch`). Otherwise it is `contained`. If the frontmatter of a skill, command, or oth… Create Plugin Claude Developer Platform · in the page api/beta/organization/plugins/create …tools` with any value other than an empty one or one that names only `AskUserQuestion`, `TodoWrite`, and `ToolSearch`). Otherwise it is `contained`. If the frontmatter of a skill, command, or oth… List Plugins Claude Developer Platform · in the page api/beta/organization/plugins/list …tools` with any value other than an empty one or one that names only `AskUserQuestion`, `TodoWrite`, and `ToolSearch`). Otherwise it is `contained`. If the frontmatter of a skill, command, or oth… Get Plugin Claude Developer Platform · in the page api/beta/organization/plugins/retrieve …tools` with any value other than an empty one or one that names only `AskUserQuestion`, `TodoWrite`, and `ToolSearch`). Otherwise it is `contained`. If the frontmatter of a skill, command, or oth… Update Plugin Claude Developer Platform · in the page api/beta/organization/plugins/update …tools` with any value other than an empty one or one that names only `AskUserQuestion`, `TodoWrite`, and `ToolSearch`). Otherwise it is `contained`. If the frontmatter of a skill, command, or oth… How the agent loop works Claude Code CLI · in the page agent-sdk/agent-loop …of preloading all of them | | **Orchestration** | `Agent`, `Skill`, `AskUserQuestion`, `TaskCreate`, `TaskUpdate` | Spawn subagents, invoke skills, ask the user, track tasks | On the [models that do… Configure permissions Claude Code CLI · in the page agent-sdk/permissions …ons` mode. Tools that require user interaction behave the same way: `AskUserQuestion` and MCP tools whose server sets [`_meta["anthropic/requiresUserInteraction"]`](/docs/en/mcp#require-approval-for-… Agent SDK reference - Python Claude Code CLI · in the page agent-sdk/python …ython SDK v0.2.162 or later, which bundles Claude Code v2.1.285. ### AskUserQuestion **Tool name:** `AskUserQuestion` Asks the user clarifying questions during execution. See [Handle approvals and… Work with sessions Claude Code CLI · in the page agent-sdk/sessions …already takes as many turns as it needs, and permission prompts and `AskUserQuestion` are [handled in-loop](/docs/en/agent-sdk/user-input.md) (they don't end the call). | What you're building | What… Agent SDK reference - TypeScript Claude Code CLI · in the page agent-sdk/typescript …t-in tool behavior. ```typescript theme={null} type ToolConfig = { askUserQuestion?: { previewFormat?: "markdown" | "html"; }; }; ``` | Field | Type | Description | | :- | :- | :- | | `askUs… Handle approvals and user input Claude Code CLI · in the page agent-sdk/user-input …running commands), and when it has **clarifying questions** (via the `AskUserQuestion` tool). Both trigger your `canUseTool` callback, which pauses execution until you return a response. This is diffe… Best practices for Claude Code Claude Code CLI · in the page best-practices …tart with a minimal prompt and ask Claude to interview you using the `AskUserQuestion` tool. Claude asks about things you might not have considered yet, including technical implementation, UI/UX, edg… Claude Code changelog Claude Code CLI · in the page changelog …after Escape on a slow or busy machine * Fixed Esc discarding a typed AskUserQuestion answer in vim mode: the free-text field now supports vim NORMAL mode, and Esc cancels only from NORMAL * Fixed the… Environment variables Claude Code CLI · in the page env-vars …fore auto-continue the on-screen countdown appears on an unanswered [`AskUserQuestion`](/docs/en/tools-reference) dialog. Default `20000` (20 seconds), capped at the auto-continue timeout. Has no effe… Run Claude Code programmatically Claude Code CLI · in the page headless …your `--allowedTools` entries or `permissions.allow` rules also run. `AskUserQuestion`, connector tools [your organization set to `ask`](/docs/en/mcp#organization-controls-on-connector-tools), MCP too… Hooks reference Claude Code CLI · in the page hooks …Read`, `Glob`, `Grep`, `Agent`, `Workflow`, `WebFetch`, `WebSearch`, `AskUserQuestion`, and `ExitPlanMode`, and any [MCP tool names](#match-mcp-tools). To run a hook when a specific file changes on d… Interactive mode Claude Code CLI · in the page interactive-mode …e `Other` row of a [question Claude asks](/docs/en/tools-reference.md#askuserquestion-tool-behavior), press `Esc` twice to cancel the question. To cancel with a single key press instead, [bind anothe… Monitoring Claude Code CLI · in the page monitoring-usage …l` tool approved at a prompt only a `PreToolUse` hook required * An [`AskUserQuestion`](/docs/en/tools-reference#askuserquestion-tool-behavior) or `ExitPlanMode` call, declined or not ##### Prompts w… Choose a permission mode Claude Code CLI · in the page permission-modes …ches Claude Code * Tools that require user interaction: the built-in `AskUserQuestion` tool and MCP tools marked [`requiresUserInteraction`](/docs/en/mcp#require-approval-for-a-specific-tool) * Recogn… Configure permissions Claude Code CLI · in the page permissions …tools pre-approved via `/permissions` or `permissions.allow` rules. `AskUserQuestion`, MCP tools marked [`requiresUserInteraction`](/docs/en/mcp#require-approval-for-a-specific-tool), [reads from net… Test plugins with evals Claude Code CLI · in the page plugin-evals …llowed_tools`, from `Read`, `Glob`, `Grep`, `NotebookRead`, `Skill`, `AskUserQuestion`, `Agent`, `TodoWrite`, and the task tools `TaskCreate`, `TaskGet`, `TaskList`, `TaskUpdate`, and `TaskStop`, plus… Manage mods for your organization Claude Code CLI · in the page plugins/mods/admin …ach row of the conversation before it's stored. [`ui.render{component=AskUserQuestion}`](/docs/en/plugins/mods/interface#change-what-claude-code-already-draws) means the mod can redraw the dialog Clau… Draw in the interface with a mod Claude Code CLI · in the page plugins/mods/interface …d group of calls | | `CommandOutput` | The row a command printed | | `AskUserQuestion` | The dialog Claude opens to ask you a question | | `Spinner`, `ToolProgress`, `TurnDuration` | Status lines for… Mods reference Claude Code CLI · in the page plugins/mods/reference …utput` | `command`, `text` | The message id | Terminal, Desktop | | [`AskUserQuestion`](/docs/en/plugins/mods/interface#change-what-claude-code-already-draws) | The question and options | The tool cal… Test a mod Claude Code CLI · in the page plugins/mods/test …A `tool.call` stub, because the question reaches it as a call to the `AskUserQuestion` tool: `($, e) => ({ result: { answers: { [e.questions[0].question]: 'Run it' } } })`. Check `e.tool` first if you… Troubleshoot a mod Claude Code CLI · in the page plugins/mods/troubleshoot …ing stays off. For example, the question ends that way when you set [`askUserQuestionTimeout`](/docs/en/settings-reference#askuserquestiontimeout) and the time passes before you answer. That setting a… Continue local sessions from any device with Remote Control Claude Code CLI · in the page remote-control …Forwarded dialogs expire**: Claude Code keeps permission prompts and `AskUserQuestion` questions open until you answer them. When Claude Code forwards another kind of dialog to the remote session, suc… Claude Code settings Claude Code CLI · in the page settings …| | `askUserQuestionTimeout` | **Default**: `"never"`. Idle time before an unanswered [`AskUserQuestion`](/docs/en/tools-refe… All settings Claude Code CLI · in the page settings-reference …with your own command | Authentication and providers | Any file | | [`askUserQuestionTimeout`](#askuserquestiontimeout) | Let an unanswered question [auto-continue](/docs/en/tools-reference.md#questio… Extend Claude with skills Claude Code CLI · in the page skills …for autonomous skills that should never call certain tools, such as `AskUserQuestion` for a background loop. Accepts a space- or comma-separated string, or a YAML list. The restriction clears when yo… Create custom subagents Claude Code CLI · in the page sub-agents …on) the tool stays listed but returns an error instead of spawning * `AskUserQuestion` * `EndConversation`, which can end only the main conversation; see [EndConversation tool behavior](/docs/en/tools… Tools reference Claude Code CLI · in the page tools-reference …on; see [Availability](/docs/en/artifacts.md#availability) | Yes | | `AskUserQuestion` | Asks multiple-choice questions to gather requirements or clarify ambiguity. Questions stay open until you answe… Week 27 · June 29 – July 3, 2026 Claude Code CLI · in the page whats-new/2026-w27 …l-b do XYZ` now load all leading skills (up to 5), not only the first`AskUserQuestion` dialogs no longer auto-continue by default; opt into an idle timeout via `/config`The "default" permission mode i… Chat in Claude Desktop on 3P Claude Documentation · in the page third-party/claude-desktop/chat …ions | Claude can present multiple-choice questions to the user (the `AskUserQuestion` tool). | | Plugin skills and hooks | Skills from the plugins you provision through [organization plugins](/docs/t…
Feedback