Claude Code 指令大全
Claude Code 指令大全依 code.claude.com 官方文件,把 CLI 子指令、啟動旗標、斜線指令、鍵盤快捷鍵、設定檔、環境變數與官方提示詞寫法集中整理,已移除官方標示停用的指令。
沒有符合的指令
換個關鍵字,或切回「全部」分類。
CLI 啟動與子指令
-
啟動互動模式推薦
在目前資料夾啟動 Claude Code 互動 session
claude -
帶著第一句話啟動
啟動互動 session 並直接送出第一個提示
claude "說明這個專案的資料夾結構"claude "query" -
非互動執行(print 模式)推薦
執行一次查詢後輸出結果並結束,適合腳本與 CI
claude -p "解釋這個錯誤訊息"claude -p "query" -
用管線餵資料
把檔案或其他指令的輸出經由 stdin 交給 Claude 處理
cat error.log | claude -p "找出錯誤根因"cat file | claude -p "query" -
接續最近的對話推薦
載入目前資料夾最近一次對話,包含已經結束的背景 session
claude -c -
接續對話並非互動執行
接著最近一次對話,用 print 模式送出一個提示後結束
claude -c -p "query" -
依 ID 或名稱恢復 session
恢復指定的 session,不帶 ID 時開啟選單挑選
claude -r "auth-refactor" "繼續做完測試"claude -r "<session>" "query" -
在獨立 git worktree 啟動
在 <repo>/.claude/worktrees/<name> 建立隔離工作區再啟動,不給名稱會自動產生,也可以傳 PR 編號或網址
claude -w feature-authclaude -w -
worktree 搭配 tmux
為 worktree 建立 tmux session,需要同時使用 --worktree,iTerm2 可用時改用原生分割窗格
claude -w name --tmux -
以背景代理啟動
把 session 當成背景代理啟動並立即返回,印出 session ID 與管理指令
claude --bg "幫我補齊 utils 的單元測試"claude --bg "task" -
開啟 agent view
監看與派送平行執行的背景 session,可加 --json 輸出給腳本使用
claude agents -
接回背景 session
在這個終端機接上一個背景 session
claude attach 7c5dcf5dclaude attach <id|name> -
查看背景 session 輸出
印出背景 session 最近的輸出內容
claude logs <id|name> -
停止背景 session
停止指定的背景 session,也接受 claude kill
claude stop <id> -
建立雲端 session
用一段任務描述在雲端建立新 session,舊的 --remote 是已淘汰的別名
claude --cloud "修正登入頁的 CI 失敗"claude --cloud "task" -
把雲端 session 接回本機
在本機終端機恢復一個雲端 session
claude --teleport -
啟動 Remote Control 伺服器
以伺服器模式執行,讓你從 claude.ai 或 Claude App 操作這台電腦上的 Claude Code
claude remote-control --name "My Project"claude remote-control -
更新到最新版
手動更新 Claude Code
claude update -
安裝或重裝原生執行檔
可指定版本號,或 stable、latest
claude install stableclaude install [version] -
查看版本
輸出目前版本號,等同 --version
claude -v -
終端機直接做安裝診斷
不啟動 session,印出安裝狀態與設定檔驗證等唯讀診斷
claude doctor -
登入 Anthropic 帳號
可加 --email 預填信箱、--sso 強制 SSO、--console 改用 Console(API 計費)登入
claude auth login -
登出帳號
登出目前的 Anthropic 帳號
claude auth logout -
查看登入狀態
以 JSON 顯示驗證狀態,加 --text 改成一般文字,已登入時結束碼為 0
claude auth status -
產生長效 OAuth token
給 CI 與腳本使用的 token,只印在終端機不會存檔,需要 Claude 訂閱方案
claude setup-token -
新增 MCP 伺服器推薦
從終端機新增遠端 HTTP MCP 伺服器,本機伺服器也用 claude mcp 管理
claude mcp add --transport http notion https://mcp.notion.com/mcpclaude mcp add --transport http <name> <url> -
MCP OAuth 登入
不開 /mcp 面板,直接跑指定 MCP 伺服器的 OAuth 流程,登出用 claude mcp logout
claude mcp login <name> -
管理外掛
在終端機管理 Claude Code 外掛,別名 claude plugins
claude plugin -
匯入其他 coding agent 設定
啟動互動 session 執行 /import,把 Codex、Gemini CLI 或 Cursor 的設定帶進來
claude import [source] -
非互動執行 ultrareview
在終端機直接跑雲端多代理程式碼審查,結果輸出到 stdout
claude ultrareview [target] -
查看 auto mode 內建規則
把 auto mode 分類器的內建規則以 JSON 印出,還原預設用 claude auto-mode reset
claude auto-mode defaults -
清除專案的本機資料
刪除某個專案的對話紀錄、任務清單、除錯紀錄與編輯歷史,可先加 --dry-run 預覽
刪除後無法復原,先用 --dry-run 確認範圍。
claude purge ~/work/repo --dry-runclaude purge [path]
CLI 旗標與參數
-
指定模型推薦
用別名(sonnet、opus、haiku、fable)或完整模型名稱設定這個 session 的模型
claude --model opus--model <alias|name> -
設定推理強度
可選 low、medium、high、xhigh、max 或 ultracode,實際可用等級依模型而定,只對這個 session 有效
claude --effort high--effort <level> -
指定起始權限模式
可用 default、acceptEdits、plan、auto、dontAsk、bypassPermissions,manual 是 default 的別名
claude --permission-mode plan--permission-mode <mode> -
略過所有權限確認
等同 --permission-mode bypassPermissions,只適合完全隔離的環境
會讓 Claude 不經確認就執行指令與改檔,不要在有正式資料或金鑰的機器上使用。
--dangerously-skip-permissions -
把 bypass 加入切換循環
不以 bypassPermissions 開始,但讓 Shift+Tab 可以切到它
--allow-dangerously-skip-permissions -
免確認的工具清單
列出不需要詢問就能執行的工具與規則,也可寫成 --allowed-tools
--allowedTools "Bash(git *)" "Read" -
禁止的工具
拒絕規則,寫工具名稱會把該工具從 Claude 可用清單移除,"mcp__*" 可移除所有 MCP 工具
--disallowedTools "Edit" -
限制內建工具
只開放指定的內建工具,"" 全部關閉,"default" 為預設組合,不影響 MCP 工具
--tools "Bash,Edit,Read" -
取代系統提示
用自訂文字取代整個預設系統提示
--system-prompt "..." -
用檔案取代系統提示
讀取檔案內容取代預設系統提示
--system-prompt-file path -
附加系統提示
在預設系統提示最後面加上一段文字,保留內建行為
--append-system-prompt "..." -
用檔案附加系統提示
讀取檔案內容接在預設系統提示後面
--append-system-prompt-file path -
print 模式輸出格式
可選 text、json、stream-json,只在 -p 模式有效
claude -p "query" --output-format json--output-format json -
print 模式輸入格式
可選 text 或 stream-json
--input-format stream-json -
輸出串流中的部分訊息
需要搭配 --print 與 --output-format stream-json
--include-partial-messages -
結構化 JSON 輸出
代理流程結束後回傳符合 JSON Schema 的結果,只在 print 模式有效
--json-schema '{...}' -
限制代理回合數
超過回合數就以錯誤結束,預設不限制,只在 print 模式有效
--max-turns 3 -
花費上限
預估的 API 花費達到上限就停止,只在 print 模式有效
--max-budget-usd 5.00 -
加入額外工作目錄
讓 Claude 可以讀寫其他資料夾,該資料夾大部分的 .claude/ 設定不會被自動載入
--add-dir ../lib -
載入設定檔
指定設定 JSON 檔或直接傳 JSON 字串,覆蓋同名設定,只對這個 session 有效
--settings ./settings.json -
指定設定來源
只載入列出的設定來源(user、project、local)
--setting-sources user,project -
替 session 命名
名稱會顯示在 /resume 與終端機標題,之後可用 claude --resume <name> 恢復
--name "my-session" / -n -
指定這個 session 用的 agent
覆蓋 agent 設定,讓主 session 以指定的 agent 身分執行
--agent <name> -
用 JSON 臨時定義 subagents
在啟動時以 JSON 動態定義自訂 subagents
--agents '{...}' -
Chrome 瀏覽器整合
開啟或關閉這個 session 的 Chrome 整合,用於網頁測試與自動化
--chrome / --no-chrome -
載入 MCP 設定
從 JSON 檔或字串載入 MCP 伺服器,多個用空白分隔
--mcp-config ./mcp.json -
只用指定的 MCP 設定
忽略其他所有 MCP 設定,只用 --mcp-config 給的伺服器
--strict-mcp-config -
用 MCP 工具處理權限詢問
非互動模式下,把權限詢問交給指定的 MCP 工具決定
--permission-prompt-tool mcp__<server>__<tool> -
載入本機外掛
從資料夾或 .zip 載入外掛,只對這個 session 有效
--plugin-dir ./my-plugin -
除錯模式
開啟除錯並可用等號形式過濾類別,例如 --debug='!mcp' 排除 MCP
過濾條件只在 = 的寫法生效,用空白分隔只會開啟除錯、不會過濾。
--debug='mcp,startup' -
除錯紀錄寫到檔案
把除錯紀錄寫到指定檔案,同時自動開啟除錯模式
--debug-file /tmp/debug.log -
詳細輸出
顯示完整的逐回合輸出
--verbose -
最小模式
略過 hooks、skills、外掛、MCP、自動記憶與 CLAUDE.md 的自動載入,腳本呼叫啟動更快
claude --bare -p "query"--bare -
安全模式排錯
關閉所有自訂內容(CLAUDE.md、skills、外掛、hooks、MCP 等)啟動,用來排查壞掉的設定
--safe-mode -
執行 Setup hooks(init)
在 print 模式開始前執行 matcher 為 init 的 Setup hooks
--init -
只跑 Setup hooks 後結束
執行 Setup 與 SessionStart hooks 後直接結束,不開始對話
--init-only -
不儲存 session
session 不寫入磁碟、之後也無法恢復,只在 print 模式有效
--no-session-persistence -
依 PR 找 session
開啟只列出與指定 PR 相關 session 的選單,支援 GitHub、GitLab、Bitbucket 網址
--from-pr 123 -
恢復時另開新 session
搭配 --resume 或 --continue 使用,產生新的 session ID 而不覆寫原本的
--fork-session -
指定 session ID
用指定的 UUID 當作這次對話的 session ID
--session-id "uuid" -
備援模型鏈
主要模型過載或無法使用時,依序改用清單中的模型
--fallback-model sonnet,haiku -
啟動時自動連 IDE
剛好只有一個可用 IDE 時自動連上
--ide -
附加 beta header
在 API 請求加上 beta header,只適用 API 金鑰使用者
--betas <header> -
agent team 隊友顯示方式
可選 in-process(預設)、auto、tmux、iterm2
--teammate-mode auto -
停用 skills 與指令
這個 session 停用所有 skills 與斜線指令
--disable-slash-commands -
開啟 Remote Control 的互動 session
啟動互動 session,同時讓你可以從 claude.ai 或 Claude App 接手
claude --remote-control "My Project"--remote-control / --rc -
把個人化內容移出系統提示
把自動記憶位置等個人化內容移到第一則使用者訊息,提高跨使用者的快取重用
--exclude-dynamic-system-prompt-sections -
改在桌面版開啟
在 Claude 桌面 App 開啟目前資料夾並結束終端機
--desktop -
開啟 advisor 工具
這個 session 啟用伺服器端 advisor,在關鍵時刻諮詢第二個模型
--advisor <model> -
設定自動壓縮門檻
指定 context 用到多少時自動壓縮,auto 回到依模型調整的預設值
--autocompact <auto|tokens>
斜線指令
-
說明與指令清單推薦
顯示說明與目前可用的指令
/help -
建立 CLAUDE.md推薦
分析專案並產生 CLAUDE.md,設定 CLAUDE_CODE_NEW_INIT=1 可改成互動流程,一併處理 skills 與 hooks
/init -
編輯記憶檔
編輯 CLAUDE.md、開關自動記憶並查看自動記憶內容
/memory -
清空對話重新開始推薦
以空白 context 開始新對話,專案記憶保留,別名 /reset、/new
/clear [name] -
壓縮對話騰出 context推薦
把目前對話摘要以釋放 context,可附上摘要重點
/compact 保留 API 設計決策與待辦/compact [instructions] -
查看 context 用量
用彩色格狀圖顯示 context 使用狀況與最佳化建議
/context [all] -
設定自動壓縮門檻
設定 context 滿到多少時自動壓縮,例如 500k,auto 回到預設
/autocompact [auto|<tokens>] -
切換模型推薦
切換模型並存成新 session 的預設值,選單中按 s 只切換目前 session,左右鍵可調推理強度
/model [model] -
調整推理強度
設定 low 到 xhigh、max 或 auto,status 顯示目前等級,ultracode on/off 開關 ultracode
/effort [level|auto|status] -
開關 fast mode
切換 fast mode,回應中執行也會立即切換,但進行中的回合維持原速度
/fast [on|off] -
開關 advisor 工具
讓 Claude 在關鍵時刻諮詢第二個模型,可指定 fable、opus、sonnet 或完整模型 ID
/advisor [model|off] -
進入 plan mode推薦
直接進入規劃模式,可順便帶上任務,例如 /plan fix the auth bug
/plan [description] -
設定目標條件
Claude 會跨回合持續工作直到條件達成,clear、stop 等可提前取消
/goal 所有單元測試通過且 lint 沒有錯誤/goal [condition|clear] -
管理權限規則
檢視與增刪 allow、ask、deny 規則,也能查看 auto mode 最近拒絕的動作
/permissions -
開啟設定
開啟設定介面,也可直接設定,例如 /config theme=dark
/config [key=value ...] -
查看狀態
顯示版本、模型、帳號與連線狀態,回應中也能執行
/status -
查看用量與花費推薦
顯示 session 花費、方案用量上限與活動統計,/cost 與 /stats 是別名
舊的 /cost 仍可用,會開啟同一個畫面。
/usage -
設定用量點數
碰到用量上限時設定或向管理員申請 usage credits
/usage-credits -
碰到用量上限的選項
顯示等額度重置自動繼續、加購點數等繼續工作的方式
/rate-limit-options -
升級方案
在瀏覽器開啟升級方案頁面
/upgrade -
檢視變更
查看工作目錄的變更,包含 Claude 目前做的修改
/diff -
程式碼審查找 bug推薦
內附 skill:審查目前 diff、PR 編號、分支或路徑的正確性問題,--fix 直接套用修正,ultra 改在雲端跑多代理審查
/review 是別名,/ultrareview 等同 /code-review ultra。
/code-review high 1234/code-review [effort] [--fix] [target] -
安全性審查
分析目前分支相對 origin 預設分支的變更,找出注入、驗證與資料外洩等風險
/security-review -
雲端深度審查
在雲端沙盒跑多代理深度程式碼審查,可指定 PR 或比較基準分支,官方建議改用 /code-review ultra,/ultrareview 是別名
依官方說明,Pro、Max、Ultra 方案含 3 次免費執行,之後需要 usage credits。
/ultrareview [PR or branch] -
精簡程式碼
內附 skill:四個審查代理平行檢查重用、簡化、效率與抽象層級並套用修正,不負責找 bug
/simplify [target] -
實際跑起來驗證
內附 skill:建置並執行專案 App 觀察結果,確認修改真的有效
/verify -
啟動並操作 App
內附 skill:把專案 App 跑起來並實際操作,看到修改的效果
/run -
產生專案的 run skill
內附 skill:寫一個專案專用 skill,教 /run 與 /verify 如何從乾淨環境建置與操作 App
/run-skill-generator -
大規模平行修改
內附 skill:研究程式碼後拆成 5 到 30 個獨立單元,核准後每個單元在獨立 worktree 由背景 subagent 實作
/batch <instruction> -
重複執行提示
內附 skill:session 開著時定時重複執行,例如 /loop 5m check if the deploy finished,別名 /proactive
/loop [interval] [prompt] -
雲端排程任務
建立、更新、列出或執行雲端排程任務(舊稱 routines),別名 /routines
/schedule [description] -
查看背景工作
檢視與管理這個 session 的背景工作,包含已完成的 subagents,別名 /bashes
/tasks -
派出分叉 subagent
背景 subagent 繼承完整對話處理任務,完成後結果回到目前對話
/subtask <task> -
複製對話到背景 session
把目前對話複製成新的背景 session,自己繼續在這裡工作
/fork [prompt] -
分支目前對話
在這個時間點分出一條對話嘗試其他方向,原本的對話可用 /resume 回去
/branch [name] -
把 session 轉到背景
讓目前 session 變成背景代理繼續跑並釋放終端機,用 claude agents 監看
/background [prompt] -
停止背景 session
停止目前接上的背景 session,對話紀錄與 worktree 會保留
/stop -
列出可傳訊息的代理
列出 Claude 可以傳訊息的 subagents、agent team 隊友與其他 session
/list-agents -
管理 subagents
目前版本會提示你請 Claude 建立或管理 subagents,或直接編輯 .claude/agents/ 資料夾
/agents -
問旁支問題
針對目前 session 問一個問題,但不加入對話紀錄
/btw [question] -
一句話摘要 session
隨時產生目前 session 的一行摘要
/recap -
恢復其他對話
依 ID 或名稱恢復對話,或開啟選單,背景 session 會標上 bg
/resume [session] -
重新命名 session
替目前 session 命名並顯示在提示列,不給名稱會自動產生
/rename [name] -
倒回對話或程式碼
把對話及程式碼回到先前的檢查點,或從某則訊息開始摘要,別名 /checkpoint、/undo
/rewind -
匯出對話
把目前對話匯出成純文字,給檔名會直接寫入檔案
/export [filename] -
複製回應
複製最後一則回應,/copy 2 複製倒數第二則,有程式碼區塊時可挑選,按 w 改寫入檔案
/copy [N] -
新增工作目錄
這個 session 多加一個可讀寫的資料夾,輸入部分路徑可用 Tab 補完
/add-dir <path> -
移動到新工作目錄
保留對話,把 session 移到另一個資料夾
/cd <path> -
管理 MCP 連線
開啟 MCP 伺服器清單處理連線與 OAuth,也可直接用 reconnect、enable、disable
/mcp reconnect all/mcp -
查看 hooks 設定
檢視目前的 hook 設定
/hooks -
列出 skills
列出可用 skills,可依名稱或來源篩選,按 t 依 token 數排序
/skills -
檢查 skills 成本
顯示每個 skill 佔用的 context 與使用頻率,找出可以關掉的 skill
/skill-doctor -
重新掃描 skills
不用重啟就載入新增或修改過的 skills 與指令檔
/reload-skills -
管理外掛
開啟外掛選單,或直接用 list、install、enable、disable
/plugin [subcommand] -
重新載入外掛
不用重啟就套用外掛變更,並列出載入錯誤
/reload-plugins -
寫 mod 的參考
載入 Claude 寫 mod 時依據的參考資料
/plugin-authoring -
查看工作流進度
開啟動態 workflow 進度畫面,可暫停、恢復或儲存
/workflows -
寫 workflow 腳本的參考
內附 skill:載入動態 workflow 腳本的 API 與範例
/workflow-authoring -
深度研究
內附 workflow:平行搜尋網路、交叉比對來源後寫出有引用的報告
/deep-research <question> -
切換輸出風格
列出或切換輸出風格,例如 /output-style concise
/output-style [style] -
設定狀態列
描述想要的狀態列內容,或不帶參數從 shell 提示自動設定
/statusline -
切換配色主題
包含自動、淺色、深色、色盲友善與自訂主題
/theme -
提示列顏色
設定這個 session 的提示列顏色,default 還原
/color [color|default] -
切換畫面渲染方式
fullscreen 改用不閃爍的全螢幕渲染,切換時保留對話
/tui [default|fullscreen] -
專注檢視
只顯示最後的提示、工具摘要與最終回應,限全螢幕渲染
/focus -
調整捲動速度
互動調整滑鼠滾輪捲動速度,限全螢幕渲染
/scroll-speed -
自訂快捷鍵
開啟 ~/.claude/keybindings.json 設定檔
/keybindings -
設定 Shift+Enter 換行
在 VS Code、Cursor、Alacritty、Zed 等終端機安裝 Shift+Enter 換行,Apple Terminal 改設定 Option+Enter
/terminal-setup -
語音輸入
開關語音聽寫或指定按住、點按模式,需要 Claude.ai 帳號
/voice [hold|tap|off] -
管理 IDE 整合
管理 IDE 連線並顯示狀態
/ide -
Claude in Chrome 設定
設定 Chrome 瀏覽器整合
/chrome -
在瀏覽器執行任務
內附 skill:透過 Claude in Chrome 測試頁面、填表或讀 console
/claude-in-chrome [task] -
移到桌面版繼續
在 Claude Code 桌面 App 接續目前 session,需要 macOS 或 x64 Windows,別名 /app
/desktop -
下載手機 App
顯示下載 Claude 手機 App 的 QR code,別名 /ios、/android
/mobile -
開放 Remote Control
讓這個 session 可以從 claude.ai 接手,需要 claude.ai 訂閱,別名 /rc
/remote-control -
拉回雲端 session
把雲端 session 的分支與對話拉到這個終端機,別名 /tp
/teleport -
選雲端環境
選擇從 CLI 啟動雲端 session 時的預設環境
/remote-env -
連結 GitHub 給雲端 session
用本機 gh CLI 憑證連結 GitHub 帳號
/web-setup -
自動修 PR
建立雲端 session 盯著目前分支的 PR,CI 失敗或有審查意見時推送修正
/autofix-pr [prompt] -
安裝 Claude GitHub App
替 repo 安裝 GitHub App,可順便設定 GitHub Actions 與 secrets
/install-github-app -
安裝 Claude Slack App
開啟瀏覽器完成 Slack OAuth
/install-slack-app -
匯入其他工具設定
把 Codex、Gemini CLI 或 Cursor 的指示檔、MCP、指令與 skills 帶進 Claude Code,--dry-run 先預覽
/import [codex|gemini|cursor] -
安裝與設定健檢
內附 skill:診斷安裝、設定、擴充與 CLAUDE.md 問題,確認後代為修正,別名 /checkup
/doctor -
開除錯紀錄並排查
內附 skill:從現在開始記錄除錯資訊並讀取紀錄找問題
/debug [description] -
記憶體快照
輸出 JavaScript heap snapshot 與記憶體分析,診斷記憶體用量過高,選單中不會顯示
/heapdump -
回報問題或意見
開啟回報對話框,送出前可選擇附上多少 session 紀錄,/bug 直接開同一個對話框
/feedback [report] -
查看更新紀錄
用版本選單查看 changelog,不會進入對話內容
/release-notes -
重啟套用更新
重新啟動並恢復這個 session 以套用已安裝的更新
/restart -
使用習慣報告
分析這台電腦最近的 sessions,產生 HTML 報告
/insights -
產生團隊上手指南
分析過去 30 天的使用紀錄,產生給隊友的上手文件
/team-onboarding -
互動功能教學
用短課程與動畫認識 Claude Code 功能
/powerup -
減少權限詢問
內附 skill:掃描過去的唯讀 Bash 與 MCP 呼叫,建議加進專案 allowlist
/fewer-permission-prompts -
草擬 auto mode 環境設定
依專案與最近 sessions 草擬 autoMode.environment 設定並存到使用者設定
/auto-mode-setup -
用描述改設定
內附 skill:描述想改的設定(允許指令、環境變數、hook),Claude 改對應的 settings.json
/update-config [request] -
開關沙盒模式
切換沙盒模式,限支援的平台
/sandbox -
隱私設定
查看與更新隱私設定,限 Pro、Max、Ultra 訂閱
/privacy-settings -
登入
登入 Anthropic 帳號
/login -
登出
登出 Anthropic 帳號
/logout -
結束 CLI
結束 Claude Code,在背景 session 中則是離開但不停止,別名 /quit
/exit -
設定 Amazon Bedrock
用互動精靈設定 Bedrock 驗證、區域與模型
/setup-bedrock -
設定 Google Cloud
用互動精靈設定 Google Cloud Agent Platform 的驗證、專案與模型
/setup-vertex -
Claude API 專案助手
內附 skill:載入 Claude API 參考,處理遷移、升級、成本最佳化等任務
/claude-api -
找回 artifacts
列出自己擁有或別人分享的 artifacts,附加到 session、在瀏覽器開啟或複製連結
/artifacts -
artifact 能力參考
內附 skill:載入發布後 artifact 可用的執行期能力說明
/artifact-capabilities -
artifact 畫圖指引
內附 skill:artifact 中什麼時候畫圖、畫什麼與怎麼寫
/artifact-diagramming -
圖表設計指引
內附 skill:依資料選圖表形式、配色與色盲安全檢查
/dataviz [request] -
做簡報
內附 skill:依需求做一份 Claude Slides 簡報 artifact
/slides [brief] -
畫 UI 草稿
內附 skill:把 UI 草稿、畫面流程或海報畫在同一張畫布,發布成 Claude Design artifact
/design [brief] -
授權 Claude Design
授權 Claude 存取 Claude Design,撤回用 /design revoke
/design consent -
登入 Claude Design
替 /design-sync 用 claude.ai 帳號授權設計系統存取
/design-login -
同步設計系統
內附 skill:把 repo 的 React 設計系統轉換上傳到 Claude Design
/design-sync [hint] -
分享免費試用
把一週免費的 Claude Code 分享給朋友,帳號符合資格才看得到
/passes -
Lo-fi 電台
在瀏覽器開啟 Claude FM lo-fi 電台
/radio -
訂購貼紙
訂購 Claude Code 貼紙
/stickers
鍵盤快捷鍵
-
中斷或清空輸入推薦
中斷目前動作,或清空輸入框
Ctrl+C -
結束 session
離開 Claude Code
Ctrl+D -
中斷 Claude 或關閉對話框推薦
停止 Claude 目前的回應,或關掉開啟中的對話框
Esc -
清除草稿或倒回
連按兩次 Esc 清除輸入草稿,或開啟倒回(rewind)選單
Esc + Esc -
切換權限模式推薦
依序切換 default、acceptEdits、plan 等模式,部分 Windows 環境改用 Alt+M
Shift+Tab -
切換模型
macOS 按 Option+P,Windows 與 Linux 按 Alt+P
Option+P / Alt+P -
切換延伸思考
開關 extended thinking,對一律使用延伸思考的模型沒有作用
Option+T / Alt+T -
切換 fast mode
macOS 按 Option+O,Windows 與 Linux 按 Alt+O
Option+O / Alt+O -
用編輯器寫提示
在預設文字編輯器開啟目前輸入,適合寫長提示
Ctrl+G / Ctrl+X Ctrl+E -
重繪畫面
重新繪製終端機畫面
Ctrl+L -
逐字稿檢視器
開關完整的逐字稿(transcript)檢視
Ctrl+O -
搜尋輸入歷史
反向搜尋先前輸入過的提示
Ctrl+R -
貼上圖片
把剪貼簿的圖片貼進提示
Ctrl+V / Cmd+V(iTerm2)/ Alt+V(Windows) -
把執行中的工作移到背景
讓正在跑的工作轉到背景繼續
Ctrl+B -
顯示任務清單
開關 Claude 的任務清單
Ctrl+T -
暫存或還原提示
把寫到一半的提示先收起來,之後再還原
Ctrl+S -
暫停 Claude Code
把程式暫停到背景(終端機的 suspend)
Ctrl+Z -
停止所有背景 subagents
停止這個 session 所有執行中的背景 subagents
Ctrl+X Ctrl+K -
立即送出排隊訊息
Claude 還在工作時,把排隊中的訊息馬上送出
Ctrl+Enter / Ctrl+X Ctrl+S -
接受自動完成
接受自動完成建議,或在權限詢問時附上說明
Tab -
切換對話框分頁
在對話框的分頁之間切換
← / → -
移動游標或瀏覽歷史
在輸入框移動游標,或往前往後翻輸入歷史
↑ / ↓ 或 Ctrl+P / Ctrl+N -
移到行首
游標移到目前這一行的開頭
Ctrl+A -
移到行尾
游標移到目前這一行的結尾
Ctrl+E -
刪到行尾
刪除游標到行尾的內容
Ctrl+K -
刪到行首
刪除游標到行首的內容
Ctrl+U -
往前刪一個字
刪除到前一個空白為止
Ctrl+W -
貼回剛刪掉的文字
貼上用 Ctrl+K、Ctrl+U 等刪掉的內容,接著按 Alt+Y 可輪替更早的內容
Ctrl+Y -
往回跳一個字
游標往回移一個單字
Alt+B -
往前跳一個字
游標往前移一個單字
Alt+F -
刪到字尾
刪除游標到單字結尾
Alt+D -
復原輸入
復原上一次輸入框裡的編輯
Ctrl+_ / Ctrl+Shift+- -
換行(任何終端機)推薦
不用設定就能在任何終端機換行
Ctrl+J -
換行(反斜線)
行尾打反斜線再按 Enter 換行,所有終端機都能用
\ + Enter -
換行(原生支援的終端機)
iTerm2、WezTerm、Ghostty、Kitty、Warp、Apple Terminal、Windows Terminal 原生支援,其他終端機用 /terminal-setup
Shift+Enter -
換行(macOS)
在 macOS 開啟「Option 當 Meta 鍵」後可用
Option+Enter -
送出訊息
送出目前輸入的提示
Enter -
開啟指令選單
在開頭輸入 / 叫出指令與 skills
/(開頭) -
Shell 模式
在開頭輸入 ! 直接執行 shell 指令
!(開頭) -
提及檔案路徑
輸入 @ 選擇要附上的檔案
@ -
快捷鍵說明面板
輸入框是空的時候按 ? 開關快捷鍵說明
?(空白輸入時) -
語音聽寫
開啟語音聽寫後,按住空白鍵錄音,或用 /voice tap 改成點一下開關
Space(按住或點按) -
逐字稿跳到上下一則提示
在逐字稿檢視器跳到前一則或下一則你的提示,需要全螢幕渲染
{ / } -
逐字稿用編輯器開啟
在逐字稿檢視器把對話寫到暫存檔並用 $EDITOR 開啟,需要全螢幕渲染
v
設定檔與記憶檔
-
專案指示檔推薦
放在 ./CLAUDE.md 或 ./.claude/CLAUDE.md,寫團隊共用的專案規範、架構與常用指令
CLAUDE.md -
個人全域指示
只對你自己、所有專案生效的個人偏好
~/.claude/CLAUDE.md -
個人專案指示
只給自己用的專案設定,例如測試網址,記得加進 .gitignore
CLAUDE.local.md -
沿用 AGENTS.md
Claude Code 可以讀 repo 既有的 AGENTS.md 當作專案指示
AGENTS.md -
依檔案類型套用的規則
把規則拆成多個檔案,限定套用在特定檔案類型
.claude/rules/*.md -
專案設定(團隊共用)
提交到 git,讓所有人共用權限、hooks 與外掛設定
.claude/settings.json -
專案個人設定
只對自己、這個專案生效,Claude Code 自動建立時會排除在 git 之外
.claude/settings.local.json -
使用者設定
對自己所有專案生效,例如主題、預設模型與個人權限規則
~/.claude/settings.json -
組織管理設定
由組織派送給所有人,優先順序最高
managed-settings.json -
專案 MCP 設定
專案層級的 MCP 伺服器設定,可提交給團隊共用
.mcp.json -
Claude Code 自己維護的檔案
存放帳號、MCP 伺服器等狀態,由 Claude Code 寫入,一般不需要手動編輯
~/.claude.json -
自訂快捷鍵
用 /keybindings 建立或開啟,重新綁定快捷鍵
~/.claude/keybindings.json -
自訂 skill
建立後可用 /<name> 呼叫,Claude 也會在相關時自動使用
.claude/skills/<name>/SKILL.md -
自訂指令(已併入 skills)
舊的自訂指令檔仍可用,和 .claude/skills/<name>/SKILL.md 一樣會產生 /<name>
.claude/commands/<name>.md -
自訂 subagent
每個 subagent 一個 Markdown 檔,個人版放在 ~/.claude/agents/
.claude/agents/<name>.md
進階功能
-
單次加深推理
在提示任何位置寫 ultrathink,該回合要求更深的推理,不改 session 的 effort 設定
官方說明只認 ultrathink 這個關鍵字,think、think hard 等寫法只會被當成一般文字。要整個 session 調整請用 /effort。
ultrathink -
六種權限模式
從每次都問到全部放行的權限模式,用 Shift+Tab 或 --permission-mode 切換
plan 只分析不改檔,auto 由分類器判斷是否放行,dontAsk 遇到需要確認的動作直接拒絕,bypassPermissions 全部放行。
default / acceptEdits / plan / auto / dontAsk / bypassPermissions -
Plan mode 先規劃再動手
只讀取與分析,提出計畫給你核准後才開始改
/plan 或 Shift+Tab -
內建 subagents
Claude 會把探索、規劃等支線任務交給 subagent,保持主對話 context 乾淨
Explore / Plan / general-purpose -
Skills 封裝工作流程
把重複的流程寫成 SKILL.md,Claude 會在相關時使用,也能用 /<name> 直接呼叫
.claude/skills/<name>/SKILL.md -
用 MCP 串外部工具
透過 MCP 連接資料庫、API、Notion、GitHub 等外部服務
claude mcp add --transport http notion https://mcp.notion.com/mcpMCP(Model Context Protocol) -
MCP 工具延後載入
MCP tool search 預設會延後載入工具定義,需要時才搜尋,可用 auto 或 auto:N 設門檻
ENABLE_TOOL_SEARCH -
Hooks 生命週期事件
在工具執行前後、回應結束、session 開始等時間點自動跑你的指令,PreToolUse 可以擋下工具呼叫
PreToolUse / PostToolUse / Stop ... -
外掛與 marketplace
把 skills、agents、hooks、MCP 打包成外掛安裝與分享
/plugin install -
Worktree 平行開發
每個任務一個 git worktree,多個 session 同時改不互相干擾
claude -w feature-name -
大規模平行改動
把大改動拆成多個單元,各自在 worktree 由背景 subagent 完成
/batch -
定時重複執行
session 開著時定時執行同一個提示,例如盯部署狀態
/loop -
背景代理與 agent view
把 session 丟到背景跑,在 agent view 一次監看多個
claude agents / --bg / /background -
雲端 session
在雲端跑任務,之後再用 --teleport 或 /teleport 接回本機
claude --cloud / /teleport -
Remote Control 手機接手
讓本機 session 可以從 claude.ai 或 Claude App 繼續操作
claude --remote-control -
/voice + Space -
Chrome 瀏覽器整合
連上 Chrome 測試網頁、看 console、填表與擷取資料
--chrome -
目標驅動的長任務
設定完成條件,Claude 跨回合持續工作直到達成
/goal -
Vim 編輯模式
在設定把編輯模式切成 Vim,支援 NORMAL、INSERT、VISUAL 等常用操作
舊的 /vim 指令已移除,改從 /config 切換。
/config → Editor mode -
模型別名
用別名選模型,opusplan 在 plan mode 用 opus、執行時改用 sonnet
別名會隨官方更新指向的版本,要固定版本就寫完整模型名稱。
opus / sonnet / haiku / fable / opusplan
環境變數
-
API 金鑰
設定後改用這把金鑰,即使已登入訂閱帳號也會優先使用
ANTHROPIC_API_KEY -
自訂 Authorization header
會在值前面加上 Bearer 後送出
ANTHROPIC_AUTH_TOKEN -
OAuth token(自動化用)
給 SDK 與自動化環境用的 claude.ai OAuth token,可用 claude setup-token 產生
CLAUDE_CODE_OAUTH_TOKEN -
自訂 API 端點
透過代理或閘道送出請求
ANTHROPIC_BASE_URL -
預設模型
指定要使用的模型設定
ANTHROPIC_MODEL -
推理強度
可設 low、medium、high、xhigh、max,優先於 --effort 與 /effort
CLAUDE_CODE_EFFORT_LEVEL -
思考 token 預算
設定延伸思考的固定 token 預算
MAX_THINKING_TOKENS -
最大輸出 token
設定多數請求的輸出上限,超過模型上限時會被調降
CLAUDE_CODE_MAX_OUTPUT_TOKENS -
改用 Amazon Bedrock
透過 Amazon Bedrock 呼叫模型
CLAUDE_CODE_USE_BEDROCK -
改用 Google Cloud
透過 Google Cloud Agent Platform 呼叫模型
CLAUDE_CODE_USE_VERTEX -
最小系統提示模式
只保留 Bash、讀檔與改檔工具並停用自動載入,--bare 會設定這個變數
CLAUDE_CODE_SIMPLE -
除錯紀錄檔路徑
指定除錯紀錄的檔案路徑(雖然名稱是 DIR,實際是檔案路徑),要另外開啟除錯模式
CLAUDE_CODE_DEBUG_LOGS_DIR -
PowerShell 工具開關
控制 Windows 上的 PowerShell 工具,設 0 關閉
CLAUDE_CODE_USE_POWERSHELL_TOOL -
Fork 模式開關
fork 模式預設開啟,讓 Claude 自行開分叉,設 0 關閉
CLAUDE_CODE_FORK_SUBAGENT -
Remote Control 名稱前綴
沒指定名稱時自動產生的 session 名稱前綴,預設是電腦名稱
CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX -
1 小時 prompt cache
把 prompt cache 存活時間從預設 5 分鐘改成 1 小時,主要給 API 金鑰與雲端供應商使用者
ENABLE_PROMPT_CACHING_1H -
MCP tool search
控制 MCP 工具是否延後載入,可設 auto 或 auto:N 調整門檻
ENABLE_TOOL_SEARCH -
Bash 輸出長度上限
讀回 bash 輸出的字元上限,預設 30000、最大 150000
BASH_MAX_OUTPUT_LENGTH -
Bash 預設逾時
前景 Bash 或 PowerShell 指令的預設逾時,預設 120000 毫秒
BASH_DEFAULT_TIMEOUT_MS -
MCP 啟動逾時
MCP 伺服器啟動的逾時毫秒數,預設 30000
MCP_TIMEOUT -
Skill 描述字元預算
覆蓋提供給 Skill 工具的 skill 描述字元預算,預設約為 context 的 1%
SLASH_COMMAND_TOOL_CHAR_BUDGET -
關閉自動記憶
設 1 停用自動記憶,設 0 強制開啟
CLAUDE_CODE_DISABLE_AUTO_MEMORY -
/init 互動流程
設 1 讓 /init 先問要產生哪些檔案(CLAUDE.md、skills、hooks)
CLAUDE_CODE_NEW_INIT -
關閉自動更新
設 1 停止背景自動更新,手動 claude update 仍可用
DISABLE_AUTOUPDATER -
關閉遙測
設任何非空值關閉遙測,注意設 0 或 false 也算關閉,要恢復需移除變數
DISABLE_TELEMETRY -
HTTPS 代理
指定網路連線用的 HTTPS 代理伺服器
HTTPS_PROXY
提示詞範本
-
描述結果,不寫步驟
說清楚要的結果,讓 Claude 自己找相關檔案,不用列路徑
官方 Prompt library 的第一個寫法:Describe the outcome, not the steps。
幫公開 API 加上流量限制,並確認既有測試全部通過 -
給它自我檢查的方法
同一個提示裡要求執行、測試或比對,Claude 會反覆修到通過
官方寫法:Give it a way to check its own work。要看實際 App 可接著跑 /verify。
寫好 migration 後在開發資料庫執行,確認 schema 和預期一致 -
指定參考對象
點名既有的檔案、測試或寫法,新程式碼會和專案一致
官方寫法:Point at a reference。
新增設定頁,版面照 profile 頁的寫法 -
給可量化的目標
效能或覆蓋率任務直接給指標與門檻,完成條件才明確
官方寫法:State the measurable target。
把 bundle 縮到 200KB 以下,並列出你拿掉了什麼 -
直接給原始資料
貼上錯誤、log、截圖,或用 @ 指定檔案,讓 Claude 讀原文
官方寫法:Give it the artifact。
為什麼建置失敗?@build.log -
指定回答格式
說明格式、長度或讀者,答案才能直接拿去用
官方寫法:Say how you want the answer。要變成預設可設定 output style。
用一頁有圖的 HTML 說明付款重試邏輯,做完在瀏覽器打開
怎麼用這一頁
先記這幾個:claude 啟動、claude -c 接續、claude -p 非互動執行、/init 建 CLAUDE.md、/plan 先規劃、/code-review 審查、/compact 壓縮 context、Shift+Tab 切權限模式、Esc 兩下倒回。其他依分類往下查。
可以直接輸入的內容(API 參數、斜線指令、提示詞範本)附複製鈕。鍵盤指令依原文使用,macOS(Cmd)與 Windows/Linux(Ctrl)的差異不會自動改寫。
- CLI 啟動與子指令啟動 Claude Code、接續與恢復 session、背景代理、登入與安裝等終端機指令
- CLI 旗標與參數控制模型、權限、輸出格式、設定來源與 print 模式的啟動旗標
- 斜線指令在互動 session 輸入 / 開頭的內建指令與內附 skill,依官方 Commands 參考整理
- 鍵盤快捷鍵一般操作、文字編輯、多行輸入、快速前綴與逐字稿檢視器的快捷鍵
- 設定檔與記憶檔CLAUDE.md、settings.json、MCP、skills、subagents 與快捷鍵設定檔的位置
- 進階功能延伸思考、權限模式、subagents、MCP、hooks、背景代理與雲端 session
- 環境變數驗證、模型、思考預算、逾時與更新相關的常用環境變數
- 實用技巧官方文件有寫、但容易被忽略的用法
- 提示詞範本依官方 Prompt library 的六個寫法整理成可直接改用的提示詞
常見比較
常見問題
多數人先用 claude 啟動、claude -c 接續上次對話、claude -p 做非互動執行,進入 session 後用 /init 建立 CLAUDE.md、/plan 先規劃、/code-review 審查變更、/compact 壓縮 context、/model 切換模型。這頁依官方 Commands 與 CLI reference 分類整理。
常用的有 Esc 中斷、Esc 連按兩下倒回、Shift+Tab 切換權限模式、Ctrl+R 搜尋歷史、Ctrl+J 或 \ + Enter 換行、Ctrl+V 貼上圖片、Ctrl+B 把工作移到背景。切換模型在 macOS 是 Option+P,Windows 與 Linux 是 Alt+P,延伸思考是 Option+T 或 Alt+T。空白輸入時按 ? 可以叫出快捷鍵說明。
依官方文件,在提示任何位置寫 ultrathink,該回合會要求更深的推理,think、think hard 等寫法只會被當成一般文字。要調整整個 session,用 /effort 或 --effort 設定 low 到 max 的等級,可用等級依模型而定。
CLAUDE.md 是給 Claude 的長期指示檔。團隊共用的專案規範放 ./CLAUDE.md 或 ./.claude/CLAUDE.md,只給自己用的專案設定放 CLAUDE.local.md,所有專案共用的個人偏好放 ~/.claude/CLAUDE.md。用 /init 可以自動產生,用 /memory 編輯。
遠端伺服器用 claude mcp add --transport http <名稱> <網址> 新增,要團隊共用就寫進專案的 .mcp.json。進入 session 後用 /mcp 查看連線狀態、處理 OAuth 或重新連線。
官方有 default、acceptEdits、plan、auto、dontAsk、bypassPermissions 六種。只想先看計畫用 plan,日常開發用 default 或 acceptEdits,auto 由分類器判斷能否放行。bypassPermissions 與 --dangerously-skip-permissions 會跳過所有確認,只適合完全隔離的環境。
依官方 Commands 參考,/cost 和 /stats 現在是 /usage 的別名,/review 是 /code-review 的別名,所以這頁併在主指令說明。/vim 已在 v2.1.92 移除,改從 /config 的 Editor mode 切換,/ultraplan 與 /pr-comments 也已移除。
可以,但做法是把規則與流程寫成檔案:CLAUDE.md 放專案規範,.claude/skills/<名稱>/SKILL.md 封裝重複流程,.claude/agents/<名稱>.md 定義 subagent。這樣同一套規則可以提交到 repo 讓整個團隊共用。