结论先说
- 九成场景选
--append-system-prompt:它在保留 Claude Code 全部内置编程工具说明与默认工程规范的基础上,把你的额外要求追加到系统提示词末尾。 - 慎用
--system-prompt:该参数会整段替换默认系统提示词,一旦替换,内置的文件编辑规范与安全约定都会被清空,仅适合极少数纯文本处理或完全自管提示词的实验。 - 长提示词用
-file变体:规则超过两句话时,改用--append-system-prompt-file ./review-role.md直接读文件,避免命令行换行混乱。 - 和
CLAUDE.md按生命周期分工:全员常驻的项目常识写进CLAUDE.md;只在某一个脚本或终端别名里单次生效的角色约束用--append-system-prompt。 - 开通与额度升级入口:高频跑多角色审查脚本需稳定付费配额;国内用户可通过本站 Claude Code 订阅专页 或免密兑换的 Claude Pro iOS 卡密 开通,重度团队脚本可看 Claude Pro 自助充值。

图:本站根据 Claude Code 官方文档:CLI reference 整理的示意图
本文根据 Claude Code 官方文档《CLI reference》《Run Claude Code programmatically》与《How Claude remembers your project》整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 Anthropic 官方网站。
适用于谁
- 想在 CI 审单、发版总结或安全扫描脚本里给 Claude 注入专属角色,又不想污染仓库公共
CLAUDE.md的开发者; - 误用了
--system-prompt结果发现 Claude 突然不会正常调内置编程工具的人; - 想理清命令行提示词参数与各级
CLAUDE.md作用范围边界的团队负责人。
一、四个 CLI 系统提示词参数对比
官方 CLI 参考页列出了两组共四个定制系统提示词的启动标志(注意 --system-prompt 与 --system-prompt-file 互斥,不可同时传入):
| 参数名称 | 对默认系统提示词的影响 | 传入内容形式 | 典型用途 |
|---|---|---|---|
--append-system-prompt | 保留内置默认提示词,在末尾追加 | 命令行内联字符串 | 注入单次审查视角、输出语言或红线 |
--append-system-prompt-file | 保留内置默认提示词,从文件追加 | 本地 .md / .txt 路径 | CI 流水线加载长篇审计规范模板 |
--system-prompt | 完全覆盖替换默认系统提示词 | 命令行内联字符串 | 纯文本转换等脱离默认代理设定的场景 |
--system-prompt-file | 完全覆盖替换默认系统提示词 | 本地 .md / .txt 路径 | 测试自定义底层 Agent 系统提示词 |
编写高质量系统级约束的结构技巧,可同步参考 系统提示词四段结构写法。
二、和 CLAUDE.md 的优先级关系与职责边界
很多开发者纠结「规则到底该写进 CLAUDE.md 还是放在命令行参数里」。结合官方记忆机制文档,两者并不是二选一,而是上下层叠加关系:
- 注入层级不同:
--append-system-prompt直接拼在系统提示词(System Prompt)层,对当次会话拥有顶层角色定调作用;而各级CLAUDE.md作为项目与用户上下文记忆在启动时自动拼接载入; - 污染范围不同:你把「只挑安全漏洞、不提代码风格意见」写进项目
./CLAUDE.md,同事平时写业务代码也会被它干扰;而写在--append-system-prompt里,只对这条命令生效,退出即销毁; - 冲突处理原则:如果命令行追加了「一律用英文输出报告」,而全局
~/.claude/CLAUDE.md写了「一律用中文回复」,建议在命令行提示词里明确点出「忽略常规语言偏好,本次仅输出英文」。全局与项目记忆的加载顺序详见 全局 CLAUDE.md 配置指南。
多角色脚本与额度准备提示:在本地封装「安全审计员」「性能挑刺员」「发版文案员」等多个 Shell 别名并高频调用时,单账号的 5 小时滚动额度消耗较快。需要更高并发余量的开发者可直接升级 5 倍额度的 Claude Max 订阅服务 或选购 Claude Max 会员升级。
三、两个即抄即用的脚本定制配方

图:本站根据 Claude Code 官方文档:Run Claude Code programmatically 整理的示意图
配方 1:CI 自动审 PR 只抓高危阻断问题
bash
git diff origin/main...HEAD | claude -p "审查标准输入中的代码变更" \
--append-system-prompt-file ./scripts/security-reviewer.md
完整流水线触发配置可结合 Claude Code 在 CI 里无头运行示例;若要固化环境变量与工具白名单,可搭配 Claude Code settings.json 配置详解。
配方 2:给交互模式封装专用终端别名
在 ~/.zshrc 或 PowerShell Profile 中定义专用角色启动命令:
bash
alias claude-sec='claude --append-system-prompt "你当前处于只读安全审计角色,严禁修改业务逻辑,重点排查越权、注入与密钥硬编码。"'
常见问题
问:为什么用了 --system-prompt 后 Claude 不按平时的习惯搜文件了?
答:因为 --system-prompt 把官方内置的工具使用指南和代码代理默认指令全部替换掉了。日常在代码库里干活,请改回 --append-system-prompt。
问:--system-prompt 和 --append-system-prompt 能同时传吗?
答:可以组合(先用前者设定基底再追加后缀),但 --system-prompt 与 --system-prompt-file 互斥不能同传。
问:-file 参数支持传入相对路径吗?
答:支持,相对路径按你执行 claude 命令时的当前工作目录解析;在跨目录脚本中建议用绝对路径防找不到文件。
问:国内开发者没有外币卡,怎么开通订阅或申请企业报销发票?
答:可通过本站 Claude Code 订阅专页 或 AI 会员充值总览 选购,支持支付宝、微信支付与 AlipayHK,提供免交密码的卡密自助兑换,团队采购可开具国内增值税发票。实时价格与售后细则以页面为准:订阅期内非违规掉订阅按剩余天数折退,风控封号不在质保范围。
相关教程
- 全局 CLAUDE.md 怎么配:用户级规则与项目指令分工
- 系统提示词怎么写:四段结构与可照抄模板
- Claude Code 在 CI 里跑:从 claude -p 到自动审 PR
- Claude Code settings.json 配置文件详解
参考资料
- Claude Code 官方文档:CLI reference — https://code.claude.com/docs/en/cli-reference
- Claude Code 官方文档:Run Claude Code programmatically — https://code.claude.com/docs/en/headless
- Claude Code 官方文档:How Claude remembers your project — https://code.claude.com/docs/en/memory
0 条评论
还没有评论,来抢沙发~