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 Flags

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 可透過 /keybindings 自訂（儲存在 ~/.claude/keybindings.json）。

5. 設定檔案

優先順序階層（由高到低）

第一個符合項目生效。Enterprise 設定無法繞過。

6. Settings.json 參考

主要設定、型別與範例。請放在上述階層中的任一 settings 檔案。

{
  "$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.118+）：

如需完整 settings schema，請參閱完整指南中的Configuration Deep Dive。

7. CLAUDE.md 快速參考

CLAUDE.md 是專案的指令檔案。Claude 會在每個 session 開始時讀取它。

存放位置：

應包含的內容：

# 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

保持易於掃描。密集的長篇文字會在每個 session 浪費 context tokens。請使用項目符號、表格與短程式碼區塊。避免長段落，因為 Claude 會在每個 session 開始時讀取 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 規則會優先解析，其餘動作則交由安全 classifier 判斷。預設會自動封鎖：curl | bash、force-push 到 main、生產環境部署、大量雲端刪除、IAM 變更、將敏感資料傳送到外部。¹

Circuit breaker：同一 session 中連續封鎖 3 次或總計封鎖 20 次，會暫停並回到手動提示。

# Enable at startup
claude --enable-auto-mode

# Cycle during session
Shift+Tab    # 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 | Config 檔案在 session 中途變更 | 是 | | WorktreeCreate | 正在建立 worktree | 是 | | WorktreeRemove | 正在移除 worktree | 否 | | PreCompact | Context compaction 前 | 否 | | PostCompact | Context compaction 後 | 否 | | Elicitation | MCP 要求結構化輸入 | 是 | | ElicitationResult | 使用者回應 MCP 對話框 | 是 | | StopFailure | Turn 因 API 錯誤而結束 | 否 | | PermissionRequest | 顯示權限對話框 | 是 | | PermissionDenied | Auto mode 拒絕某項動作（v2.1.88+） | 否 | | CwdChanged | 工作目錄變更（v2.1.83+） | 否 | | FileChanged | 受監看檔案由外部修改（v2.1.83+） | 否 | | TaskCreated | 建立新 task（v2.1.84+） | 否 | | TeammateIdle | Agent 團隊成員閒置 | 是 | | TaskCompleted | Task 標記為完成 | 是 |

如需完整 hook protocol（輸入/輸出 JSON、matchers、exit codes），請參閱完整指南中的Hooks Deep Dive。

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 語法：

Exit codes：

Async hooks 會在背景執行而不封鎖：請在 hook 物件中加入"async": true。²

Hook 輸出/輸入欄位：

• duration_ms位於PostToolUse/PostToolUseFailure hook input（v2.1.119+）— 工具執行時間，不包含權限提示與 PreToolUse hooks。
• hookSpecificOutput.updatedToolOutput（v2.1.121+）— 取代任何工具的輸出（v2.1.118 最初僅為 MCP 引入；v2.1.121 擴展到所有工具）。
• hookSpecificOutput.sessionTitle（v2.1.96+）— 從UserPromptSubmit hook 設定 session 標題。
• args: string[]位於 command hooks（v2.1.139+）— 不需 shell quoting，即可傳遞結構化 argv。
• continueOnBlock位於PostToolUse hooks（v2.1.139+）— 將封鎖原因回傳給 Claude，並繼續該 turn。
• subagent_type位於 agent hook input（v2.1.140+）— 識別正在執行的 agent 類型。
• terminalSequence位於 hook JSON output（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多個伺服器。³如需傳輸類型、elicitation與工具搜尋設定，請參閱完整指南中的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 scheme 上完成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 為背景工作階段加入 dispatch flags；v2.1.143 則將這些 flags 一致套用到儀表板與背景工作階段：--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年4月）。⁵

典型 session 會消耗 50K-200K input tokens 與 10K-50K output tokens。Haiku session：約 $0.10-$0.45。Opus session：約 $0.50-$2.25。

各方案預設模型（Claude Code 截至 2026年4月16日）：

• Max、Team Premium → Opus 4.7
• Pro、Team Standard、Enterprise、Anthropic API → Sonnet 4.6（Enterprise + API 會在 2026年4月23日切換至 Opus 4.7）
• Bedrock、Vertex、Foundry → Sonnet 4.5（可透過 ANTHROPIC_DEFAULT_OPUS_MODEL 固定使用較新模型）

Opus 4.7 需要 Claude Code v2.1.111 或更新版本。它只使用自適應推理（沒有固定 thinking budgets）。新的 xhigh effort level 是 Opus 4.7 在程式開發／agentic 工作負載上的預設值。

在 session 期間切換模型：

/model opus       # Switch to Opus (resolves to 4.7 on API, 4.6 on Bedrock/Vertex/Foundry)
/model sonnet     # Switch to Sonnet 4.6
/model haiku      # Switch to Haiku 4.5
/effort xhigh     # Opus 4.7 only — recommended for coding/agentic

決策規則：簡單探索交給 Haiku。重視成本的日常程式開發交給 Sonnet。困難推理、架構、agentic loops 與安全分析交給 Opus。複雜重構使用 opusplan（Opus 規劃，Sonnet 執行）。

15. 重要檔案位置

16. 變更記錄

17. 參考資料

這份 cheat sheet 是完整 Claude Code CLI指南的快速查閱搭配資料。如需設定逐步說明，請參閱Claude Code quickstart。若是 iOS 與 macOS 專案，請參閱iOS Agent Development指南、XcodeBuildMCP整合模式，以及Apple Ecosystem Series。最後更新日期：2026年5月24日。