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 auth login       # Log in or switch accounts
claude auth status      # Check current auth state
claude auth logout      # Clear stored credentials

2. CLI旗標

3. Slash Commands

自訂指令：建立.claude/commands/my-command.md（專案）或~/.claude/commands/my-command.md（個人），並用/my-command呼叫。指令支援YAML frontmatter，可設定description、allowed tools、model override，並透過$ARGUMENTS或位置參數$1、$2插入arguments。

---
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的型別與範例。可放在上述階層中的任何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"
}

Permission規則語法：Tool(pattern:*)提供前綴比對。Bash(npm run test:*)允許npm run test、npm run test:unit等。檔案pattern使用glob語法：Edit(src/**)。

新增keys（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 中使用 # 前綴，可將內容加入自動記憶，而不必編輯 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、force-push 到 main、生產環境部署、大量刪除雲端資源、IAM 變更，以及將敏感資料傳送到外部。¹

斷路機制：單一 session 內連續封鎖 3 次或總計封鎖 20 次，就會暫停並回到手動提示。

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

# Cycle during session
Shift+Tab    # default -> acceptEdits -> auto -> plan

PowerShell自動核准（v2.1.119+）： PowerShell tool 指令會和 Bash 指令一樣，依照權限模式自動核准。像 PowerShell(Get-*:*) 這類 allow 規則，可讓唯讀操作略過提示。

9. hooks 事件

| InstructionsLoaded | CLAUDE.md 載入時 | 否 | | ConfigChange | Config 檔案在 session 中途變更時 | 是 | | WorktreeCreate | 正在建立 worktree 時 | 是 | | WorktreeRemove | 正在移除 worktree 時 | 否 | | PreCompact | context compact 前 | 否 | | PostCompact | context compact 後 | 否 | | Elicitation | MCP要求結構化輸入時 | 是 | | ElicitationResult | 使用者回應 MCP對話框時 | 是 | | StopFailure | 回合因 API錯誤而結束時 | 否 | | PermissionRequest | 顯示權限對話框時 | 是 | | PermissionDenied | Auto mode 拒絕某個動作時（v2.1.88+） | 否 | | CwdChanged | 工作目錄變更時（v2.1.83+） | 否 | | FileChanged | 受監看檔案遭外部修改時（v2.1.83+） | 否 | | TaskCreated | 建立新 task 時（v2.1.84+） | 否 | | TeammateIdle | Agent team member 閒置時 | 是 | | TaskCompleted | task 標記為完成時 | 是 |

完整 hook protocol（input/output JSON、matchers、exit codes）請參閱完整指南中的 Hooks Deep Dive。

10. hooks 設定

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 output / input 欄位：

• duration_ms 位於 PostToolUse / PostToolUseFailure hook input（v2.1.119+）：tool 執行時間，不包含權限提示與 PreToolUse hooks。
• hookSpecificOutput.updatedToolOutput（v2.1.121+）：替換任意 tool 的輸出（v2.1.118 起僅支援 MCP；v2.1.121 擴展至所有 tools）。
• hookSpecificOutput.sessionTitle（v2.1.96+）：透過 UserPromptSubmit hook 設定 session title。
• args: string[] 位於 command hooks（v2.1.139+）：不需 shell quoting，即可傳遞結構化 argv。
• continueOnBlock 位於 PostToolUse hooks（v2.1.139+）：將封鎖原因回傳給 Claude，並繼續該回合。
• subagent_type 位於 agent hook input（v2.1.140+）：識別正在執行的 agent 類型。

11. MCP快速設定

用一個指令加入 MCP server：

# 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

Scope控制：

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 多個已索引的 servers。³ 關於 transport 類型、elicitation 與 tool search 設定，請參閱完整指南中的 MCP section。

alwaysLoad（v2.1.121+）： 讓可信任 server 不受 Tool Search 延遲載入影響。所有 tools 會在 session 開始時載入，不需要 ToolSearch 往返：

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

Auto-retry（v2.1.121+）： MCP servers 若在啟動時發生錯誤，會最多重試 3 次，之後才標記為 disconnected。

SDK mcp_authenticate redirectUri（v2.1.121+）： 若要在自訂 URI schemes 上完成 OAuth，此欄位為必要項目，例如 desktop apps 與 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

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

claude agents會在目前版本中開啟Agent View：這是一個research-preview作業畫面，用於檢視執行中、受阻與已完成的Claude Code sessions。它適合用來監控，不應作為工作已通過品質門檻的證明。⁶

Custom agent frontmatter欄位：

Custom 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. Environment Variables

Authentication與API

Model Configuration

Cloud Providers

Behavior Control

Tool Configuration

Network與Proxy

完整清單請參閱完整指南中的Environment Variables。

14. Cost Reference

每100萬tokens的價格（截至2026年4月）。⁵

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

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

• 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或更新版本。它僅使用adaptive reasoning（沒有固定thinking budgets）。新的xhigh effort level是Opus 4.7在coding/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。重視成本的日常coding交給Sonnet。高難度推理、架構、agentic loops與security analysis交給Opus。複雜重構使用opusplan（Opus規劃，Sonnet執行）。

15. Key File Locations

16. 變更記錄

17. 參考資料

本 cheat sheet 是 完整 Claude Code CLI guide 的快速查閱搭配資料。若需 setup walkthroughs，請參閱 Claude Code quickstart。若是 iOS 與 macOS 專案，請參閱 iOS Agent Development guide、XcodeBuildMCP integration patterns，以及 Apple Ecosystem Series。最後更新日期：2026年5月13日。