輸出樣式

使用內建輸出樣式（例如簡潔或詳細說明）改變 Claude Code 的角色、語氣和回應格式，或撰寫自訂樣式。

輸出樣式是一組指令，為工作階段中的每個回應設定 Claude 的角色、語氣和回應格式。Claude Code 除了預設樣式外，還包括四種內建樣式，您也可以撰寫自己的樣式。

使用輸出樣式來改變 Claude 在整個工作階段中的回應和協作方式，這樣您就不需要在每個提示中重複請求。例如，內建樣式可以使回應更簡短、為每個變更新增說明，或讓 Claude 在不提出例行問題的情況下開始工作。自訂樣式也可以將 Claude 轉變為軟體工程師以外的角色，例如寫作助手或資料分析師。

• 若要使用內建樣式，請從內建輸出樣式中選擇一個，並切換到它。
• 若要撰寫您自己的指令，請建立自訂輸出樣式。

內建輸出樣式

Claude Code 以預設樣式開始，這是其完成軟體工程任務的標準指令。其他四種內建樣式各自保留這些指令並添加自己的指令。

此表格顯示每種樣式如何改變工作階段以及何時適用：

預設

預設表示未選擇任何輸出樣式。Claude Code 不添加樣式指令，Claude 從 Claude Code 的標準系統提示詞工作，該提示詞是為軟體工程任務編寫的。

default 出現在 /output-style 列表中與其他樣式一起，因此您以相同方式選擇它。

Proactive

在 Proactive 樣式中，Claude 在您發送任務後立即開始實施。它對例行決策做出合理的假設，而不是停下來詢問，除非您要求計畫，否則不會切換到 Plan Mode。您可以隨時重新導向它。

該樣式的指令也告訴 Claude 在刪除資料或變更共享或生產系統的操作前在對話中與您確認。該確認是 Claude 遵循的指令，與權限提示分開。

切換到 Proactive 樣式不會改變您的權限模式。您的權限模式仍然決定哪些工具呼叫在不詢問您的情況下執行，因此權限提示的出現方式與您切換前相同。

Concise

在 Concise 樣式中，回應的第一句陳述發生了什麼或答案是什麼。Claude 省略了引言、逐步敘述和結尾回顧，並在一到三句話內回答簡單問題。它以與預設樣式相同的徹底程度進行工程工作。需要 Claude Code v2.1.237 或更新版本。

Claude 在以下情況下仍會完整編寫：

• 您要求的任何內容：當您要求解釋或更多詳細資訊時，Claude 會完整回答。
• 您安全行動所需的任何內容：錯誤報告、失敗的測試輸出、安全警告和破壞性操作的確認保留其完整內容。

Explanatory

在 Explanatory 樣式中，Claude 以與預設樣式相同的方式執行任務，並添加其做出選擇原因的簡短解釋。每個解釋出現在對話中，在其相關程式碼之前或之後，在標記為 Insight 的區塊中。解釋不會作為註解寫入您的檔案中。

Insight 區塊包含關於您的程式碼庫或 Claude 編寫的程式碼的兩到三個要點，例如在添加 API 端點後的這個：

★ Insight ─────────────────────────────────────
- Every route in this repo goes through the withAuth wrapper, so the new endpoint gets session checks without its own middleware.
- Rate limits are set per route in limits.ts, which is why this change adds an entry there rather than a global default.
─────────────────────────────────────────────────

Learning

在 Learning 樣式中，Claude 添加與 Explanatory 樣式相同的 Insight 區塊，並要求您編寫一些程式碼。Claude 自己處理例行實施。當它到達具有真實設計決策的部分時，例如錯誤處理、資料結構或具有多個有效方法的業務邏輯，它會為您留下幾行。

Claude 用檔案中的 TODO(human) 註解標記該位置，然後發送一個請求，說明已經構建的內容、要編寫的內容以及要權衡的內容：

● Learn by Doing

Context: The upload form is in place and calls validateFile() before accepting a file. Size and type checks work for images, but the switch statement has no handling for documents yet.

Your Task: In upload.js, implement the case "document" branch inside validateFile(). Look for TODO(human).

Guidance: Decide on a size limit for documents and whether the file extension has to match the MIME type. Return {valid: boolean, error?: string}.

Claude 然後停止並等待。在 TODO(human) 註解處編寫您的程式碼，並告訴 Claude 您已完成。Claude 會回應一個關於您程式碼的 Insight，並繼續執行任務。

變更您的輸出樣式

使用命令、選單或設定檔選擇樣式。命令和兩個選單都會將您的選擇儲存到本地專案層級的 .claude/settings.local.json。

• /output-style 命令：執行 /output-style <style> 以切換，例如 /output-style concise。不帶引數時，該命令會列出您可以選擇的樣式並標記目前的樣式。

  該命令也適用於非互動模式和 Agent SDK 工作階段，以及來自行動應用程式或網頁的遠端控制，您只能列出和選擇內建樣式。需要 Claude Code v2.1.269 或更新版本。

• 終端機選單：執行 /config 並選擇輸出樣式以從選單中選擇樣式。

• VS Code 擴充功能：使用 / 開啟命令選單並選擇輸出樣式以選擇樣式，包括您的自訂樣式。需要 Claude Code v2.1.257 或更新版本。

• 桌面應用程式：在設定檔中設定 outputStyle 欄位，例如 .claude/settings.local.json，這是終端機選單寫入的檔案。當您在那裡執行 /config 時，Claude Code 開啟設定 > Claude Code而不是選單。

若要在不使用選單的情況下設定樣式，請直接編輯設定檔中的 outputStyle 欄位：

{
  "outputStyle": "Explanatory"
}

該值區分大小寫，因此請將內建名稱寫成 Proactive、Concise、Explanatory 和 Learning。不完全符合樣式名稱的值（例如 explanatory）會給您預設樣式。/output-style 命令會忽略大小寫。

若要在各專案中將樣式設為預設值，請在 ~/.claude/settings.json 中設定 outputStyle。專案本身的設定檔會優先於該值。

當您在工作階段中切換樣式時，Claude 會從您的下一則訊息開始使用新樣式。如需了解該第一則訊息在 prompt caching 中的成本，請參閱變更輸出樣式。在 v2.1.251 之前，新樣式僅在您執行 /clear 或開始新工作階段後才會套用。

建立自訂輸出樣式

自訂輸出樣式是一個 Markdown 檔案：frontmatter 用於中繼資料，然後是 Claude 的指令。

在 VS Code 擴充功能中，您也可以從輸出樣式選單建立檔案，而不是手動編寫。這需要 Claude Code v2.1.261 或更新版本。

---
name: Diagrams first
description: Lead every explanation with a diagram
keep-coding-instructions: true
---

When explaining code, architecture, or data flow, start with a Mermaid diagram showing the structure, then explain in prose.

## Diagram conventions

Use `flowchart TD` for control flow and `sequenceDiagram` for request paths. Keep diagrams under 15 nodes.

Plugins 也可以在 output-styles/ 目錄中提供輸出樣式。

Frontmatter 參考

使用 YAML frontmatter 在檔案頂部的 --- 標記之間設定輸出樣式。所有欄位都是選用的，欄位名稱使用以連字號分隔的小寫單字。拼寫錯誤的欄位會被忽略而不會出現錯誤。如果 YAML 無法解析，樣式仍會以其檔案名稱載入，且不會設定任何欄位；執行 claude --debug 以查看解析錯誤。