結論先說
- 九成場景選
--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 條評論
還沒有評論,來搶沙發~