Claude Code --system-prompt 與 --append-system-prompt 怎麼用:和 CLAUDE.md 的優先級關係與腳本定製

Claude Code 提供 --system-prompt 與 --append-system-prompt(及對應的 -file 參數)定製單次運行的系統提示詞。本文講清完全替換與末尾追加的巨大差異、與 CLAUDE.md 的分工及腳本實例。

NNathaniel bigo··原創首發·AI 輔助撰寫
9 分鐘讀完
資料核對於 2026-11-18 · 依據官方文檔與公開資料整理 Pro 帳號

結論先說

  1. 九成場景選 --append-system-prompt:它在保留 Claude Code 全部內置編程工具說明與預設工程規範的基礎上,把你的額外要求追加到系統提示詞末尾。
  2. 慎用 --system-prompt:該參數會整段替換預設系統提示詞,一旦替換,內置的文件編輯規範與安全約定都會被清空,僅適合極少數純文本處理或完全自管提示詞的實驗。
  3. 長提示詞用 -file 變體:規則超過兩句話時,改用 --append-system-prompt-file ./review-role.md 直接讀文件,避免命令行換行混亂。
  4. 和 CLAUDE.md 按生命週期分工:全員常駐的項目常識寫進 CLAUDE.md;只在某一個腳本或終端別名裏單次生效的角色約束用 --append-system-prompt。
  5. 開通與額度升級入口:高頻跑多角色審查腳本需穩定付費配額;國內用戶可通過本站 Claude Code 訂閱專頁 或免密兌換的 Claude Pro iOS 卡密 開通,重度團隊腳本可看 Claude Pro 自助充值。

四類系統提示詞參數與 CLAUDE.md 對比

圖:本站根據 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 還是放在命令行參數裏」。結合官方記憶機制文檔,兩者並不是二選一,而是上下層疊加關係:

  1. 注入層級不同:--append-system-prompt 直接拼在系統提示詞(System Prompt)層,對當次會話擁有頂層角色定調作用;而各級 CLAUDE.md 作為項目與用戶上下文記憶在啟動時自動拼接載入;
  2. 污染範圍不同:你把「只挑安全漏洞、不提代碼風格意見」寫進項目 ./CLAUDE.md,同事平時寫業務代碼也會被它干擾;而寫在 --append-system-prompt 裏,只對這條命令生效,退出即銷燬;
  3. 衝突處理原則:如果命令行追加了「一律用英文輸出報告」,而全局 ~/.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 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

Nathaniel 的更多內容

  1. 01

    獨立開發者用 ChatGPT + Codex 跑通產品全流程:市場驗證、PRD、原型到代碼上線覆盤清單

    單人做獨立產品最容易陷入「閉門寫兩個月代碼上線零用戶」或「AI 寫到一半目錄越改越崩」。本文整理「ChatGPT 負責市場驗證、PRD 與覆盤 + Codex 負責工程實現與測試」的五階段雙軌流程,附起手提示詞與 7 項上線覆盤清單。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成規範文件命名規則、整理混亂目錄樹與合併零散發票抬頭清單腳本

    面對滿桌面的「新建文件夾」「最終版2」和上百張零散電子發票,手工改名抄台帳耗時又容易漏重。本文分享先脫敏取樣、再用 ChatGPT 生成帶預演和回滾日誌的本地 Python 腳本,離線安全完成目錄整理與發票抬頭合併去重的實戰流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外電郵營銷(EDM)受眾分層文案、A/B 主題行測試與防進垃圾箱自檢

    做海外獨立站或出海 SaaS 電郵營銷(EDM),最怕千人一面群發被直接送進垃圾箱。本文結合 Gmail/Yahoo 批量發件人規範,梳理用 ChatGPT 設計受眾分層文案、批量生成 A/B 主題行矩陣並開展發前垃圾詞與合規自檢的實戰提示詞。

    ChatGPT0
  4. 04

    用 ChatGPT 寫 Notion Formula 2.0 公式、Obsidian Dataview 查詢與 Airtable 自動化腳本

    給 Notion 數據庫寫多條件 Formula 2.0 公式、給 Obsidian 寫 Dataview 動態看板,或在 Airtable 裏寫自動化腳本,經常因為一個小括號或類型不匹配報錯半天。本文整理三大工具的通用上下文喂料規範與三套直接可複製的生成提示詞。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 處理複雜 JSON / YAML / XML 字段映射、格式轉換與校驗規則編寫實戰

    對接第三方 API、遷移 Kubernetes 配置或解析政企 XML 報文時,手工對照幾百行嵌套字段既慢又容易漏掉空值與類型邊界。本文整理用 ChatGPT 完成字段映射表梳理、生成確定性轉換腳本以及編寫 JSON Schema / Pydantic / XSD 校驗規則的實戰流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 準備本科/碩士畢業論文答辯:提煉答辯 PPT 結構、模擬導師犀利追問與 3 分鐘自述稿

    畢業論文寫完後,要在 3–5 分鐘內講清研究價值並頂住答辯評委的連環追問並不輕鬆。本文整理在嚴格遵守高校學術規範的前提下,用 ChatGPT 提煉答辯 PPT 結構、打磨 3 分鐘口語自述稿並開展模擬導師犀利追問的排練流程與提示詞。

    ChatGPT0

同產品的其他教學

  1. 01

    Anthropic Contextual Retrieval(上下文增強檢索)是什麼、怎麼實現:給文檔塊自動補背景摘要結合緩存降失誤率

    長文檔切成小塊後丟了公司名、年份和主語指代導致 RAG 頻頻搜錯?本文按 Anthropic 官方技術文章詳解 Contextual Retrieval 原理、官方公開評測失誤率下降 49% 至 67% 的組合架構,以及用 Claude 提示詞緩存低成本批量生成切片背景的完整 Python 代碼。

    Claude其他 AI 工具0
  2. 02

    RAG 知識庫回答不準怎麼調優:切片大小(Chunking)、BM25 + 向量混合檢索與 Rerank 重排序三步排查法

    搭好的 RAG 企業知識庫一問具體型號、報錯碼或跨行表格就答非所問?本文按 OpenAI 與 Anthropic 官方檢索文檔,給出先隔離檢索與生成故障、再按結構化切片(Chunking)、BM25 加向量混合召回(RRF)與 Rerank 重排序逐層調優的三步法。

    Claude其他 AI 工具0
  3. 03

    Langfuse 開源本地部署(Docker Compose)與提示詞版本管理(Prompt Management)從零上手教學

    企業內網嚴禁業務日誌出境,又想免費擁有大模型調用鏈追蹤與不發版熱更新提示詞的能力?本文按 Langfuse 官方文檔整理 Docker Compose 本地一鍵啟動(含 ClickHouse 架構注意事項)、密鑰配置與 Prompt Management 標籤化版本管理全流程。

    Claude其他 AI 工具0
  4. 04

    LangSmith 入門教學:給 LangGraph 與原生 OpenAI / Claude 接口加調用鏈追蹤、Token 成本統計與免費層限額

    智能體多步調用總是找不到哪一輪提示詞跑偏、單次請求到底燒了多少 Token?本文按 LangSmith 官方文檔講清環境變量零侵入接入 LangGraph、用 wrap_openai / wrap_anthropic 與 @traceable 追蹤原生接口,以及 Developer 免費層額度與留存規則。

    Claude其他 AI 工具0
  5. 05

    Zotero 搭配 Claude / ChatGPT 高效讀英文文獻:PDF 翻譯插件、批註導出精讀與防捏造參考文獻流程

    在 Zotero 裏讀英文頂會論文怎麼無縫聯動 Claude 與 ChatGPT?本文整理 Translate for Zotero 劃詞翻譯配置、高亮批註導出精讀提示詞,以及杜絕 AI 捏造假 DOI 參考文獻的核驗閉環。

    Claude其他 AI 工具0
  6. 06

    Obsidian 接入 Claude、ChatGPT 與本地 Ollama 做個人雙鏈筆記問答:主流插件配置與私隱脫敏邊界

    想在 Obsidian 裏基於自己的雙鏈筆記庫做 AI 問答又擔心私隱外泄?本文對比 Copilot 與 Smart Connections 插件,整理接入 Claude、OpenAI 官方 API 與本地 Ollama 的步驟及敏感目錄隔離規則。

    Claude其他 AI 工具0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~