启动参数看官方文档从文件加载系统提示替换默认值Syntax--system-prompt-file <path>示例claude --system-prompt-file ./custom-prompt.txt相关命令--system-prompt--append-system-prompt-file全网调研整理典型场景在 CI/CD pipeline 中为自动化任务加载专用 prompt 文件,定义角色(如「安全审计员」「代码审查机器人」)团队通过版本控制共享标准化 prompt 文件,确保所有成员与 AI 的交互行为一致切换到非编码场景(文档生成、安全分析)时,完全替换默认的 coding-focused 系统提示在多项目脚本中按项目类型动态传入不同 prompt 文件,无需修改代码或配置配合 `-p`(print mode)批量处理任务,实现无人值守的自动化管道实用技巧文件支持 `.md` 格式,可用 markdown 标题结构化「角色定义 / 输出规范 / 示例」,提升可读性和可维护性配合 `--model claude-opus-4-8` 使用,按任务复杂度灵活搭配模型与 prompt 文件配合 `--output-format json` 可构建完全机器可解析的自动化管道,prompt 文件中明确要求输出 JSON schema仅需追加规则而非完全替换时,优先用 `--append-system-prompt` 保留 Claude Code 内置工具指引,避免功能退化将不同场景的 prompt 文件放入项目 `.claude/prompts/` 目录纳入版本控制,方便 CI 脚本按分支或环境动态引用常见坑仅在 print mode(`-p` / `--print`)下生效,交互式会话中传入此 flag 不会生效完全替换默认系统提示会丢失 Claude Code 内置的工具使用指引和安全指令,需自行在 prompt 文件中补全所需能力描述与 `--system-prompt` 互斥,二者不可同时使用,同时传入会报错来源CLI reference - Claude Code Docs (Official)Claude Code CLI Commands & Flags | Full Reference Guide - CodingNomadsEvery Claude Code command you need to know with examples - HowDoIUseAIClaude Code: 10 CLI flags you probably aren't using - mager.co创建于v1.0.55最近更新v2.0.30变化次数2新增 2变化时间线(按版本倒序)新增v2.0.30· 2025/10/31 · 2025/10/31新增用于指定系统 prompt 文件路径的启动参数新增v1.0.55· 2025/07/18 · 2025/07/18新增选项用于在 print 模式下覆盖系统提示上一个--system-prompt回到命令字典下一个--teleport