Claude Code速查表：指令、設定與快捷鍵

一站掌握所有CLI旗標、斜線指令、鍵盤快速鍵、設定鍵、hook 事件與環境變數。如需深入說明，請參閱完整的Claude Code指南。若是首次設定，請參閱快速入門。

1. 安裝

共有3種安裝方式，依建議優先順序排列。

# Native binary (recommended)
curl -fsSL https://claude.ai/install.sh | bash

# Homebrew (macOS)
brew install --cask claude-code

# NPM (deprecated — migrate with `claude install`)
npm install -g @anthropic-ai/claude-code

安裝特定版本：

curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

驗證安裝：

claude doctor
claude --version

驗證身分：

claude auth login       # Log in or switch accounts
claude auth status      # Check current auth state
claude auth logout      # Clear stored credentials

2. CLI 旗標

v2.1.212新增的子命令：claude auto-mode reset可從終端機重設自動模式狀態；傳入--yes即可略過確認提示。⁷

3. 斜線命令

自訂命令：建立.claude/commands/my-command.md（專案）或~/.claude/commands/my-command.md（個人），再使用/my-command呼叫。命令支援YAML frontmatter，可指定說明、允許的工具、模型覆寫，以及透過$ARGUMENTS或位置參數$1、$2進行引數插值。

---
description: Fix a GitHub issue
allowed-tools: Read, Edit, Bash(git:*)
model: opus
argument-hint: [issue-number]
---

Fix GitHub issue #$ARGUMENTS following our coding standards.

用法：/fix-issue 123

4. 鍵盤快速鍵

一般控制

快速前綴

多行輸入

您可以透過 /keybindings 自訂按鍵綁定（儲存於 ~/.claude/keybindings.json）。

5. 設定檔

優先順序（由高至低）

以第一個相符項目為準。企業設定無法規避。

6. Settings.json 參考

以下列出主要設定、型別與範例。可放入上述優先順序中的任何設定檔。

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-sonnet-4-6",
  "permissions": {
    "allow": ["Read", "Glob", "Grep", "Bash(npm run:*)", "Bash(git:*)", "Edit(src/**)"],
    "deny": ["Read(.env*)", "Bash(rm -rf:*)", "Bash(sudo:*)"],
    "ask": ["WebFetch", "Bash(docker:*)"],
    "defaultMode": "acceptEdits",
    "additionalDirectories": ["../shared-lib"]
  },
  "env": {
    "NODE_ENV": "development"
  },
  "hooks": {},
  "sandbox": {
    "enabled": false,
    "autoAllowBashIfSandboxed": true
  },
  "cleanupPeriodDays": 30,
  "respectGitignore": true,
  "showTurnDuration": true,
  "language": "en",
  "autoMemoryDirectory": ".claude/memory",
  "plansDirectory": ".claude/plans"
}

權限規則語法：Tool(pattern:*) 提供前綴比對。Bash(npm run test:*) 允許 npm run test、npm run test:unit 等命令。檔案模式使用 glob 語法：Edit(src/**)。自 v2.1.214 起，單一路徑區段的 dir/** 允許規則只會比對 <cwd>/dir，不再比對目錄樹中任意位置的 dir/；若要比對任意深度，請寫成 Edit(**/src/**)。deny/ask 規則仍會比對任意深度，而 hook 的 if: 條件也採用相同的 cwd 範圍限制。

新增鍵值（v2.1.118+）：

如需完整的設定結構描述，請參閱完整指南中的設定深入解析。

7. CLAUDE.md 快速參考

CLAUDE.md 是專案的指示檔案。Claude 會在每個工作階段開始時讀取此檔案。

存放位置：

AGENTS.md（v2.1.277+）：若專案沒有 CLAUDE.md，Claude Code 會改為讀取 AGENTS.md——可在 /config 的「Project instructions」下變更此行為（Bedrock/Vertex/Foundry 尚不支援）。

建議包含的內容：

# Project Name

## Stack
- Backend: FastAPI, Python 3.11+
- Frontend: HTMX + Alpine.js + Bootstrap 5

## Commands
- Dev: `uvicorn app.main:app --reload --port 8000`
- Test: `python -m pytest -v`
- Lint: `ruff check .`

## Conventions
- Conventional commits: feat:, fix:, docs:, refactor:
- Never force push to main
- Always activate venv before Python commands

## Key Files
- app/main.py — FastAPI app and routes
- app/models.py — SQLAlchemy models

內容應便於快速瀏覽。密集的敘述文字會在每個工作階段浪費內容權杖。請使用項目符號、表格及簡短的程式碼區塊，並避免冗長段落——Claude 會在每個工作階段開始時讀取 CLAUDE.md，因此每個字都會占用內容空間。

專業技巧： - 在 REPL 中使用 # 前綴，即可將內容加入自動記憶，無須編輯 CLAUDE.md：# Always use TypeScript strict mode - 當 Claude 讀取子目錄中的檔案時，也會載入該子目錄內的 CLAUDE.md - 團隊共用規則可放在 .claude/rules/*.md，以模組化方式整理

8. 權限模式

Auto Mode（v2.1.85+）自 2026年8月14日起，已成為 Pro、Max 與 Team 方案新工作階段的預設權限模式（自行設定的 defaultMode 會持續生效，直到您接受一次性的切換提示；disableAutoMode 可在整個組織停用此模式）。這是建議用來取代 --dangerously-skip-permissions 的模式。唯讀操作與檔案編輯會自動核准；自 v2.1.281 起，分類器審查改在伺服器端執行，因此唯讀操作與沙箱化的 shell 命令也必須等待審查，若被標記便會遭到封鎖。系統會先套用自訂的允許／拒絕規則，其餘操作再交由安全分類器處理。預設會自動封鎖的操作包括：curl | bash、強制推送至 main、部署至正式環境、大量刪除雲端資源、變更 IAM，以及將敏感資料傳送至外部。¹

熔斷機制：連續封鎖 3 次，或單一工作階段內累計封鎖 20 次後，會暫停 Auto Mode 並恢復手動提示。

無人值守模式下的危險 rm（v2.1.281）：在 auto 模式及 --dangerously-skip-permissions 下，危險的 rm 提示會等待 2 分鐘，之後拒絕該命令並提供改寫提示，讓工作階段得以繼續。若遞迴 rm 的目標僅由命令替換輸出構成，例如 rm -rf "$(pwd)"，即使設有 Bash 允許規則，現在也會要求確認。

# Enable at startup (--enable-auto-mode was removed in v2.1.111)
claude --permission-mode auto

# Cycle during session
Shift+Tab    # Manual (aka default) -> acceptEdits -> auto -> plan

PowerShell 自動核准（v2.1.119+）：PowerShell 工具命令在權限模式下會比照 Bash 命令自動核准。PowerShell(Get-*:*) 等允許規則可讓唯讀操作略過提示。大量使用 PowerShell 的工作流程建議採用 v2.1.149+；此版本修正了內建 cd 的權限規避問題、前綴／萬用字元允許規則的比對問題，以及目錄變數未即時更新的問題。

9. Hook 事件

| InstructionsLoaded | CLAUDE.md 載入時 | 否 | | ConfigChange | 設定檔在工作階段期間變更時 | 是 | | DirectoryAdded | /add-dir 或 SDK register_repo_root 在工作階段期間新增工作目錄時（v2.1.219+） | 否 | | WorktreeCreate | 建立 worktree 時 | 是 | | WorktreeRemove | 移除 worktree 時 | 否 | | PreCompact | 壓縮上下文前 | 否 | | PostCompact | 壓縮上下文後 | 否 | | Elicitation | MCP 要求結構化輸入時 | 是 | | ElicitationResult | 使用者回應 MCP 對話框時 | 是 | | StopFailure | 回合因 API 錯誤而結束時 | 否 | | PermissionRequest | 顯示權限對話框時 | 是 | | PermissionDenied | 自動模式拒絕操作時（v2.1.88+） | 否 | | CwdChanged | 工作目錄變更時（v2.1.83+） | 否 | | FileChanged | 受監看檔案遭外部修改時（v2.1.83+） | 否 | | TaskCreated | 建立新任務時（v2.1.84+） | 否 | | TeammateIdle | Agent 團隊成員閒置時 | 是 | | TaskCompleted | 任務標記為完成時 | 是 |

完整的 Hook 協定（輸入／輸出 JSON、比對器、結束代碼）請參閱完整指南中的 Hook 深入解析。

10. Hook 設定

Hooks 位於 settings.json 或專用的 hooks.json 中。最小範例如下：

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write \"$FILE_PATH\""
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/validate-bash.sh"
          }
        ]
      }
    ]
  }
}

比對器語法：

結束代碼：

非同步 hooks 會在背景執行，不會造成阻擋：請在 hook 物件中加入 "async": true。²

Hook 輸出／輸入欄位：

• PostToolUse／PostToolUseFailure hook 輸入中的 duration_ms（v2.1.119+）——工具執行時間，不含權限提示與 PreToolUse hooks。
• hookSpecificOutput.updatedToolOutput（v2.1.121+）——取代任何工具的輸出（v2.1.118 僅針對 MCP 推出此功能；v2.1.121 擴充至所有工具）。
• hookSpecificOutput.sessionTitle（v2.1.96+）——透過 UserPromptSubmit hook 設定工作階段標題。
• 命令 hooks 上的 args: string[]（v2.1.139+）——無須 shell 引號即可傳遞結構化 argv。
• PostToolUse hooks 上的 continueOnBlock（v2.1.139+）——將阻擋原因傳回 Claude，並繼續執行該回合。
• Agent hook 輸入中的 subagent_type（v2.1.140+）——識別正在執行的 Agent 類型。
• Hook JSON 輸出中的 terminalSequence（v2.1.141+）——輸出用於通知、視窗標題與提示音的終端機控制序列。

11. MCP 快速設定

只需一個命令即可新增 MCP 伺服器：

# Remote HTTP server (recommended)
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# Remote with auth header
claude mcp add --transport http api https://api.example.com/mcp \
  --header "Authorization: Bearer $TOKEN"

# Local stdio server
claude mcp add --transport stdio postgres \
  --env "DATABASE_URL=postgresql://user:pass@localhost/db" \
  -- npx -y @anthropic-ai/mcp-server-postgres

範圍控制：

claude mcp add --scope project ...   # Team-shared (.mcp.json)
claude mcp add --scope user ...      # Personal (~/.claude.json)

專案 .mcp.json 範例：

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "database": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost/db"
      }
    }
  }
}

MCP 目前每月下載量已達 1 億次，索引的伺服器超過 3,000 個。³如需瞭解傳輸類型、輸入引導與工具搜尋設定，請參閱完整指南中的 MCP 章節。

alwaysLoad（v2.1.121+）：讓受信任的伺服器不受工具搜尋延後載入機制影響。其所有工具會在工作階段開始時載入，無須額外進行 ToolSearch 往返：

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "alwaysLoad": true
    }
  }
}

自動重試（v2.1.121+）：啟動期間發生錯誤的 MCP 伺服器最多會重試 3 次，之後才會標記為已中斷連線。

SDK mcp_authenticate redirectUri（v2.1.121+）：使用自訂 URI 配置完成 OAuth 時的必要欄位——適用於桌面應用程式與 claude.ai 連接器流程。

11.5. Plugin CLI 命令

12. Subagent 類型

Claude 會自動將工作委派給 subagents。您也可以明確提出要求：

> Use the explore agent to find all auth-related files
> Have a subagent analyze the database schema

自訂 subagents 會以含有 YAML frontmatter 的 Markdown 檔案，定義於 .claude/agents/（專案）或 ~/.claude/agents/（個人）中。最多可平行執行 10 個 subagents。⁴

在目前版本中，claude agents 會開啟 Agent View：這是一個研究預覽階段的操作畫面，可檢視執行中、受阻及已完成的 Claude Code 工作階段。claude agents --cwd <path> 可將檢視範圍限定於單一目錄（v2.1.141+）；v2.1.142 新增背景工作階段的派送旗標；v2.1.143 則將這些旗標一致套用至儀表板與背景工作階段：--add-dir、--settings、--mcp-config、--plugin-dir、--permission-mode、--model、--effort 及 --dangerously-skip-permissions。v2.1.144 新增背景工作階段的 /resume 支援，並以 bg 標示；v2.1.145 新增 claude agents --json、等待輸入的分頁計數，以及 Agent View 回覆窗格修正；v2.1.147 新增固定的背景工作階段，使其在閒置時仍維持運作，並能就地重新啟動以套用更新。Agent View 適合用於監控，但不能作為工作已通過品質關卡的證明。⁶

自訂 Agent frontmatter 欄位：

自訂 Agent 範例（.claude/agents/security-reviewer.md）：

---
name: security-reviewer
description: Expert security code reviewer. Use PROACTIVELY after code changes to auth or data handling.
tools: Read, Grep, Glob, Bash
model: opus
permissionMode: plan
---

You are a senior security engineer. Analyze for OWASP Top 10 vulnerabilities,
secrets, hardcoded credentials, and SQL injection. Report findings with severity
levels and remediation steps.

13. 環境變數

驗證與API

模型設定

雲端供應商

行為控制

工具設定

網路與 Proxy

如需完整清單，請參閱完整指南中的環境變數。

14. 費用參考

每100萬個 token 的定價（截至2026年9月）。⁵

一般工作階段會耗用50K–200K個輸入 token 與10K–50K個輸出 token。Haiku 工作階段：$0.10–$0.45。Opus 5.5 工作階段：$0.40–$1.80。

Claude Code 的預設模型（依方案區分）：自 v2.1.280（2026年9月22日）起，所有方案皆預設使用 Opus——Pro 與 Team Standard 已從 Sonnet 改為 Opus，與 Max、Team Premium 及 Enterprise 一致——且預設 Opus 模型為 Opus 5.5（claude-opus-5-5），opus 別名目前也會指向此模型。v2.1.251 的分流方式（高階方案使用 Opus 5，Pro／Team Standard 使用 Sonnet 5）以及 v2.1.197 全面預設使用 Sonnet 5 的安排，皆已成為歷史。管理員可設定全組織的預設值，該值會在 /model 中顯示為「Org default」（v2.1.196+）。AWS、Amazon Bedrock 與 Google Cloud Agent Platform 上的 Claude Platform 也預設使用 Opus 5.5；Microsoft Foundry 是唯一例外（預設使用 Sonnet 4.5，且只有此處的 opus 會解析為 Opus 4.6）——可透過 ANTHROPIC_DEFAULT_OPUS_MODEL／ANTHROPIC_DEFAULT_SONNET_MODEL 固定使用特定模型。

Opus 5.5、Sonnet 5、Opus 5、Opus 4.8、Fable 5 與 Fable 5.1 僅採用自適應推理（不提供固定 thinking 預算），面對最困難的程式開發／代理型工作時可使用 /effort xhigh。除了 Opus 5.5 預設為 medium 之外，其他模型的 effort 均預設為 high——此外，自 v2.1.280 起，在 /effort 改為依模型分別設定之前儲存的 effort 層級，不再沿用至 Opus 5.5 等新發布模型。因此，新模型會先採用本身的預設值，直到您另行選擇。Opus 5.5 與 Fable 系列模型無法關閉 thinking（MAX_THINKING_TOKENS=0 對其無效）。Opus 5 相較於 Opus 4.8 的破壞性變更：若請求省略 thinking 欄位，預設會啟用 thinking；若將 thinking: {type: "disabled"} 與 xhigh 或 max effort 搭配使用，則會傳回 400。

Fast mode（/fast）適用於 Opus 5.5、Opus 5 與 Opus 4.8，而自 v2.1.280 起預設使用 Opus 5.5——Opus 5.5 每 MTok 為 $8／$40，Opus 5 與 4.8 則為 $10／$50（各為基本價格的2倍），每秒輸出 token 數最高可達2.5倍。Opus 4.7 已移除：claude-opus-4-7 + speed: "fast" 現在會回報錯誤，不再退回標準速度。此功能為研究預覽版，僅適用於 Claude API 與訂閱方案（不支援 Bedrock／Vertex／Foundry 或 AWS 上的 Claude Platform）；切換速度會使提示詞快取失效。自 v2.1.271 起，fast mode 也可用於 Claude Code Remote 工作階段（雲端與自行託管的執行器）：在組織允許的情況下，系統會套用主機的 fast mode 設定，或您在工作階段中輸入的 /fast。

在工作階段期間切換模型：

/model opus       # Switch to Opus 5.5 (v2.1.280+)
/model sonnet     # Switch to Sonnet 5
/model haiku      # Switch to Haiku 4.5
/model fable      # Switch to Fable 5.1 (tier above Opus, v2.1.257+)
/effort xhigh     # Recommended for the hardest coding/agentic work

判斷原則：簡單探索交給 Haiku。注重成本的日常程式開發交給 Sonnet。高難度推理、架構設計、代理型迴圈與安全性分析交給 Opus。複雜重構請使用 opusplan（由 Opus 規劃、Sonnet 執行）。

15. 重要檔案位置

16. 變更記錄

17. 參考資料

這份速查表是完整 Claude Code CLI 指南的快速查閱搭配資源。如需設定操作說明，請參閱 Claude Code 快速入門。若專門針對 iOS 與 macOS 專案，請參閱 iOS Agent 開發指南、XcodeBuildMCP 整合模式，以及 Apple 生態系系列。最後更新於2026年7月17日。