Claude Code 快速參考表

原站（英文） GitHub
Claude Code v2.1.201 更新日期：2026 年 7 月 5 日
📋 近期更新 ✕
⌨️ 鍵盤快捷鍵
一般控制
CtrlC 取消輸入／中斷生成
CtrlD 結束對話
CtrlL 清除畫面
CtrlO 切換詳細／逐字稿／焦點模式NEW
CtrlU 清空整個輸入緩衝區NEW
CtrlY 還原已清空的輸入NEW
CtrlR 反向搜尋歷史
CtrlG 在編輯器中開啟提示詞
CtrlX CtrlE 在編輯器中開啟（別名）
CtrlB 將任務移至背景
CtrlT 釘選/取消釘選背景 Session（claude agents 中）；一般模式切換任務清單NEW
CtrlV 貼上圖片（[Image #N] 標籤）
CtrlX CtrlK 終止背景 Agent
EscEsc 回溯或摘要
模式切換
ShiftTab 循環切換權限模式
AltP 切換模型
AltT 切換思考模式
AltO 切換快速模式NEW
輸入
\Enter 換行（快速）
CtrlJ 換行（控制序列）
前綴符號
/ 斜線指令
! 直接執行 Bash
@ 檔案提及 + 自動完成
Session 選擇器
↑↓ 瀏覽
←→ 展開／收合
P 預覽
R 重新命名
/ 搜尋
A 所有專案
B 目前分支
逐字稿／焦點模式 (Ctrl+O)
CtrlE 切換顯示全部
Q / Esc 離開逐字稿
? 顯示快捷鍵說明NEW
{ / } 跳至上／下一個使用者訊息NEW
v 切換快捷鍵面板NEW
Vim 模式
v 視覺模式（選取 + 運算子）NEW
V 視覺行模式NEW
🔌 MCP 伺服器
新增伺服器
--transport http 遠端 HTTP（推薦）
--transport stdio 本機程序
--transport sse 遠端 SSE
作用範圍
Local ~/.claude.json（僅個人）
Project .mcp.json（共享／版控）
User ~/.claude.json（全域）
管理
/mcp 互動式管理介面
claude mcp list 列出所有伺服器
claude mcp serve 將 CC 作為 MCP 伺服器
Elicitation 伺服器可在任務中請求輸入
2KB 上限 工具描述 + 伺服器指令限制
maxResultSizeChars _meta 標註覆寫（最高 500K）NEW
alwaysLoad 跳過工具搜尋延遲，工具始終可用（MCP server config）NEW
⚡ 斜線指令
Session 管理
/clear 清除對話
/compact [焦點] 壓縮上下文
/resume 恢復／切換 Session
/rename [名稱] 命名目前 Session
/branch [名稱] 分支對話（/fork 別名）
/cost Token 用量（各模型 + 快取明細）NEW
/context 視覺化上下文（格狀圖）
/diff 互動式差異檢視器；詳細檢視支援鍵盤捲動（方向鍵、j/k、PgUp/PgDn）NEW
/copy [N] 複製最近（或第 N 筆）回應
/rewind 回溯對話／程式碼檢查點；支援恢復至 /clear 之前的狀態NEW
/undo /rewind 的別名NEW
/recap 回來時摘要 Session 上下文NEW
/export 匯出對話
/cd <路徑> 切換工作目錄而不中斷 prompt cacheNEW
設定
/config [key=value] 開啟設定；key=value 直接設定選項（如 /config thinking=false）；--help 列出速記鍵NEW
/model [模型] 切換模型（僅目前 Session）；選擇器中按 d 設定新 Session 預設NEW
/fast [on|off] 切換快速模式
/theme 更換色彩主題 — 含「Auto（跟隨終端機）」深／淺色選項NEW
/permissions 查看／更新權限
/effort [等級] 設定 effort（low/medium/high/xhigh/max）；不帶參數時開啟方向鍵互動式滑桿NEW
/color [顏色] 設定提示列顏色
/scroll-speed 調整滑鼠滾輪速度（含即時預覽）NEW
/keybindings 自訂鍵盤快捷鍵
/terminal-setup 設定終端機按鍵綁定
工具
/init 建立 CLAUDE.md
/memory 編輯 CLAUDE.md 檔案
/mcp 管理 MCP 伺服器
/hooks 管理 Hooks
/skills 列出可用 Skills（可輸入即時篩選）NEW
/agents 管理 Agents（執行中 + 函式庫分頁，快速啟動／檢查）NEW
/chrome Chrome 整合
/plugin list 列出已安裝外掛（--enabled/--disabled 篩選）NEW
/reload-plugins 熱載入外掛，自動安裝缺少的相依套件NEW
/reload-skills 重新掃描 Skill 目錄，無需重啟 SessionNEW
/team-onboarding 從本地使用記錄生成團隊入門指南NEW
/add-dir <路徑> 新增工作目錄
特殊指令
/powerup 互動式功能教學NEW
/btw <問題> 附帶問題（不佔上下文）；按 c 可複製原始 Markdown 回應NEW
/plan [描述] 計畫模式（+ 自動啟動）
/goal [條件] 設定完成條件，Claude 持續工作直到達成NEW
/ultraplan 在瀏覽器 Session 草擬計畫，自動建立雲端環境NEW
/ultrareview [PR#] 雲端程式碼審查 — 多 Agent 平行分析NEW
/focus 切換焦點模式（僅全螢幕）NEW
/less-permission-prompts 新增白名單以減少權限提示NEW
/loop [間隔] [prompt] 排程週期任務（/proactive 別名）NEW
/voice 按鍵說話語音（20 種語言）
/doctor 診斷安裝狀態
/pr-comments [PR] 擷取 GitHub PR 留言
/stats 使用統計與偏好
/insights 分析 Session 報告
/desktop 在桌面版繼續
/remote-control 橋接至 claude.ai/code（/rc）
/usage 方案限額、速率狀態（含 /cost、/stats 功能）；分類用量明細（Skills／子 Agent／外掛／各 MCP 費用）NEW
/usage-credits 用量點數（原 /extra-usage，舊名仍可使用）NEW
/schedule 雲端排程任務
/security-review 變更的安全性分析
/help 顯示說明 + 指令
/feedback 提交回饋（別名：/bug）
/release-notes 互動式版本更新日誌NEW
/stickers 訂購貼紙！🎉
📁 記憶與檔案
CLAUDE.md 位置
./CLAUDE.md 專案（團隊共享）
./.claude/CLAUDE.md 專案（團隊共享，替代位置）
./CLAUDE.local.md 個人本機（已 gitignore）
~/.claude/CLAUDE.md 個人（所有專案）
/etc/claude-code/ 受管理（Linux/WSL，組織層級）
規則與匯入
.claude/rules/*.md 專案規則
~/.claude/rules/*.md 使用者規則
paths: frontmatter 路徑限定規則
@path/to/file 在 CLAUDE.md 中匯入
自動記憶
~/.claude/projects/<專案>/memory/
MEMORY.md + 主題檔案，自動載入（25KB/200 行上限）
🧠 工作流程與技巧
計畫模式
ShiftTab 一般 → 自動接受 → 計畫
--permission-mode plan 以計畫模式啟動
Plan 檔名 以 prompt 命名（例：fix-auth-race-snug-otter.md）NEW
思考與 Effort
AltT 切換思考開／關
"ultrathink" 單回合最大 effort
"ultracode" 工作流程觸發關鍵字（紫色高亮顯示，取代舊版 "workflow"）NEW
CtrlO 檢視思考過程（詳細模式）
/effort ○ low · ◐ medium · ● high · ★ max
Sonnet 5 現為預設模型；原生 1M Token 上下文；$2/$10 per Mtok 優惠至 2026/08/31NEW
Fable 5 Mythos 等級模型；能力超越所有先前可用模型NEW
Opus 4.8 預設 effort xhigh；快速模式 2× 費率 / 2.5× 速度NEW
自動模式被拒
/permissions → Recent 按 R 重試被拒操作NEW
Git Worktrees
--worktree name 每個功能獨立分支
isolation: worktree Agent 在獨立 worktree 運行
sparsePaths 僅 checkout 需要的目錄
workspace.git_worktree 狀態列 JSON：連結的 worktree 路徑NEW
/batch 自動建立 worktrees
語音模式
/voice 啟用按鍵說話
Space（按住） 錄音，放開傳送
20 種語言 EN、ES、FR、DE、CZ、PL…
上下文管理
/context 用量 + 最佳化建議
/compact [焦點] 聚焦壓縮
自動壓縮 約 95% 容量觸發（抖動偵測：3 次）NEW
1M 上下文 Sonnet 5（預設）/ Opus 4.6（Max/Team/Enterprise）NEW
CLAUDE.md 壓縮後仍保留！
Session 進階操作
claude -c 繼續上次對話
claude -r "名稱" 按名稱恢復
/btw 問題 附帶提問，不佔上下文
SDK／Headless
claude -p "查詢" 非互動模式
--output-format json 結構化輸出
--max-budget-usd 5 費用上限
cat file | claude -p 管線輸入
排程與遠端
/loop 5m msg 週期性任務
Monitor 串流背景指令碼事件NEW
/rc 遠端控制（預設主機名前綴）NEW
--remote 在 claude.ai 上開啟 Web Session
⚙️ 設定與環境
設定檔
~/.claude/settings.json 使用者設定
.claude/settings.json 專案（共享）
.claude/settings.local.json 僅限本機
~/.claude.json OAuth、MCP、狀態
.mcp.json 專案 MCP 伺服器
managed-settings.d/ 組織策略片段（Drop-in）
重要設定
modelOverrides 映射模型選擇器 → 自訂 ID
autoMemoryDirectory 自訂記憶目錄
worktree.sparsePaths Sparse checkout 目錄
worktree.baseRef Worktree diff 比對的基準分支NEW
worktree.bgIsolation "none"：背景 session 直接編輯工作目錄，無需 EnterWorktreeNEW
autoMode.hard_deny Auto 模式分類器無條件拒絕規則NEW
sandbox.failIfUnavailable 沙盒失敗則退出
hooks: if 條件式 Hooks（權限規則語法）
DISABLE_PROMPT_CACHING* 停用 prompt caching 時啟動會警告NEW
PermissionDenied Hook：自動模式被拒絕NEW
showThinkingSummaries 選擇啟用（預設關閉）NEW
allowedChannelPlugins 管理員頻道外掛白名單
hooks: "defer" 暫停 Headless → 稍後恢復
hooks: type: "mcp_tool" Hook 直接呼叫 MCP 工具NEW
hooks: duration_ms Hook 事件回報工具執行時間NEW
hookSpecificOutput.updatedToolOutput PostToolUse Hook 覆寫所有工具輸出（非僅 MCP）NEW
hooks: continueOnBlock PostToolUse 被拒時回傳拒絕原因給 Claude 並繼續本回合（設為 true）NEW
hooks: args: string[] exec form：直接 spawn 指令不透過 shell，路徑佔位符無需引號NEW
hooks: background_tasks Stop / SubagentStop Hook 輸入欄位：目前執行中的背景任務清單NEW
hooks: session_crons Stop / SubagentStop Hook 輸入欄位：已排程的 Session Cron 清單NEW
hookSpecificOutput.additionalContext Stop / SubagentStop Hook 回傳值：給 Claude 回饋並繼續本回合，不標記為 hook 錯誤NEW
allowAllClaudeAiMcps 企業受管理設定：隨 managed-mcp.json 一併載入 claude.ai 雲端 MCP 連接器NEW
pluginSuggestionMarketplaces 受管理設定：白名單組織市集，允許情境提示建議外掛NEW
requiredMinimumVersion 受管理設定：版本低於此值時拒絕啟動NEW
requiredMaximumVersion 受管理設定：版本高於此值時拒絕啟動，引導至核准版本NEW
fallbackModel 最多指定三個備援模型，依序嘗試（主要模型過載或不可用時）NEW
disableBundledSkills 隱藏內建 Skills、工作流程與斜線指令NEW
post-session hook 自我托管生命週期 Hook：Session 結束後、工作區刪除前執行；SIGTERM→SIGKILL 延遲時間可設定NEW
enforceAvailableModels 受管理設定：限制 Default 模型至白名單，使用者 / 專案設定無法擴展NEW
wheelScrollAccelerationEnabled 設為 false 停用全螢幕模式的滾輪加速NEW
language 設定 Session 標題生成語言（預設跟隨對話語言）NEW
footerLinksRegexes 正規表示式清單，比對 URL 以顯示自訂連結 badgeNEW
attribution.sessionUrl 設為 false 可省略 commit 與 PR 中附加的 claude.ai Session 連結NEW
sandbox.allowAppleEvents macOS 沙盒選擇性啟用 Apple Events（設為 true）NEW
sandbox.credentials 阻止沙盒指令讀取憑證檔案與 secret 環境變數NEW
autoMode.classifyAllShell 將所有 Bash/PowerShell 指令路由至 Auto 模式分類器（預設僅路由任意程式碼執行模式）NEW
teammateMode: "iterm2" 設定 iTerm2 為 Teammate 模式；未偵測到 it2 CLI 時顯示警告NEW
MessageDisplay Hook 事件：在顯示前轉換或隱藏助理訊息文字NEW
hookSpecificOutput.sessionTitle SessionStart Hook 回傳值：設定 Session 標題（啟動與恢復均適用）NEW
reloadSkills: true SessionStart Hook 回傳值：重新掃描 Skill 目錄，讓安裝後立即生效NEW
prUrlTemplate 自訂 PR 審查 URL（取代預設 github.com）NEW
autoMode: "$defaults" 在自訂規則外一併保留內建規則NEW
disableSkillShellExec 禁止 Skills/外掛中的 !`cmd`NEW
forceRemoteSettingsRefresh 強制刷新：阻擋啟動直到取得最新設定NEW
refreshInterval 自訂狀態列每 N 秒重新執行NEW
重要環境變數
ANTHROPIC_API_KEY
ANTHROPIC_MODEL
CLAUDE_CODE_EFFORT_LEVEL low/medium/high/xhigh/max/auto
MAX_THINKING_TOKENS 0=關閉
ENABLE_PROMPT_CACHING_1H 啟用 1 小時 prompt cache TTLNEW
FORCE_PROMPT_CACHING_5M 強制 5 分鐘 prompt cache TTLNEW
CLAUDE_CODE_ENABLE_AWAY_SUMMARY 停用遙測時仍強制產生回來時的 recapNEW
CLAUDE_CODE_USE_POWERSHELL_TOOL 啟用 Windows PowerShell 工具（Linux/macOS 設 =1，需 pwsh 在 PATH）NEW
CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY 設為 1 退出 PowerShell -ExecutionPolicy Bypass 預設值NEW
CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE 設為 1 將快速模式固定使用 Opus 4.6（預設已升至 Opus 4.7）NEW
CLAUDE_CODE_FORK_SUBAGENT 在外部建置上啟用分叉子 Agent（=1）NEW
DISABLE_UPDATES 封鎖所有更新路徑，包含手動 claude updateNEW
CLAUDE_CODE_HIDE_CWD 隱藏啟動 Logo 中的工作目錄NEW
ANTHROPIC_CUSTOM_MODEL_OPTION 自訂 /model 選項
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB 從子程序移除憑證
CLAUDE_STREAM_IDLE_TIMEOUT_MS 串流逾時看門狗（預設 90s）
CLAUDE_CODE_NO_FLICKER 替代畫面渲染（=1）NEW
MCP_CONNECTION_NONBLOCKING 在 -p 模式跳過 MCP 等待NEW
CLAUDE_CODE_USE_MANTLE 透過 Mantle 使用 Bedrock（=1）NEW
ANTHROPIC_BEDROCK_SERVICE_TIER 選擇 Bedrock 服務層級（default / flex / priority）NEW
CLAUDE_CODE_PERFORCE_MODE Perforce 模式：唯讀檔案自動提示 p4 edit（=1）NEW
CLAUDE_CODE_CERT_STORE 設為 bundled 僅使用內建 CA 憑證NEW
CLAUDECODE 偵測 CC Shell 環境（=1）
CLAUDE_CODE_MAX_OUTPUT_TOKENS 預設 32K
CLAUDE_CODE_DISABLE_CRON 停用排程任務
CLAUDE_CODE_SESSION_ID 用於 Hooks 與 CI 追蹤的唯一 Session ID；stdio MCP 伺服器在 --resume 時也收到相同值NEW
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN 關閉全螢幕替代畫面渲染（=1）NEW
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE 透過 Homebrew／WinGet 自動升級NEW
CLAUDE_PROJECT_DIR MCP stdio 伺服器可用的專案目錄路徑（與 Hooks 環境一致）NEW
CLAUDE_CODE_STOP_HOOK_BLOCK_CAP 覆寫 stop hooks 連續阻塞警告上限（預設 8 次）NEW
ANTHROPIC_WORKSPACE_ID 工作負載身份聯盟：將 minted token 範圍限定至特定工作區NEW
CLAUDE_CODE_PLUGIN_PREFER_HTTPS 透過 HTTPS 複製 GitHub 外掛來源，取代預設 SSHNEW
NO_COLOR / FORCE_COLOR 現在僅套用至子程序，不影響 Claude Code UI 顏色NEW
OTEL_METRICS_INCLUDE_ENTRYPOINT 設為 true 時在 OpenTelemetry 指標中加入 app.entrypoint Session 來源屬性NEW
CLAUDE_CODE_ENABLE_AUTO_MODE 設為 1 在 Bedrock / Vertex / Foundry 上啟用 Auto 模式（Opus 4.7 + 4.8）NEW
OTEL_LOG_TOOL_DETAILS 設為 1 時，tool_decision 遙測事件包含 tool_parameters 詳情NEW
OTEL_RESOURCE_ATTRIBUTES 值作為標籤附加至 OpenTelemetry 指標資料點，可按自訂維度（如 team、repo）切分用量指標NEW
CLAUDE_CODE_SAFE_MODE 停用所有客製化設定（CLAUDE.md、外掛、Skills、Hooks、MCP 伺服器），等同 --safe-mode 旗標NEW
CLAUDE_CODE_DISABLE_BUNDLED_SKILLS 隱藏內建 Skills、工作流程與斜線指令NEW
CLAUDE_CLIENT_PRESENCE_FILE 指定檔案路徑；檔案存在時抑制行動裝置推播通知NEW
CLAUDE_CODE_DISABLE_MOUSE_CLICKS 全螢幕模式下停用滑鼠點擊／拖曳／懸停（保留滾輪捲動）NEW
OTEL_LOG_ASSISTANT_RESPONSES 設為 1 時將助理回應文字寫入 OpenTelemetry log；預設跟隨 OTEL_LOG_USER_PROMPTSNEW
🔧 Skills 與 Agents
內建 Skills
Skill tool 發現內建斜線指令（/init、/review、/security-review…）NEW
/code-review [等級] 程式碼審查，回報正確性錯誤；--fix 直接套用建議；--comment 在 GitHub PR 發行內聯留言（/simplify 為 --fix 別名）NEW
/batch 大規模平行變更（5-30 worktrees）
/debug [描述] 從除錯日誌排錯
/loop [間隔] 週期性排程任務
/claude-api 載入 API + SDK 參考
/dataviz 圖表與資料視覺化設計指南，含色彩配置驗證器NEW
自訂 Skill 位置
.claude/skills/<名稱>/ 專案 Skills（自動載入，無需 Marketplace）；巢狀子目錄也自動載入NEW
~/.claude/skills/<名稱>/ 個人 Skills
Skill Frontmatter
description 自動觸發條件
allowed-tools 跳過權限提示
disallowed-tools Skill 啟用時從模型中移除指定工具NEW
model 覆寫 Skill 使用的模型
effort 覆寫 effort 等級
paths: [globs] 路徑限定（YAML 列表）NEW
context: fork 在子 Agent 中執行
$ARGUMENTS 使用者輸入預留位
\$ 跳脫語法 在指令主體中以 \$ 輸入字面 $（如 \$1 不觸發參數替換）NEW
${CLAUDE_SKILL_DIR} Skill 所在目錄
!`cmd` 動態上下文注入
plugin bin/ 隨附可執行檔供 Bash 工具使用NEW
plugin themes/ 外掛附帶自訂主題NEW
plugin SKILL.md 根目錄有 SKILL.md 且無 skills/ 子目錄時，外掛自動作為 Skill 提供NEW
plugin.json: defaultEnabled 設為 false 讓外掛安裝後預設停用NEW
內建 Agents
Explore 快速唯讀（Haiku）
Plan 計畫模式研究
General 完整工具，複雜任務
Bash 獨立上下文的終端機
Agent Frontmatter
permissionMode default/acceptEdits/plan/dontAsk/bypassPermissions
isolation: worktree 在 Git worktree 中執行
memory: user|project|local 持久記憶
background: true 背景任務
maxTurns 限制 Agent 回合數
initialPrompt 第一回合自動提交
SendMessage 恢復 Agent（取代 resume）
@agent-name 提及命名子 AgentNEW
mcpServers 在 --agent 主執行緒 session 中載入 MCP 伺服器NEW
agent settings.json 中的 agent 欄位在已派送 Session 中正確生效NEW
Tool(param:value) 權限規則語法：如 Agent(model:opus) 允許以 Opus 模型派送子 AgentNEW
5 層巢狀子 Agent 子 Agent 可再派送子 Agent，最多 5 層深NEW
🖥️ CLI 指令與旗標
核心指令
claude 互動模式
claude "問題" 帶提示詞啟動
claude -p "問題" Headless 模式
claude -c 繼續上次
claude -r "名稱" 恢復 Session
claude update 更新
claude plugin prune 移除孤立的自動安裝外掛相依套件NEW
claude plugin init <name> 建立新外掛的目錄鷹架NEW
claude plugin details <name> 顯示外掛元件清單及預估每 session token 費用NEW
claude project purge [path] 刪除專案所有 CC 狀態（--dry-run / -y / -i / --all）NEW
claude auth login 支援終端機貼入 OAuth 碼（WSL2 / SSH / 容器）NEW
claude mcp login <name> 從 CLI 驗證 MCP 伺服器（--no-browser 支援 SSH stdin 重定向）NEW
claude mcp logout <name> 從 CLI 登出 MCP 伺服器NEW
claude agents [--cwd <path>] 所有 Session 統一清單（執行中、已阻塞、已完成）；--json 輸出 JSON 供腳本整合（含 waitingFor、id、state 欄位）；--all 含已完成 Session；支援 --add-dir、--settings、--mcp-config、--model 等旗標NEW
claude ultrareview [target] 非互動式程式碼審查（PR / 分支 / 路徑）NEW
重要旗標
--model 指定模型
--fallback-model 主要模型找不到時自動切換至備援模型NEW
--thinking disabled 停用預設會思考的模型的思考功能NEW
--safe-mode 停用所有客製化設定（CLAUDE.md、外掛、Skills、Hooks、MCP 伺服器）以排錯NEW
-w Git worktree
-n / --name Session 名稱
--add-dir 新增目錄
--agent 使用 Agent
--from-pr [URL] 從 PR 恢復（支援 GitHub / GitLab / Bitbucket / GHE）NEW
--allowedTools 預先核准工具
--output-format json/stream
--json-schema 結構化輸出
--max-turns 限制回合數
--max-budget-usd 費用上限
--console 透過 Anthropic Console 認證
Bedrock 精靈 登入時互動式 AWS 設定NEW
Vertex AI 精靈 登入時互動式 Google Vertex 設定NEW
--verbose 詳細模式
--bare 最小化 Headless（無 hooks/LSP）
--channels 權限中繼／MCP 推送
--remote Web Session
--effort low/medium/high/max
--permission-mode manual（原 default）/ plan / acceptEdits / bypassPermissionsNEW
--exclude-dynamic-system-prompt-sections 列印模式省略動態段落（跨使用者提示快取優化）NEW
--allow-dangerously-skip-permissions 將 bypassPermissions 加入 Shift+Tab 循環
--plugin-url 從 URL 抓取外掛 .zipNEW
--dangerously-skip-permissions 跳過所有權限提示，含 .claude/ .git/ .vscode/ 等保護路徑 ⚠️NEW
--remote-control / --rc 互動式 Remote Control Session
--chrome Chrome 整合
PowerShell 工具 Windows 預覽版NEW