它到底是什么

--bare 是 Claude Code CLI 的精简（最小化）模式 flag。开启后，Claude Code 会跳过对 hooks、skills、custom commands、subagents、plugins、MCP servers、auto memory、CLAUDE.md 的自动发现，目的是让脚本化调用（尤其是配合 -p）启动更快。

默认情况下（不带 --bare），-p 会像交互式会话一样加载完整上下文，包括工作目录或 ~/.claude 中配置的一切。开启 --bare 后，Claude 仍可使用 Bash、文件读取（Read）、文件编辑（Edit）三个内置工具。通过 --add-dir 传入的目录是部分例外：该目录下 .claude/skills/ 里的 skills 仍会加载，但 .claude/commands/ 和 .claude/agents/ 依旧被跳过。

官方文档明确标注：

--bare is the recommended mode for scripted and SDK calls, and will become the default for -p in a future release.

也就是说，目前仍需手动指定 --bare，官方计划未来将其设为 -p 的默认行为（尚未成为默认）。

用法

claude --bare -p "query"

官方示例（预先批准 Read 工具，避免弹出权限提示，并需要在环境中设置 ANTHROPIC_API_KEY）：

claude --bare -p "Summarize README.md" --allowedTools "Read"

与其他 flag 的组合 / 互斥

--bare 主要与 -p（--print）搭配使用，用于 CI 和脚本场景。由于它会跳过 MCP servers、plugins、CLAUDE.md 等自动加载，若仍需要这些上下文，需显式通过对应 flag 补充：

运行约束 / 限制

经典使用场景

官方文档指出该模式 "useful for CI and scripts where you need the same result on every machine"：不带 --bare 时，队友 ~/.claude 里的 hook、项目 .mcp.json 里的 MCP server 都可能在不同机器上产生不同结果；--bare 完全不读取这些内容，从而保证可复现性。官方也建议脚本化 / SDK 调用优先使用该模式。

常见坑

• 不加 --bare 时 -p 也会静默加载陌生仓库的内容：官方文档强调，没有 --bare，claude -p 不会弹出 workspace trust 对话框，也没有逐个 MCP server 的审批提示——即便在从未信任过的文件夹里运行也是如此。这意味着队友 .claude/settings.json 里的 hook、项目 .mcp.json 里的 MCP server 都会被静默执行 / 连接，容易造成误解为"-p 更安全"。
• bare 模式不会自动使用订阅登录：忘记设置 ANTHROPIC_API_KEY（或 apiKeyHelper）会导致鉴权失败，因为 bare 模式完全不读取 OAuth 凭证或 keychain。
• --add-dir 的加载是不完整的例外：容易误以为 --add-dir 传入的目录会把该目录下的 commands/agents 也一并加载，但官方文档明确只有 .claude/skills/ 会加载，.claude/commands/ 和 .claude/agents/ 依然被跳过。

来源

• CLI reference
• Run Claude Code programmatically（headless）— Start faster with bare mode