跳轉到主要內容
輸出樣式允許您將 Claude Code 用作任何類型的代理，同時保留其核心功能，例如執行本地指令碼、讀取/寫入檔案和追蹤待辦事項。

​
內建輸出樣式

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

​
輸出樣式如何運作

輸出樣式直接修改 Claude Code 的系統提示。
  • 所有輸出樣式都排除了高效輸出的指令（例如簡潔回應）。
  • 自訂輸出樣式排除了編碼指令（例如使用測試驗證程式碼），除非 keep-coding-instructions 為真。
  • 所有輸出樣式都在系統提示的末尾添加了自己的自訂指令。
  • 所有輸出樣式都會在對話期間觸發提醒，讓 Claude 遵守輸出樣式指令。

​
變更您的輸出樣式

您可以：
  • 執行 /output-style 以存取選單並選擇您的輸出樣式（也可以從 /config 選單存取）
  • 執行 /output-style [style]，例如 /output-style explanatory，直接切換到某個樣式
這些變更適用於本地專案級別，並保存在 .claude/settings.local.json 中。您也可以直接編輯不同級別的設定檔案中的 outputStyle 欄位。

​
建立自訂輸出樣式

自訂輸出樣式是具有 frontmatter 和將添加到系統提示的文字的 Markdown 檔案： 
---
name: My Custom Style
description:
  A brief description of what this style does, to be displayed to the user
---

# Custom Style Instructions

You are an interactive CLI tool that helps users with software engineering
tasks. [Your custom instructions here...]

## Specific Behaviors

[Define how the assistant should behave in this style...]
您可以在使用者級別 (~/.claude/output-styles) 或專案級別 (.claude/output-styles) 保存這些檔案。

​
Frontmatter

輸出樣式檔案支援 frontmatter，對於指定有關命令的中繼資料很有用：
Frontmatter用途預設
name輸出樣式的名稱，如果不是檔案名稱從檔案名稱繼承
description輸出樣式的描述。僅在 /output-style 的 UI 中使用無
keep-coding-instructions是否保留 Claude Code 系統提示中與編碼相關的部分。false

​
與相關功能的比較

​
輸出樣式 vs. CLAUDE.md vs. —append-system-prompt

輸出樣式完全「關閉」Claude Code 預設系統提示中特定於軟體工程的部分。CLAUDE.md 和 --append-system-prompt 都不編輯 Claude Code 的預設系統提示。CLAUDE.md 將內容添加為 Claude Code 預設系統提示之後的使用者訊息。--append-system-prompt 將內容附加到系統提示。

​
輸出樣式 vs. Agents

輸出樣式直接影響主代理迴圈，僅影響系統提示。Agents 被呼叫以處理特定任務，可以包括額外的設定，例如要使用的模型、可用的工具以及有關何時使用代理的一些上下文。

​
輸出樣式 vs. Skills

輸出樣式修改 Claude 的回應方式（格式、語氣、結構），一旦選擇就始終處於活動狀態。Skills 是特定於任務的提示，您可以使用 /skill-name 呼叫或 Claude 在相關時自動載入。使用輸出樣式來實現一致的格式設定偏好；使用 skills 來實現可重複使用的工作流程和任務。