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
  },
  "includeCoAuthoredBy": 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/** allow 規則僅比對 <cwd>/dir，不再比對目錄樹中任意位置的 dir/；若要比對任意深度，請寫成 Edit(**/src/**)。deny/ask 規則仍會比對任意深度，而 hook 的 if: 條件也採用相同的 cwd 範圍界定方式。

新增鍵值（v2.1.118+）：

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

7. CLAUDE.md 快速參考

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

存放位置：

建議包含的內容：

# 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 的建議替代方案。唯讀操作與檔案編輯會自動核准。自訂 allow/deny 規則會優先判定，其餘操作則交由安全分類器處理。預設自動封鎖的操作包括：curl | bash、強制推送至 main、正式環境部署、大量刪除雲端資源、IAM 變更，以及將敏感資料傳送至外部。¹

斷路器：連續封鎖 3 次，或單一工作階段內累計封鎖 20 次後，將暫停並回復為手動提示。

# 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-*:*) 等 allow 規則可讓唯讀操作略過提示。若工作流程大量使用 PowerShell，請採用 v2.1.149+；此版本修正了內建 cd 的權限繞過問題、前綴／萬用字元 allow 規則的比對問題，以及過時的目錄變數追蹤問題。

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 | Auto mode 拒絕操作時（v2.1.88+） | 不可以 | | CwdChanged | 工作目錄變更時（v2.1.83+） | 不可以 | | FileChanged | 受監看檔案遭外部修改時（v2.1.83+） | 不可以 | | TaskCreated | 建立新任務時（v2.1.84+） | 不可以 | | TeammateIdle | Agent 團隊成員進入閒置狀態時 | 可以 | | TaskCompleted | 任務標記為完成時 | 可以 |

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

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+）——傳遞結構化 argv，無須使用 shell 引號。
• 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+）：讓受信任的伺服器不受 Tool Search 延後載入機制影響。其所有工具都會在工作階段開始時載入，無須經過 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 connector 流程。

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 工作階段：$0.50–$2.25。

Claude Code的預設模型（依方案區分）：高階方案——Max、Team Premium、Enterprise（隨用隨付，並自CLI v2.1.251 起包含訂閱席次）——以及AnthropicAPI、Bedrock／Google Cloud 的 Agent Platform／AWS 上的Claude Platform，預設使用 Opus 5；Pro 與 Team Standard 則預設使用 Sonnet 5（Microsoft Foundry：Sonnet 4.5）。v2.1.197 將 Sonnet 5 設為全域預設模型（2026年6月30日）已成歷史；opus 別名現在指向 Opus 5（v2.1.219+）。管理員可以設定整個組織的預設模型，並在 /model 中顯示為「組織預設值」（v2.1.196+）；在 Bedrock／Vertex／Foundry 上，可透過 ANTHROPIC_DEFAULT_OPUS_MODEL／ANTHROPIC_DEFAULT_SONNET_MODEL 鎖定特定模型。

Sonnet 5、Opus 5、Opus 4.8、Fable 5 與 Fable 5.1 僅使用自適應推理（沒有固定的思考預算）。這些模型的 effort 均預設為 high；面對最困難的程式開發／代理式工作，可使用 /effort xhigh。Opus 5 相較於 Opus 4.8 的重大變更：若請求省略 thinking 欄位，預設會開啟思考；若在 effort 為 xhigh 或 max 時使用 thinking: {type: "disabled"}，則會傳回 400 錯誤。

截至 v2.1.219，Fast mode（/fast）僅適用於 Opus 5 與 Opus 4.8——每 MTok $10／$50（基本價格的 2 倍），輸出 token 的每秒處理量最高可達 2.5 倍。Opus 4.7 已移除：claude-opus-4-7 搭配 speed: "fast" 現在會回報錯誤，不再退回標準速度。此功能處於研究預覽階段，僅限ClaudeAPI（不支援 Bedrock／Vertex／Foundry）；切換速度會使提示快取失效。

在工作階段中切換模型：

/model opus       # Switch to Opus 5 (v2.1.219+)
/model sonnet     # Switch to Sonnet 5 (default on Pro/Team Standard)
/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日。