工具速查手冊 / 2026.08.02

Claude Code×Codex

指令、Hooks、Plugins 的全景速查。所有數字都實地查證過:星數直接打 GitHub API 取得,指令表對照官方文件與程式原始碼,查不到的一律標明

Claude Code 指令 69 Hook 事件 30 官方 Plugin 38 Codex 指令 50 查證日期 2026.08.02
01

先把名詞講清楚

這幾個詞在後面會一直出現。看懂它們,剩下的內容就都讀得動了。

斜線指令
Slash Command

在輸入框打一個斜線加上指令名稱,叫工具做一件特定的事。它不是跟 AI 聊天,是直接下命令,所以結果固定、不會發揮。

例如打 /usage 就看到這個月用掉多少額度。

掛鉤
Hook

讓工具在「某個時刻」自動做一件事,不需要你每次提醒。像在門上裝感應器:門一開,燈自動亮。

例如設定成「每次改完程式碼,自動跑一次排版」。

外掛
Plugin

一個安裝包。裡面可以同時裝進指令、掛鉤、技能與外部工具連線,一次到位,不用自己一項一項設定。

例如裝一個「程式碼審查包」,就多出一整組審查指令。

技能
Skill

一份寫給 AI 看的工作說明書。告訴它遇到某類任務時該照什麼步驟走、什麼不能做。它會在合適的時機自己讀。

例如寫一份「寫報價單的規矩」,之後每次做報價都照著來。

外部工具連線
MCP

一種通用接頭,讓 AI 能連上外面的服務,例如資料庫、Slack、雲端硬碟。有了它,AI 才能真的去查資料、發訊息,而不只是憑印象回答。

接上雲端硬碟後,可以直接叫它去讀某份試算表。

分身
Subagent

派另一個 AI 去處理一件事,做完只把結論帶回來。適合那種很花時間、過程你也不想全程盯著的雜活。文件裡有時譯為「子代理」,是同一件事。

例如叫它去讀完三十份文件,只回報結論。

對話脈絡
Context

AI 一次能記住的內容總量。塞太滿它就會開始忘掉前面講過的事,所以長對話要定期整理或清空。

/context 可以看目前被什麼佔滿。

工作階段
Session

一段從開始到結束的完整對話。關掉再開就是新的一段,之前講過的事不會自動記得,除非你叫它接續。

/resume 可以回到先前那一段繼續。

02

最值得採用的十件事

從整份資料裡篩出來、學起來最划算的幾個。橘色屬 Claude Code,綠色屬 Codex。

01
/btw

問一個側邊問題,不寫進對話歷史。想確認一件小事又不想打亂目前討論時用。

02
/branch / /fork

同一個對話分岔去試別的方向。/fork 是複製到背景繼續跑,兩者都不破壞原本的進度。

03
/background

把目前這段對話丟到背景繼續跑,讓你手上這條線空出來做別的事。

04
/goal

設一個「達成條件」,它會跨多輪對話自己推進到條件滿足為止,不必你一直催。

05
/rewind

程式碼與對話一起回捲到某個檢查點。改壞了不用手動復原,等於時光機。

06
/context / /usage

前者用彩色網格看記憶被什麼吃掉,後者看額度用了多少。都是立即執行,不打斷對話。

07
hookify

官方出的外掛。用講的就能生成防呆掛鉤,它會分析對話裡出現過的壞行為,自動寫出攔截規則。

08
語言智慧外掛

官方市集有 12 種程式語言的語言伺服器,讓 AI 讀程式碼時是真的看懂結構,不是靠猜。

09
Codex /import

一鍵把 Claude Code 的設定、專案脈絡、近期對話搬進 Codex。兩邊都用的人最短路徑。

10
codex exec --json

不進對話介面直接執行,輸出固定格式的資料,可以接進自動化流程當一個環節。

03

Claude Code 內建指令

官方文件實列約 69 個,以下依用途分組。標記 新招 的是多數人沒用過但值得學的。點任何指令可以直接複製。

先看懂最容易搞混的那幾個

/branch/fork/background/subtask 這四個都跟「分岔」有關,光看說明很難分辨差在哪。 點下面任一個按鈕,看它實際會發生什麼事。

互動示範
選一個指令,看它對你的對話做了什麼。

四個指令的差別,一句話講完

指令跑完你人在哪對話變成怎樣什麼時候用
/branch切換到新分支原本那條完整保留,用 /resume 回去想試另一種做法,但不確定會不會比較好
/fork留在原地複製一份到背景獨立跑,兩邊從此互不相干想同時推進兩條路,自己顧其中一條
/background整個離開,視窗空出來整段對話搬到背景繼續做交代完就走,讓它自己做到完
/subtask留在原地分身出去辦事,只把結果送回這條對話需要一份查詢結果,但不想被過程洗版

對話分岔與平行工作

指令用途
/branch新招從現在這一點分岔,你會被切換過去。原本那條完整保留,用 /resume 回來
/fork新招複製一份到背景獨立跑,你留在原地。可以順便交代副本去做什麼
/background新招別名 /bg。整段對話搬到背景,視窗空出來。可以留一句最後指示再走
/subtask派分身處理旁支任務,只有結論回到這條對話,過程不佔你的畫面
/batch新招要改幾十個檔案套同一種修改時用。開多個隔離工作區平行處理,彼此不會打架
/btw新招問一個快速側問,不寫入對話歷史。不帶問題呼叫可翻閱之前問過的
/goal新招設一個達成條件,它會跨多輪自己推進直到滿足,不必你每輪催
/plan大改動前先讓它出方案給你過目,確認方向對了再動手
/loop要定期盯一件事時用,例如每五分鐘檢查一次部署好了沒

記憶與對話管理

指令用途
/context新招用彩色網格看目前的記憶被什麼佔滿
/compact把前面的對話摘要壓縮騰出空間,但同一條對話繼續走。可指定摘要要著重什麼
/rewind新招程式碼與對話一起回捲到檢查點。改壞了不必自己手動復原檔案
/resume回到先前的某一段對話繼續,也是 /branch 之後回原線的方法
/clear清空記憶開全新一段,跟 /compact 不同,前面的內容不會留下
/focus新招畫面被大量輸出洗版時切過去,只留最後一問一答、一行工具摘要與改動行數統計
/export把整段對話匯出成純文字
/copy複製最後一則回應到剪貼簿

品質與審查

指令用途
/code-review審查這次的改動找出錯誤。加上 ultra 會跑一次雲端深度審查
/security-review掃描這次改動有沒有安全漏洞
/simplify只做簡化與重複清理,不找錯誤
/verify驗證正確性,會實際跑一次測試而不是用看的
/diff開互動式差異檢視器,看還沒提交的改動與每一輪的改動,方向鍵切換檔案與版本

打完指令,畫面上會看到什麼

有些指令的價值要看到輸出才懂。以下是幾個常用指令的畫面示意,數字是編的,版面以你自己的版本為準。

輸出示意
點上面任一個指令,看它的輸出長什麼樣子。
這是依官方文件的描述畫出來的示意圖,不是實際擷圖。數字是編的,實際版面依你的版本而異。

用量與狀態

指令用途
/usage別名 /cost。看這段對話與整個帳號的用量:token 數、請求數、估計花費。立即顯示不打斷回應
/status看目前用哪個模型、思考深度設多少、以及正在追的目標
/tasks列出正在背景跑的工作與分身

模型與設定

指令用途
/model切換使用的模型
/effort設定模型的思考深度
/fast快速模式開關。訂閱方案與 API 帳號都能用,但 Bedrock 這類雲端平台不支援
/advisor顧問工具開關。訂閱方案與 API 帳號都能用,雲端平台同樣不支援
/mcp管理外部工具的連線
/memory編輯它的長期記憶檔
/add-dir把另一個資料夾加進可存取範圍
/cd把這段對話移到別的工作資料夾
/config開設定介面。也能在非互動模式與手機遠端控制時使用
/keybindings自訂鍵盤快捷鍵
/color設定輸入列顏色,連上遠端控制時會同步到網頁版

跨裝置與整合

指令用途
/desktop新招別名 /app。把目前這段對話接續到桌面應用程式。限 macOS 與 x64 Windows、且以訂閱身分登入
/remote-control新招把這段對話連上 claude.ai/code,讓你從別的裝置接著用,也可以管理現有連線
/teleport新招把網頁版的對話拉進終端機
/autofix-pr新招派一個分身盯著這個分支的 PR,測試失敗或審查者留言時自動推修正
/mobile顯示手機版的下載 QR code
/install-github-app安裝 GitHub 整合
/install-slack-app安裝 Slack 整合
/chrome設定瀏覽器擴充功能

診斷與其他

指令用途
/doctor很實用別名 /checkup。健檢整套環境:抓重複安裝與 PATH 問題、揪出佔著記憶卻沒在用的技能與外部工具、標記拖慢速度的掛鉤,還會把 CLAUDE.md 去重、砍掉能從程式碼自行推導的內容、把剩下的常駐指引搬進按需載入的技能。改動前會先報告再問你
/debug開啟除錯記錄
/heapdump傾印記憶體快照,記憶體異常時用
/bug回報問題給官方。你可以選要附多少對話紀錄,送出前會再讓你確認一次
/feedback送出產品意見
/passes符合資格時可分享免費週給朋友
沒有符合的指令,換個關鍵字試試
04

Hooks|讓它在固定時刻自動做事

為什麼需要這個

你可以每次都提醒它「改完記得排版」「不要碰那個資料夾」,但人會忘,AI 也會漏。掛鉤是把這些規矩變成自動執行的機制:不靠提醒,靠攔截。

它在固定時刻一定會跑,不受當下聊了什麼影響。所以最常見的兩種用法,一種是自動做雜事(排版、跑測試、記帳),另一種是擋下不該發生的事(刪檔指令、把密碼寫進檔案)。後者尤其重要,因為那類錯誤一旦發生就來不及了。

設定方式是在設定檔裡寫一段:什麼事件、符合什麼條件、要跑什麼。下面把 30 個可用的時機全部列出來。

30 個時機,都在這條時間軸上

下面是一段對話從開始到結束會經過的時刻。點任何一個事件名稱,看它在什麼時候觸發、能拿來做什麼。

掛鉤生命週期

對話開始

你送出一則訊息

這一段會重複很多次

它要動用工具,但還沒動手

工具跑完之後

如果有派分身出去

它講完一輪話,把發言權交還給你

對話太長,需要壓縮記憶時

對話結束

不在主線上,這些隨時可能發生

點上面任何一個事件名稱,這裡會說明它什麼時候觸發、能拿來做什麼。

rm -rf / 掛鉤檢查 已擋下

掛鉤可以用哪五種方式執行

別人已經在用的 15 個掛鉤

掛在哪個時機做什麼
PostToolUse編輯完自動排版
PreToolUse攔截刪除整個資料夾、強制覆蓋這類危險指令
PreToolUse偵測到密碼或金鑰就擋下,不讓它被寫進檔案
PostToolUse改完程式自動跑對應的測試
PostToolUse把每次操作記成一行紀錄,事後可回溯
PostToolUse依分支名稱自動補上工單編號
PostToolUse從改過的檔案抓出待辦註解,彙整成清單
Stop對話結束自動存一版快照,免得白做
Stop把每段對話的花費記進試算表
Stop任務完成發訊息到團隊聊天室
Stop依對話內容自動生成 PR 的標題與說明
SubagentStop統計每個分身的時間與成本,抓出不划算的派工
Notification等你回應太久就跳桌面通知
PostToolUse編輯完跑一次程式碼檢查
狀態列底部固定顯示目前模型、分支與花費

這份清單整理自社群文章(ayautomate.com,2026 年 6 月),方向可信,但沒有逐條實測過。

最省事的起手式

官方文件直接建議「叫它幫你寫掛鉤」。文件裡給的例句是這樣:寫一個掛鉤,每次改完檔案就跑一次程式碼檢查寫一個掛鉤,擋掉所有對 migrations 資料夾的寫入。你不用先學設定檔格式,講清楚要擋什麼就行。

再進一步,官方有一個叫 hookify 的外掛,會分析你對話裡出現過的壞行為,自動生成對應的攔截規則。等於用 AI 寫規矩來管 AI。

想深入的話,這幾個 repo 值得看

Repo說明星數
FlorianBruniaux/claude-code-ultimate-guide自稱最完整的指南,附現成的擋危險操作與自動排版範例5,631
disler/claude-code-hooks-mastery掛鉤教學的標竿,還示範了語音回報與多代理互審3,865
karanb192/claude-code-hooks包成可直接安裝的市集,分安全、成本、觀測、生產力四類462
05

Plugins|一次裝一整包能力

為什麼需要這個

前面講的指令、掛鉤、技能、外部工具連線,都可以自己一項一項設定。問題是:同一套設定要複製到另一台電腦、另一個專案、或分給同事時,靠手動搬檔案很快就會走樣,而且不知道誰的版本才是對的。

外掛就是把這些打包成一個可以安裝、更新、分享的單位。裝一次,該有的指令與規矩就全都到位;別人更新了,你更新一下就跟上。

換句話說:掛鉤是「一條規矩」,外掛是「一整套配備」。

裝一個外掛,實際會多出什麼

安裝示意
程式碼審查包
/review多一個指令
PreToolUse多一條規矩
審查準則多一份說明書
GitHub多一個連線
一個安裝動作,四種能力同時到位,不用自己一項一項設定。

一個外掛裡面可以裝什麼

可以裝的東西白話說明
指令安裝後多出來的斜線指令
技能寫給 AI 看的工作說明書,遇到對應任務會自己讀
掛鉤自動執行與攔截的規矩
外部工具連線預先設定好的服務連線,裝了就能用
語言伺服器讓 AI 真的讀懂程式碼結構,而不是靠文字猜
代理設定特定用途的 AI 分身與它的行為準則

官方市集有什麼(共 38 個,以下為精選)

分類內容
語言智慧12 種語言:TypeScript、Rust、Python、Go、C/C++、C#、Java、Kotlin、Lua、PHP、Ruby、Swift。裝了之後 AI 讀那個語言的程式碼會準很多
開發流程程式碼審查、簡化、現代化改寫、功能開發、PR 審查工具組、提交訊息、工作總結
安全治理安全掃描、安全建議、專案規則檔管理
做給開發者用的外掛開發、外部工具開發、hookify 自動生成掛鉤、技能產生器
輸出風格解說型、教學型,改變它回答你的方式
趣味與實驗ralph-loop 讓它用同一個指令反覆跑到完成、數學奧林匹亞、前端設計

三種安裝方式

06

社群資源排行

星數是 2026 年 8 月 2 日直接向 GitHub 查詢取得的,不是抄自搜尋結果的舊數字。

Repo一句話星數
obra/superpowers把測試驅動開發、系統化除錯這類方法論做成會自動觸發的技能包
264,730
affaan-m/ECC定位有疑義,見最後一節說明
236,784
ComposioHQ/awesome-claude-skills上千個跨工具技能,含 78 組現成的雲端服務整合
71,539
shanraisshan/claude-code-best-practice先講方法再列工具的實踐指南
63,852
hesreallyhim/awesome-claude-code公認最正統的清單。每天更新,失效的項目會主動下架
51,447
luongnv89/claude-howto圖解式教學,掛鉤與記憶各有專章
40,755
wshobson/agents同一套代理定義可以跨多種工具使用
38,421
anthropics/claude-plugins-official官方外掛市集
32,943
davila7/claude-code-templates一站式安裝器,配網頁介面 aitmpl.com 點選即裝
30,038
wshobson/commands57 個現成指令,不過近十個月沒更新了
2,597
qdhenry/Claude-Command-Suite兩百多個指令,含 GitHub 與工單系統雙向同步
1,323
如果只收藏三個

hesreallyhim/awesome-claude-code 最正統的策展清單,每天更新,repo 裡還附一套可以直接抄的指令。

aitmpl.com 把六百多個代理、兩百多個指令、三十幾個掛鉤做成網頁介面,看中什麼點了就裝。

官方最佳實踐文件 講怎麼讓 AI 自我驗證、先探索再規劃再動手的四階段流程、規則檔怎麼寫,還附一份「這樣做會出事」的反面清單。內容跟著版本一起更新。

07

Codex 側|兩個顛覆舊印象的發現

以 2026 年 7 月底的 0.146.0 版為準。指令表是直接對照程式原始碼列出來的,比文件頁更準。

結論先講

Codex 現在有正式的掛鉤與外掛系統了,2026 年 3 月起陸續上線。事件名稱幾乎跟 Claude Code 一模一樣,所以熟悉一邊的人可以直接把經驗搬過去。

如果你對 Codex 的印象還停留在「就是個沒有擴充機制的終端機工具」,這印象在 2026 年中已經過時。這件事有官方文件、程式原始碼、以及一個實際存在的相關參數三方佐證。

指令亮點

指令用途
/import必試把 Claude Code 的設定、目前專案、近期對話一次搬進來
/hooks檢視與管理掛鉤
/plugins瀏覽外掛市集
/skills管理技能。注意在 Codex 裡是用 $ 開頭呼叫技能,不是斜線
/memories設定它要記住什麼、怎麼記
/side別名 /btw。開一個用完即棄的側邊對話
/goal設定長時間任務的目標
/fork分岔目前的對話
/plan切換到規劃模式
/review審查目前的改動找問題
/agent別名 /subagents。切換分身
/apps管理外部服務連線,例如 GitHub、Slack、雲端硬碟
/approve核准一次被自動審查擋下的重試
/personality選它跟你說話的風格
/ps列出背景執行中的終端,/stop 全部停掉
/pets在終端機裡養一隻寵物,官方放的彩蛋

接進自動化流程

# 不進對話介面,直接執行並輸出固定格式的資料
codex exec "任務描述" \
  --json \
  --output-schema schema.json \
  -o last-message.txt

# 接續上一次的執行
codex exec resume --last

這組參數會讓輸出變成穩定的結構化資料,下游程式可以直接解析,適合當自動化流程裡的一個節點。

三個要留意的地方

  1. 套件名稱有陷阱 正確的是 @openai/codex。如果裝成沒有前綴的 codex,會裝到一個 2012 年就存在的無關套件,而且不會報錯,你以為裝好了其實不是。
  2. 舊的自訂指令機制已不建議用 官方標示改推技能,而且某個版本後有選單消失的問題,官方也沒打算修。要用之前先實測。
  3. 外掛不是每個介面都能用 官方明講編輯器擴充、手機版都不支援,只有終端機版與桌面應用程式有。
08

桌面版與終端機版的差別

官方沒有出一張逐指令的平台對照表,以下依證據強弱分開講。

實際測試出來的結果

官方文件寫明的幾點

合理推測,但文件沒寫

09

還沒查證清楚的部分

查不到就是查不到。以下七項沒有被當成確定事實寫進前面的內容,如果你要引用,請自己再確認一次。

  1. affaan-m/ECC 到底是什麼 星數 236,784 是真的,但有文章說它是資源索引,官方說明卻寫成效能優化框架,兩邊對不上。
  2. 「Claude Cowork」跟 Claude Code 的關係 名稱容易混淆,那篇文章列的外掛清單本文沒有採用。
  3. playwright 外掛是否還在官方市集 逐一看過 38 個項目沒有找到,可能已經下架或改名。
  4. Codex 文件多出來的 8 個指令 /cloud/worktree 這幾個在程式原始碼裡找不到。實際以你電腦上打斜線跳出來的清單為準。
  5. Codex 雲端版支不支援掛鉤與外掛 官方沒寫,本文不做猜測。
  6. 那些部落格文章的實際影響力 只確認了查得到、日期新、內容具體,沒有逐篇去看閱讀量。
  7. 15 個現成掛鉤的清單 整理自社群文章,方向合理但沒有逐條實測。
修正紀錄

掛鉤事件數量最初查到的是 34 個,回頭核對官方文件後修正為 30 個。

/subtask 這個指令第一次查有找到,第二次複查時只在別的指令說明文字裡看到它被提及,證據比其他指令弱,所以在這裡標記出來。

本頁的中文說明是從官方的一行英文說明改寫而來,改寫過程中曾混入未經查證的推斷。2026-08-02 做了一次逐條複查,修掉 5 處與官方文件不符的說法(其中 /doctor 原本只寫「檢查安裝」,漏掉它其實會健檢整個工作區並幫 CLAUDE.md 瘦身;/fast/advisor 原本寫「訂閱方案限定」,實際上 API 帳號也能用),另外收斂了 10 處自行加上、官方沒說的細節。

10

那該從哪裡開始

  1. 今天就能試的五個指令 /btw 問側邊問題、/branch 分岔試方向、/rewind 改壞了回捲、/context 看記憶佔用、/goal 交代長任務。這五個桌面版都能用。
  2. 先跑一次 /doctor 它會告訴你哪些技能與外掛佔著記憶卻根本沒在用、哪個掛鉤在拖慢速度,還會幫你把 CLAUDE.md 去重瘦身、把常駐指引改成按需載入。CLAUDE.md 養得越久這個越有感。要在終端機版跑,桌面版開不起來。
  3. 裝一個 hookify 官方出的,用講的就能生成防呆規則。如果你曾經被「不小心刪掉東西」嚇到過,這是最直接的解法。
  4. 裝對應語言的智慧外掛 寫哪種語言就裝哪個,AI 讀你的程式碼會準很多。
  5. 收藏兩個地方 awesome-claude-code 看最新有什麼、aitmpl.com 用點的挑工具。
  6. 兩邊都用的話 在 Codex 跑一次 /import,把設定搬過去,省下重新配置的時間。
已複製