輸出風格
將 Claude Code 適配用於軟體工程以外的用途
輸出風格讓您可以將 Claude Code 用作任何類型的代理,同時保持其核心功能,例如運行本地腳本、讀取/寫入檔案和追蹤 TODO。
內建輸出風格
Claude Code 的預設輸出風格是現有的系統提示,旨在幫助您高效完成軟體工程任務。
還有兩種額外的內建輸出風格,專注於教您程式碼庫和 Claude 的運作方式:
-
解釋性:在幫助您完成軟體工程任務的過程中提供教育性的「洞察」。幫助您理解實作選擇和程式碼庫模式。
-
學習:協作式的邊做邊學模式,Claude 不僅會在編碼時分享「洞察」,還會要求您自己貢獻小而策略性的程式碼片段。Claude Code 會在您的程式碼中添加
TODO(human)
標記供您實作。
輸出風格的運作方式
輸出風格直接修改 Claude Code 的系統提示。
- 非預設輸出風格排除了通常內建在 Claude Code 中特定於程式碼生成和高效輸出的指令(例如簡潔回應和用測試驗證程式碼)。
- 相反,這些輸出風格有自己的自訂指令添加到系統提示中。
更改您的輸出風格
您可以:
-
運行
/output-style
來存取選單並選擇您的輸出風格(這也可以從/config
選單存取) -
運行
/output-style [風格]
,例如/output-style explanatory
,直接切換到某種風格
這些更改適用於本地專案層級,並保存在 .claude/settings.local.json
中。
建立自訂輸出風格
要在 Claude 的幫助下設定新的輸出風格,請運行
/output-style:new I want an output style that ...
預設情況下,透過 /output-style:new
建立的輸出風格會以 markdown 檔案的形式保存在使用者層級的 ~/.claude/output-styles
中,並可跨專案使用。它們具有以下結構:
您也可以建立自己的輸出風格 Markdown 檔案,並將它們保存在使用者層級(~/.claude/output-styles
)或專案層級(.claude/output-styles
)。
與相關功能的比較
輸出風格 vs. CLAUDE.md vs. —append-system-prompt
輸出風格完全「關閉」Claude Code 預設系統提示中特定於軟體工程的部分。CLAUDE.md 和 --append-system-prompt
都不會編輯 Claude Code 的預設系統提示。CLAUDE.md 將內容作為使用者訊息添加到 Claude Code 預設系統提示_之後_。--append-system-prompt
將內容附加到系統提示。
輸出風格 vs. 代理
輸出風格直接影響主代理循環,只影響系統提示。代理被調用來處理特定任務,可以包括額外的設定,如要使用的模型、它們可用的工具,以及關於何時使用代理的一些上下文。
輸出風格 vs. 自訂斜線命令
您可以將輸出風格視為「儲存的系統提示」,將自訂斜線命令視為「儲存的提示」。