Claude Code 指令大全

啟動互動推薦

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

帶提示啟動

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

claude "幫我重構這個函式"

繼續對話推薦

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

繼續列印模式

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

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

恢復指定

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

claude -r "refactor-auth"

列印模式推薦

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

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

管線輸入

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

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

工作樹模式

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

工作樹 tmux

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

claude -w fix-auth --tmux

遠端 Session

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

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

接續遠端

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

更新版本

更新 Claude Code 到最新版本

登入

登入 Claude Code，進行身份驗證

登出

登出目前的 Claude Code 帳號

驗證狀態

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

新增 MCP

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

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

列出代理

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

產生 Token

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

指定模型推薦

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

claude --model opus "分析架構"

推理強度

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

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

替換系統提示

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

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

檔案系統提示

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

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

追加系統提示

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

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

檔案追加提示

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

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

權限模式推薦

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

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

跳過權限

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

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

工具白名單

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

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

工具黑名單

指定禁止使用的工具清單

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

最大回合數

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

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

預算上限

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

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

輸出格式

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

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

JSON 驗證

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

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

輸入格式

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

追加目錄

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

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

載入設定

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

claude --settings ./team-settings.json

命名 Session

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

claude -n "auth-refactor"

沙箱模式

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

Chrome 開關

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

MCP 設定檔

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

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

MCP 嚴格模式

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

限制工具

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

除錯日誌

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

claude --debug "api,mcp,tools"

除錯檔案

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

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

詳細輸出

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

精簡模式

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

執行初始化

執行 init hooks 後啟動互動 session

僅初始化

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

不存 Session

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

關聯 PR

恢復與指定 Pull Request 關聯的 session

claude --from-pr 456

分叉 Session

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

指定 Session ID

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

備用模型

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

claude --model opus --fallback-model sonnet

IDE 連接

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

啟用 Beta

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

claude --betas interleaved-thinking

團隊模式

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

停用斜線指令

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

遠端控制

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

排除動態提示

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

允許跳過權限

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

顯示幫助

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

清除上下文

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

壓縮對話推薦

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

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

回顧摘要

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

產生 CLAUDE.md推薦

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

切換模型

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

調整強度

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

開啟設定

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

PR 審查

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

安全審查

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

全面審查

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

深度規劃

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

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

規劃模式

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

批次重構

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

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

循環執行

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

/loop 5m /review

環境診斷

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

權限設定

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

費用查詢

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

重新命名

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

/rename auth-migration

語音輸入

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

恢復 Session

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

全螢幕模式

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

快捷鍵設定

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

中斷生成推薦

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

結束退出

結束並退出 Claude Code 互動 session

任務列表

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

詳細記錄

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

歷史搜尋

搜尋指令輸入歷史記錄

送出訊息

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

換行推薦

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

清除畫面

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

暫存提示

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

外部編輯器

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

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

貼上圖片

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

切換權限推薦

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

進入規劃

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

取消輸入

取消目前的輸入內容

倒轉選單

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

跳至行首

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

跳至行尾

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

刪除字詞

向後刪除一個字詞（word）

退一字詞

將游標向後移動一個字詞

進一字詞

將游標向前移動一個字詞

模型選擇器

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

快速模式

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

延伸思考

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

按住說話

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

僅在 /voice 模式啟用後生效

瀏覽歷史

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

專案記憶

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

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

全域指令

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

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

專案設定

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

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

全域設定

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

本地專案設定

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

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

本地全域設定

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

MCP 設定

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

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

快捷鍵設定

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

自訂 Skill

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

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

自訂代理

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

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

延伸思考

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

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

請 ultrathink 分析這個競爭條件

遠端控制

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

語音聽寫

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

Chrome 自動化

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

工作樹隔離

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

MCP 整合

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

自訂技能

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

子代理系統

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

規劃模式

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

六級權限

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

plan → default → acceptEdits → auto → dontAsk → bypassPermissions

批次模式

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

循環模式

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

自動回顧

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

遠端 Session

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

工具搜尋

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

API 金鑰

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

export ANTHROPIC_API_KEY=sk-ant-...

除錯日誌目錄

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

export CLAUDE_CODE_DEBUG_LOGS_DIR=/tmp/claude-logs

精簡模式

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

export CLAUDE_CODE_SIMPLE=1

PowerShell

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

set CLAUDE_CODE_USE_POWERSHELL_TOOL=1

分叉子代理

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

export CLAUDE_CODE_FORK_SUBAGENT=1

遠端控制前綴

設定 Remote Control session 名稱的前綴

export CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX=ci-

延長快取

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

export ENABLE_PROMPT_CACHING_1H=1

Bash 輸出上限

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

export BASH_MAX_OUTPUT_LENGTH=100000

Task 輸出上限

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

export TASK_MAX_OUTPUT_LENGTH=200000

Skill 字數預算

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

export SLASH_COMMAND_TOOL_CHAR_BUDGET=50000

自訂端點

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

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

記憶體上限

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

export CLAUDE_CODE_MAX_MEMORY=8192

自動模式

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

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

計畫檔命名

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

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

管線串接

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

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

JSON 管線

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

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

內建快速搜尋

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

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

MCP 平行啟動

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

Skill 自動發現

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

強度滑桿

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

提示暫存

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

對話倒轉

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

思考觸發詞

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

唯讀自動放行

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

MCP 延遲載入

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

預算防護

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

全螢幕渲染

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