輸出樣式已棄用。在 2025 年 11 月 5 日或之後，我們將自動將您的使用者層級輸出樣式檔案轉換為外掛程式，並停止支援輸出樣式功能。請改用外掛程式。(內建解釋性輸出樣式的範例外掛程式)

​
棄用時間表

自 2025 年 11 月 5 日起，Claude Code 將：
  • 自動將使用者層級輸出樣式檔案 (~/.claude/output-styles) 轉換為外掛程式
  • 停止支援輸出樣式功能
  • 移除 /output-style 命令和相關功能
您需要做的事項：
  • 在 2025 年 11 月 5 日之前遷移到外掛程式，以獲得更順暢的過渡
  • 查看下面的遷移指南，以了解您的選項

​
替代方案：改用外掛程式

外掛程式提供了更強大且靈活的方式來自訂 Claude Code 的行為。explanatory-output-style 外掛程式重新建立了已棄用的解釋性輸出樣式功能。

​
範例：解釋性輸出樣式外掛程式

explanatory-output-style 外掛程式使用 SessionStart 鉤子來注入額外的上下文，鼓勵 Claude 提供教育性見解。以下是它的功能：
  • 提供關於實現選擇的教育性見解
  • 解釋程式碼庫模式和決策
  • 平衡任務完成與學習機會

​
安裝外掛程式

要安裝像 explanatory-output-style 這樣的外掛程式：
新增市場（如果尚未新增）
/plugin marketplace add anthropics/claude-code
安裝外掛程式
/plugin install explanatory-output-style@claude-code-plugins
重新啟動 Claude Code 以啟用外掛程式
/exit
停用外掛程式
/plugin manage explanatory-output-style@claude-code-plugins

1. 當您看到 claude-code-marketplace 時按 Enter
2. 當您看到 explanatory-output-style 時按空格以切換啟用狀態
3. 按下箭頭移至「套用變更」，然後按 Enter
    您應該會看到「已停用 1 個外掛程式。重新啟動 Claude Code 以套用變更。」

/exit
如需外掛程式的更多詳細資訊，請參閱外掛程式文件。

​
遷移指南

輸出樣式直接修改了 Claude Code 的系統提示。以下是如何透過鉤子和子代理（都可透過 Claude Code 外掛程式取得）實現類似效果的方法：

​
使用 SessionStart 鉤子進行上下文注入

如果您使用輸出樣式在工作階段開始時新增上下文，請改用 SessionStart 鉤子。 鉤子的輸出 (stdout) 會新增到對話上下文中。您也可以：
  • 執行動態產生上下文的指令碼
  • 載入專案特定的資訊
SessionStart 鉤子與 CLAUDE.md 一樣，不會變更系統提示。

​
使用子代理進行不同的系統提示

如果您使用輸出樣式來改變 Claude 對特定任務的行為，請改用子代理。 子代理是具有以下特性的專門 AI 助手：
  • 自訂系統提示（必須位於與主迴圈不同的單獨上下文視窗中）
  • 特定的工具存取權限
  • 可選的模型使用（如果不是主迴圈模型）

​
參考：原始輸出樣式文件

下面的內容僅供參考。輸出樣式已棄用，將在 2025 年 11 月 5 日移除。請遷移到外掛程式、鉤子或子代理。
輸出樣式允許您將 Claude Code 用作任何類型的代理，同時保留其核心功能，例如執行本機指令碼、讀取/寫入檔案和追蹤待辦事項。

​
內建輸出樣式

Claude Code 的預設輸出樣式是現有的系統提示，旨在幫助您有效地完成軟體工程任務。 還有兩個額外的內建輸出樣式，專注於教導您程式碼庫和 Claude 的運作方式：
  • 解釋性：在幫助您完成軟體工程任務的同時提供教育性「見解」。幫助您了解實現選擇和程式碼庫模式。
  • 學習：協作式的邊做邊學模式，Claude 不僅會在編碼時分享「見解」，還會要求您自己貢獻小的、策略性的程式碼片段。Claude Code 將在您的程式碼中新增 TODO(human) 標記供您實現。

​
輸出樣式的運作方式

輸出樣式直接修改 Claude Code 的系統提示。
  • 非預設輸出樣式排除了特定於程式碼產生和 Claude Code 內建的高效輸出的指令（例如簡潔回應和使用測試驗證程式碼）。
  • 相反，這些輸出樣式在系統提示中新增了自己的自訂指令。

​
變更您的輸出樣式

您可以：
  • 執行 /output-style 以存取功能表並選擇您的輸出樣式（這也可以從 /config 功能表存取）
  • 執行 /output-style [style]，例如 /output-style explanatory，以直接切換到某個樣式
這些變更適用於本機專案層級，並儲存在 .claude/settings.local.json 中。 您也可以建立自己的輸出樣式 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. 自訂斜線命令

您可以將輸出樣式視為「儲存的系統提示」，將自訂斜線命令視為「儲存的提示」。