Claude Code CLI 指令語法大全：一篇搞懂所有常用指令

🤖 Claude Code CLI 指令總覽

Claude Code 是 Anthropic 推出的代理式命令列介面 (Agentic CLI)，讓開發者可以直接在終端機中與 AI 對話、分析程式碼、執行命令與編輯檔案。本文聚焦於指令語法，幫你快速查找需要的用法。

🚀 啟動與對話指令

基本啟動

語法	說明
`claude`	啟動互動式 REPL，在當前目錄開始對話
`claude "問題內容"`	帶著問題啟動互動模式
`claude -p "問題內容"`	Print Mode：輸出回答後直接結束

範例

# 進入互動模式
claude

# 帶著問題啟動
claude "解釋這個專案的架構"

# 只拿答案，不進入互動
claude -p "用 TypeScript 寫一個 debounce 函式"

對話管理

語法	說明
`claude -c`	繼續上一次的對話 session
`claude -c -p "問題"`	在上一次 session 中提問後結束
`claude -r "session名稱" "問題"`	恢復指定名稱的 session 並提問
`claude --fork-session`	搭配 `-c` 或 `-r`，從既有 session 分支出新對話

範例

# 繼續上次對話
claude -c

# 恢復之前命名為 "auth-refactor" 的 session
claude -r "auth-refactor" "PR 完成了嗎？"

# 從某個 session 複製一個新分支繼續聊
claude -r "auth-refactor" --fork-session

📂 管道模式 (Pipe)

Claude Code 支援 Unix 管道，可以將任何文字資料餵給 AI 分析：

語法	說明
`cat 檔案 \| claude -p "問題"`	讀取檔案內容後提問
`指令 \| claude -p "問題"`	將指令輸出作為上下文提問

範例

# 分析錯誤日誌
cat error.log | claude -p "解釋這些錯誤訊息並給出修復建議"

# Code Review
git diff main..feature | claude -p "review 這些變更，列出潛在問題"

# 自動產生 commit message
git diff --staged | claude -p "產生一個符合 conventional commits 的 commit message"

# 解讀測試結果
npm test 2>&1 | claude -p "這些測試為什麼失敗？怎麼修？"

⚡ 斜線指令 (Slash Commands)

在互動模式中，輸入 / 加上指令名稱即可執行。以下依功能分類：

Session 管理

指令	說明
`/compact`	壓縮對話歷史，釋放 context window 空間
`/rename <名稱>`	重新命名目前的 session
`/resume <名稱>`	恢復指定名稱的 session
`/exit`	結束互動模式 (也可以用 `Ctrl+C`)

資訊查詢

指令	說明
`/help`	顯示所有可用的斜線指令
`/cost`	查看 token 使用量與預估費用
`/permissions`	查看或管理工具執行權限

專案與設定

指令	說明
`/init`	初始化專案，自動建立或更新 CLAUDE.md
`/config`	開啟互動式設定介面 (主題、模型、權限等)
`/doctor`	執行診斷檢查，排查 API 連線或設定問題
`/mcp`	管理 MCP 伺服器連線 (新增、移除、認證)
`/review`	請 Claude 對當前程式碼變更進行 Code Review

使用範例

> /cost
# 顯示目前 session 的 token 用量與預估費用 (實際格式依版本而異)

> /compact
Compressed conversation from 45,000 to 8,000 tokens.

> /rename my-feature-work

> /init
Creating CLAUDE.md with project context...

🔧 進階 CLI 參數

目錄與上下文

參數	說明
`--add-dir <路徑>`	加入額外目錄讓 Claude 讀取 (可多次使用)
`--init`	啟動時執行初始化 hooks
`--init-only`	僅執行初始化 hooks，不進入對話

範例

# 同時讀取前端和後端的程式碼
claude --add-dir ../backend --add-dir ../frontend

# 啟動時自動執行初始化
claude -p --init "分析整個專案"

模型與思考深度

參數	說明
`--effort low`	快速簡短回答
`--effort medium`	平衡速度與品質 (預設)
`--effort high`	更深入的分析
`--effort xhigh`	極深度分析
`--effort max`	最詳盡的回答，適合複雜任務
`--fallback-model sonnet`	設定當主模型不可用時的備用模型

範例

# 快速回答簡單問題
claude -p --effort low "這個 function 做了什麼？"

# 深度分析複雜邏輯
claude -p --effort max "分析這段演算法的時間複雜度"

權限模式

參數	說明
`--permission-mode default`	預設模式，每次操作前都會詢問
`--permission-mode auto`	自動核准符合規則的操作
`--permission-mode plan`	唯讀模式，只能分析不能修改
`--dangerously-skip-permissions`	跳過所有權限檢查 (⚠️ 危險)
`--allowedTools "工具名稱"`	指定允許使用的工具
`--disallowedTools "工具名稱"`	指定禁止使用的工具

範例

# 唯讀模式，適合純分析
claude --permission-mode plan

# 只允許讀取和 git 操作
claude --allowedTools "Read" "Bash(git log *)" "Bash(git diff *)"

系統提示

參數	說明
`--append-system-prompt "指示"`	附加自訂系統提示文字
`--append-system-prompt-file <檔案>`	從檔案載入附加系統提示

範例

# 限定回答使用 TypeScript
claude --append-system-prompt "Always use TypeScript, never JavaScript"

# 載入團隊的共用規則
claude --append-system-prompt-file ./team-rules.txt

輸出格式

參數	說明
`--output-format text`	純文字輸出 (預設)
`--output-format json`	JSON 格式輸出
`--output-format stream-json`	串流 JSON 格式 (適合程式整合)
`--bare`	精簡模式，跳過非必要的 UI 元素

範例

# CI/CD 中取得結構化輸出
claude -p --output-format json "列出所有 TODO 項目" < app.ts

# 精簡模式，適合腳本使用
claude --bare -p "快速回答"

🔑 帳號與系統指令

語法	說明
`claude auth login`	登入帳號
`claude auth logout`	登出帳號
`claude auth status`	查看目前登入狀態
`claude update`	更新到最新版本
`claude install stable`	安裝穩定版
`claude install latest`	安裝最新版 (可能包含測試功能)
`claude --version`	顯示目前版本號
`claude --help`	顯示完整參數說明
`claude mcp`	管理 MCP 伺服器
`claude agents`	管理子代理 (subagents)
`claude --debug "api"`	啟用 debug 模式，輸出除錯資訊

📊 互動模式快捷鍵

快捷鍵	功能
`Ctrl + C`	中斷當前操作或結束 session
`Shift + Tab`	切換 Auto Mode (自動核准操作)
`@檔案名稱`	提及特定檔案作為對話上下文
`/`	開啟斜線指令選單

🛠️ 常見指令組合速查

以下整理開發日常中最實用的指令組合：

情境	指令
Code Review	`git diff \| claude -p "review 這段程式碼"`
產生 commit message	`git diff --staged \| claude -p "產生 conventional commit message"`
分析錯誤日誌	`cat error.log \| claude -p "分析根本原因"`
跨專案分析	`claude --add-dir ../api --add-dir ../web`
唯讀分析模式	`claude --permission-mode plan`
深度分析	`claude -p --effort max "問題"`
CI/CD 整合	`claude -p --output-format json --bare "問題"`
繼續上次對話	`claude -c`
壓縮長對話	互動模式中輸入 `/compact`
查看費用	互動模式中輸入 `/cost`

常見問題 FAQ

Q1：`claude` 和 `claude -p` 有什麼差別？

claude 和 claude "問題" 會啟動互動模式，你可以持續對話。claude -p "問題" 是 Print Mode，輸出回答後立即結束程式，適合用在腳本或一次性查詢。

Q2：`/compact` 什麼時候該用？

當你在一個 session 中對話很久，發現 Claude 開始「忘記」之前討論過的內容，或者回應速度明顯變慢時，就該使用 /compact。它會壓縮對話歷史，保留關鍵上下文並釋放 token 空間。

Q3：`--effort` 各等級的差異是什麼？

low：快速回應，適合簡單問題 (如「這個變數是什麼型別？」)
medium：預設等級，平衡速度與品質
high：更深入的思考與分析
xhigh：極深度分析，介於 high 與 max 之間
max：最完整的回答，Claude 會花更多時間思考，適合複雜的架構設計或 debug

Q4：怎麼讓 Claude 同時讀取多個專案的程式碼？

使用 --add-dir 參數，可以多次指定：

claude --add-dir ../project-a --add-dir ../project-b --add-dir ../shared-lib

Claude 會同時讀取所有指定目錄的內容作為上下文。

Q5：`--permission-mode plan` 和 `default` 差在哪？

plan 模式下 Claude 完全不能修改檔案或執行命令，只能讀取與分析。適合你只想要 AI 幫忙看程式碼、給建議，但不希望它碰你的專案時使用。default 模式下 Claude 可以提議修改，但每次都會先詢問你的同意。

總結

Claude Code CLI 的指令可以歸納為五大類：

啟動指令： claude、claude -p、claude -c——控制如何開始和延續對話
管道操作： cat / git diff | claude -p——把任何資料餵給 AI 分析
斜線指令： /compact、/cost、/init——在互動模式中快速操作
進階參數： --effort、--permission-mode、--add-dir——精細控制行為
系統指令： claude auth、claude update、claude mcp——帳號與環境管理

熟悉這些指令語法後，你就能更高效地運用 Claude Code 來加速日常開發工作。