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. Slash Commands

自訂命令：建立.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

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

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

8. 權限模式

Auto Mode（v2.1.85+）是--dangerously-skip-permissions的建議替代方案。唯讀操作與檔案編輯會自動核准。系統會先套用自訂的 allow／deny 規則，其餘操作則交由安全分類器判定。預設自動封鎖的操作包括：curl | bash、強制推送至 main、正式環境部署、大規模刪除雲端資源、變更 IAM，以及將敏感資料傳送至外部。¹

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

# 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 | 壓縮 context 前 | 不可以 | | PostCompact | 壓縮 context 後 | 不可以 | | 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、matchers、結束代碼），請參閱完整指南中的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"
          }
        ]
      }
    ]
  }
}

Matcher 語法：

結束代碼：

非同步 hooks 會在背景執行，不會造成封鎖：在 hook 物件中加入"async": true即可。²

Hook 輸出／輸入欄位：

• PostToolUse／PostToolUseFailurehook 輸入中的duration_ms（v2.1.119+）——工具執行時間，不含權限提示與 PreToolUse hooks。
• hookSpecificOutput.updatedToolOutput（v2.1.121+）——取代任意工具的輸出（v2.1.118 僅為 MCP導入此功能；v2.1.121 擴充至所有工具）。
• hookSpecificOutput.sessionTitle（v2.1.96+）——透過UserPromptSubmithook 設定工作階段標題。
• 指令 hooks 的args: string[]（v2.1.139+）——無須 shell 引號即可傳遞結構化 argv。
• PostToolUsehooks 的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 連接器流程。

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 萬個權杖的價格（截至 2026年7月）。⁵

一般工作階段會消耗 50K–200K 個輸入權杖，以及 10K–50K 個輸出權杖。Haiku 工作階段：$0.10–$0.45。Opus 工作階段：$0.50–$2.25。

Claude Code的預設模型（自 v2.1.197，2026年6月30日起）：所有新工作階段均使用 Sonnet 5—原生 1M 上下文，至 8月31日止的首發優惠價為 $2／$10—只要執行一次 /model opus 即可切換至 Opus（自 v2.1.219 起，該別名會指向 Opus 5）。管理員可設定整個組織的預設模型，並在 /model 中顯示為「組織預設值」（v2.1.196+）；在 Bedrock／Vertex／Foundry 上，則可透過 ANTHROPIC_DEFAULT_OPUS_MODEL／ANTHROPIC_DEFAULT_SONNET_MODEL 固定使用特定模型。

Sonnet 5、Opus 5、Opus 4.8 與 Fable 5 僅採用自適應推理（沒有固定的思考預算）。所有模型的 effort 均預設為 high；面對最艱鉅的程式設計或代理式工作時，可使用 /effort xhigh。Opus 5 相較於 Opus 4.8 的重大變更：未提供 thinking 欄位的請求會預設啟用思考；若使用 thinking: {type: "disabled"} 並將 effort 設為 xhigh 或 max，則會傳回 400。

截至 v2.1.219，Fast mode（/fast）僅適用於 Opus 5 與 Opus 4.8—每 MTok 的費用為 $10／$50（基本價格的 2 倍），輸出權杖速度最高可達 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 (the default)
/model haiku      # Switch to Haiku 4.5
/model fable      # Switch to Fable 5 (tier above Opus)
/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日。