Linux内核竞态条件解析：锁机制与调试工具实战
2026/10/8 8:45:34
- 文档
- 提示工程
- 人工智能
【免费下载链接】claude-code-system-prompts
All parts of Claude Code's system prompt, 27 builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, statusline, magic docs, WebFetch, Bash cmd, security review, agent creation). Updated for each Claude Code version.
项目地址：https://gitcode.com/gh_mirrors/cl/claude-code-system-prompts
本文基于 system-prompts/system-prompt-minimal-mode.md（Claude Code 主系统提示词中"Minimal mode"片段的原文）展开。Minimal mode 是 Claude Code 为需要可预测、可审计、零隐式行为的会话设计的精简运行模式：它批量跳过 hooks、LSP、插件同步、自动记忆等 8 类特性，强制要求通过 CLI 参数显式提供上下文。读完本文，你将掌握 minimal mode 的确切行为边界、认证凭据的读取规则，以及用
--system-prompt、--add-dir、--mcp-config、--settings、--agents、--plugin-dir等参数手工重建上下文的完整实战方案。
Minimal Mode 是什么：一次说清行为与约束
Minimal mode 是 Claude Code 主系统提示词（system-prompt-minimal-mode.md）中描述的一种会话运行模式。它的核心设计哲学是**"关掉一切默认行为，把上下文交给用户显式声明"**：凡是依赖环境探测、配置发现或后台任务的功能一律跳过，凡是需要的信息都必须通过命令行参数明确传入。这使它特别适合 CI/CD 流水线、自动化脚本、沙箱环境，以及对"每次运行行为完全一致"有硬性要求的场景——因为不会有意料之外的 hooks 拦截、插件注入或记忆干扰。
该片段在仓库 CHANGELOG.md 中被记录为 v2.1.81 版本新增（**NEW:** System Prompt: Minimal mode），并在 README.md 的 System Prompt 列表中标注为 285 tokens 的系统提示词片段，属于随每个 Claude Code 版本持续更新的官方行为定义。
被跳过的 8 类功能逐项拆解
原文档明确列出 minimal mode 会跳过的功能清单，逐一展开如下：
| 跳过的功能 | 行为含义 | 影响场景 |
|---|---|---|
| hooks（settings 与已安装插件中定义的） | 不执行任何用户配置或插件带来的 hook 命令 | 权限拦截、格式化钩子、日志钩子全部失效 |
| LSP | 不加载语言服务器协议能力 | 定义跳转、引用查找、符号检索等 IDE 级代码智能不可用 |
| plugin sync | 不做插件同步 | 插件新增/更新不会自动拉取 |
| attribution | 不进行出处标注 | 影响代码归属/引用追踪类功能 |
| auto-memory | 不执行自动记忆 | 不会自动读写记忆文件 |
| background prefetches | 不做后台预取 | 预取相关的内容加速机制被关闭 |
| keychain reads | 不读取系统钥匙串 | 凭据来源被严格限定（见下文认证规则） |
| CLAUDE.md auto-discovery | 不自动发现 CLAUDE.md | 项目记忆文件不再自动加载 |
其中 hooks 需要特别说明：原文档强调"features built into Claude Code are unaffected"——即内置于 Claude Code 自身的功能不受影响，跳过的只是 settings 文件和已安装插件中定义的外部 hooks。也就是说 minimal mode 关闭的是"用户/插件扩展层"的钩子，而不是 Claude Code 内置能力的钩子。关于 hooks 的完整结构（事件、类型、输入输出 JSON 字段）可参考仓库中的 system-prompt-hooks-configuration.md，其中列出了 PermissionRequest、PreToolUse、PostToolUse、Stop、SessionStart 等事件及 command/prompt/agent 三种 hook 类型——这些在 minimal mode 下若由外部配置定义，均不会生效。
CLAUDE_CODE_SIMPLE=1：最小模式的标记
minimal mode 会设置环境变量CLAUDE_CODE_SIMPLE=1。这是该模式生效的运行时标记：会话启动时即被置位，供 Claude Code 内部及第三方工具检测当前是否运行在精简模式下。从源码结构看，可以推断该变量是 minimal mode 与正常模式在进程环境层面的分界信号——任何依赖该变量判断运行环境的脚本、插件或诊断工具，都能据此识别出"当前会话跳过了 hooks/LSP/插件同步等特性"。
认证与凭据：只认 API Key，绝不读 OAuth 与钥匙串
Minimal mode 对 Anthropic 认证采用了最严格的约束：
- 严格限定两种凭据来源：
ANTHROPIC_API_KEY环境变量，或通过--settings传入的apiKeyHelper； - OAuth 与钥匙串永不读取：正常的 OAuth 登录流程和系统钥匙串（keychain）中的既有凭据在 minimal mode 下完全不会被触碰；
- 第三方 provider 不受影响：Bedrock、Vertex、Foundry 等第三方模型提供商使用各自的凭据体系，minimal mode 的认证约束只作用于 Anthropic 第一方认证路径。
这一设计的目的非常明确：可复现性与安全性。在自动化场景中，凭据来源必须唯一且可显式控制——只依赖环境变量或 settings 文件中的 apiKeyHelper，避免了隐式读取本机 OAuth 会话或钥匙串导致的行为漂移。
Skills 仍然可用：/skill-name 照常解析
被跳过的特性清单不包含 skills。文档明确写道：Skills still resolve via /skill-name。也就是说，在 minimal mode 下，通过/skill-name方式调用技能依然可用。这与仓库中大量技能文档（如 skill-claude-code-configuration-guide.md、skill-debugging.md 等）所描述的调用机制保持一致——skills 属于按需显式调用的能力，不依赖启动时的环境发现，因此与 minimal mode 的"显式优于隐式"哲学天然兼容。
显式提供上下文：6 类 CLI 参数实战
Minimal mode 关闭自动发现后，上下文必须通过 CLI 参数显式注入。原文档给出了完整的参数清单，逐一解析如下：
| 参数 | 作用 | 使用说明 |
|---|---|---|
--system-prompt[-file] | 设置主系统提示词 | 方括号表示两种形式均可：--system-prompt直接传字符串，--system-prompt-file从文件读取，用于整体替换或指定系统提示词 |
--append-system-prompt[-file] | 追加系统提示词 | 同样支持--append-system-prompt（内联文本）与--append-system-prompt-file（文件路径）两种形式，在不替换主提示词的前提下追加附加指令 |
--add-dir | 添加 CLAUDE.md 目录 | 将指定目录纳入 CLAUDE.md 记忆文件的读取范围，弥补自动发现的缺失。仓库中的>ANTHROPIC_API_KEY=sk-ant-... claude \ --minimal-mode \ --system-prompt-file ./prompts/ci-agent.md \ --append-system-prompt "仅在必要时使用 Bash，优先使用专用工具" \ --add-dir ./docs \ --mcp-config ./mcp.json \ --settings ./settings.json \ --agents ./agents \ --plugin-dir ./plugins
与 /code-review minimal mode 的区别仓库中还存在一个名称相近但完全不同的概念—— 适用场景与注意事项综合原文档与仓库证据，minimal mode 最适合以下场景：
使用时需要特别留意的三点：
结语Minimal mode 是 Claude Code 在"默认智能化"与"严格可控"之间提供的明确分界线。通过本文的拆解可以看到，它的每一项行为都服务于同一个目标：用显式参数交换隐式便利，用可预测性换取确定性。在需要精确复现、严格审计或受限环境的场景下，这套由 8 项跳过特性、1 个环境变量标记、严格认证规则与 6 类上下文注入参数组成的契约，就是构建可靠自动化 Claude Code 工作流的基础。 参考资源（均位于本仓库内）：Minimal mode 系统提示词原文 · 仓库总览 README · 系统提示词变更记录 CHANGELOG · Hooks 配置参考 · DirectoryAdded hook 描述 · /code-review minimal mode 提示词 赞
【免费下载链接】claude-code-system-promptsAll parts of Claude Code's system prompt, 27 builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, statusline, magic docs, WebFetch, Bash cmd, security review, agent creation). Updated for each Claude Code version. 项目地址：https://gitcode.com/gh_mirrors/cl/claude-code-system-prompts 相关推荐
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 |