tools vs allowedTools
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.
tools Option
The option that sets which built-in tools are there at all.
tools is the Agent SDK option that sets which built-in tools exist in a session. You pass a list of tool names, or the claude_code preset for Claude Code's full set. A tool left out is gone, so Claude never sees it. An empty list removes every built-in tool, which leaves only your MCP tools. It decides what exists, not what runs without asking.
allowedTools Option
The option that lists tools the agent may use with no prompt.
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.
In one line
- tools Option
- The option that sets which built-in tools are there at all.
- allowedTools Option
- The option that lists tools the agent may use with no prompt.