← 文章

Claude Code 的 mod 是什麼?怎麼用?推薦你四個

· 9 分鐘閱讀 · 13 次閱讀
Claude Code plugin 終端機 hook 開源
Claude Code 2.1.287 新功能

Claude Code 的 mod 是什麼?

怎麼用?推薦你四個

用 AI 寫程式一個小時之後,我常想回頭找一小時前問過的問題。往上捲的時候,捲過的大多不是對話,是 AI 每個小動作的紀錄。這篇講我怎麼用 Claude Code 新推出的 mod,把這些紀錄收起來。

原本的 Claude Code 畫面:AI 的動作紀錄和自動檢查的提醒,夾在對話之間
同樣兩輪對話,原本的畫面

整個過程我跟 AI 模型 Opus 5.5 一起做。我決定方向、看截圖拍板;Opus 5.5 寫程式、跑測試,也錄下文中所有示範畫面。示範用的是一個假的小專案,截圖是真實的終端機視窗,只抽掉了電腦上的資料夾路徑。

Claude Code 推出 mod,剛好對上我兩個痛點

2026 年 10 月 1 日,Claude Code 推出 mod:別人寫的小外掛,可以改變它的畫面怎麼畫。

Claude Code 是一個讓 AI 在終端機裡幫你寫程式的工具。終端機就是那個黑底、打字下指令的視窗。我每天用它好幾個小時,有兩個痛點一直沒解決。

1

AI 的動作紀錄

AI 每讀一個檔、跑一個指令、改一段程式,畫面上就多一段紀錄。一個小時下來,畫面大多是這些紀錄,真正的對話被擠到要一直往上捲才找得到。

2

我自己掛的自動檢查

Claude Code 讓使用者掛 hook:在特定時刻自動跑的小程式,例如每輪結束提醒我還有檔案沒存版本。我掛了一堆,每個都在對話裡印一兩行提醒,夾在工作中間。

兩個痛點都出在畫面怎麼排,而 mod 剛好能改畫面,又不會動到 AI 讀到的內容。

嘗試一 · quiet-tools

沒出事的動作,收成一行

quiet-tools 把 AI 成功完成的動作,各收成一行灰字。

失敗或被中斷的動作,照原樣整段留著,錯誤訊息還在原本的位置。收不收看的是「有沒有出事」,不是「長不長」。一段很長的成功紀錄可以收,一行很短的錯誤不能收。

收起來的那一行,會留下原本藏在紀錄裡的重點:

  • 存了哪個版本,畫面上寫成 committed 5f78e2b → main
  • 指令轉到背景繼續跑
  • 搜尋了但沒找到東西

想看完整內容,按 ctrl+o 打開詳細檢視,歷史裡收起來的每一行都會展開。再按一次,又收回去。下面可以自己按按看:

平常:成功的動作各收成一行
平常:成功的動作各收成一行

被擋下的動作,另外給一個樣子。很多人會掛「動手前檢查」,例如沒跑過測試就不准存版本。被擋下的動作根本沒執行,能讀的只有被擋的原因,所以 quiet-tools 把它收成一行紅字。

存版本時第一次被擋下,收成一行紅字;AI 照提示跑完測試後再存,才通過
存版本時第一次被擋下,收成一行紅字;AI 照提示跑完測試後再存,才通過

收不收,看有沒有出事;收起來的東西,要隨時拿得回來。

嘗試二 · hook-notices

散落的提醒,收進一個角落

裝了 hook-notices 之後,自動檢查的提醒不再夾在對話裡,全收到輸入框上方的一行。

那一行只寫:還有幾則沒讀、其中幾則是警告、最新一則在說什麼。點開是側邊的完整清單,可以一則一則看。對話裡不再夾著提醒。

做的時候卡在一件事:mod 攔不到自動檢查印出來的字。所以我改成跟檢查約好一個檔案,檢查把提醒寫進檔案,mod 再讀出來顯示。開源的程式碼裡附了一支小程式,原本的檢查改幾行就能接上。

右側清單:所有自動檢查的提醒,對話裡不再夾著它們
右側清單:所有自動檢查的提醒,對話裡不再夾著它們

攔不到的東西,就跟對方約好交接的方式。

嘗試三 · turn-nav

對話一長,就需要目錄

想回頭找一小時前問的問題,turn-nav 給你一份目錄:送出過的每個問題都列在上面,點一下就跳回那一輪。

我第一次看到對話導覽,是在 Gemini Voyager:一個替 Google Gemini 網頁版加時間軸的開源瀏覽器插件,每則訊息是一個點,點一下就跳過去。我天天用的是 Claude Code,也想要一樣的東西。剛好 mod 出了,我就把它搬進終端機。

Gemini Voyager 的時間軸:右側每個點是一則訊息
Gemini Voyager 的時間軸
點開時間軸的清單:每一列是一個問題(文字已換成示意條)
點開後的問題清單(文字已換成示意條)

限制也照實寫:只有全螢幕版面能跳;接回舊的對話時,接回之前的問題不會列出來。

對話一長,缺的是目錄,不是更快的捲動。

附:prompt-band,兩行併成一行

prompt-band 讓上面兩個小外掛共用一行。提醒和目錄原本各佔輸入框上方一行。寬螢幕時並排成一行,窄螢幕時自動疊回兩行。

prompt-band 只管排版,按下去還是交給原本的小外掛處理;所以不裝它,另外兩個也能單獨用。

四個嘗試加起來

同樣兩輪對話,畫面從 57 行縮到 36 行,少了三分之一以上。其中 AI 的動作紀錄和提醒,從 20 行變成 3 行。代價是輸入框上方固定多一行。

沒出事的收起來,出事的留在原地,要找的給目錄。

做完才看到的三個對照

做完之後,我才看到別人做的類似東西。三個對照放在一起,反而讓我看清楚自己的做法差在哪裡。

官方 /focustool-linesquiet-tools
收的單位一整輪對話每個動作每個動作
失敗的動作一起藏起來也收成一行整段留著
被擋下的動作一起藏起來也收成一行一行紅字,附原因
AI 讀到的內容會變(AI 被告知你只看得到最後一則)不變不變

同一週,有人做了類似的東西

Tickloop/claude-mods 的 tool-lines,跟我在同一週出現,也是把 AI 的每個動作畫成一行。

差別在判準:tool-lines 連失敗的動作也收成一行;quiet-tools 只收沒出事的。我參考了它兩個部分:收起來的那一行附上重點,以及從使用者的問題那一列判斷「現在是不是詳細檢視」。它沒有寫授權條款,所以我只參考想法,程式自己寫。

有人獨立做出同一個東西,是確認方向沒錯的便宜方法;參考別人的程式之前,先看授權。

官方的 /focus,收的是整輪

Claude Code 自己也有 /focus(專注模式),收的單位是一整輪對話。

打開之後,每輪只留下你的問題、一行摘要和 AI 最後的回答。它還會告訴 AI「使用者只看得到最後一則」,AI 的回答寫法也會跟著變。代價是看不出哪裡出了事:失敗的動作、被擋下的動作、檢查的提醒,都跟成功的一起藏起來。

官方 /focus:每輪只剩問題、摘要和最後的回答
官方 /focus:每輪只剩問題、摘要和最後的回答

只想看結論,用 /focus 就夠;要邊看邊抓問題,就得按有沒有出事來收。

目錄這件事,各家都走到了

先有 Gemini Voyager 這類插件替網頁上的 AI 對話加導覽,後來 ChatGPT 網頁版自己也加了目錄。

據報導,ChatGPT 網頁版在 2026 年 5 月底替長對話加了目錄。turn-nav 是同一個需求,放在終端機裡的版本。

對話一長,目錄是遲早要補的東西。

對照下來,差別都落在判準上:收不收看有沒有出事,提醒怎麼收靠約好交接的方式。

怎麼裝、怎麼用,以及誰不需要

四個小外掛開源在 operonlab/claude-code-mods,在 Claude Code 裡各用一行安裝:

/plugin install quiet-tools --marketplace operonlab/claude-code-mods /plugin install hook-notices --marketplace operonlab/claude-code-mods /plugin install turn-nav --marketplace operonlab/claude-code-mods /plugin install prompt-band --marketplace operonlab/claude-code-mods

hook-notices 還要在設定檔 ~/.claude/settings.json 加一行,讓一開機就跑的檢查也找得到它:

"env": { "HOOK_NOTICES_SINK": "1" }

除了上面那一行設定,裝好之後打開 Claude Code 就生效。平常會用到的只有四個:

ctrl+o展開所有收起來的紀錄,再按一次收回去
/turn-nav打開問題目錄
/hook-notices打開提醒清單
/quiet-tools暫時關掉收合,看原本的樣子

本文的數字是這樣量的:同一組問題,每次開全新的對話,各跑三次,兩邊的範圍沒有重疊。測試跑在 2026 年 10 月的 Claude Code 2.1.295,截圖時已更新到 2.1.296。

順帶一件事:我用的另一個 mod,image-view,在 tmux(一種把終端機分割成多個視窗的工具)裡顯示不出圖片。我修好之後,把修正送回給原作者(PR #15),這樣以後不用自己一直維護修改版。

tmux 裡的圖片:上為原版的空格,下為修正後
tmux 裡的圖片:上為原版的空格,下為修正後

自動檢查很少、對話很短的話,原本的畫面就夠讀,不必多裝。只想看結論的話,/focus 比較省事。對話越長、檢查越多,收起來省下的畫面才越多。

帶走這段

複製給你的 AI Agent

收不收,看有沒有出事——不看紀錄長不長。自己看不出這四個適不適合你的話,把下面這段貼給你的 AI,讓它對照你的實際環境判斷。

# 複製給你的 AI Agent 請先讀這篇文章:https://blog.joneshong.com/zh/blog/claude-code-mods 文章做了四個 Claude Code mod(quiet-tools、hook-notices、turn-nav、prompt-band), 背後的判準是:按「有沒有出事」決定收不收、被檢查擋下的動作和執行失敗分開顯示、 自動檢查的提醒改寫到約好的檔案、長對話給一份問題目錄。 請幫我評估我的環境適不適合裝這幾個 mod: 1. 讀 ~/.claude/settings.json(以及專案裡的 .claude/settings.json),列出每個 hook 掛在哪個時機、 會不會在對話裡印出文字。 2. 對照文章 hook-notices 的交接方式,標出哪幾個 hook 可以改成寫進檔案、各要改哪幾行。 3. 查有沒有開 "tui": "fullscreen";沒有的話,說明 turn-nav 的哪些功能會用不到。 4. 有沒有在動手前擋指令的 hook;有的話,說明 quiet-tools 的紅字單行對我有沒有幫助。 如果我的 hook 很少、對話通常很短,請直接說不需要裝,不要硬套。

延伸閱讀

資源為什麼重要
operonlab/claude-code-mods四個小外掛的原始碼和測試;文中每條判準都能在測試裡找到對應的例子。
Gemini Voyagerturn-nav 的起點:替 Gemini 網頁版長對話加時間軸的開源插件,可以看它怎麼把每則訊息變成能點的節點。
Tickloop/claude-mods另一套一行式的做法,判準不同(失敗也收成一行),對照著看可以想清楚自己要哪一種取捨。
ChatGPT 替長對話加入目錄的報導聊天介面替長對話補目錄的官方做法,可以和終端機的版本對照。
jarrodwatts/claude-image-view PR #15tmux 圖片修正的完整原因和做法。
✦ 帶走這段