Claude Code 快速參考：指令、快捷鍵與速查表

2026 年 10 月 21 日更新： 依 Claude Code 2.1.305 全面校正：快捷鍵、斜線指令與別名（/review → /code-review、/cost → /usage）、CLI 指令（claude auth、claude purge）、權限模式參數、權限規則語法、AGENTS.md，以及 Opus 5.5 / Sonnet 5.5 / Haiku 5.5 / Fable 5.1 模型陣容。

收藏這個頁面。高效使用 Claude Code 所需的一切，依快速查閱需求整理。

鍵盤快捷鍵

基本快捷鍵

快捷鍵	動作
`Escape`	中斷 Claude（停止目前的回應或工具呼叫）
`Ctrl+C`	中斷或清除輸入；在空白提示列再按一次即退出
`Ctrl+L`	重繪畫面（保留對話）
`上/下`	瀏覽指令歷史
`Tab`	接受自動完成建議
`Shift+Enter`	多行輸入（任何終端機都可用 `\` + `Enter` 或 `Ctrl+J`）
`Shift+Tab`	切換權限模式（Manual → acceptEdits → plan → auto）
`Esc` `Esc`	清除草稿；提示列為空時開啟 rewind 選單
`Ctrl+R`	反向搜尋指令歷史

macOS 專用

快捷鍵	動作
`Opt+P`	切換模型
`Opt+T`	切換延伸思考（對一律思考的 Opus 5.5、Sonnet 5.5、Haiku 5.5 與 Fable 無作用）
`Opt+O`	切換 fast mode

包括 Opt+P 在內，多數 Option 快捷鍵需要在終端機把 Option 設為 Meta。Cmd+K 並不是 Claude Code 的「清除對話」鍵，請改用 /clear。

Windows/Linux 專用

快捷鍵	動作
`Alt+P`	切換模型
`Alt+T`	切換延伸思考
`Alt+O`	切換 fast mode

Ctrl+K 是刪除到行尾，不會清除對話。

斜線指令

內建指令

指令	說明
`/help`	顯示所有可用指令
`/clear`	以空白上下文開始新對話（別名：`/reset`、`/new`）
`/compact`	摘要對話以釋放上下文
`/context`	顯示上下文視窗被什麼佔用
`/init`	為專案初始化 CLAUDE.md
`/model`	切換模型（並存為新 session 的預設）
`/effort`	設定 effort（`low`–`xhigh`、`max`、`auto`）；`/effort ultracode` 切換 ultracode
`/memory`	編輯 CLAUDE.md 檔案並管理自動記憶
`/usage`	Session 成本、方案用量上限與統計（`/cost`、`/stats` 為別名）
`/doctor`	執行設定健檢並修復問題（別名：`/checkup`）
`/config`	開啟 Settings（別名：`/settings`）
`/permissions`	管理 allow、ask、deny 規則
`/bug`	回報錯誤或分享對話（別名：`/share`）

檔案指令

指令	說明
`@<路徑>`	在提示中提及檔案或目錄（沒有 `/add` 指令）
`/add-dir <路徑>`	為此 session 新增工作目錄

審查與版本控制

指令	說明
`/code-review`	審查目前的 diff，或指定的 PR 編號、分支、路徑（`--fix`、`--comment`、`ultra`）
`/review`	`/code-review` 的別名（自 v2.1.223 起）
`/security-review`	檢查目前分支變更中的安全漏洞
`/diff`	檢視工作目錄的變更，包括 Claude 的編輯

/pr-comments 已在 v2.1.91 移除；請直接請 Claude 讀取 PR 評論。

CLI 參數

啟動 Claude Code

# 基本
claude                    # 啟動互動 session
claude "提示"             # 以初始提示啟動 session
claude -c                 # 繼續此目錄最近的對話
claude -r                 # 依 ID 或名稱恢復 session，或開啟選擇器
claude -n "auth-refactor" # 為 session 命名

# 模型選擇（Anthropic API 上的別名）
claude --model opus       # Opus 5.5（預設模型）
claude --model sonnet     # Sonnet 5.5
claude --model haiku      # Haiku 5.5
claude --model fable      # Fable 5.1（不會是預設）
claude --effort high      # low | medium | high | xhigh | max

# 輸出控制
claude -p "提示"          # 列印模式（非互動）
claude -p "提示" --output-format json  # JSON 輸出（text | json | stream-json）
claude --verbose          # 逐回合的詳細輸出
claude --debug            # 除錯日誌（或 --debug-file <路徑>）

# 權限
claude --permission-mode plan  # manual | acceptEdits | plan | auto | dontAsk | bypassPermissions
claude --restricted            # 移除執行指令的工具與 WebFetch；忽略 user/project/local 設定
claude --dangerously-skip-permissions  # 跳過所有權限提示（僅限隔離的容器）

沒有任何設定指定權限模式時，互動式終端機 session 以 auto 模式啟動（v2.1.283+）；claude -p 則以 Manual 模式啟動（v2.1.302+）。

MCP 管理

# 列出和管理 MCP 伺服器
claude mcp list                                # 列出伺服器與健康狀態
claude mcp add --transport http <名稱> <url>   # 新增遠端 HTTP 伺服器
claude mcp add <名稱> -- <指令> [參數...]      # 新增本機 stdio 伺服器
claude mcp get <名稱>                          # 檢視單一伺服器
claude mcp remove <名稱>                       # 移除 MCP 伺服器
claude mcp reset-project-choices               # 重設 .mcp.json 伺服器的核准

# 範圍限定的 MCP（預設範圍：local）
claude mcp add --scope project <名稱> -- <指令>
claude mcp add --scope user <名稱> -- <指令>

配置

# 設定（`claude config` 已在 v2.0 移除）
/config                   # 在 session 中：開啟 Settings
/config model=sonnet      # 在 session 中：直接設定單一鍵值
# 檔案：~/.claude/settings.json（使用者）、.claude/settings.json（專案）、
#       .claude/settings.local.json（本機，不納入 git）

# 登入/驗證
claude auth login         # 驗證（--console 改用 API 計費）
claude auth status        # 顯示驗證狀態
claude auth logout        # 登出
claude setup-token        # 供 CI 與腳本使用的長效 OAuth token

# 維護
claude update             # 更新 Claude Code
claude doctor             # 安裝與設定診斷
claude purge [路徑]       # 刪除專案的本機狀態（--dry-run、--all）

常見檔案模式

@ 參考

# 在提示或 CLAUDE.md 中
參見 @README.md 了解專案概述。
檢查 @src/lib/auth.ts 的驗證工具。
參考 @package.json 了解依賴。

CLAUDE.md 模板

# 最小 CLAUDE.md
## 專案
[簡短描述]

## 指令
- npm run dev
- npm test

## 標準
- TypeScript 嚴格模式
- 功能需要測試

# 完整 CLAUDE.md
## 概述
[專案描述]

## 技術棧
- [框架]
- [語言]
- [資料庫]

## 目錄結構
src/
├── [資料夾]/  # [用途]
└── [資料夾]/  # [用途]

## 指令
- [指令] - [說明]

## 自主操作
- [允許的動作]

## 需要確認
- [受限的動作]

權限模式

settings.json

{
  "permissions": {
    "allow": [
      "Read",
      "Write",
      "Edit",
      "Bash(npm *)",
      "Bash(git *)"
    ],
    "deny": [
      "Read(.env*)",
      "Edit(.env*)",
      "Bash(rm -rf *)"
    ]
  }
}

模式語法

模式	匹配
`Read`	所有讀取操作
`Edit(src/**)`	編輯 src/ 及子目錄（路徑規則用 `Edit`；`Write(路徑)` 規則永遠不會被檢查）
`Bash(npm *)`	所有 npm 指令（`Bash(npm:*)` 是等效的舊寫法）
`Bash(git diff *)`	git diff 帶任何參數
`Read(.env*)`	任何 .env 檔案
`WebFetch(domain:example.com)`	對 example.com 的擷取

規則依 deny → ask → allow 的順序評估，而且 deny 規則在每一種權限模式（包括 bypassPermissions）都有效。

模型比較

模型	最適合	速度
Fable 5.1	最困難的問題、長時間自主任務	較慢
Opus 5.5	多數工作的預設、複雜推理	快速；`/fast` 最高可達 2.5 倍
Sonnet 5.5	成本較低的日常編碼	快速
Haiku 5.5	快速任務、探索、subagent	最快

何時使用各模型

Fable 5.1：根因調查、架構決策、一次坐不完的大型工作（用 /model fable 選擇；它不會是預設，且可能以 usage credits 計費）
Opus 5.5：Pro、Max、Team、Enterprise 與 Anthropic API 的預設，也是 Anthropic 建議的起點；重視回應速度時可開啟 /fast
Sonnet 5.5：日常開發、功能實作
Haiku 5.5：快速問題、檔案探索、簡單編輯

在 Anthropic API 上，opus、sonnet、haiku、fable 分別自 Claude Code v2.1.280、v2.1.284、v2.1.293、v2.1.257 起指向上述模型。Bedrock、Google Cloud’s Agent Platform、Microsoft Foundry 與 Claude Platform on AWS 仍有部分別名指向較舊的模型。Opus 5.5、Sonnet 5.5、Haiku 5.5 的預設 effort 是 medium；Fable 5.1 預設 high。各模型的完整選擇建議，請見模型選擇指南。

記憶系統

記憶檔案

位置	範圍	用途
`~/.claude/CLAUDE.md`	全域	個人偏好
`./CLAUDE.md`	專案	團隊標準
`./.claude/CLAUDE.md`	專案	團隊標準（隱藏）
`./CLAUDE.local.md`	個人	個人覆寫
`./AGENTS.md`	專案	沒有 CLAUDE.md 時改讀此檔（v2.1.277+）
`~/.claude/projects/<專案>/memory/`	每個專案	Claude 自行寫入的自動記憶

載入順序

檔案會合併而非互相覆蓋；越後面越具體：
1. ~/.claude/CLAUDE.md（使用者）
2. ./CLAUDE.md 或 ./.claude/CLAUDE.md（專案）
3. ./CLAUDE.local.md（本機，最後讀取）

常見工作流程

開始新功能

claude
> 實作 [功能描述]
> 遵循 TDD - 先寫測試

除錯問題

claude
> 除錯：[錯誤訊息]
> 檢查 [路徑] 的日誌

程式碼審查

claude
> /code-review
> 關注：安全性、效能、可維護性

重構

claude
> 將 [元件] 重構為 [模式]
> 保持向後相容

故障排除快速修復

問題	解決方案
CLAUDE.md 被忽略	檢查檔案位置（./CLAUDE.md 或 ./.claude/CLAUDE.md）；`/context` 會列出已載入的記憶檔案
MCP 未載入	`/mcp` 或 `claude mcp get <名稱>`；`claude mcp reset-project-choices`
權限被拒	用 `/permissions` 或在 settings.json 允許清單中新增規則
token 使用過高	先看 `/context`，再用 `/compact` 或 `/clear`
模型錯誤	`/model`，或 `Option+P`（Mac）/ `Alt+P`（Win/Linux）
配置未套用	執行 `claude doctor` 檢查設定錯誤，再重新啟動 Claude Code

環境變數

# API 配置
ANTHROPIC_API_KEY=sk-...

# 代理（如需要）
HTTP_PROXY=http://...
HTTPS_PROXY=https://...

# 模型與工具
ANTHROPIC_MODEL=opus               # 新 session 使用的模型
CLAUDE_CODE_EFFORT_LEVEL=high      # low | medium | high | xhigh | max | auto
CLAUDE_CODE_ENABLE_TODO_TOOLS=1    # 在較新模型上啟用 Task/TodoWrite 工具（預設關閉）

# 除錯
DEBUG=1                            # 等同 --debug

可列印摘要

CLAUDE CODE 快速參考
====================

快捷鍵
------
Escape      中斷 Claude
Ctrl+C      中斷 / 清除 / 退出
Shift+Tab   切換權限模式
Opt/Alt+P   切換模型

指令
----
/help       顯示指令
/clear      開始新對話
/init       建立 CLAUDE.md
/doctor     診斷問題

CLI
---
claude              啟動 session
claude -p "提示"    單一提示後結束
claude -c           繼續 session
claude --model X    使用模型 X

檔案
----
./CLAUDE.md         專案配置
~/.claude/CLAUDE.md 全域配置
CLAUDE.local.md     個人覆寫
.claude/settings.json  權限

MCP
---
claude mcp list     顯示伺服器
claude mcp add      新增伺服器
claude mcp remove   移除伺服器

收藏這個頁面並隨時查閱。你會比想像中更常使用它。

來源：Claude Code 文件、CLI 參考、指令、互動模式、模型設定、Claude Code GitHub