AI 工具速查

Claude Code 指令大全

Claude Code 指令大全收錄 CLI 指令、斜線命令、快捷鍵與設定檔參考，涵蓋基礎到隱藏技巧，以繁體中文說明每個指令的功能與用法。

159 個指令 8 個分類 更新：2026-04-22
目錄：8 個分類

CLI 啟動與 Session 18

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"
NEW 進階
遠端 Session 建立 web session，可在瀏覽器中操作 Claude Code
範例 
claude --remote "重構登入模組"
claude --teleport
NEW 進階
接續遠端 將遠端 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 旗標與參數 41

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
NEW 進階
團隊模式 設定多代理協作的顯示模式：auto 自動、tmux 分割視窗
--disable-slash-commands
進階
停用斜線指令 停用所有 skill 和自訂斜線指令
--remote-control
NEW 進階
遠端控制 啟動時開啟 Remote Control 功能，可透過 API 操控
--exclude-dynamic-system-prompt-sections
進階
排除動態提示 排除動態系統提示區段，提升 prompt cache 命中率
--allow-dangerously-skip-permissions
進階
允許跳過權限 將 bypassPermissions 加入 Shift+Tab 權限切換循環

斜線指令 23

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
NEW 進階
全面審查 使用雲端 Opus 執行全面深度程式碼審查
/ultraplan [task]
NEW 進階
深度規劃 使用雲端 Opus 進行深度任務規劃與架構設計
範例 
/ultraplan 重構認證模組為微服務架構
/plan
基礎
規劃模式 進入規劃模式：只分析和建議，不執行任何修改
/batch [description]
NEW 進階
批次重構 在多個 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
NEW 進階
全螢幕模式 切換到全螢幕渲染模式，減少畫面閃爍
/keybindings
進階
快捷鍵設定 自訂鍵盤快捷鍵綁定，修改預設操作對應

鍵盤快捷鍵 25

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
基礎
瀏覽歷史 使用上下方向鍵瀏覽先前輸入的指令歷史

設定檔 10

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 定義檔

進階功能 15

Advanced Features

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

think / think hard / megathink / ultrathink
進階
延伸思考 在提示中加入思考觸發詞，逐級提升推理深度

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

Gemini 的 Thinking Mode ChatGPT GPT-5.5 推理模式
範例 
請 ultrathink 分析這個競爭條件
claude --remote-control
NEW 進階
遠端控制 啟用 Remote Control 模式，可透過外部 API 操控 Claude
/voice + Space
進階
語音聽寫 啟用語音聽寫後，按住空白鍵說話，放開送出
ChatGPT Advanced Voice
--chrome
NEW 進階
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

ChatGPT 和 Gemini 無此概念，Cursor 有類似的 YOLO Mode
/batch
進階
批次模式 在多個 worktree 中平行執行大規模重構任務
/loop
進階
循環模式 定時重複執行任務：監控部署、定期審查、自動化檢查
/recap
基礎
自動回顧 回到 session 時自動生成上下文摘要，快速接續工作
claude --remote
進階
遠端 Session 建立 web session 在瀏覽器操作，或用 --teleport 接回本地

環境變數 12

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

隱藏技巧 15

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"
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）永遠不需要權限確認
--max-budget-usd guard
隱藏
預算防護 用 --max-budget-usd 設定花費上限，防止 API 費用失控
/tui fullscreen rendering
隱藏
全螢幕渲染 用 /tui 切換全螢幕模式，消除長輸出時的畫面閃爍

常見問題

Claude Code 有哪些指令？

Claude Code 涵蓋 CLI 啟動、旗標參數、斜線指令、鍵盤快捷鍵、設定檔、進階功能、環境變數與隱藏技巧共 8 大分類。

Claude Code 的快捷鍵有哪些？

常用快捷鍵包括 Ctrl+C 中斷生成、Ctrl+J 換行、Ctrl+R 搜尋歷史、Shift+Tab 切換權限模式、Esc+Esc 時光倒流、Cmd+P 模型選擇器等。

如何讓 Claude Code 自動執行不需要確認？

使用 --permission-mode auto 或 Shift+Tab 切換到 auto 模式。也可以用 --dangerously-skip-permissions 跳過所有權限提示，但僅建議在安全環境中使用。

Claude Code 的 Extended Thinking 怎麼用？

在 prompt 中加入 "think" 啟用 4K token 思考、"think hard" 或 "megathink" 啟用 10K、"ultrathink" 啟用 32K 最大推理。也可以用 Cmd+T 切換。

CLAUDE.md 是什麼？怎麼設定？

CLAUDE.md 是 Claude Code 的專案記憶檔。放在專案根目錄可定義編碼規範、架構說明、常用指令等。放在 ~/.claude/CLAUDE.md 則為全域指令，所有專案共用。用 /init 可自動生成。

Claude Code 怎麼接 MCP Server？

用 claude mcp add 互動式新增，或在 .mcp.json 中手動設定。支援 stdio 和 HTTP 兩種傳輸方式。MCP 工具會自動 lazy-load，減少 95% context 佔用。

Claude Code 可以用語音輸入嗎？

可以，輸入 /voice 啟用語音模式。按住空白鍵說話（push-to-talk），放開後自動轉文字。語音辨識針對程式術語優化，跨 session 持續有效。

Claude Code 有哪些隱藏功能？

包括 Auto Mode 自動跳過安全操作的確認、Plan file 自動命名、管道（pipe）用法、MCP Tool Search lazy loading、內建 bfs/ugrep 加速搜尋、Esc+Esc 時光倒流等。

資料來源

本頁內容以 2026-04-22 版本為準。Claude Code 持續更新中，建議搭配官方文件使用。