ARTICLE DETAIL

资讯详情

深耕编程入门与网站建设的一线实战洞察。

Claude Code Minimal Mode 全面解析:跳过的功能、认证约束与显式上下文注入

Claude Code Minimal Mode 全面解析:跳过的功能、认证约束与显式上下文注入 文档提示工程人工智能【免费下载链接】claude-code-system-promptsAll parts of Claude Codes 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.mdClaude 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 会跳过的功能清单逐一展开如下跳过的功能行为含义影响场景hookssettings 与已安装插件中定义的不执行任何用户配置或插件带来的 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_SIMPLE1最小模式的标记minimal mode 会设置环境变量CLAUDE_CODE_SIMPLE1。这是该模式生效的运行时标记会话启动时即被置位供 Claude Code 内部及第三方工具检测当前是否运行在精简模式下。从源码结构看可以推断该变量是 minimal mode 与正常模式在进程环境层面的分界信号——任何依赖该变量判断运行环境的脚本、插件或诊断工具都能据此识别出当前会话跳过了 hooks/LSP/插件同步等特性。认证与凭据只认 API Key绝不读 OAuth 与钥匙串Minimal mode 对 Anthropic 认证采用了最严格的约束严格限定两种凭据来源ANTHROPIC_API_KEY环境变量或通过--settings传入的apiKeyHelperOAuth 与钥匙串永不读取正常的 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_KEYsk-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说明--minimal-mode的实际开关名以你所安装的 Claude Code 版本claude --help输出为准本文聚焦的是该模式被激活后的行为契约即上方系统提示词片段所描述的内容。与 /code-review minimal mode 的区别仓库中还存在一个名称相近但完全不同的概念——agent-prompt-code-review-minimal-mode.mdagent-prompt-code-review-minimal-mode.md。它描述的是/code-review斜杠命令在 minimal 档位下的提示词执行一次细致的 diff 审阅最多报告 15 条具体正确性问题并跳过常规的 finder-verifier 多轮流程。它针对的是代码审查的力度档位而本文的 minimal mode 针对的是整个会话的运行特性。两者不应混淆——后者也在 CHANGELOG.md 中有独立的引入记录**NEW:** Agent Prompt: /code-review minimal mode。适用场景与注意事项综合原文档与仓库证据minimal mode 最适合以下场景CI/CD 与自动化脚本需要每次运行行为完全一致不被本机 hooks、插件或记忆文件污染沙箱与受限环境环境变量受限、OAuth 不可用只能用ANTHROPIC_API_KEY完成认证可审计的凭据管理严格要求绝不读取钥匙串/OAuth凭据来源单一明确上下文完全受控的会话通过--system-prompt-file、--add-dir等参数精确拼装上下文杜绝隐式内容注入。使用时需要特别留意的三点hooks 双面性settings 与插件定义的 hooks 被跳过但 Claude Code 内置功能不受影响记忆断连auto-memory 与 CLAUDE.md 自动发现均关闭跨会话记忆依赖手动--add-dir与显式提示词注入第三方凭据独立Bedrock/Vertex/Foundry 用户不受 Anthropic 认证约束影响各自走自己的凭据路径。结语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 Codes 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点击查看免费下载相关推荐电子课本如何下载把国家中小学智慧教育平台的 PDF 批量存到本地电子课本如何下载把国家中小学智慧教育平台的 PDF 批量存到本地 国家中小学智慧教育平台的电子课本预览页只能在线翻阅而这款开源工具能把电子课本下载这件事一步网页爬虫教育SuperClaude Framework Introspection Mode 深度解析面向 Claude Code 的元认知内省与推理优化模式SuperClaude Framework Introspection Mode 深度解析面向 Claude Code 的元认知内省与推理优化模式 导读本文开发工具CLIAI 技能/插件测试人工智能AI 评测Warp CLI Agent 富输入 上下文为 Claude Code / Codex 注入文件与符号路径Warp CLI Agent 富输入 上下文为 Claude Code / Codex 注入文件与符号路径 导读 本篇文章讲解 Warp 终端中 CLI桌面应用开发者工具人工智能AI 应用AI Agent代码智能体创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表