Search the documentation
22 pages for askuserquestion.
Titles and paths first, then pages whose text carries it. Each row opens that page as this site last read it.
How the agent loop works
Claude Code CLI · in the page
agent-sdk/agent-loop
…f preloading all of them | | **Orchestration** | `Agent`, `Skill`, `AskUserQuestion`, `TaskCreate`, `TaskUpdate` | Spawn subagents, invoke skills, ask the user, track tasks | On t…
Configure permissions
Claude Code CLI · in the page
agent-sdk/permissions
…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.136 or later, which bundles Claude Code v2.1.228. ### 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) (they don't end the call). | What you're building…
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…
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. </Tip> Claude asks about things you might not have considered yet, including technical implementation, UI/…
Claude Code changelog
Claude Code CLI · in the page
changelog
…errors after the OAuth token expired or rotated mid-session * Fixed AskUserQuestion telling Claude to continue even when your answer asked it to wait or explain first — free-text answers now get neu…
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
…ssions#read-only-commands), which is useful for locked-down CI runs. `AskUserQuestion`, connector tools [your organization set to `ask`](/docs/en/mcp#organization-controls-on-connector-tools), and MCP…
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…
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) * `rm` a…
Configure permissions
Claude Code CLI · in the page
permissions
…unless pre-approved via `/permissions` or `permissions.allow` rules. `AskUserQuestion`, MCP tools marked [`requiresUserInteraction`](/docs/en/mcp#require-approval-for-a-specific-tool), and connector t…
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…
Claude Code settings reference
Claude Code CLI · in the page
settings-reference
…| Authentication and providers | Any file | | [`askUserQuestionTimeout`](#askuserquestiontimeout) | Let an unanswered question [auto-c…
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
…| Yes | | `AskUserQuestion` | Asks multiple-choice questions to gather requirements or clarify ambiguity. Questions stay open until you…
Week 27 · June 29 – July 3, 2026
Claude Code CLI · in the page
whats-new/2026-w27
…all leading skills (up to 5), not only the first</div> <div><code>AskUserQuestion</code> dialogs no longer auto-continue by default; opt into an idle timeout via <code>/config</code></div> <di…
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).…
Configuration reference
Claude Documentation · in the page
third-party/claude-desktop/configuration
…`, `TaskGet`, `TaskList`, `TaskStop`, `Skill`, `REPL`, `JavaScript`, `AskUserQuestion`, `ToolSearch`, `SendUserMessage`) or an argument-scoped [permission rule](https://code.claude.com/docs/en/permiss…