CLI Agent 新手入坑:三大家真正共有的 8 個命令(Claude Code / Codex CLI / OpenCode)

三家 CLI Agent 命令匯流主視覺

裝完 Claude Code,第一次在 prompt 敲 /,跳出來 90 幾個命令——這不是誇張,是 我自己 grep 官方 docs 數出來的 。Codex CLI 大概 40 個,OpenCode 大概 20 個。三家加起來破百,你坐在那邊滑著選單想:「我到底要記哪幾個才能開始幹活?」

我也是這樣愣過。後來把三家官方 docs 整個爬一遍,發現一件事:真正三家都有、語意又夠接近的內建命令,只有 8 個。把這 8 個吃透,你就能跨工具切換,不必在每次換家時重學一輪。

這篇是給準備入坑的人看的——不講花俏、不秀進階;講 8 個命令、3 個必踩坑,和一條「第一天就能跑」的工作流。


三大家是誰?要選哪一家入坑?

三家 CLI Agent 對峙示意

先說人是誰:

工具 出身 語言 架構 開源
Claude Code Anthropic 官方 TypeScript / Node.js Standalone
Codex CLI OpenAI 官方 Rust Standalone 是(Apache 2.0)
OpenCode sst.dev (GitHub org sst Go(server)+ TypeScript / Bun(TUI) Client / Server 是(MIT,168k+ stars

實戰選擇講白話:

  • 想要功能最齊全、Claude 模型強:選 Claude Code ,命令 90 個爆炸給你,連 /stickers(訂貼紙)/voice(語音輸入)都有,廢到笑但有用的也不少。
  • 想要 ChatGPT 訂閱戶免費 + 跑 CI / 自動化:選 Codex CLI ,命令精簡正交,sandbox + approval + plan mode 三層防護做得最嚴。
  • 想要自由換 model、隱私、跨裝置:選 OpenCode ,唯一 client/server 架構,SSH 斷線後重連,跑中的任務還活著——這在跨域工作或長任務時夭壽好用。

三家不必選邊站。我自己是平常 Claude Code 主力、CI 用 Codex、長跑任務或想換 Sonnet/GPT/Gemini 比較時切到 OpenCode。能跨家的關鍵就是接下來這 8 個命令。


三家真正共有的 8 個命令

把三家的官方 slash commands 列表交叉比對之後,所有三個工具都內建、語意相近的命令只有這 8 個:

命令 Claude Code Codex CLI OpenCode 一句話用途
/init 產生 CLAUDE.md 產生 AGENTS.md 產生 AGENTS.md 專案初始化掃描
/clear aliases /reset /new 清螢幕+新對話 /new 的 alias 開新對話
/compact [instructions] 可指定焦點 摘要對話釋放 context alias /summarize 壓縮對話
/help 顯示全部命令 顯示全部命令 顯示全部命令 忘記就敲它
/model / /models 單數 單數 複數 切換模型
/resume [session] 或選單 從本地 transcript alias /sessions /continue 恢復過去 session
/exit / /quit /exit 兩個都收 /exit /quit /q 離開
/diff 含 untracked 含 untracked 沒有原生,用 !git diff 看 Git diff

⚠️ 嚴格講 /diff 在 OpenCode 不是原生 slash 命令,但 OpenCode 支援 ! 前綴跑 shell 命令,敲 !git diff 就行,所以放寬算進來。如果你龜毛,真共有只有 7 個。

8 個命令我幫你分成三組記憶:

開局 / 收工/init /exit
對話管理/clear /compact /resume
日常操作/help /model /diff

這分組不是亂湊的——這正是你在一個 session 從頭到尾會經過的順序。


/init 看似一樣,產物完全不同(最容易踩第一坑)

三家 init 產物示意

三家 /init 都會「掃描你的專案、生成一份 markdown,給 agent 每次對話開頭讀」。但產物檔名不一樣

  • Claude Code → CLAUDE.md
  • Codex CLI → AGENTS.md
  • OpenCode → AGENTS.md

AGENTS.md 是社群在 2025 年慢慢收斂出來的「跨工具標準」,目前 Codex、OpenCode、Cursor、Amp、Zed 全部採用。只有 Claude Code 還在堅持自家的 CLAUDE.md——這件事在 GitHub 上吵了將近一年(issue #6235 自 2025-08 開到現在),到 2026 年中還沒結論。

那實務上怎麼處理?兩種解法:

解法一:symlink 大法(跨工具團隊推薦)

# 在專案根目錄
touch AGENTS.md
ln -s AGENTS.md CLAUDE.md
# 之後只維護 AGENTS.md,CLAUDE.md 自動跟著動

這招 HN 上 很多人在用 ,乾淨。

解法二:在 CLAUDE.md 內嵌 AGENTS.md

# CLAUDE.md
@AGENTS.md
(其他 Claude 專屬指令…)

Anthropic 官方有承認這招會把 AGENTS.md 內容塞進 system prompt,等同直接讀。

順帶一提:OpenCode 會自動讀 CLAUDE.md——如果你已經寫好 CLAUDE.md 想切到 OpenCode,啥都不用改。Codex 不會,需要自己改名。

還有一個雷:別亂跑 /init

HumanLayer 的這篇 講得直白:自動生成的 CLAUDE.md / AGENTS.md 通常太長,會塞滿每一次對話的 context window,反而降低品質

實戰建議:/init 第一次跑就好,跑完立刻精簡——只留下 LLM「光看 repo 結構推不出來」的東西(例如:團隊內部用詞、隱私限制、特殊架構決策)。剩下的全刪。50 行就很夠。


/clear vs /compact vs /resume——新手最容易死的三條 alley

對話管理三命令概念

這三個命令長得很像,做的事差很多。我看過太多人把它們搞混,結果不是燒爆 token,就是把重要對話清掉。

/clear——徹底重置

session 開始 → 講了三件事 → /clear → 對話歸零,但檔案改動還在

三家都有,但 alias 略不同:

  • Claude Code/clear /reset /new 三個都一樣,/clear [name] 還可以順手把舊對話命名存到 /resume 選單裡(這設計超貼心)
  • Codex CLI/clear 直接清螢幕+開新對話。如果只想清螢幕保留對話,按 Ctrl+L
  • OpenCode/new 才是本名,/clear 是 alias。前一個 session 自動留在 /sessions 列表

⚠️ 三家都不會還原檔案改動。要還原檔案:

  • OpenCode:/undo(內建用 git 管,乾淨)
  • Claude Code:/rewind(可選「只還原程式碼 / 只還原對話 / 都還原」)
  • Codex CLI:手動 git restore,沒有 slash 命令

/compact——壓縮但保留

session 開始 → 講了 30 件事 → /compact → LLM 摘要前 28 件,最後 2 件保留原樣

三家都有,這是「長對話救命招」。社群公認最大的省 token 技巧不是 /compact,是用 /clear 換題。但如果你「想繼續同一個任務、但 context 已經滿到警告了」,這時 /compact 才出場。

Claude Code 還能帶參數指定保留焦點:

/compact Focus on the auth module and the failing tests

OpenCode 對應命令是 /summarize(與 /compact 互為 alias)。Codex 跑 /compact 會先問你確認再壓——保守派最愛。

/resume——三家「貌合神離」,差異最大

表面三家都做「恢復過去 session」,但底層機制完全不同

工具 機制 體感
Claude Code 存檔的 transcript 重啟 冷啟動,狀態凍結重建
Codex CLI 本地存檔的 transcript 復原 類似 Claude,靜態
OpenCode 連回 live 的後台 server session 還活著,跑中任務沒中斷

夭壽,這就是為什麼 Medium 上有篇比較文 一直強調 OpenCode 的「session 持久性」是真差異化——它是唯一不怕 SSH 斷線的工具。

如果你的工作流會涉及長跑任務(測試套件、大型重構、批次處理),這個差異會直接影響你選哪家。


第一天就能跑的 6 步工作流

Day1 工作流流程示意

這套流程在三家 CLI 都通用。把它印出來貼螢幕旁邊,第一週照著做就對了。

# Step 1:進專案
cd /path/to/project

# Step 2:啟動工具(擇一)
claude          # Claude Code
codex           # Codex CLI
opencode        # OpenCode

# Step 3:第一個動作——產生專案說明檔
/init
# 跑完立刻打開 CLAUDE.md / AGENTS.md,刪掉 80% 廢話

# Step 4:開始對話
> 這個專案是做什麼的?先給我一張架構圖

# Step 5:對話一長就壓縮
/compact

# Step 6:commit 前看改動
/diff
# OpenCode 是 !git diff

# 隔天接續
/resume

# 換完全不同的任務時
/clear

# 收工
/exit

口訣(建議背起來)

/init 開局、/clear 換題、/compact 續命、/resume 接班、/diff 防爆、/exit 收工。

學會這 6 個動詞,你就能在三家 CLI 之間自由換家。其他 90+ 個命令是進階課題,等你穩了再慢慢吃。


三家獨家亮點(值得知道但別現在學)

最後留一張小抄,講三家「最值得多看一眼」的獨家命令。第一週不用碰,但知道它們存在,之後遇到痛點才知道要去找哪一家。

Claude Code 獨家

  • /rewind:選擇性回滾「程式碼 / 對話 / 兩者」。我覺得這是 Claude Code 最神的命令,比 git stash 還順手。
  • /btw <question>:「順便問一下」——暫時插隊問問題,不污染主對話。寫到一半想確認某 API 用法時超好用。
  • /security-review:對 pending 變更做安全審查。
  • /skills:列出所有 skill(社群在 這個寶藏地圖 收集了不少)。

Codex CLI 獨家

  • /personality:對話風格(friendly / pragmatic / none)。pragmatic 模式不會跟你寒暄,CI 用爆好。
  • /approve:批准 auto-review 拒絕的動作重試。
  • /experimental:開啟實驗功能,例如 subagents。

OpenCode 獨家

  • /share:產生公開 URL(opncd.ai/s/...),把 session 丟給同事看,連 onboarding 都省了。
  • /unshare:撤回分享。
  • /details / /thinking:toggle 工具細節與思考顯示。debug 神器。

寫在最後:別被命令數量嚇跑

90+ 個命令看起來嚇人,真正用到的就那 8 個。其他都是「你想到時才存在」的工具——遇到痛點才查 /help,不必預先全部記住。

CLI agent 這場仗打到 2026 年,三家已經明顯收斂在共通詞彙上:/init 產說明檔、/clear 換題、/compact 續命、/resume 接班。再過半年大概還會多幾個共通命令(/skills 看起來會收斂、/hooks 也快了),這篇之後我會更新。

入坑就從 /init 開始,跑完刪掉 80% 自動生成的內容,剩下的事就讓 agent 幫你做。


延伸閱讀

沒有留言:

張貼留言

TTS 文字轉語音完全指南:技術原理、聲音克隆與 2026 選型實戰

前陣子我在測 Qwen3-TTS,官方技術報告寫著首包延遲 97ms,聽起來就是為即時對話而生的。結果我照官方範例跑起來,按下生成、等了整整 10 秒才聽到第一個字。乾,差了一百倍。 這不是我環境爛,而是 TTS 這個領域的日常:論文數字、行銷頁數字、你實際跑出來的數字,是三個...