# AskUserQuestion Tool

> The tool Claude uses to ask you a question with choices.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** AskUserQuestion, askUserQuestionTimeout

## Think of it like

It is like being asked: do you want soup or salad?

## Definition

The AskUserQuestion tool lets Claude ask you a question with a few choices to pick from. Claude uses it when it needs a decision before it can go on. You pick an option, or type your own answer in the Other row. A question stays open until you answer it. The askUserQuestionTimeout setting can close it after 60 seconds, 5 minutes or 10 minutes, so Claude goes on without you.

## Example

Jack asks for a login page. Claude asks whether he wants email links or passwords, and builds the one he picks.

## Example code

```json
{"askUserQuestionTimeout": "5m"}
```

Close a question no one answers after five minutes.

## Why it matters

A quick choice up front saves building the wrong thing.

## Common mistake

Leaving a long job running and walking away. It may wait on a question all night unless you set a timeout.

## Three principles

- **A few choices.** Or your own answer.
- **Waits for you.** By default.
- **A timeout.** Lets Claude go on.

## Related terms

- [Human-in-the-Loop](https://learn.benibix.com/term/ai/human-in-the-loop)
- [Plan Mode Tools](https://learn.benibix.com/term/ai/plan-mode-tools)
- [Claude Code Session](https://learn.benibix.com/term/ai/claude-code-session)

## Taught in

- [Claude Code Session Tools](https://learn.benibix.com/learn/ai-claude-code/claude-code-session-tools): Claude Code, 11/16

![Tools that steer the session: ask a question, switch to plan mode, enter a worktree, run a skill, keep a task list.](https://learn.benibix.com/diagrams/ct-session-tools.svg)

---

Source: https://learn.benibix.com/term/ai/ask-user-question-tool
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
