# Read-mutate permission split

> Claude Code ships 46 built-in tools; only 14 ask for permission. Reads (Read, Grep, Glob) run freely in the working directory; mutations and external calls (Bash, Edit, Write) ask.

URL: https://bartlomiejkrupa.dev/notes/read-mutate-permission-split/
Category: concept | Updated: 2026-10-07
Summary: Claude Code ships 46 built-in tools; only 14 ask for permission. Reads (Read, Grep, Glob) run freely in the working directory; mutations and external calls (Bash, Edit, Write) ask.

The everyday design of Claude Code's tool surface: **reads run freely; mutations ask**. As of October 2026 there are 46 built-in tools; 14 ask for permission. Read-only tools still prompt for paths outside the working directory, and on macOS, Linux, and WSL Glob and Grep are left out by default in favor of `find` and `grep` through Bash.

| Tool | What it does | Asks |
| --- | --- | --- |
| `Read` / `Glob` / `Grep` / `LSP` | Inspect the codebase | No |
| `Agent` | Spawn a subagent in its own context | No (subagent's tools still checked) |
| `Edit` / `Write` / `NotebookEdit` | Change files | Yes |
| `Bash` / `PowerShell` / `Monitor` | Run / watch commands | Yes |
| `WebFetch` / `WebSearch` | Reach the network | Yes |
| `Skill` / `ExitPlanMode` | Execute skill / leave plan mode | Yes |

## Behaviors that bite

- **Edit enforces read-before-edit** - Claude must have read the file in this conversation; `old_string` must match exactly once (or `replace_all`). Viewing via `cat`/`head` counts; piped output does not.
- **Bash is stateless between commands** - `export` does not survive; 2-minute default timeout; 30k characters of output before spill to a file.
- **WebFetch is lossy** - a separate model call answers Claude's extraction prompt; "doesn't mention X" may mean the prompt did not ask.
- **Grep respects `.gitignore`; Glob does not by default.**

Restrict further with [permission rules](/notes/permission-rules-block) and the [sandbox ladder](/notes/sandbox-ladder). Full map: [Claude Code tools](/articles/claude-code-tools).

Sources:
- Tools reference: https://code.claude.com/docs/en/tools-reference
- Configure permissions: https://code.claude.com/docs/en/permissions
