# --allowedTools Flag

> It lists tools that run without asking you first.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** claude --allowedTools, --allowed-tools

## Think of it like

It is like a list of games you may play. You do not have to ask first.

## Definition

--allowedTools lists tools that run without asking you first. Each entry is a permission rule, such as Read or "Bash(git log *)". Tools you leave off still exist, they just ask before they run. To take a tool away, use --tools or --disallowedTools. --allowed-tools is the same flag.

## Example

Jack's CI job only needs git log and file reads. He lists just those in --allowedTools, so the job never stops to ask about them.

## Example code

```bash
claude -p "Show what changed" --allowedTools "Bash(git log *)" "Bash(git diff *)" "Read"
```

Let git log, git diff and Read run with no prompt.

## Why it matters

A run with no one watching cannot answer a prompt. The allow list keeps it moving.

## Common mistake

Using it to limit Claude to those tools. Others are still there and can ask. Use --tools to remove them.

## Three principles

- **Runs without asking.** Just these.
- **Permission rules.** Read, Bash(git log *).
- **Others still exist.** They ask.

## Related terms

- [Permission Rule](https://learn.benibix.com/term/ai/permission-rule)
- [--tools Flag](https://learn.benibix.com/term/ai/tools-flag)
- [--disallowedTools Flag](https://learn.benibix.com/term/ai/disallowed-tools-flag)
- [Claude Code Built-in Tool](https://learn.benibix.com/term/ai/claude-code-built-in-tool)

## Told apart from

- [--tools vs --allowedTools](https://learn.benibix.com/compare/tools-flag-vs-allowed-tools-flag): People think --allowedTools limits Claude to the tools it lists. It does not. --allowedTools only says which tools may run without asking you first. Every other tool is still there and can ask. --tools is the one that decides which built-in tools exist at all, and anything it leaves out is gone. To lock a session down, use --tools. To stop it asking about safe tools, use --allowedTools.

## Taught in

- [Tool and Settings Flags](https://learn.benibix.com/learn/ai-claude-code-commands/tool-and-settings-flags): Claude Code Commands, 15/17

![--tools sets which tools exist, --allowedTools which skip asking, --disallowedTools which go.](https://learn.benibix.com/diagrams/flag-tools.svg)

---

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