它到底是什么

--tools 是 Claude Code CLI 的启动 flag，用来限制本次会话可见、可用的内置工具集合。官方 CLI Reference 原文对它的描述是：

Restrict which built-in tools Claude can use. Use "" to disable all, "default" for the default set, or tool names like "Bash,Edit,Read".

关键点：它接受三种取值——

• ""：禁用全部内置工具。
• "default"：使用默认工具集。
• 工具名列表：如 "Bash,Edit,Read"，只启用列出的内置工具。

它与 --allowedTools 的本质区别在于：--tools 决定"这个会话里 Claude 能不能看到、用到这个工具"（可用性层面）；--allowedTools 决定"用到这个工具时要不要弹出权限确认"（权限提示层面）。两者可以同时使用。

用法

claude --tools "Bash,Edit,Read"

这是 CLI Reference 表格中给出的官方示例写法——多个工具名写在同一个带引号的字符串里，以逗号分隔。

官方另一处文档（Restricted mode 章节）给出的示例是逗号写在同一个引号字符串内：

claude --tools "Bash,Read,Edit"

实际使用时，按 CLI Reference 表格的写法，把工具名用逗号写在同一个引号字符串内即可。

目前没有查到与 --tools 直接对应的环境变量，也没有查到与之对应的 settings.json 字段。

与其他 flag 的组合 / 互斥

• 与 --allowedTools 职责不同：官方在 --allowedTools 一行说明"要限制可用工具，请改用 --tools"——--tools 圈定可用范围，--allowedTools 决定哪些工具免提示。
• 和 --restricted 组合：--restricted 模式会移除运行命令/代码类的内置工具（以及 WebFetch 等）；要把某个被移除的工具找回来，需要在 --tools 里把它和其他想保留的工具一起列出——因为 --tools 是替换式的白名单，不是增量添加，漏列的工具不会自动保留。
• 和 --disallowedTools / permission 的 deny 规则没有直接互斥，但都能影响同一批工具的可用性。

在 settings.json / env 的等价配置

运行约束 / 限制

经典使用场景

• 在非默认模型上启用 Task 追踪工具：官方文档把"把这些工具列进 --tools，和你要用的其他内置工具放在一起"列为三种开启方式之一（另两种是设置 CLAUDE_CODE_ENABLE_TODO_TOOLS=1，或在 --allowedTools 中点名其一）。
• --restricted 模式下按需找回被移除的工具：--restricted 会剥离运行命令/代码的工具以及 WebFetch；需要哪个工具，就把它连同其余保留的工具一起写进 --tools，例如 --tools "Bash,Read,Edit"。
• 在 macOS/Linux/WSL 上把 Glob/Grep 显式加回工具集，而不是让 Claude 一律通过 Bash 里的 find/grep 间接搜索。

常见坑

• 和 --allowedTools 混淆：--allowedTools 只是跳过权限确认，并不缩小工具可见范围；真正把工具"从会话中拿掉"要用 --tools（或 --disallowedTools 做反向的拒绝）。
• --tools 是替换式白名单，不是增量叠加：一旦使用 --tools，会话工具集就变成"你列出的这些"，没列的默认工具（包括你可能没意识到会用到的工具）也会一并消失——这在 --restricted 场景下找回工具时尤其容易漏配。
• Glob/Grep 的恢复行为在 --tools 和 --allowedTools 下不对称：用 --tools 只拿到你点名的那一个，用 --allowedTools 点名其中一个则两个都会恢复；settings.json 里的 allow 规则则完全不触发这个恢复逻辑。

来源

• CLI reference - Claude Code Docs
• Tools reference - Claude Code Docs
• Choose a permission mode - Claude Code Docs
• Settings reference - Claude Code Docs