启动参数看官方文档在默认系统提示的末尾追加自定义文本Syntax--append-system-prompt <text>示例claude --append-system-prompt "Always use TypeScript"全网调研整理典型场景为 -p 非交互管道注入每次调用的任务规范（如语言要求、输出格式），无需改动项目配置临时叠加安全合规审查要求，适合 CI 脚本中对特定 PR 做一次性规则增强为某个仓库追加领域约束（如 'Only use internal logging library'），补充 CLAUDE.md 覆盖不到的强制层团队流水线中统一编码风格（Always use TypeScript / 始终写 docstring），而不破坏 Claude Code 默认工具链在 SDK 的 claude_code preset 上按会话叠加专项指令，无需修改持久化配置文件实用技巧与 -p 组合是最高杠杆用法：`claude -p "$TASK" --append-system-prompt "$RULES"` 可在 shell 脚本中动态注入规则append 内容写入 system prompt，指令权重高于 CLAUDE.md（后者以用户消息注入，优先级略低）SDK 等价写法是 `systemPrompt: { type: 'preset', preset: 'claude_code', append: '...' }`，可编程动态生成规则跨机器共享 prompt cache：SDK 中同时设 `excludeDynamicSections: true`，将工作目录等动态信息移入用户消息，让 system prompt 保持一致从而命中缓存可与 output style 叠加：output style 设持久人格，--append-system-prompt 加单次会话的专项焦点，两者不冲突常见坑与 --system-prompt 同时使用时行为未定义：--system-prompt 完全替换默认提示，append 的内容可能被丢弃CLAUDE.md 与本 flag 不可互换：CLAUDE.md 注入的是用户消息上下文而非 system prompt，两者优先级不同enableDynamicSections 默认开启导致工作目录等信息嵌入 system prompt，不同机器上相同 append 文本仍会 cache miss，需显式设 excludeDynamicSections: true 才能跨会话复用缓存来源CLI reference - Claude Code DocsModifying system prompts - Claude Agent SDK DocsDocs: Clarify how CLAUDE.md and --append-system-prompt influence Claude's instructions · Issue #6973Claude Code: 10 CLI flags you probably aren't using - mager.coHow to Append Custom System Prompt in Claude Code - aiengineerguide.com最早记录ⓘ≤v1.0.51最近更新v2.0.30变化次数2新增 1改进 1变化时间线(按版本倒序)新增v2.0.30· 2025/10/31 · 2025/10/31新增用于追加系统 prompt 内容的启动参数改进v1.0.51· 2025/07/12 · 2025/07/12--append-system-prompt 旗标现在可用于交互模式，不仅限于 --print 模式上一个--all回到命令字典下一个--background