# Claude Code 指令大全

> 收錄超過 159 個 CLI 指令、斜線命令、快捷鍵與設定檔參考。
> 版本：1.0.0 | 更新：2026-04-22

## 🚀 CLI 啟動與 Session（CLI Launch & Session）

啟動 Claude Code、繼續對話、恢復 session 等基本操作

### `claude` : 啟動互動（基礎）

啟動 Claude Code 互動式 session，進入對話模式

### `claude "query"` : 帶提示啟動（基礎）

以初始提示直接啟動 session，省去打開後再輸入的步驟

```
claude "幫我重構這個函式"
```

### `claude -c` : 繼續對話（基礎）

繼續最近一次的對話 session，自動載入上次 context

### `claude -c -p "query"` : 繼續列印模式（進階）

在繼續對話的同時使用 print 模式，輸出後立即結束

```
claude -c -p "上次的問題解決了嗎"
```

### `claude -r "session"` : 恢復指定（進階）

恢復指定名稱的 session，可搭配 -n 命名過的 session 使用

```
claude -r "refactor-auth"
```

### `claude -p "query"` : 列印模式（基礎）

非互動 print 模式：執行查詢後直接輸出結果並結束

```
claude -p "解釋這個錯誤訊息"
```

### `cat file | claude -p "query"` : 管線輸入（進階）

透過 stdin pipe 將檔案內容傳給 Claude 處理

```
cat error.log | claude -p "分析這些錯誤"
```

### `claude -w` : 工作樹模式（進階）

在 git worktree 中啟動，隔離修改不影響主分支

### `claude -w name --tmux` : 工作樹 tmux（進階）

建立命名的 worktree 並在 tmux session 中執行

```
claude -w fix-auth --tmux
```

### `claude --remote "task"` : 遠端 Session（進階）

建立 web session，可在瀏覽器中操作 Claude Code

```
claude --remote "重構登入模組"
```

### `claude --teleport` : 接續遠端（進階）

將遠端 web session 接回本地終端繼續操作

### `claude update` : 更新版本（基礎）

更新 Claude Code 到最新版本

### `claude auth login` : 登入（基礎）

登入 Claude Code，進行身份驗證

### `claude auth logout` : 登出（基礎）

登出目前的 Claude Code 帳號

### `claude auth status` : 驗證狀態（基礎）

檢查目前的登入狀態與帳號資訊

### `claude mcp add` : 新增 MCP（進階）

新增 MCP (Model Context Protocol) 伺服器連接

```
claude mcp add ./my-server --scope project
```

### `claude agents` : 列出代理（進階）

列出所有已定義的 subagent（子代理）

### `claude setup-token` : 產生 Token（進階）

產生 OAuth token 供 CI/CD 自動化使用

## 🏳️ CLI 旗標與參數（CLI Flags & Arguments）

控制模型、權限、輸出格式、效能限制等執行參數

### `--model opus/sonnet/haiku` : 指定模型（基礎）

選擇要使用的 Claude 模型：opus 最強、haiku 最快

```
claude --model opus "分析架構"
```

### `--effort low/medium/high/xhigh/max` : 推理強度（基礎）

調整 AI 推理深度：low 快速回應、max 深度分析

```
claude --effort max "設計資料庫 schema"
```

### `--system-prompt "..."` : 替換系統提示（進階）

完全替換預設系統提示詞，自訂 Claude 的行為基準

```
claude --system-prompt "你是資安專家"
```

### `--system-prompt-file path` : 檔案系統提示（進階）

從檔案載入系統提示詞，適合長篇指令

```
claude --system-prompt-file ./prompts/reviewer.md
```

### `--append-system-prompt "..."` : 追加系統提示（進階）

在預設系統提示詞之後追加自訂內容

```
claude --append-system-prompt "回答請用繁體中文"
```

### `--append-system-prompt-file path` : 檔案追加提示（進階）

從檔案載入內容追加到系統提示詞之後

```
claude --append-system-prompt-file ./extra-rules.md
```

### `--permission-mode default/acceptEdits/plan/auto/dontAsk/bypassPermissions` : 權限模式（進階）

設定工具執行的權限等級：plan 最安全、bypassPermissions 全自動

```
claude --permission-mode auto "修復所有 lint 錯誤"
```

### `--dangerously-skip-permissions` : 跳過權限（進階）

跳過所有權限確認提示，完全自主執行（需謹慎使用）

危險操作：建議僅在受控環境（如 CI）中使用

### `--allowedTools "Bash(git *)" "Read"` : 工具白名單（進階）

指定允許使用的工具清單，支援 glob 模式匹配

```
claude --allowedTools "Read" "Grep" -p "分析程式碼"
```

### `--disallowedTools "Edit"` : 工具黑名單（進階）

指定禁止使用的工具清單

```
claude --disallowedTools "Bash" "Edit" -p "只讀分析"
```

### `--max-turns 3` : 最大回合數（進階）

限制代理執行的最大回合數，防止無限迴圈

```
claude --max-turns 5 -p "逐步修復 bug"
```

### `--max-budget-usd 5.00` : 預算上限（進階）

設定最大 API 花費上限（美元），超過自動停止

```
claude --max-budget-usd 2.00 "大規模重構"
```

### `--output-format json/text/stream-json` : 輸出格式（進階）

指定輸出格式：json 結構化、text 純文字、stream-json 串流

```
claude -p --output-format json "列出所有函式"
```

### `--json-schema '{...}'` : JSON 驗證（進階）

用 JSON Schema 驗證輸出結構，確保回傳格式正確

```
claude -p --output-format json --json-schema '{"type":"object"}' "query"
```

### `--input-format stream-json` : 輸入格式（進階）

指定 print 模式的輸入格式，用於程式化串接

### `--add-dir ../lib` : 追加目錄（進階）

將額外目錄加入工作範圍，讓 Claude 可以存取多個專案

```
claude --add-dir ../shared-lib --add-dir ../types
```

### `--settings ./settings.json` : 載入設定（進階）

從指定路徑載入額外的設定檔

```
claude --settings ./team-settings.json
```

### `--name "my-session" / -n` : 命名 Session（基礎）

為 session 命名，方便日後用 -r 恢復

```
claude -n "auth-refactor"
```

### `--sandbox` : 沙箱模式（進階）

啟用作業系統層級沙箱，限制檔案系統與網路存取

### `--chrome / --no-chrome` : Chrome 開關（進階）

啟用或停用 Chrome 瀏覽器自動化功能

### `--mcp-config ./mcp.json` : MCP 設定檔（進階）

從指定路徑載入 MCP 伺服器設定

```
claude --mcp-config ./my-mcp-servers.json
```

### `--strict-mcp-config` : MCP 嚴格模式（進階）

只使用指定的 MCP 設定，忽略全域與專案設定

### `--tools "Bash,Edit,Read"` : 限制工具（進階）

限制可用工具範圍，只允許指定的工具

### `--debug "api,mcp"` : 除錯日誌（進階）

啟用指定類別的除錯日誌輸出

```
claude --debug "api,mcp,tools"
```

### `--debug-file /tmp/debug.log` : 除錯檔案（進階）

將除錯日誌寫入指定檔案而非終端

```
claude --debug "api" --debug-file /tmp/claude-debug.log
```

### `--verbose` : 詳細輸出（進階）

啟用詳細日誌模式，顯示更多執行資訊

### `--bare` : 精簡模式（進階）

最小化啟動模式，跳過自動探索 CLAUDE.md 和設定檔

### `--init` : 執行初始化（進階）

執行 init hooks 後啟動互動 session

### `--init-only` : 僅初始化（進階）

只執行 init hooks 後立即結束，不啟動 session

### `--no-session-persistence` : 不存 Session（進階）

不將 session 資料存到磁碟，適合臨時使用

### `--from-pr 123` : 關聯 PR（進階）

恢復與指定 Pull Request 關聯的 session

```
claude --from-pr 456
```

### `--fork-session` : 分叉 Session（進階）

基於當前 session 建立新的分叉，保留上下文但獨立追蹤

### `--session-id "uuid"` : 指定 Session ID（進階）

使用特定的 session ID，用於精確恢復或外部整合

### `--fallback-model sonnet` : 備用模型（進階）

主模型過載時自動切換到備用模型

```
claude --model opus --fallback-model sonnet
```

### `--ide` : IDE 連接（進階）

自動連接到 IDE（如 VS Code），同步編輯狀態

### `--betas interleaved-thinking` : 啟用 Beta（進階）

啟用指定的 beta 功能，如交錯思考模式

```
claude --betas interleaved-thinking
```

### `--teammate-mode auto/in-process/tmux` : 團隊模式（進階）

設定多代理協作的顯示模式：auto 自動、tmux 分割視窗

### `--disable-slash-commands` : 停用斜線指令（進階）

停用所有 skill 和自訂斜線指令

### `--remote-control` : 遠端控制（進階）

啟動時開啟 Remote Control 功能，可透過 API 操控

### `--exclude-dynamic-system-prompt-sections` : 排除動態提示（進階）

排除動態系統提示區段，提升 prompt cache 命中率

### `--allow-dangerously-skip-permissions` : 允許跳過權限（進階）

將 bypassPermissions 加入 Shift+Tab 權限切換循環

## ⌨️ 斜線指令（Slash Commands）

在互動 session 中使用的 / 開頭指令

### `/help` : 顯示幫助（基礎）

顯示所有可用指令與功能的幫助說明

### `/clear` : 清除上下文（基礎）

重置對話上下文，清除所有先前的訊息記錄

### `/compact [instructions]` : 壓縮對話（基礎）

壓縮對話歷史以釋放 context 空間，可附加壓縮指引

```
/compact 保留架構決策和 API 細節
```

### `/recap` : 回顧摘要（基礎）

產生目前對話的上下文摘要，快速回顧先前討論內容

### `/init` : 產生 CLAUDE.md（基礎）

分析專案結構並自動產生 CLAUDE.md 設定檔

### `/model` : 切換模型（基礎）

在互動 session 中切換使用的 Claude 模型

### `/effort` : 調整強度（基礎）

互動式調整推理強度等級，即時切換深淺思考

### `/config` : 開啟設定（基礎）

開啟設定選單，管理模型、權限、工具等設定

### `/review` : PR 審查（進階）

設定 Pull Request 自動審查，分析程式碼變更

### `/security-review` : 安全審查（進階）

執行安全性分析，檢查潛在漏洞與安全風險

### `/ultrareview` : 全面審查（進階）

使用雲端 Opus 執行全面深度程式碼審查

### `/ultraplan [task]` : 深度規劃（進階）

使用雲端 Opus 進行深度任務規劃與架構設計

```
/ultraplan 重構認證模組為微服務架構
```

### `/plan` : 規劃模式（基礎）

進入規劃模式：只分析和建議，不執行任何修改

### `/batch [description]` : 批次重構（進階）

在多個 worktree 中平行執行重構任務

```
/batch 將所有 React class component 轉為 function component
```

### `/loop [interval] [command]` : 循環執行（進階）

定時重複執行指令或提示，適合監控與自動化

```
/loop 5m /review
```

### `/doctor` : 環境診斷（基礎）

檢查 Claude Code 執行環境，診斷設定與相依問題

### `/permissions` : 權限設定（進階）

設定各工具的執行權限，管理白名單與黑名單

### `/cost` : 費用查詢（基礎）

顯示目前 session 的 API 使用量與費用統計

### `/rename [name]` : 重新命名（基礎）

重新命名目前的 session，方便辨識與恢復

```
/rename auth-migration
```

### `/voice` : 語音輸入（進階）

切換語音聽寫模式，用麥克風口述指令

### `/resume` : 恢復 Session（基礎）

顯示可恢復的 session 列表，選擇要恢復的對話

### `/tui` : 全螢幕模式（進階）

切換到全螢幕渲染模式，減少畫面閃爍

### `/keybindings` : 快捷鍵設定（進階）

自訂鍵盤快捷鍵綁定，修改預設操作對應

## ⌥ 鍵盤快捷鍵（Keyboard Shortcuts）

提升操作效率的鍵盤組合快捷鍵

### `Ctrl+C` : 中斷生成（基礎）

中斷目前正在生成的回應或執行中的操作

### `Ctrl+D` : 結束退出（基礎）

結束並退出 Claude Code 互動 session

### `Ctrl+T` : 任務列表（基礎）

切換顯示/隱藏任務列表面板

### `Ctrl+O` : 詳細記錄（進階）

切換顯示詳細的工具呼叫記錄（verbose transcript）

### `Ctrl+R` : 歷史搜尋（基礎）

搜尋指令輸入歷史記錄

### `Enter` : 送出訊息（基礎）

送出目前輸入的訊息給 Claude 處理

### `Ctrl+J` : 換行（基礎）

在輸入框中插入換行，不送出訊息

### `Ctrl+L` : 清除畫面（基礎）

清除提示輸入或重繪終端畫面

### `Ctrl+S` : 暫存提示（進階）

暫存（stash）目前輸入的提示內容，稍後取回

### `Ctrl+G / Ctrl+X, Ctrl+E` : 外部編輯器（進階）

用外部編輯器（如 vim、nano）編輯目前輸入內容

使用 $EDITOR 環境變數指定的編輯器

### `Ctrl+V / Alt+V` : 貼上圖片（基礎）

從剪貼簿貼上圖片，讓 Claude 分析視覺內容

### `Shift+Tab` : 切換權限（進階）

循環切換權限模式：default → auto → plan → ...

### `Shift+Tab+Tab` : 進入規劃（進階）

快速進入 plan 模式，只分析不執行

### `Esc` : 取消輸入（基礎）

取消目前的輸入內容

### `Esc+Esc` : 倒轉選單（進階）

開啟 rewind 選單，瀏覽並恢復到對話的較早時間點

### `Ctrl+A` : 跳至行首（基礎）

將游標移動到目前行的開頭

### `Ctrl+E` : 跳至行尾（基礎）

將游標移動到目前行的結尾

### `Ctrl+W` : 刪除字詞（基礎）

向後刪除一個字詞（word）

### `Alt+B` : 退一字詞（基礎）

將游標向後移動一個字詞

### `Alt+F` : 進一字詞（基礎）

將游標向前移動一個字詞

### `Cmd+P / Meta+P` : 模型選擇器（進階）

開啟模型快速選擇器，切換 Claude 模型

### `Meta+O` : 快速模式（進階）

切換 fast mode（降低推理深度、加速回應）

### `Cmd+T / Meta+T` : 延伸思考（進階）

切換 extended thinking 模式，啟用或關閉深度推理

### `Space` : 按住說話（進階）

語音模式下按住空白鍵說話（push-to-talk）

僅在 /voice 模式啟用後生效

### `Up/Down` : 瀏覽歷史（基礎）

使用上下方向鍵瀏覽先前輸入的指令歷史

## 📁 設定檔（Configuration Files）

自訂行為、權限、工具整合的設定檔案

### `CLAUDE.md` : 專案記憶（基礎）

專案層級的記憶與上下文檔案，定義專案規則與偏好

放在專案根目錄，每次啟動自動載入

### `~/.claude/CLAUDE.md` : 全域指令（基礎）

使用者全域指令檔，所有專案共用的規則與偏好

優先級低於專案 CLAUDE.md，用於跨專案共通設定

### `.claude/settings.json` : 專案設定（進階）

專案層級設定檔：權限白名單、工具設定、hooks 等

可提交到 git，團隊共用設定

### `~/.claude/settings.json` : 全域設定（進階）

使用者全域設定檔：跨專案通用的權限與偏好

### `.claude/settings.local.json` : 本地專案設定（進階）

本地專案設定（gitignored）：個人偏好不提交到版控

自動加入 .gitignore，適合放個人 API key 等

### `~/.claude/settings.local.json` : 本地全域設定（進階）

使用者本地設定：不同步到任何地方的私有全域設定

### `.mcp.json` : MCP 設定（進階）

專案層級 MCP 伺服器設定，定義可用的外部工具

放在專案根目錄，定義 MCP server 連接方式

### `~/.claude/keybindings.json` : 快捷鍵設定（進階）

自訂鍵盤快捷鍵綁定檔案，覆寫預設按鍵對應

### `.claude/skills/<name>/SKILL.md` : 自訂 Skill（進階）

定義自訂斜線指令（skill），可被 / 指令觸發

每個 skill 一個資料夾，包含 SKILL.md 定義檔

### `.claude/agents/<name>/AGENT.md` : 自訂代理（進階）

定義自訂 subagent，可被主代理呼叫執行專門任務

每個 agent 一個資料夾，包含 AGENT.md 定義檔

## 🔬 進階功能（Advanced Features）

延伸思考、遠端控制、語音輸入、瀏覽器整合等進階能力

### `think / think hard / megathink / ultrathink` : 延伸思考（進階）

在提示中加入思考觸發詞，逐級提升推理深度

think 基礎、think hard 深入、megathink 極深、ultrathink 最大推理

```
請 ultrathink 分析這個競爭條件
```

### `claude --remote-control` : 遠端控制（進階）

啟用 Remote Control 模式，可透過外部 API 操控 Claude

### `/voice + Space` : 語音聽寫（進階）

啟用語音聽寫後，按住空白鍵說話，放開送出

### `--chrome` : Chrome 自動化（進階）

啟用 Chrome 瀏覽器自動化：截圖、填表、測試網頁

### `claude -w feature-name` : 工作樹隔離（進階）

在 git worktree 中隔離修改，平行處理多個任務不互相影響

### `MCP (Model Context Protocol)` : MCP 整合（進階）

透過 MCP 協議連接外部工具：資料庫、API、檔案系統等

### `.claude/skills/<name>/SKILL.md` : 自訂技能（進階）

建立 SKILL.md 定義自訂斜線指令，封裝重複性工作流程

### `Subagents (Explore / Plan / General)` : 子代理系統（進階）

呼叫專門的子代理處理探索、規劃或通用任務，保持主 context 乾淨

### `/plan or Shift+Tab+Tab` : 規劃模式（基礎）

策略性思考模式：只分析、建議和規劃，不執行任何修改

### `Permission Modes (6 levels)` : 六級權限（進階）

從 plan（唯讀）到 bypassPermissions（全自動）的六級權限控制

plan → default → acceptEdits → auto → dontAsk → bypassPermissions

### `/batch` : 批次模式（進階）

在多個 worktree 中平行執行大規模重構任務

### `/loop` : 循環模式（進階）

定時重複執行任務：監控部署、定期審查、自動化檢查

### `/recap` : 自動回顧（基礎）

回到 session 時自動生成上下文摘要，快速接續工作

### `claude --remote` : 遠端 Session（進階）

建立 web session 在瀏覽器操作，或用 --teleport 接回本地

### `ToolSearch (lazy-load MCP)` : 工具搜尋（進階）

延遲載入 MCP 工具定義，減少 context 佔用達 95%

## 🌐 環境變數（Environment Variables）

透過環境變數控制 Claude Code 行為的隱藏開關

### `ANTHROPIC_API_KEY` : API 金鑰（基礎）

設定 Anthropic API 金鑰，用於直接 API 認證

```
export ANTHROPIC_API_KEY=sk-ant-...
```

### `CLAUDE_CODE_DEBUG_LOGS_DIR` : 除錯日誌目錄（進階）

指定除錯日誌的儲存目錄路徑

```
export CLAUDE_CODE_DEBUG_LOGS_DIR=/tmp/claude-logs
```

### `CLAUDE_CODE_SIMPLE` : 精簡模式（進階）

啟用精簡/bare 模式，跳過自動探索與初始化

```
export CLAUDE_CODE_SIMPLE=1
```

### `CLAUDE_CODE_USE_POWERSHELL_TOOL` : PowerShell（進階）

Windows 環境下使用 PowerShell 取代 Bash 工具

```
set CLAUDE_CODE_USE_POWERSHELL_TOOL=1
```

### `CLAUDE_CODE_FORK_SUBAGENT` : 分叉子代理（進階）

啟用 forked subagent 模式，子代理在獨立 process 執行

```
export CLAUDE_CODE_FORK_SUBAGENT=1
```

### `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` : 遠端控制前綴（進階）

設定 Remote Control session 名稱的前綴

```
export CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX=ci-
```

### `ENABLE_PROMPT_CACHING_1H` : 延長快取（進階）

啟用 1 小時 prompt cache TTL，減少重複 token 消耗

```
export ENABLE_PROMPT_CACHING_1H=1
```

### `BASH_MAX_OUTPUT_LENGTH` : Bash 輸出上限（進階）

設定 Bash 工具的最大輸出字元數

```
export BASH_MAX_OUTPUT_LENGTH=100000
```

### `TASK_MAX_OUTPUT_LENGTH` : Task 輸出上限（進階）

設定 Task（subagent）的最大輸出字元數

```
export TASK_MAX_OUTPUT_LENGTH=200000
```

### `SLASH_COMMAND_TOOL_CHAR_BUDGET` : Skill 字數預算（進階）

設定 skill 描述載入的字元預算上限

```
export SLASH_COMMAND_TOOL_CHAR_BUDGET=50000
```

### `ANTHROPIC_BASE_URL` : 自訂端點（進階）

設定自訂 API 端點 URL，用於代理或私有部署

```
export ANTHROPIC_BASE_URL=https://my-proxy.example.com
```

### `CLAUDE_CODE_MAX_MEMORY` : 記憶體上限（進階）

設定 Claude Code process 的最大記憶體使用量

```
export CLAUDE_CODE_MAX_MEMORY=8192
```

## 💡 隱藏技巧（Hidden Tips & Power User）

官方文件不一定提到的進階用法與效率技巧

### `Auto Mode` : 自動模式（隱藏）

預設安全操作（如 ls、git log）不需權限確認，直接執行

唯讀指令和已知安全操作會自動放行，無需手動允許

### `Plan file auto-naming` : 計畫檔命名（隱藏）

計畫檔案會根據提示自動命名，如 fix-auth-race-snug-otter.md

格式為「動詞-名詞-形容詞-動物」，方便辨識

### `cat file | claude -p "query"` : 管線串接（隱藏）

用 Unix pipe 將任意內容串接給 Claude 分析處理

```
git diff | claude -p "審查這些變更"
```

### `claude -p --output-format json "query" | jq .result` : JSON 管線（隱藏）

用 JSON 輸出格式串接 jq 等工具，建構自動化管線

```
claude -p --output-format json "列出 TODO" | jq ".result"
```

### `Built-in fast search (bfs/ugrep)` : 內建快速搜尋（隱藏）

Claude Code 內建高效搜尋引擎，比外部 grep 快數倍

使用 bfs 搜尋檔案、ugrep 搜尋內容，比 find/grep 效能更好

### `Concurrent MCP startup` : MCP 平行啟動（隱藏）

多個 MCP 伺服器會平行啟動，大幅縮短初始化時間

### `Skill auto-discovery` : Skill 自動發現（隱藏）

自動偵測 .claude/skills/ 目錄下的所有自訂 skill

### `/effort interactive slider` : 強度滑桿（隱藏）

用 /effort 指令互動式調整推理強度，即時生效

### `Ctrl+S stash / Ctrl+C discard` : 提示暫存（隱藏）

Ctrl+S 暫存目前輸入，下次自動恢復; Ctrl+C 放棄暫存

### `Esc+Esc rewind menu` : 對話倒轉（隱藏）

按兩次 Esc 開啟倒轉選單，回到對話中任意時間點

### `ultrathink in SKILL.md` : 思考觸發詞（隱藏）

在 SKILL.md 中加入 ultrathink 可觸發最大推理深度

### `Read-only Bash auto-approve` : 唯讀自動放行（隱藏）

安全的唯讀指令（ls、git log、cat）永遠不需要權限確認

### `MCP ToolSearch lazy-load` : MCP 延遲載入（隱藏）

MCP 工具定義延遲載入，減少 context window 佔用達 95%

### `--max-budget-usd guard` : 預算防護（隱藏）

用 --max-budget-usd 設定花費上限，防止 API 費用失控

### `/tui fullscreen rendering` : 全螢幕渲染（隱藏）

用 /tui 切換全螢幕模式，消除長輸出時的畫面閃爍

---
來源：AITerms.tw | https://aiterms.tw/cheatsheet/claude-code