Claude Code 輸出太囉嗦怎麼設定:讓回覆更短、更像工程匯報

Claude Code 輸出太囉嗦時怎麼設定的實用教程:用臨時提示詞、CLAUDE.md、output style、自訂 slash command 和輸出格式約束,讓 Claude Code 少鋪墊、少複述、多給結論和驗證結果。

Claude Code 用久了,很多人會遇到一個小煩惱:它能幹活,但回覆太長。

明明只是讓它修一個測試,它先解釋一遍測試框架,再複述任務,再寫一段「我將會」,最後才說改了哪個檔案。程式碼可能沒問題,但閱讀成本很高;長會話裡還會把上下文塞滿,讓後續任務更慢、更貴。

解決這個問題不要只靠一句「簡潔一點」。更穩的做法是分層設定:臨時任務用短提示詞,專案長期規則寫進 CLAUDE.md,固定風格用 output style 或自訂 slash command,審查和提交這類固定場景則單獨規定輸出格式。

目標是讓 Claude Code 的輸出更像工程匯報:結論靠前,少鋪墊,少複述,只保留必要檔案、命令、風險和下一步。

先給結論:用 4 層控制輸出

層級 適合場景 怎麼做
臨時提示詞 目前這一輪太囉嗦 直接要求只輸出結論、改動、驗證、風險
CLAUDE.md 目前專案長期偏好 寫入簡潔輸出規則和固定匯報格式
Output style 想全域固定語氣和格式 用 Claude Code 的 output styles 定義回答風格
自訂 slash command 程式碼審查、修測試、提交總結等固定任務 把短輸出模板保存成命令

推薦順序:

  1. 先用臨時提示詞止血;
  2. 再把穩定規則寫進 CLAUDE.md
  3. 如果每個專案都想保持這種風格,再做 output style;
  4. 如果是固定任務,做自訂 slash command。

快速止血:本輪直接這樣說

1
2
3
4
5
6
後續回覆請壓縮:
- 不複述我的需求。
- 不寫禮貌鋪墊。
- 先給結論。
- 只列改動檔案、驗證命令、結果、風險。
- 沒有風險就寫「未發現額外風險」。

做程式碼修改時:

1
2
3
4
5
6
7
請用簡短工程匯報格式輸出:
1. 改了什麼
2. 改了哪些檔案
3. 跑了什麼驗證
4. 還有什麼風險

不要解釋通用背景,不要複述任務。

做排查時:

1
2
3
4
5
6
只輸出:
- 最可能原因
- 證據
- 下一步驗證命令

不要寫長篇分析過程。

這類臨時提示詞馬上生效,但只適合目前會話。長期還是要沉澱到專案規則裡。

寫進 CLAUDE.md

可以在專案根目錄的 CLAUDE.md 加:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
## Response Style

- Be concise and engineering-focused.
- Do not restate the user's request.
- Do not include generic explanations unless asked.
- Put the result first.
- For code changes, report only:
  1. changed files
  2. behavior changed
  3. validation run
  4. remaining risks
- If no validation was run, say so directly.
- If no extra risk is found, write "未发现额外风险".

中文專案可以寫:

1
2
3
4
5
6
7
8
9
## 回覆風格

- 預設用中文,簡潔、直接、工程化。
- 不複述使用者需求。
- 不寫禮貌鋪墊。
- 不解釋通用背景,除非使用者明確要求。
- 修改程式碼後只匯報:改動檔案、行為變化、驗證命令、剩餘風險。
- 沒有執行驗證時必須明確說明。
- 沒有額外風險時寫「未發現額外風險」。

不要把 CLAUDE.md 寫成幾百行輸出風格大全。它本身也會進入上下文,太長會增加負擔。提示詞和規則檔怎麼壓縮可以看:/zh-tw/2026/07/10/ai-coding-prompt-compression-guide/。

用 Output Style 固定語氣和格式

Claude Code 的 output styles 會改變 Claude 的回應方式,例如角色、語氣和輸出格式。它不是讓 Claude 學新知識,而是改變回覆風格。

簡潔工程風格可以這樣寫:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
# Concise Engineering

Respond like a senior engineer giving a short handoff.

Rules:
- Lead with the result.
- Avoid restating the task.
- Avoid generic explanations.
- Use short bullets only when useful.
- For code work, include changed files, validation, and risks.
- If blocked, state the blocker and the next concrete action.
- Keep final answers short unless the user asks for detail.

中文版本:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
# 簡潔工程匯報

預設用中文回答,風格像資深工程師交接工作。

規則:
- 先說結果。
- 不複述使用者需求。
- 不寫通用背景。
- 不寫「我將會」這類過程鋪墊。
- 程式碼修改後只匯報改動、驗證、風險。
- 遇到阻塞時只說明阻塞點和下一步。
- 使用者沒有要求長解釋時,回答保持短。

output style 適合控制表達方式,不適合塞專案路徑、測試命令、禁區檔案。這些事實應該放在 CLAUDE.md

/config 調整 output style

Claude Code 裡可以輸入:

1
/config

然後在設定裡查找 output style 相關選項。

如果版本支援直接設定,也可以按目前版本提示使用類似:

1
/config outputStyle=你的樣式名

不同版本的 key 名可能調整,最穩的是先用 /config 打開介面確認。

用自訂 slash command

如果不是所有回答都想變短,而是某些任務固定要短,可以用自訂 slash command。

例如:

1
.claude/commands/short-review.md

內容:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
只讀審查目前改動,不要修改檔案。

輸出格式:

1. 高風險問題
2. 中低風險問題
3. 缺失測試
4. 結論

規則:
- 每個問題最多 2 行。
- 必須給檔案路徑。
- 沒有問題時寫「未發現高風險問題」。
- 不要複述任務。
- 不要寫通用審查方法。

之後執行:

1
/short-review

同理可以做:

1
2
3
.claude/commands/short-fix.md
.claude/commands/short-test.md
.claude/commands/short-summary.md

程式碼修改後的推薦輸出格式

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
結果:
- ...

改動檔案:
- path/to/file

驗證:
- 命令:...
- 結果:...

風險:
- ...

更短版本:

1
2
3
4
改動:...
檔案:...
驗證:...
風險:...

如果沒有驗證:

1
驗證:未執行,原因是 ...

程式碼審查時少廢話

1
2
3
4
5
6
7
只讀審查目前 diff。

只輸出真實問題,不輸出優點。
按嚴重程度排序。
每個問題包含:檔案路徑、問題、建議。
沒有問題就寫「未發現高風險問題」。
不要寫總結性誇獎。

如果同時用 Codex 做獨立審查,可以讓 Claude Code 負責實作,Codex 負責只讀 review。三工具分工可看:/zh-tw/2026/07/10/cursor-codex-claude-code-workflow-division/。

修測試時少解釋

1
2
3
4
5
6
7
請修復目前 failing test。

輸出限制:
- 不解釋測試框架。
- 不複述錯誤日誌。
- 只保留失敗原因、改動檔案、驗證結果。
- 連續失敗兩次後停止修改,先總結共同原因。

如果是 token 消耗變高,也要控制日誌輸出。相關排查可以看:/zh-tw/2026/07/08/claude-code-token-usage-spike-troubleshooting-faq/。

不要把所有回答都壓到極短

短輸出適合 bug 修復、測試失敗、commit 總結、程式碼審查、簡單命令解釋、範圍明確的實作任務。

不適合太短的場景包括新人學專案、架構取捨、複雜故障復盤、安全風險分析、資料庫遷移方案、需求還沒澄清。

一句話:執行階段短,設計階段可以稍微展開。

和 caveman 的區別

站內之前寫過 caveman,它會把 Claude Code、Codex 等 Agent 的輸出壓縮成更短風格:/zh-tw/2026/07/03/caveman-agent-output-compression-guide/。

本文方法更基礎:臨時提示詞控制本輪,CLAUDE.md 控制專案,output style 控制整體表達,slash command 控制固定任務。

常見誤區

只寫「簡潔一點」

太模糊。更好:

1
只保留:結果、檔案、驗證、風險。

每個提示詞都重複風格要求

穩定規則放進 CLAUDE.md 或 output style。

把專案規則寫進 output style

不要這樣做。output style 負責語氣和格式,專案事實放 CLAUDE.md

把安全說明也壓沒了

危險操作、資料庫、權限、生產設定、檔案刪除相關說明不能省。

讓它完全不解釋

更好的寫法:

1
預設短輸出;只有遇到設計取捨、風險或阻塞時再解釋。

可直接複製的配置

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
## Response Style

- Default language: Chinese.
- Be concise and engineering-focused.
- Do not restate the user's request.
- Do not include generic background unless asked.
- For code changes, report only:
  - result
  - changed files
  - validation
  - risks
- For reviews, list only actionable issues.
- For test failures, summarize the failing cause and next command only.
- If validation was not run, say that explicitly.
- If no risk is found, write "未发现额外风险".

臨時短輸出提示:

1
2
3
本輪請使用短匯報格式:
結果 / 檔案 / 驗證 / 風險。
不要複述任務,不要解釋通用背景。

總結

Claude Code 輸出太囉嗦,不一定要換工具,也不一定要強行壓所有回答。先分層控制:目前會話用短提示詞,專案長期偏好寫進 CLAUDE.md,全域表達用 output style,固定任務用 slash command。

真正好用的設定不是「越短越好」,而是讓 Claude Code 在正確時機說正確長度的話:實作和測試匯報要短,架構和風險討論可以展開。

參考資料

记录并分享
使用 Hugo 建立
主題 StackJimmy 設計