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

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

鍵盤快捷鍵

基本快捷鍵

快捷鍵	動作
`Escape`	取消目前生成
`Ctrl+C`	中斷 Claude / 退出
`Ctrl+L`	清除螢幕
`上/下`	瀏覽指令歷史
`Tab`	自動完成指令
`Shift+Enter`	多行輸入

macOS 專用

快捷鍵	動作
`Opt+P`	切換模型
`Cmd+K`	清除對話

Windows/Linux 專用

快捷鍵	動作
`Alt+P`	切換模型
`Ctrl+K`	清除對話

斜線指令

內建指令

指令	說明
`/help`	顯示所有可用指令
`/clear`	清除對話歷史
`/compact`	壓縮對話（減少 token）
`/init`	為專案初始化 CLAUDE.md
`/model`	顯示或變更目前模型
`/memory`	顯示記憶狀態
`/cost`	顯示 session 成本
`/doctor`	診斷配置問題
`/config`	開啟配置
`/bug`	回報錯誤

檔案指令

指令	說明
`/add <路徑>`	將檔案加入上下文
`/add-dir <路徑>`	將目錄加入上下文

審查與版本控制

指令	說明
`/review`	審查暫存變更
`/pr-comments`	審查 PR 評論

CLI 參數

啟動 Claude Code

# 基本
claude                    # 啟動互動 session
claude "提示"             # 執行單一提示
claude -c                 # 繼續上次 session
claude --resume           # 從特定 session 恢復

# 模型選擇
claude --model sonnet     # 使用 Claude Sonnet
claude --model opus       # 使用 Claude Opus
claude --model haiku      # 使用 Claude Haiku

# 輸出控制
claude -p "提示"          # 列印模式（非互動）
claude --output-format json  # JSON 輸出
claude --verbose          # 詳細日誌
claude --quiet            # 最少輸出

# Session 管理
claude --no-memory        # 此 session 停用記憶
claude --dangerously-skip-permissions  # 跳過所有權限提示

MCP 管理

# 列出和管理 MCP 伺服器
claude mcp list                    # 列出所有 MCP 伺服器
claude mcp add <名稱> <指令>       # 新增 MCP 伺服器
claude mcp remove <名稱>           # 移除 MCP 伺服器
claude mcp reset-project-choices   # 重設 MCP 權限

# 範圍限定的 MCP
claude mcp add --scope project <名稱> <指令>
claude mcp add --scope user <名稱> <指令>

配置

# 設定
claude config list         # 顯示所有設定
claude config set <鍵>     # 設定配置
claude config get <鍵>     # 取得配置值

# 登入/驗證
claude login              # 驗證
claude logout             # 登出

常見檔案模式

@ 參考

# 在提示或 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*)",
      "Write(.env*)",
      "Bash(rm -rf:*)"
    ]
  }
}

模式語法

模式	匹配
`Read`	所有讀取操作
`Write(src/**)`	寫入 src/ 及子目錄
`Bash(npm:*)`	所有 npm 指令
`Bash(git diff:*)`	git diff 帶任何參數
`Read(.env*)`	任何 .env 檔案

模型比較

模型	最適合	速度	上下文
Opus 4.5	複雜推理、關鍵任務	較慢	200K
Sonnet 4.5	一般編碼、平衡	快速	200K
Haiku 4.5	快速任務、探索	最快	200K

何時使用各模型

Opus：架構決策、安全審查、複雜重構
Sonnet：日常開發、功能實作
Haiku：快速問題、檔案探索、簡單編輯

記憶系統

記憶檔案

位置	範圍	用途
`~/.claude/CLAUDE.md`	全域	個人偏好
`./CLAUDE.md`	專案	團隊標準
`./.claude/CLAUDE.md`	專案	團隊標準（隱藏）
`./CLAUDE.local.md`	個人	個人覆寫

優先順序

1. CLAUDE.local.md（最高）
2. ./CLAUDE.md
3. ~/.claude/CLAUDE.md（最低）

常見工作流程

開始新功能

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

除錯問題

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

程式碼審查

claude
> 審查 [檔案] 的變更
> 關注：安全性、效能、可維護性

重構

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

故障排除快速修復

問題	解決方案
CLAUDE.md 被忽略	檢查檔案位置（./CLAUDE.md 或 ./.claude/CLAUDE.md）
MCP 未載入	`claude mcp reset-project-choices`
權限被拒	加入 settings.json 允許清單
token 使用過高	使用 `/compact` 或開始新 session
模型錯誤	`Option+P`（Mac）或 `Alt+P`（Win/Linux）
配置未套用	重新啟動 Claude Code

環境變數

# API 配置
ANTHROPIC_API_KEY=sk-...

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

# 除錯
CLAUDE_CODE_DEBUG=1

可列印摘要

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

快捷鍵
------
Escape      取消生成
Ctrl+C      中斷 / 退出
Ctrl+L      清除螢幕
Opt/Alt+P   切換模型

指令
----
/help       顯示指令
/clear      清除歷史
/init       建立 CLAUDE.md
/doctor     診斷問題

CLI
---
claude              啟動 session
claude "提示"       單一提示
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 文件、Claude Code GitHub