启动参数看官方文档从文件加载系统提示文本并追加到默认提示Syntax--append-system-prompt-file <path>示例claude --append-system-prompt-file ./extra-rules.txt全网调研整理典型场景需要将 30-200 行的 role/persona 定义存入独立文件,避免在 shell 命令中内嵌大段文字团队把代码规范文件(如 style-rules.md)提交到 git,CI/CD 管道用同一文件保持一致性多个项目复用同一个 ROLE.md,每次调用时追加而无需重复粘贴文本非交互式脚本(-p 模式)中注入领域上下文或输出格式要求,而不改变默认编码能力想在不破坏 Claude Code 默认安全指令和工具指导的前提下,附加额外约束规则实用技巧可与 --system-prompt-file 或 --system-prompt 组合:先用替换 flag 设置全新基础提示,再用 --append-system-prompt-file 叠加补丁规则在 CI 批量调用场景中,搭配 --exclude-dynamic-system-prompt-sections 可让不同机器的系统提示完全一致,显著提升 prompt cache 命中率在该 flag 出现之前,社区的临时方案是 --append-system-prompt "$(cat ROLE.md)",两者效果等同,但文件路径方式更易读且不受 shell 特殊字符影响附加文件支持 Markdown 格式,可用标题、列表组织规则,Claude 能正确解析结构化指令对于需要跨会话持久化的项目规范,优先用 CLAUDE.md;--append-system-prompt-file 适合按次调用时动态切换不同角色或任务上下文常见坑该 flag 仅对当前调用生效,不会持久化到后续会话,想要项目级持久规则应改用 CLAUDE.md当同时使用 --system-prompt 或 --system-prompt-file 时,默认提示会被完全替换,--append-system-prompt-file 的内容追加在替换后的提示末尾,而非原始默认提示末尾--system-prompt 与 --system-prompt-file 两个替换 flag 互斥,不能同时使用;但两个 append flag 可各自与任意一个替换 flag 组合来源CLI reference - Claude Code Docs (EN)CLI 参考 - Claude Code Docs (ZH)Modifying system prompts - Agent SDK[FEATURE] Add --append-system-prompt-file · Issue #6153 · anthropics/claude-codeClaude Code: 10 CLI flags you probably aren't using - mager.co回到命令字典