# allowedTools Option

> The option that lists tools the agent may use with no prompt.

**Field:** Artificial Intelligence  
**Category:** Claude Agent SDK  
**Also known as:** allowedTools, allowed_tools, Agent SDK allowed tools, Claude Agent SDK allowedTools

## Think of it like

It is like a list of toys a kid may take and not ask.

## Definition

allowedTools is an Agent SDK option that lists tools Claude may use with no approval step. In Python it is allowed_tools. A rule can name a whole tool, such as Read, or part of one, such as Bash(npm *). It does not limit Claude to those tools. A call to a tool not on the list goes to the permission mode instead.

## Example

Leo's agent reads code and runs tests. He allows Read, Glob and Bash(npm test), so it never stops to ask for those.

## Example code

```typescript
allowedTools: ["Read", "Glob", "Bash(npm test)"]
```

Let these run with no approval.

## Why it matters

An agent that stops for each read is slow. One that asks for nothing is a risk.

## Common mistake

Thinking it blocks every tool not on the list. It does not. Use disallowedTools to block.

## Three principles

- **Pre-approves tools.** No prompt.
- **Not a full list.** Others still exist.
- **Scoped rules work.** Bash(npm *).

## Related terms

- [disallowedTools Option](https://learn.benibix.com/term/ai/disallowed-tools-option)
- [permissionMode Option](https://learn.benibix.com/term/ai/permission-mode-option)
- [canUseTool Callback](https://learn.benibix.com/term/ai/can-use-tool-callback)
- [Permission Rule](https://learn.benibix.com/term/ai/permission-rule)

## Told apart from

- [allowedTools vs disallowedTools](https://learn.benibix.com/compare/allowed-tools-option-vs-disallowed-tools-option): People think allowedTools is a full list, so a tool left off it is blocked. It is not. allowedTools only lets the listed tools run with no prompt, and other tools still go to the permission mode. disallowedTools is the one that blocks, and its block holds in every mode, even bypass.
- [tools vs allowedTools](https://learn.benibix.com/compare/tools-option-vs-allowed-tools-option): People think tools and allowedTools do the same job. tools decides which built-in tools exist, so a tool left out is never seen by Claude. allowedTools decides which of the tools that exist run without asking. Use tools to shrink the toolbox, and allowedTools to skip the prompt.

---

Source: https://learn.benibix.com/term/ai/allowed-tools-option
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-20
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
