claude@cli:~/docs$ cat claude-code.md

Claude Code CLI：完整指南

# Claude Code CLI：權威技術參考

words: 10226 read_time: 96m updated: 2026-03-21 05:17

Claude Code CLI：權威技術參考

Last updated: 2026-03-21 · 96 分鐘閱讀 · 10K+ words

$ less claude-code.md

重點摘要： Claude Code是一個代理式CLI，能夠讀取您的程式碼庫、執行命令，並透過分層的權限系統、hooks、MCP整合及subagents來修改檔案。掌握五大核心系統（設定、權限、hooks、MCP及subagents），您就能解鎖倍增的生產力。根據每項任務選擇適合的模型層級——Opus用於複雜推理、Sonnet用於一般工作、Haiku用於快速探索——或者如果品質是您唯一的考量，則統一使用Opus。對於必須始終執行的操作，請使用hooks（而非提示詞）。

Claude Code以代理式系統運作，而非僅是具備程式設計知識的聊天介面。此CLI能讀取您的程式碼庫、執行命令、修改檔案、管理git工作流程、透過MCP連接外部服務，並將複雜任務委派給專門的subagents。一切皆透過命令列介面運作，完美融入開發者實際的工作流程。截至2026年2月，4%的公開GitHub提交（每日約135,000次）由Claude Code完成——自研究預覽版發布以來，13個月內成長了42,896倍——而Anthropic自身90%的程式碼由AI撰寫。110

隨意使用與高效使用Claude Code之間的差異，取決於五大核心系統。掌握這些系統，Claude Code將成為您的力量倍增器：

  1. 設定層級架構：控制行為
  2. 權限系統：管控操作
  3. Hook系統：實現確定性自動化
  4. MCP協定：擴展功能
  5. Subagent系統：處理複雜的多步驟任務

關鍵要點

  • 五大系統決定您的效能：設定層級架構、權限、hooks、MCP及subagents控制從行為到自動化的一切。
  • 將工作推送至委派層：subagents透過在乾淨的上下文視窗中隔離探索任務來防止上下文膨脹，僅回傳摘要。
  • Hooks保證執行；提示詞則不然：對於每次都必須執行的程式碼檢查、格式化及安全檢查，請使用hooks，不受模型行為影響。
  • 模型分層在不犧牲品質的前提下節省成本：將subagent探索任務導向較低成本的模型，將Opus保留給真正的架構推理——或者如果品質是您唯一的考量，則統一使用Opus。
  • MCP將Claude連接至您的工具鏈：資料庫、GitHub、Sentry及3,000+整合服務，將Claude的能力擴展至檔案讀取和bash命令之外。

我花了數個月的時間，在正式環境的程式碼庫、CI/CD流水線及企業級部署中將Claude Code推向極限。本指南將這些經驗濃縮為我在開始使用時最希望擁有的完整參考文件。每個功能都包含實際語法、真實設定範例，以及容易讓有經驗的使用者踩坑的邊界情況。

如何使用本指南

本指南超過5,000行——您不需要從頭讀到尾。請根據您的經驗程度選擇起始位置：

經驗程度 從這裡開始 接著探索
Claude Code新手 如何安裝？ → 快速入門 → 心智模型 設定、權限
日常使用者 Hooks、Subagents、Skills MCP、Plan Mode
團隊主管／企業用戶 企業部署 → 最佳實踐 決策框架、工作流程範例
從其他工具遷移 對象導向指引 決策框架

使用瀏覽器的Ctrl+F / Cmd+F搜尋特定的flags、命令或設定鍵。末尾的快速參考卡提供所有主要命令的速覽摘要。

Claude Code 的運作原理：心智模型

在深入探討功能之前，先了解 Claude Code 的架構如何影響您的所有操作。系統分為三個層級：

┌─────────────────────────────────────────────────────────┐
│                    CLAUDE CODE LAYERS                    │
├─────────────────────────────────────────────────────────┤
│  EXTENSION LAYER                                         │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐    │
│  │   MCP   │  │  Hooks  │  │ Skills  │  │ Plugins │    │
│  └─────────┘  └─────────┘  └─────────┘  └─────────┘    │
│  External tools, deterministic automation, domain       │
│  expertise, packaged extensions                          │
├─────────────────────────────────────────────────────────┤
│  DELEGATION LAYER                                        │
│  ┌─────────────────────────────────────────────────┐    │
│  │              Subagents (up to 10 parallel)       │    │
│  │   Explore | Plan | General-purpose | Custom      │    │
│  └─────────────────────────────────────────────────┘    │
│  Isolated contexts for focused work, returns summaries  │
├─────────────────────────────────────────────────────────┤
│  CORE LAYER                                              │
│  ┌─────────────────────────────────────────────────┐    │
│  │         Main Conversation Context                │    │
│  │   Tools: Read, Edit, Bash, Glob, Grep, etc.     │    │
│  └─────────────────────────────────────────────────┘    │
│  Your primary interaction; limited context; costs money │
└─────────────────────────────────────────────────────────┘

核心層：您的主要對話。每則訊息、檔案讀取和工具輸出都會消耗共享視窗的上下文（標準 200K tokens98，使用 Opus 4.6 或延伸上下文模型可達 1M tokens）。當上下文填滿時，Claude 會失去對早期決策的追蹤，品質隨之下降。此層級按 token 計費。

委派層：Subagents 以乾淨的上下文啟動，專注執行工作，並回傳摘要。探索結果不會膨脹您的主要對話；只有結論會回傳。您可以將 subagents 路由至較便宜的模型層級進行探索，或全程使用主要模型以確保品質優先於成本。

擴充層：MCP 連接外部服務（資料庫、GitHub、Sentry）。Hooks 保證 shell 指令的執行不受模型行為影響。Skills 編碼領域專業知識，讓 Claude 自動套用。Plugins 將以上所有功能打包以便發佈。

關鍵洞察：大多數使用者完全在核心層工作，眼看上下文膨脹和成本攀升。進階使用者會將探索和專業工作推送至委派層，保持擴充層針對工作流程做好設定，僅將核心層用於協調和最終決策。

目錄

  1. 如何安裝 Claude Code？
  2. 快速入門：您的第一個工作階段
  3. 核心互動模式
  4. 設定系統深入探討
  5. 我該選擇哪個模型？
  6. Claude Code 的費用是多少？
  7. 決策框架
  8. 權限系統如何運作？
  9. Hooks 如何運作？
  10. 什麼是 MCP（Model Context Protocol）？
  11. 什麼是 Subagents？
  12. 什麼是延伸思考模式？
  13. 輸出風格
  14. 斜線指令
  15. Skills 如何運作？
  16. Plugin 系統
  17. 記憶功能如何運作？
  18. 圖片與多模態輸入
  19. 語音模式
  20. Git 整合如何運作？
  21. 如何在 IDE 中使用 Claude Code？
  22. 進階使用模式
  23. 遠端與背景代理 [研究預覽]
  24. Claude in Chrome
  25. Claude Code in Slack [研究預覽]
  26. Claude Code on the Web [研究預覽]
  27. 效能最佳化
  28. 如何除錯問題？
  29. 企業部署
  30. 鍵盤快捷鍵參考
  31. 最佳實踐
  32. 工作流程範例
  33. 遷移指南
  34. 特定受眾指引
  35. 快速參考卡
  36. 更新日誌
  37. 參考資料

如何安裝 Claude Code？

系統需求

Claude Code 可在 macOS 10.15+、Ubuntu 20.04+/Debian 10+ 以及 Windows 10+（透過 WSL 或 Git Bash）上執行。系統最低需要 4 GB RAM 及有效的網際網路連線。99 Shell 相容性在 Bash、Zsh 或 Fish 上表現最佳。

Windows 環境下，WSL 1 和 WSL 2 皆可使用。如果您偏好原生 Windows 環境，Git Bash 同樣適用。Alpine Linux 及其他基於 musl 的系統需要安裝額外的套件：

apk add libgcc libstdc++ ripgrep
export USE_BUILTIN_RIPGREP=0

安裝方式

原生安裝（建議方式）

原生二進位檔提供最簡潔的體驗，無需 Node.js 依賴：

# macOS and Linux
curl -fsSL https://claude.ai/install.sh | bash

# Homebrew alternative
brew install --cask claude-code

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

安裝特定版本：

# Install specific version
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

# Install latest explicitly
curl -fsSL https://claude.ai/install.sh | bash -s latest

# Windows PowerShell - specific version
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58

NPM 安裝（已棄用）

注意： 自 v2.1.15 起，npm 安裝會顯示棄用通知。目前建議使用原生二進位檔進行安裝。請使用 claude install 進行遷移。

若舊有環境仍需使用 npm：

npm install -g @anthropic-ai/claude-code

切勿在 npm 安裝時使用 sudo。這會造成權限問題，使後續所有操作更加複雜。

從既有安裝遷移

若您使用的是舊版 npm 安裝，請遷移至原生二進位檔：

claude install

驗證選項

Claude Code 支援三種驗證路徑，各有不同的取捨：

Claude Console（API 計費）

透過 platform.claude.com（前身為 console.anthropic.com）連接至 Anthropic 的 API。建立帳號、設定帳單，並透過 CLI 進行驗證。Console 提供按用量計費的方式，可完整存取 API。系統會自動建立專屬的「Claude Code」工作區；您無法為此工作區建立 API 金鑰，但可以監控用量。

Claude Pro 或 Max 訂閱

使用您的 claude.ai 帳號憑證。訂閱方案涵蓋網頁介面及 CLI 用量，統一以月費計費。此訂閱方案簡化了希望擁有可預測費用的個人使用者的帳單管理。

企業平台

AWS Bedrock、Google Vertex AI 及 Microsoft Foundry 各自提供企業級存取，可搭配現有的雲端帳單關係使用：

# AWS Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1
export AWS_PROFILE=your-profile

# Google Vertex AI
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5
export ANTHROPIC_VERTEX_PROJECT_ID=your-project

# Microsoft Foundry
export CLAUDE_CODE_USE_FOUNDRY=1
export ANTHROPIC_FOUNDRY_RESOURCE=your-resource-name
# Optional: API key auth (otherwise uses Entra ID)
export ANTHROPIC_FOUNDRY_API_KEY=your-key

企業部署若需透過代理伺服器或 LLM 閘道器：

# Corporate proxy
export HTTPS_PROXY='https://proxy.example.com:8080'

# LLM gateway (skip native auth)
export CLAUDE_CODE_USE_BEDROCK=1
export ANTHROPIC_BEDROCK_BASE_URL='https://your-gateway.com/bedrock'
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1

驗證安裝

claude doctor

此指令會回報安裝類型、版本、系統設定及任何偵測到的問題。

驗證管理（v2.1.41+）

無需進入 REPL 即可管理驗證：97

claude auth login          # Log in or switch accounts
claude auth status         # Check current auth state (account, plan, expiry)
claude auth logout         # Clear stored credentials

切換帳號或組織的常見工作流程：

claude auth logout && claude auth login

另請參閱：如何除錯問題？以排除驗證失敗的問題。

更新

Claude Code 預設會自動更新，在啟動時及工作階段中定期檢查。更新會在背景下載，並在下次啟動時套用。

停用自動更新：

export DISABLE_AUTOUPDATER=1

或在 settings.json 中設定：

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

手動更新：

claude update

解除安裝

原生安裝（macOS/Linux/WSL）：

rm -f ~/.local/bin/claude
rm -rf ~/.claude-code

原生安裝（Windows PowerShell）：

Remove-Item -Path "$env:LOCALAPPDATA\Programs\claude-code" -Recurse -Force
Remove-Item -Path "$env:LOCALAPPDATA\Microsoft\WindowsApps\claude.exe" -Force

清除設定（移除所有設定）：

rm -rf ~/.claude
rm ~/.claude.json
rm -rf .claude
rm -f .mcp.json

快速入門：您的第一個工作階段

1. 安裝並啟動：

claude                           # Launch in current directory

2. 前往專案目錄：

cd ~/my-project && claude        # Or launch from any git repo

3. 請 Claude 執行任務：

> "Explain the architecture of this project"
> "Find all TODO comments and create a summary"
> "Add input validation to the signup form"

4. 在工作階段中使用快捷鍵：

/cost                            # Check token usage and cost
/compact                         # Free up context when it gets large
Alt+T                            # Toggle extended thinking for hard problems
Ctrl+C                           # Cancel current response

5. 稍後繼續：

claude -c                        # Resume your most recent session
claude --resume                  # Pick from session list

進階技巧： 在您的專案根目錄建立 CLAUDE.md 檔案，記錄建構指令、編碼慣例及架構說明。Claude 每次工作階段都會讀取此檔案——這是提升品質最具影響力的做法。

核心互動模式

互動式 REPL

不帶任何參數啟動 Claude Code 即可進入互動式讀取-求值-輸出迴圈：

cd your-project
claude

REPL 會在各輪對話中維持上下文。直接輸入查詢、接收回應，並持續互動直到您使用 /exit 或 Ctrl+D 退出。

以初始提示開始以聚焦工作階段：

claude "explain the authentication flow in this project"

專家提示： REPL 會在壓縮事件中保留狀態。當上下文過大時，Claude 會自動摘要較早的對話內容，同時保留關鍵決策和程式碼片段。您可以使用 /compact 手動觸發此功能，或自訂要保留的內容說明。

非互動模式

列印模式（-p）執行單一查詢後退出：

# Direct query
claude -p "list all TODO comments in this project"

# Process piped input
cat error.log | claude -p "identify the root cause of these failures"

# Chain with other tools
claude -p "generate a README" > README.md

如需適合在指令碼中解析的結構化輸出：

claude -p "count lines by file type" --output-format json

JSON 輸出包含自動化所需的所有資訊：

{
  "type": "result",
  "subtype": "success",
  "total_cost_usd": 0.0034,
  "is_error": false,
  "duration_ms": 2847,
  "duration_api_ms": 1923,
  "num_turns": 4,
  "result": "Response text here...",
  "session_id": "abc-123-def"
}

如需即時處理串流輸出：

claude -p "build the application" --output-format stream-json | while read line; do
  echo "$line" | jq -r 'select(.result) | .result'
done

輸出格式選項：

格式 旗標 使用情境
文字（預設） --output-format text 人類可讀輸出、導出至檔案
JSON --output-format json 指令碼解析、CI/CD 整合
串流 JSON --output-format stream-json 即時處理、進度監控

結束代碼：

代碼 意義
0 成功
1 錯誤（執行期失敗、API 錯誤，或 Claude 回報錯誤）

在 -p 模式中控制代理行為：

# Limit autonomous turns (prevents runaway loops)
claude -p "refactor the auth module" --max-turns 10

# Allow specific tools without prompting
claude -p "fix lint errors" --allowedTools "Edit,Bash(npm run lint)"

# Use with a specific model
claude -p "explain this code" --model claude-sonnet-4-5-20250929

CI/CD 整合模式：

# In a GitHub Action or CI pipeline
result=$(claude -p "review this diff for security issues" --output-format json 2>/dev/null)
is_error=$(echo "$result" | jq -r '.is_error')
if [ "$is_error" = "true" ]; then
  echo "Review failed"
  exit 1
fi
echo "$result" | jq -r '.result'

工作階段管理

工作階段會保留對話歷史以供後續繼續。工作階段的持久化對複雜的多階段工作至關重要：

# Continue most recent session
claude -c

# Continue with additional prompt
claude -c -p "now add error handling"

# Resume specific session by ID
claude -r "abc123" "implement the remaining tests"

# Fork a session for parallel exploration
claude -r "base-session" --fork-session "try a different approach"

PR 連結工作階段（v2.1.27+）： 啟動與特定 Pull Request 連結的工作階段：81

claude --from-pr 123                                    # By PR number
claude --from-pr https://github.com/org/repo/pull/123   # By URL

當您在工作階段中透過 gh pr create 建立 PR 時，工作階段也會自動連結至該 PR。這讓您日後可以輕鬆恢復特定 PR 的工作。

命名工作階段： 在啟動時或工作階段進行中命名：

# Name session at startup (v2.1.76+)
claude -n "auth-refactor"                  # --name flag sets display name[^125]

# Name current session
> /rename auth-refactor

# Resume by name or number
> /resume 1                    # Resume first session
> /resume auth-refactor        # Resume by name
claude --resume auth-refactor  # Resume from terminal
claude -r 3                    # Resume by number from terminal

# Fork for parallel exploration
claude --resume auth-refactor --fork-session

注意： --session-id 需要有效的 UUID（例如 550e8400-e29b-41d4-a716-446655440000）。若需人類可讀的工作階段命名，請改用 /rename 和 --resume。

Claude Code 將工作階段儲存為 JSONL 記錄檔。代理執行時會指派唯一的 agentId 值，記錄檔儲存為 agent-{agentId}.jsonl。恢復工作階段時會保留先前對話的完整上下文。

規劃模式

規劃模式將 Claude 限制為唯讀探索——不進行檔案編輯、不執行 bash、不進行任何破壞性操作。Claude 會設計實作方案、將其寫入規劃檔案，並等待您核准後才執行任何操作。

進入規劃模式：

# Cycle through modes during a session
Shift+Tab           # Cycles: normal → plan → auto-accept

# Or use the /plan command with an optional description (v2.1.72+)
/plan                                     # Enter plan mode
/plan refactor the auth module            # Enter plan mode with a description

# Or ask Claude directly
"Plan how to refactor the auth module"   # Claude may enter plan mode automatically

運作方式：

  1. Claude 進入規劃模式（針對複雜任務自動進入，或透過 Shift+Tab 手動觸發）
  2. 使用唯讀工具探索程式碼庫：Read、Glob、Grep、WebSearch、WebFetch
  3. 將規劃寫入 .claude/plans/{session-slug}.md
  4. 使用 ExitPlanMode 退出規劃模式，向您呈現規劃內容
  5. 您可以核准、要求修改或拒絕

規劃模式中可用的工具： Read、Glob、Grep、LS、WebSearch、WebFetch、AskUserQuestion。編輯工具（Edit、Write、Bash、NotebookEdit）會被封鎖。

規劃核准後（v2.1.32+）： Claude 提供三個選項： - 「是，清除上下文並自動接受編輯」（Shift+Tab）——以全新上下文開始執行規劃 - 「是，手動核准編輯」——保留上下文，由您逐一核准每項變更 - 「是，自動接受編輯」——保留上下文，Claude 無需逐項核准即可執行

核准時自動清除上下文是建議的工作流程。這會為規劃提供全新的上下文視窗，顯著提升規劃的遵循度——Claude 能更長時間地保持在正軌上，不受舊對話的干擾。

何時使用規劃模式： - 涉及架構決策的新功能實作 - 多檔案重構，且您希望先審閱方案 - 不熟悉的程式碼庫，探索應先於修改 - 存在多種有效方案且您需要建議的任何任務

專家提示： 在規劃模式中投入的時間越多，Claude 在實作時成功的可能性就越高。規劃模式實質上是零成本的探索——沒有高風險的工具呼叫，沒有浪費的編輯。請大量使用。

設定系統深入探討

Claude Code使用分層設定系統。了解其階層架構至關重要，因為較高層級會覆蓋較低層級，而企業級設定則完全無法被繞過。

設定階層

層級 位置 範圍 可否覆蓋
企業級 /etc/claude-code/managed-settings.json（Linux） 所有使用者 否
/Library/Application Support/ClaudeCode/managed-settings.json（macOS）
C:\Program Files\ClaudeCode\managed-settings.json（Windows）
CLI旗標 命令列引數 目前工作階段 是
本機專案 .claude/settings.local.json 個人，目前專案 是
共享專案 .claude/settings.json 透過 git 與團隊共享 是
使用者 ~/.claude/settings.json 您的所有專案 是
狀態 ~/.claude.json 執行時狀態、OAuth、MCP 不適用

專家提示：在共享專案中使用.claude/settings.local.json來儲存個人偏好設定（將其加入.gitignore）。使用.claude/settings.json來設定團隊共用的組態，並將其納入版本控制。

完整 settings.json 參考

展示所有主要選項的完整設定範例：

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-sonnet-4-5-20250929",
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep",
      "Bash(npm run:*)",
      "Bash(git:*)",
      "Bash(make:*)",
      "Edit(src/**)",
      "Write(src/**)",
      "mcp__github"
    ],
    "deny": [
      "Read(.env*)",
      "Read(secrets/**)",
      "Bash(rm -rf:*)",
      "Bash(sudo:*)",
      "Edit(package-lock.json)",
      "Edit(.git/**)"
    ],
    "ask": [
      "WebFetch",
      "Bash(curl:*)",
      "Bash(docker:*)"
    ],
    "additionalDirectories": [
      "../shared-lib",
      "../docs"
    ],
    "defaultMode": "acceptEdits"
  },
  "env": {
    "NODE_ENV": "development",
    "DEBUG": "app:*"
  },
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write \"$FILE_PATH\""
          }
        ]
      }
    ]
  },
  "sandbox": {
    "enabled": false,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["git", "docker"]
  },
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh"
  },
  "includeCoAuthoredBy": true,
  "cleanupPeriodDays": 30,
  "outputStyle": "Explanatory",
  "language": "en",
  "respectGitignore": true,
  "showTurnDuration": true,
  "plansDirectory": ".claude/plans",
  "spinnerVerbs": ["Thinking", "Processing", "Analyzing"],
  "spinnerTipsOverride": {
    "tips": ["Custom tip 1", "Custom tip 2"],
    "excludeDefault": true
  },
  "includeGitInstructions": false,
  "modelOverrides": {
    "bedrock": "us.anthropic.claude-opus-4-6-20260312-v1:0",
    "vertex": "claude-opus-4-6@20260312",
    "foundry": "anthropic.claude-opus-4-6"
  },
  "autoMemoryDirectory": ".claude/memory",
  "sandbox": {
    "enableWeakerNetworkIsolation": true
  }
}

環境變數參考

驗證與API：

ANTHROPIC_API_KEY=sk-ant-...                    # Direct API authentication
ANTHROPIC_AUTH_TOKEN=token                      # Custom authorization header
ANTHROPIC_CUSTOM_HEADERS="X-Key: val"           # Additional request headers

模型設定：

ANTHROPIC_MODEL=claude-opus-4-6                 # Override default model
ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-6    # Opus 4.6 (Feb 2026)
ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5-20250929
ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5-20251001
CLAUDE_CODE_SUBAGENT_MODEL=sonnet               # Model for subagents
MAX_THINKING_TOKENS=10000                       # Enable extended thinking
CLAUDE_CODE_MAX_OUTPUT_TOKENS=4000              # Limit output length
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1          # Enable agent teams (v2.1.32+)

雲端供應商設定：

CLAUDE_CODE_USE_BEDROCK=1                       # Use AWS Bedrock
CLAUDE_CODE_USE_VERTEX=1                        # Use Google Vertex AI
CLAUDE_CODE_USE_FOUNDRY=1                       # Use Microsoft Foundry
ANTHROPIC_BEDROCK_BASE_URL=https://...          # Custom Bedrock endpoint
CLAUDE_CODE_SKIP_BEDROCK_AUTH=1                 # Skip Bedrock auth (for gateways)
CLAUDE_CODE_SKIP_VERTEX_AUTH=1                  # Skip Vertex auth
AWS_BEARER_TOKEN_BEDROCK=token                  # Bedrock bearer token
VERTEX_REGION_CLAUDE_3_7_SONNET=us-west1        # Override Vertex region

行為控制：

DISABLE_AUTOUPDATER=1                           # Prevent automatic updates
DISABLE_TELEMETRY=1                             # Opt out of usage telemetry
DISABLE_ERROR_REPORTING=1                       # Disable Sentry
DISABLE_BUG_COMMAND=1                           # Disable /bug command
DISABLE_COST_WARNINGS=1                         # Hide cost warnings
DISABLE_PROMPT_CACHING=1                        # Disable prompt caching globally
DISABLE_PROMPT_CACHING_SONNET=1                 # Disable for Sonnet only
DISABLE_PROMPT_CACHING_OPUS=1                   # Disable for Opus only
DISABLE_NON_ESSENTIAL_MODEL_CALLS=1             # Skip non-critical API calls

工具設定：

BASH_DEFAULT_TIMEOUT_MS=30000                   # Bash command timeout (30s)
BASH_MAX_TIMEOUT_MS=600000                      # Maximum bash timeout (10min)
BASH_MAX_OUTPUT_LENGTH=50000                    # Bash output limit
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1     # Reset CWD after each bash
MCP_TIMEOUT=5000                                # MCP server startup timeout
MCP_TOOL_TIMEOUT=30000                          # MCP tool execution timeout
MAX_MCP_OUTPUT_TOKENS=25000                     # MCP output limit
SLASH_COMMAND_TOOL_CHAR_BUDGET=15000            # Slash command context limit

網路與代理伺服器：

HTTP_PROXY=http://proxy:8080                    # HTTP proxy
HTTPS_PROXY=https://proxy:8080                  # HTTPS proxy
NO_PROXY=localhost,example.com                  # Bypass proxy for domains
CLAUDE_CODE_CLIENT_CERT=/path/to/cert           # mTLS certificate
CLAUDE_CODE_CLIENT_KEY=/path/to/key             # mTLS private key
CLAUDE_CODE_CLIENT_KEY_PASSPHRASE=pass          # mTLS passphrase

介面與終端機：

CLAUDE_CODE_DISABLE_TERMINAL_TITLE=1            # Don't update terminal title
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL=1             # Skip IDE extension install
CLAUDE_CODE_SHELL=/bin/zsh                      # Override shell detection
USE_BUILTIN_RIPGREP=1                           # Use included ripgrep (default)
CLAUDE_CONFIG_DIR=~/.myconfig                   # Custom config directory
IS_DEMO=1                                       # Hide sensitive UI elements[^37]
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1          # Disable background tasks and Ctrl+B[^46]
CLAUDE_CODE_TMPDIR=/path/to/tmp                 # Override temp directory[^50]
CLAUDE_CODE_DISABLE_1M_CONTEXT=1               # Disable 1M context window (use standard 200K)[^103]
CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS=120000       # Plugin marketplace git timeout (default 120s, was 30s)[^105]
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS=1        # Remove built-in commit/PR instructions[^117]
CLAUDE_CODE_DISABLE_CRON=1                    # Stop scheduled cron jobs mid-session[^121]
CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS=30000 # SessionEnd hooks timeout (default varies)[^123]

技能變數（v2.1.69+）：

${CLAUDE_SKILL_DIR}                            # Self-reference for skills to locate their own directory[^117]

SDK呼叫者身分（v2.1.51+）：

CLAUDE_CODE_ACCOUNT_UUID=uuid                  # Provide account UUID synchronously for SDK callers
CLAUDE_CODE_USER_EMAIL=[email protected]        # Provide user email for SDK callers
CLAUDE_CODE_ORGANIZATION_UUID=uuid             # Provide organization UUID for SDK callers

除錯：

ANTHROPIC_LOG=debug                             # Enable API request logging

該選擇哪個模型？

為每項任務選擇合適的模型，對成本與品質都有顯著影響。Claude Code提供多層級的彈性模型切換機制。

可用模型

別名 模型 最適用途 輸入/1M 輸出/1M
opus Claude Opus 4.6 複雜推理、架構設計、長上下文作業 $5.00 $25.00
sonnet Claude Sonnet 4.6 日常程式開發、均衡表現 $3.00 $15.00
haiku Claude Haiku 4.5 簡單任務、快速操作 $1.00 $5.00
default 依帳戶而定 通用用途 不定 不定
opus[1m] Opus 4.6 搭配 1M 上下文 大型程式碼庫、長時間工作階段 $10.00 $37.50
sonnet[1m] Sonnet 4.6 搭配 1M 上下文 大型程式碼庫 $6.00 $22.50
opusplan Opus（規劃）+ Sonnet（執行） 複雜重構 混合計價 混合計價

Opus 4.6（2026年2月5日）：最新旗艦模型，具備 1M token 上下文視窗、128K 最大輸出、自適應思考及 agent teams 功能。86 定價與 Opus 4.5 相同（$5/$25 per MTok）。自 v2.1.75（2026年3月13日）起，Max、Team 及 Enterprise 方案預設啟用 1M 上下文視窗——這些方案不再需要 [1m] 後綴。124 自 v2.1.77（2026年3月17日）起，Opus 4.6 的預設輸出 token 上限提升至 64K，最高可達 128K token。126 僅透過API使用時，長上下文（>200K 輸入）的費用仍為 $10/$37.50 per MTok。模型 ID：claude-opus-4-6。1

Sonnet 4.6（2026年2月17日）：取代 Sonnet 4.5 成為 claude.ai 及Claude Cowork 預設模型的新均衡模型。100 定價與 Sonnet 4.5 相同（$3/$15 per MTok）。提升了 agentic 搜尋效能，同時降低 token 消耗。支援延伸思考、自適應思考，以及 1M token 上下文視窗（beta）。64K 最大輸出（v2.1.77 中上限提升至 128K）。126 知識截止日期：2025年8月（可靠），2026年1月（訓練資料）。模型 ID：claude-sonnet-4-6。Sonnet 4.5 現已列為舊版模型。100

為何價差如此重要：一般程式開發工作階段消耗 50K-200K 輸入 token 和 10K-50K 輸出 token。使用 Haiku 每次約 $0.10-$0.45；使用 Opus 則為 $0.50-$2.25，高出 5 倍。建議將 Opus 留給真正困難的問題。1

各模型的使用時機

Haiku：適合用於探索型 subagents、簡單檔案搜尋、快速提問。費用約為 Opus 的五分之一，回應速度也更快，非常適合不需要深度推理的背景任務。

Sonnet：日常開發的主力模型，能勝任大多數程式任務：功能實作、修復 bug、撰寫測試、程式碼審查。建議作為預設選擇。Sonnet 4.6（2026年2月）相較 Sonnet 4.5，在 agentic 搜尋與 token 效率方面均有提升，並支援自適應思考及 1M 上下文視窗 beta。100

Opus：留給真正需要複雜推理的場景：架構決策、棘手的除錯、理解複雜系統、安全性分析。Opus 4.6（2026年2月）有顯著提升：規劃更縝密、agentic 任務持續力更強、大型程式碼庫中運作更穩定，程式碼審查時也更善於發現自身錯誤。86 具備 beta 階段的 1M token 上下文視窗，並引入自適應思考，能自動判斷推理深度。根據Anthropic的資料，在 Terminal-Bench 2.0 上，Opus 4.6 取得了業界最高的 agentic 程式開發分數。在 GDPval-AA（具經濟價值的知識工作）評測中，Anthropic表示其領先 GPT-5.2 約 144 Elo 分。86 注意：Pro 訂閱用戶可作為訂閱內容的一部分使用 Opus。20

Opusplan：混合模式，以 Opus 負責規劃（推理品質最為關鍵之處），以 Sonnet 負責執行（速度優先之處）。非常適合複雜重構——既能獲得最佳規劃方案，又不必為每次個別修改都使用 Opus 等級的推理能力。

切換模型

工作階段中切換：

> /model opus
> /model sonnet
> /model haiku

啟動時指定：

claude --model opus

透過環境變數設定：

export ANTHROPIC_MODEL=opus

在 settings.json 中設定：

{
  "model": "claude-sonnet-4-5-20250929"
}

針對 subagents 指定：

export CLAUDE_CODE_SUBAGENT_MODEL=haiku

延伸上下文

處理大型程式碼庫或長時間工作階段時，可啟用 1M token 上下文：

claude --model sonnet[1m]
claude --model opus[1m]           # Opus 4.6 with 1M context

或在工作階段中切換：

> /model sonnet[1m]
> /model opus[1m]

自 v2.1.75（2026年3月13日）起，Opus 4.6 預設使用 1M 上下文——Max、Team 及 Enterprise 方案無需加上 [1m] 後綴。124 Sonnet 及僅使用API的用戶仍需加上 [1m] 後綴。

Opus 4.6 是首個原生支援 1M 上下文的 Opus 級模型。在 MRCR v2 的 8-needle 1M 變體測試中達到 76% 準確率（競爭對手約為 ~18.5%），為長上下文檢索能力最強的模型。86

延伸上下文的每 token 費用較高（輸入超過 200K token 時，輸入費用為 2 倍、輸出為 1.5 倍）。Sonnet 搭配 [1m] 時，建議在確實需要時才啟用，不宜設為預設。

查看目前模型

> /status

此指令會顯示目前使用的模型、帳戶資訊、已套用的設定及其他工作階段狀態。

模型選擇器標籤（v2.1.51+）：/model 選擇器現在會顯示易讀的標籤（例如「Sonnet 4.6」），而非釘選版本的原始模型 ID，並在有新版本可用時提供升級提示。105

快速模式（v2.1.36+）

快速模式可大幅提升相同模型的輸出速度，並非切換至較低階的模型。在工作階段中以 /fast 切換。93

> /fast            # Toggle fast mode on/off

定價（Opus 4.6 快速模式）：

標準 快速模式
輸入 $5/MTok $30/MTok（6 倍）
輸出 $25/MTok $150/MTok（6 倍）

快速模式的定價適用於整個上下文視窗，包括超過 200K 輸入 token 的請求——快速模式下不會額外加收長上下文費用。1 快速模式的定價會與 prompt caching 及 data residency 倍率疊加，但不會與長上下文定價疊加。快速模式不適用於 Batch API。

適合使用快速模式的時機： - 快速迭代小幅修改，延遲是主要瓶頸時 - 產生測試、樣板程式碼或重複性程式碼，速度比成本更重要時 - 依序處理一系列類似任務時

不適合使用快速模式的時機： - 長時間執行的 agentic 任務（6 倍費率下成本累積極快） - 背景 subagent 作業（無人等待輸出結果） - 預算有限的工作階段

Opus 4.6 快速模式現已包含完整的 1M 上下文視窗（v2.1.50+）。先前快速模式僅限標準上下文，現在可以在快速模式速度下享有相同的 1M token 容量。103

進階技巧：快速模式與 opusplan 混合模式搭配效果極佳：在 Sonnet 執行階段使用快速模式加速迭代，同時 Opus 規劃階段維持標準費率。請注意 /fast 需要先啟用 /extra-usage（v2.1.37 修正）。93

Claude Code 的費用是多少？

理解並控制成本對於持續使用 Claude Code 至關重要。另請參閱模型選擇了解模型功能，以及決策框架了解如何為每項任務選擇合適的模型。

查看費用

> /cost

輸出：

Total cost:            $0.55
Total duration (API):  6m 19.7s
Total duration (wall): 6h 33m 10.2s
Total code changes:    247 lines added, 89 lines removed

訂閱方案

方案 價格 用量 存取權限
免費 $0 有限 無 Claude Code 存取權限
Pro $20/月 免費的5倍 Claude Code + Opus 存取權限20
Max（5x） $100/月 Pro的5倍 優先存取，增強效能
Max（20x） $200/月 Pro的20倍 最高優先級，可購買額外用量

速率限制（2025年8月）：Anthropic 為付費訂閱者引入了每週速率限制。Max 訂閱者可以按標準 API 費率購買超出速率限制的額外用量。21

API Token 定價（2026年2月）186

對於按 API 計費的使用者，每百萬 token 的定價：

模型 輸入 輸出 備註
Haiku 4.5 $1 $5 速度與效率
Sonnet 4.6 $3 $15 智慧與成本的平衡（取代 Sonnet 4.5）
Opus 4.6 $5 $25 旗艦款（與 Opus 4.5 同價）
Opus 4.5 $5 $25 前代旗艦

長上下文定價（輸入 token 超過200K）：

模型 標準輸入 長文輸入 標準輸出 長文輸出
Opus 4.6 $5 $10 $25 $37.50
Sonnet 4.6/4.5/4 $3 $6 $15 $22.50

200K 閾值基於總輸入 token 數（包括快取讀取/寫入）。超過此閾值時，Anthropic 會以長上下文費率對所有 token 計費。1

資料駐留定價：透過 inference_geo 指定僅限美國推論時，所有 token 定價會加上1.1倍的乘數（僅適用於 Opus 4.6+ 模型）。1

Prompt 快取可大幅降低重複輸入成本：快取寫入費用為基本價的1.25倍（5分鐘快取）或2倍（1小時快取），但快取讀取僅需0.1倍，節省90%。對於 agentic 系統和具有重複上下文的程式碼助手，快取可降低88-95%的成本。

批次 API 提供50%折扣，24小時內完成，適用於非緊急任務，例如隔夜測試套件。

多帳號政策59

可以擁有多個 claude.ai 帳號嗎？可以，用於合法用途。Anthropic 明確允許在帳號服務不同目的時擁有多個帳號。

允許的情況：

情境 範例 狀態
家庭成員 您和配偶各有 Max 帳號 允許
工作 + 個人 個人帳號 + 雇主管理的工作帳號 允許
個人 + 團隊 個人 Pro/Max 搭配組織帳號 允許
相同網路 同一家用 WiFi 的多個帳號 允許
同一台電腦 在一台機器上切換帳號 允許

技術限制： - 同一電話號碼最多可驗證 3個帳號 - 明確支援來自相同 IP/網路的多個付費訂閱 - 帳號完全獨立；帳號之間無法轉移對話或專案

禁止事項（依據使用政策）： - 被封禁後建立帳號以規避封禁 - 跨帳號協調惡意活動以避免偵測 - 使用多帳號繞過速率限制或免費額度

實際案例：2026年1月，重度使用者 Jeffrey Emanuel（@doodlestein）的22個 Max 帳號被自動標記並暫時封禁。Anthropic 員工 Thariq（@trq212）在確認為合法使用後，於4小時內解決了此問題。如果您在多個帳號上大量使用 Claude Code 進行工作和個人專案，這正是該服務的設計用途，但請勿嘗試鑽漏洞。

如有疑問：請聯繫 Anthropic 支援以書面確認您的具體設定。

成本因素

因素 影響 最佳化方式
模型選擇 Opus >> Sonnet >> Haiku 簡單任務使用 Haiku
輸入 token 更多上下文 = 更高成本 保持 CLAUDE.md 精簡
輸出 token 更長回應成本更高 設定 MAX_OUTPUT_TOKENS
思考 token 延伸思考增加成本 僅在需要時使用
Prompt 快取 降低重複輸入成本 保持啟用（預設）

實際成本範例

任務 模型 輸入 輸出 成本
快速檔案搜尋 Haiku 20K 2K $0.03
含測試的錯誤修復 Sonnet 100K 30K $0.75
架構審查 Opus 150K 50K $2.00
全天工作階段（Sonnet） Sonnet 500K 150K $3.75
全天工作階段（混合） Haiku+Sonnet 500K 150K ~$2.00

節省成本的洞見：使用 Haiku 作為探索用 subagents，Sonnet 用於實作，通常比全程使用 Sonnet 降低40-50%的成本。

團隊成本管理

依團隊規模建議的 TPM/RPM：

團隊規模 每位使用者 TPM 每位使用者 RPM
1-5 200k-300k 5-7
5-20 100k-150k 2.5-3.5
20-50 50k-75k 1.25-1.75
50-100 25k-35k 0.62-0.87
100+ 10k-20k 0.25-0.5

隱藏工具費用

除了每 token 定價外，部分工具會產生額外費用：16

工具 費用 備註
程式碼執行 $0.05/工作階段時 每月每組織前1,550小時免費。當請求中包含 web_search 或 web_fetch 工具時免費。40
網路搜尋 $10/1,000次搜尋 Token 成本仍適用。失敗的搜尋不計費。
網路擷取 免費 擷取內容除標準 token 成本外無額外費用。1
Bash 工具 每次呼叫+245個輸入 token 每次呼叫的額外開銷
文字編輯器 每次呼叫約+700個輸入 token 典型額外開銷

這些費用在 agent 迴圈中會累積。一個100次迭代的除錯循環使用 Bash 僅在額外開銷上就會產生約24,500個額外輸入 token。

節省成本的策略

  1. Subagents 使用 Haiku：大多數探索不需要 Sonnet
  2. 啟用 prompt 快取：預設已啟用，但請確認未被停用
  3. 設定最大回合數：claude --max-turns 5 防止對話失控
  4. 使用計畫模式進行探索：不執行 = 不會意外產生高額操作
  5. 主動壓縮：較小的上下文 = 較少的 token
  6. 限制輸出：export CLAUDE_CODE_MAX_OUTPUT_TOKENS=2000
  7. 非緊急工作使用批次 API：輸入和輸出 token 均享50%折扣

監控用量

  • claude.ai 控制台：platform.claude.com（需要管理員或帳務角色）
  • 工作區限制：為每個工作區設定支出上限
  • Bedrock/Vertex：使用原生雲端成本監控
  • LiteLLM：用於第三方供應商的詳細每使用者追蹤

背景 Token 使用

部分操作會在背景消耗 token： - /resume 的對話摘要 - /cost 和 /status 指令 - 自動壓縮

每次工作階段通常低於 $0.04。

Claude Code 分析 API（團隊/企業版）53

透過 Admin API 以程式化方式存取您組織的 Claude Code 使用分析和生產力指標。

端點：GET /v1/organizations/usage_report/claude_code

要求： - Admin API 金鑰（sk-ant-admin...） - 團隊或企業方案 - 管理員、帳務或開發者角色

可用指標：

指標 說明
num_sessions 已啟動的不同 Claude Code 工作階段數
lines_of_code.added/removed 新增/移除的程式碼總行數
commits_by_claude_code 建立的 git commit 數量
pull_requests_by_claude_code 建立的 PR 數量
terminal_type 環境（vscode、iTerm.app、tmux 等）
customer_type api（API 客戶）或 subscription（Pro/Team）

請求範例：

curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?starting_at=2026-01-15" \
  -H "x-api-key: sk-ant-admin..." \
  -H "anthropic-version: 2023-06-01"

使用案例： - 開發者生產力分析（工作階段、commit、PR） - 工具使用指標（Edit、Write 等的接受/拒絕率） - 跨團隊的成本追蹤與分配 - AI 程式碼工具的 ROI 論證

備註：資料會在活動完成後1小時內顯示。為確保一致性，回應中僅包含超過1小時的資料。

決策框架

僅知道功能的存在是不夠的。您需要知道何時使用每項功能。這些決策樹將知識轉化為行動。

我應該使用哪個模型？

START → Is the task simple? (file search, quick question, formatting)
         │
         ├── YES → Use Haiku
         │         Cost: ~$0.03/task
         │         Speed: Fastest
         │
         └── NO → Does it require deep reasoning?
                  (architecture, complex debugging, security analysis)
                  │
                  ├── YES → Use Opus 4.6
                  │         Cost: ~$2.00/task
                  │         Quality: Highest (1M context, adaptive thinking)
                  │
                  └── NO → Use Sonnet (default)
                           Cost: ~$0.75/task
                           Balance: Best overall

經驗法則：從 Sonnet 開始。subagents 降級使用 Haiku。僅在 Sonnet 的回答感覺淺薄時才升級至 Opus 4.6。透過 agent teams（v2.1.32+），Opus 可以協調多個 agents 同時並行處理不同的子任務。86

Command、Skill、Subagent 還是 Agent Team？

Do you want explicit control over when it runs?
│
├── YES → Use Slash Command
│         Example: /deploy, /test, /security-review
│         You invoke it. You control timing.
│
└── NO → Should the expertise apply automatically based on context?
         │
         ├── YES → Use Skill
         │         Example: Security patterns, domain rules, code standards
         │         Claude recognizes context and applies expertise.
         │
         └── NO → Does the work need isolated context?
                  │
                  ├── YES → Is there one subtask or many parallel subtasks?
                  │         │
                  │         ├── ONE → Use Subagent (Task tool)
                  │         │         Example: Deep exploration, parallel analysis
                  │         │         Prevents context bloat in main conversation.
                  │         │
                  │         └── MANY → Use Agent Team (v2.1.32+)
                  │                   Example: 5 agents reviewing different modules simultaneously
                  │                   Opus coordinates; each agent works independently.
                  │
                  └── NO → Just prompt directly
                           Not everything needs abstraction.

Hook 還是 Prompt？

Must the action ALWAYS happen, regardless of Claude's judgment?
│
├── YES → Use Hook (deterministic)
│         Examples:
│         - Format code after every edit
│         - Log all bash commands
│         - Block access to .env files
│         Claude cannot skip, forget, or decide otherwise.
│
└── NO → Use Prompt (probabilistic)
         Examples:
         - "Consider adding tests"
         - "Think about edge cases"
         - "Review for security if relevant"
         Claude decides based on context.

何時使用延伸思考？

Is this a genuinely hard problem?
│
├── Architectural decision with many tradeoffs → YES, use thinking
├── Complex debugging with unclear root cause → YES, use thinking
├── Security analysis requiring careful reasoning → YES, use thinking
├── Understanding unfamiliar codebase → YES, use thinking
│
├── Routine bug fix → NO, skip thinking
├── Simple refactoring → NO, skip thinking
├── Code formatting → NO, skip thinking
└── Quick questions → NO, skip thinking

在工作階段中使用 Alt+T 切換。較高的思考預算會產生更多費用；從最低開始，僅在回應感覺倉促時才增加。

Opus 4.6 自適應思考：Opus 4.6 會根據問題複雜度自動調整思考深度。對於大多數任務，不需要明確控制思考預算——Opus 會針對困難問題自動提升，對簡單任務則保持快速。手動切換思考模式在使用 Sonnet 時最為實用，適合您想強制進行更深入分析的情境。

應該使用哪個執行環境？

Where should this work happen?
│
├── Requires YOUR local files and tools
│   │
│   ├── Interactive, iterative work → Main REPL session
│   ├── One-shot scripted task → claude -p "prompt" (print mode)
│   ├── CI/CD automation → claude -p --json (non-interactive + structured output)
│   └── Parallel isolated tasks → Subagents via Task tool
│
├── Requires SOMEONE ELSE'S environment
│   │
│   └── Remote codebase or server → Background agent (cloud)
│
└── Doesn't require any environment
    │
    ├── Research or analysis → Subagent with Explore type
    └── Web content extraction → WebFetch / WebSearch tools
情境 執行環境 原因
偵錯失敗的測試 主 REPL 需要本機檔案，反覆迭代
分類處理 20 個 GitHub issues 背景 agent 長時間執行，不需要本機檔案
審查 PR Subagent 或 --from-pr 隔離的上下文，聚焦的輸出
產生變更日誌 claude -p 單次執行，可腳本化
每次提交時執行 lint + test Hook（PreCommit） 必須始終執行，確定性的
跨多個儲存庫搜尋模式 Subagent（Explore） 避免上下文膨脹
將遷移套用至預備環境 背景 agent 需要遠端存取
快速程式碼說明 主 REPL 或 /fast 互動式，需要快速回應
多模組重構 Agent team 跨檔案並行作業

Agent Teams、Subagents 與平行工作階段的比較

Do you need multiple agents working on related subtasks?
│
├── YES → Are the subtasks independent (no shared state)?
│         │
│         ├── YES → Can they share the same codebase?
│         │         │
│         │         ├── YES → Use Agent Team (v2.1.32+)
│         │         │         Opus coordinates. Agents share repo access.
│         │         │         Example: "Review auth, API, and DB modules in parallel"
│         │         │
│         │         └── NO → Use Parallel Sessions (separate terminals)
│         │                  Each has its own working directory.
│         │                  Example: "Fix repo-A and repo-B simultaneously"
│         │
│         └── NO → Use Sequential Subagents
│                  Results from one feed into the next.
│                  Example: "Explore → Plan → Implement"
│
└── NO → Use Single Subagent or Main REPL
方式 最大並行數 共享上下文 協調方式 成本
Agent Team 5-10 agents 共享儲存庫，獨立上下文 Opus 統籌協調 高（N 個 agents）
Subagents 無限制（自行管理） 無（隔離的） 透過提示詞自行協調 每個 agent 中等
平行工作階段 受終端機數量限制 無 手動 每個工作階段中等

應該使用哪種 Hook 類型？

What kind of automation do you need?
│
├── Run a shell command at a specific event?
│   │
│   └── Use Command Hook
│       Trigger: PreToolUse, PostToolUse, Notification, Stop, SubagentStop
│       Example: "Run prettier after every file edit"
│       Config: hooks.PostToolUse[].command = "prettier --write $FILE"
│
├── Modify Claude's system prompt based on context?
│   │
│   └── Use Prompt Hook (v2.1.35+)
│       Trigger: Same events
│       Example: "Inject project rules when working in /src/auth/"
│       Config: hooks.PreToolUse[].prompt = "When editing auth files..."
│
└── Have Claude make a judgment call before proceeding?
    │
    └── Use Agent Hook (v2.1.35+)
        Trigger: Same events
        Example: "Evaluate if this bash command is safe before running"
        Config: hooks.PreToolUse[].agent = { prompt: "Is this safe?" }

何時使用 /fast？

Is response speed more important than depth right now?
│
├── YES → Use /fast
│         Same Opus 4.6 model, faster output
│         Good for: quick questions, simple edits, code explanations,
│                   file searches, formatting tasks
│
└── NO → Stay in normal mode
         Good for: architecture decisions, complex debugging,
                   security reviews, multi-file refactors,
                   anything requiring deep reasoning

/fast 可切換目前工作階段的快速模式。它使用相同的模型（Opus 4.6）並最佳化輸出速度——並不會切換至較便宜的模型。

權限系統如何運作？

Claude Code 的權限系統提供細緻的操作執行控制。理解這套機制對於安全性和工作流程效率都至關重要。另請參閱企業部署，了解如何在組織層級統一管理權限設定。

權限層級

唯讀工具（自動核准）： - Read - 讀取檔案內容 - Glob - 依模式搜尋檔案 - Grep - 搜尋檔案內容 - WebSearch - 搜尋網頁 - LSP - 程式碼智慧功能（跳至定義、尋找參考、懸停文件）25

LSP 工具功能（v2.0.74+）： LSP 工具提供類似 IDE 的程式碼智慧功能： - 跳至定義：直接導覽至符號的定義位置 - 尋找參考：列出整個程式碼庫中所有使用該符號的位置 - 懸停文件：取得任何符號的型別資訊與文件說明 - 支援 TypeScript、Python、Go、Rust 及其他具備 LSP 支援的語言 - 需要語言伺服器可用（通常隨工具鏈一併安裝）

修改工具（需要核准）： - Edit - 修改現有檔案 - Write - 建立新檔案 - Bash - 執行 shell 命令 - WebFetch - 擷取 URL 內容 - NotebookEdit - 修改 Jupyter 筆記本

修改工具首次執行時，Claude Code 會提示使用者核准。核准在工作階段內持續有效，除非另行設定。

權限模式

模式 行為 使用情境
default 每項工具首次使用時提示 一般開發
acceptEdits 自動核准檔案編輯，Bash 仍需提示 受信任的專案
plan 不允許執行或編輯 僅供分析
bypassPermissions 跳過所有提示 CI/CD 自動化

YOLO 模式（v2.0.68+）： 若需完全自主運作，可使用 --dangerously-skip-permissions 旗標。此旗標會對所有操作一律放行：檔案編輯、Bash 命令、所有工具呼叫。名稱中的「dangerous」是刻意為之。請僅在沙箱環境中使用，或在完全信任程式碼庫時才啟用。61

claude --dangerously-skip-permissions

透過CLI設定模式：

claude --permission-mode acceptEdits

在工作階段中切換：

Shift+Tab  # Cycles through modes

在 settings.json 中設定：

{
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}

權限規則語法

細緻的規則可控制特定操作。規則依序評估，首個符合的規則優先生效。

Bash 命令模式：

{
  "allow": [
    "Bash(npm run build)",
    "Bash(npm run test:*)",
    "Bash(git commit:*)",
    "Bash(make:*)"
  ],
  "deny": [
    "Bash(rm -rf:*)",
    "Bash(sudo:*)",
    "Bash(curl|wget:*)"
  ]
}

星號提供前綴比對功能：Bash(npm run test:*) 允許 npm run test、npm run test:unit 和 npm run test:integration。

重要限制： Bash 模式僅支援前綴比對，並非正規表示式。像 Bash(curl http:*) 這樣的模式無法比對 curl -X GET http://...，因為選項出現在 URL 之前。若要可靠地封鎖，請直接拒絕整個命令：Bash(curl:*)。

檔案操作模式：

{
  "allow": [
    "Edit(src/**)",
    "Write(src/**)",
    "Read(docs/**)"
  ],
  "deny": [
    "Read(.env*)",
    "Read(secrets/**)",
    "Edit(.git/**)",
    "Edit(node_modules/**)"
  ]
}

路徑語法： - 相對路徑：Edit(src/**)——相對於工作目錄 - 相對於設定檔的絕對路徑：Edit(/build/**)——相對於設定檔所在位置 - 真正的絕對路徑：Edit(//tmp/**)——以 // 開頭 - 家目錄：Read(~/.zshrc)

MCP 工具模式：

{
  "allow": [
    "mcp__github",
    "mcp__database__query",
    "mcp__myserver__*"
  ],
  "deny": [
    "mcp__dangerous_server",
    "mcp__untrusted__*"
  ]
}

使用萬用字元語法 mcp__server__* 可一次允許或拒絕特定 MCP 伺服器的所有工具。39 萬用字元語法適合快速啟用受信任伺服器的所有工具，或封鎖來自不受信任來源的整個伺服器。

WebFetch 模式：

{
  "allow": [
    "WebFetch(domain:github.com)",
    "WebFetch(domain:api.example.com)"
  ]
}

額外目錄

將 Claude 的存取範圍擴展至目前專案之外：

{
  "permissions": {
    "additionalDirectories": [
      "../shared-lib",
      "../docs",
      "~/reference-projects/design-system"
    ]
  }
}

額外目錄對於 monorepo 架構，或 Claude 需要參考相鄰目錄中的程式碼時不可或缺。

沙箱模式

啟用檔案系統與網路隔離：

> /sandbox

或在設定中配置：

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["git", "docker"],
    "network": {
      "allowUnixSockets": ["~/.ssh/agent-socket"],
      "allowLocalBinding": true
    }
  }
}

啟用沙箱後： - 檔案系統存取限制在專案目錄內 - 網路存取受到控制 - 特定命令可排除在沙箱限制之外 - 若 autoAllowBashIfSandboxed 為 true，Bash 命令會自動核准

進階技巧： 沙箱模式非常適合在不受信任的程式碼庫上執行 Claude。探索陌生專案或需要額外防護時，建議啟用此模式。Anthropic 內部測試顯示，沙箱化可減少 84% 的權限提示。45 沙箱使用作業系統層級的原生機制（macOS seatbelt、Linux bubblewrap）進行檔案系統和網路隔離，因此即使遭受成功的提示注入攻擊，影響範圍也完全受限。Anthropic 已開源沙箱執行環境，供自行建置代理程式的團隊使用。89

安全性備註（v2.1.34+）： 透過 sandbox.excludedCommands 或 dangerouslyDisableSandbox 排除沙箱限制的命令，先前在啟用 autoAllowBashIfSandboxed 時可能繞過 Bash 詢問權限規則；此問題已在 v2.1.34 中修正。94 自 v2.1.38 起，沙箱模式下會封鎖對 .claude/skills 的寫入操作，防止提示注入修改技能定義。95 v2.1.77 新增 allowRead 沙箱檔案系統設定，可在 denyRead 區域內重新允許讀取——適用於封鎖大部分目錄樹但需將特定子目錄加入白名單的情境。126

Hooks 如何運作？

Hooks 在 Claude Code 工作流程的特定節點執行確定性的 shell 命令。不同於提示 Claude 執行操作，hooks 能保證執行，不受模型行為影響。對於團隊規範的強制執行和重複性任務的自動化而言，hooks 不可或缺。請參閱決策框架中的「該用哪種 Hook 類型？」決策樹，涵蓋命令、提示詞和代理 hooks。

為何選擇 hooks 而非提示詞： 告訴 Claude「編輯檔案後一律執行 Prettier」有時確實有效，但 Claude 可能會遺忘、為求速度而跳過，或認為改動「太小不值得」。Hooks 則保證執行：每次 Edit 或 Write 都會觸發格式化工具，毫無例外。在合規、安全和團隊規範的場景下，確定性遠勝於機率性。7

可用事件

事件 觸發時機 可阻斷 用途
PreToolUse 工具執行前 是 驗證、記錄或阻斷操作
PostToolUse 工具完成後 否 格式化輸出、執行 linter、觸發建置
PostToolUseFailure 工具失敗後 否 記錄失敗、發送告警、提供修正回饋
UserPromptSubmit 使用者送出提示詞 是 添加上下文、驗證輸入、注入資料
Notification 觸發通知 否 自訂通知處理
Stop Claude 完成回應 是 防止過早停止、強制完成條件。包含 last_assistant_message（v2.1.47+）
SubagentStart 子代理生成 否 記錄代理類型、透過 additionalContext 注入上下文
SubagentStop 子代理完成 是 防止子代理停止、強制品質關卡。包含 last_assistant_message（v2.1.47+）
TeammateIdle 代理團隊成員閒置 是 在隊友停止前強制品質關卡（v2.1.33+）
TaskCompleted 任務標記完成 是 強制完成條件、執行測試（v2.1.33+）
SessionStart 工作階段開始 否 環境設定、載入上下文、設定環境變數
SessionEnd 工作階段結束 否 清理、最終記錄
Setup --init/--init-only/--maintenance 旗標 否 環境設定任務（v2.1.10+）60
InstructionsLoaded CLAUDE.md 或 .claude/rules/*.md 被載入 否 回應指令檔案變更、注入上下文（v2.1.69+）
ConfigChange 工作階段中設定檔變更 是 稽核設定變更、強制安全策略（v2.1.49+）
WorktreeCreate 工作樹建立中 是 自訂 VCS 設定（取代預設 git 行為）（v2.1.50+）
WorktreeRemove 工作樹移除中 否 自訂 VCS 清理（v2.1.50+）
PreCompact 上下文壓縮前 否 驗證、記錄
PostCompact 上下文壓縮後 否 記錄、快取重用最佳化（v2.1.76+）125
Elicitation MCP 伺服器請求結構化輸入 是 攔截／覆寫 MCP 引導對話（v2.1.76+）125
ElicitationResult 使用者回應 MCP 引導 是 驗證／轉換引導回應（v2.1.76+）125
StopFailure 回合因 API 錯誤結束（速率限制、驗證失敗） 否 錯誤告警、重試邏輯（v2.1.78+）127
PermissionRequest 顯示權限對話框 是 自訂核准邏輯

Hook 設定

在 settings.json 或專用的 hooks.json 中定義 hooks：

{
  "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"
          }
        ]
      }
    ],
    "UserPromptSubmit": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/inject-context.sh"
          }
        ]
      }
    ]
  }
}

匹配器

matcher 欄位決定哪些工具會觸發 hook：

{"matcher": "*"}              // Match all tools
{"matcher": "Bash"}           // Match Bash only
{"matcher": "Edit|Write"}     // Match Edit or Write
{"matcher": "mcp__github"}    // Match MCP server tools
{"matcher": ""}               // Match for events without tools (like UserPromptSubmit)

Hook 輸入／輸出協定

Hooks 透過 stdin 接收 JSON：

{
  "tool_name": "Bash",
  "tool_input": {
    "command": "npm test",
    "description": "Run test suite"
  },
  "session_id": "abc-123"
}

Hook 事件擴充（v2.1.69+）： 所有 hook 事件在從子代理或 --agent 工作階段觸發時，現在都會包含 agent_id 和 agent_type 欄位，狀態列 hook 命令中還會包含 worktree 欄位。117

Stop/SubagentStop hooks（v2.1.47+） 會額外接收 last_assistant_message 欄位，包含 Claude 的最終回應文字，讓 hooks 無需解析對話記錄即可檢查輸出：

{
  "session_id": "abc-123",
  "last_assistant_message": "I've completed the refactoring. Here's what changed..."
}

結束代碼控制行為： - 0：成功：操作繼續。Stdout 在詳細模式（Ctrl+O）中顯示。對於 UserPromptSubmit 和 SessionStart，stdout 會加入上下文。 - 2：阻斷錯誤：操作中止。Stderr 成為回饋給 Claude 的錯誤訊息。 - 1、3 等：非阻斷錯誤：操作繼續。Stderr 在詳細模式中顯示為警告。

對於進階控制，hooks 可以輸出 JSON：

{
  "decision": "allow",
  "message": "Command validated and modified",
  "modifications": {
    "tool_input": {
      "command": "npm test -- --coverage"
    }
  }
}

PreToolUse 決策控制（建議格式）： PreToolUse hooks 使用 hookSpecificOutput 實現更精細的控制：三種結果（allow/deny/ask）加上修改工具輸入和注入上下文的能力：96

{
  "hookSpecificOutput": {
    "hookEventName": "PreToolUse",
    "permissionDecision": "allow",
    "permissionDecisionReason": "Command validated and modified",
    "updatedInput": {
      "command": "npm test -- --coverage --ci"
    },
    "additionalContext": "Note: This database has a 5-second query timeout."
  }
}
欄位 值 說明
permissionDecision "allow"、"deny"、"ask" allow 略過權限、deny 阻斷、ask 提示使用者
permissionDecisionReason 字串 顯示給使用者（allow/ask）或回饋給 Claude（deny）
updatedInput 物件 在執行前修改工具輸入
additionalContext 字串 注入 Claude 該回合的上下文51

注意： 頂層的 decision 和 reason 欄位在 PreToolUse 中已棄用。請改用 hookSpecificOutput.permissionDecision 和 hookSpecificOutput.permissionDecisionReason。其他事件（PostToolUse、Stop 等）仍使用頂層的 decision。96

非同步 Hooks（2026年1月）

Hooks 現可在背景執行，不阻斷 Claude Code 的運作。在 hook 設定中加入 async: true：88

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/notify-slack.sh",
            "async": true
          }
        ]
      }
    ]
  }
}

何時使用非同步 hooks： - 不應拖慢工作階段的通知（Slack、電子郵件、Pushover） - 可在背景執行的記錄和遙測 - 非關鍵的後處理（分析、備份）

何時不應使用非同步 hooks： - 格式化（必須在下次編輯前完成） - 驗證（失敗時必須阻斷） - 任何需要修改工具輸入／輸出的 hook

提示詞型與代理型 Hooks（v2.1.32+）

除了 shell 命令 hooks（type: "command"），Claude Code 還支援兩種 LLM 驅動的 hook 類型，透過 AI 推理而非腳本來評估條件。96

提示詞 hooks（type: "prompt"）向快速 Claude 模型發送單回合提示詞。模型回傳 { "ok": true } 表示允許，或 { "ok": false, "reason": "..." } 表示阻斷：

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "prompt",
            "prompt": "Evaluate if Claude should stop: $ARGUMENTS. Check if all requested tasks are complete and tests pass.",
            "timeout": 30
          }
        ]
      }
    ]
  }
}

HTTP hooks（type: "http"）將事件的 JSON 輸入以 POST 請求發送至 URL，並接收 JSON 回應。適用於 webhooks、外部通知服務或 API 驗證（v2.1.63+）：111

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "http",
            "url": "https://api.example.com/notify",
            "headers": {
              "Authorization": "Bearer $MY_TOKEN"
            },
            "allowedEnvVars": ["MY_TOKEN"]
          }
        ]
      }
    ]
  }
}

HTTP hooks 使用與命令 hooks 相同的決策格式（回傳包含 decision 和 reason 的 JSON）。啟用沙箱時會透過沙箱網路代理路由。SessionStart/Setup 事件不支援此類型。

代理 hooks（type: "agent"）生成具有工具存取權限（Read、Grep、Glob）的子代理，進行多回合驗證。當檢查需要實際檢視檔案或測試輸出時使用：

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "agent",
            "prompt": "Verify all unit tests pass. Run the test suite and check results. $ARGUMENTS",
            "timeout": 120
          }
        ]
      }
    ]
  }
}

使用 $ARGUMENTS 作為 hook 的 JSON 輸入佔位符。兩種類型都支援 model（預設為快速模型）和 timeout 欄位。支援的事件：PreToolUse、PostToolUse、PostToolUseFailure、PermissionRequest、UserPromptSubmit、Stop、SubagentStop、TaskCompleted。TeammateIdle 不支援提示詞／代理 hooks。

Hook 環境變數

Hooks 可存取用於解析路徑的環境變數：96

變數 可用範圍 說明
$CLAUDE_PROJECT_DIR 所有 hooks 專案根目錄（路徑含空格時需加引號）
${CLAUDE_PLUGIN_ROOT} 外掛 hooks 外掛的根目錄
$CLAUDE_ENV_FILE 僅 SessionStart 用於持久化環境變數供後續 Bash 命令使用的檔案路徑
$CLAUDE_CODE_REMOTE 所有 hooks 在遠端 Web 環境中設為 "true"

從 SessionStart 持久化環境變數：

#!/bin/bash
if [ -n "$CLAUDE_ENV_FILE" ]; then
  echo 'export NODE_ENV=production' >> "$CLAUDE_ENV_FILE"
fi
exit 0

HTTP hook 安全性（v2.1.51+）： 在標頭中插值環境變數的 HTTP hooks 現在需要明確的 allowedEnvVars 清單。這可防止透過標頭值任意洩漏環境變數。啟用沙箱時，HTTP hooks 也會透過沙箱網路代理路由，強制執行網域白名單。SessionStart/Setup 事件不支援 HTTP hooks。105

{
  "hooks": {
    "PostToolUse": [{
      "hooks": [{
        "type": "command",
        "command": "curl -H 'Authorization: Bearer $MY_TOKEN' https://api.example.com/notify",
        "allowedEnvVars": ["MY_TOKEN"]
      }]
    }]
  }
}

Hook 工作區信任（v2.1.51+）： statusLine 和 fileSuggestion hook 命令在互動模式下執行前，現在需要接受工作區信任，以封堵潛在的安全漏洞。105

實用 Hook 範例

編輯後自動格式化 TypeScript 檔案：

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "bash -c '[[ \"$FILE_PATH\" == *.ts ]] && npx prettier --write \"$FILE_PATH\" || true'"
          }
        ]
      }
    ]
  }
}

記錄所有 bash 命令：

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.command' >> ~/.claude/bash-history.log"
          }
        ]
      }
    ]
  }
}

阻斷存取敏感檔案：

#!/bin/bash
# .claude/hooks/protect-files.sh
data=$(cat)
path=$(echo "$data" | jq -r '.tool_input.file_path // empty')

if [[ "$path" == *".env"* ]] || [[ "$path" == *"secrets/"* ]] || [[ "$path" == *".pem"* ]]; then
  echo "Blocked: Cannot access sensitive file $path" >&2
  exit 2  # Exit 2 = block the tool call. Exit 1 = non-blocking error (hook failure only).
fi
exit 0

程式碼變更後執行測試：

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit",
        "hooks": [
          {
            "type": "command",
            "command": "bash -c '[[ \"$FILE_PATH\" == *.test.ts ]] || npm run test:affected'"
          }
        ]
      }
    ]
  }
}

自訂通知系統：

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "notify-send 'Claude Code' 'Waiting for your input'"
          }
        ]
      }
    ]
  }
}

將動態上下文注入提示詞：

#!/bin/bash
# .claude/hooks/inject-context.sh
# Add current git branch and recent commits to every prompt

branch=$(git branch --show-current 2>/dev/null)
commits=$(git log --oneline -3 2>/dev/null | tr '\n' ' ')

if [ -n "$branch" ]; then
  echo "[Context: Branch '$branch', Recent: $commits]"
fi
exit 0

Hook 偵錯

啟用偵錯模式以排查 hooks 問題：

claude --debug

偵錯模式會記錄： - Hook 執行時間 - 輸入／輸出資料 - 錯誤訊息和堆疊追蹤 - 決策結果（allow/reject/ask）

Hook 來源顯示（v2.1.75+）： 當 hook 需要使用者確認時，權限提示現在會顯示 hook 的來源（設定、外掛或 skill），更易於辨識是哪個元件在請求存取。124

元件範圍 Hooks（v2.1.0+）

Hooks 可透過 frontmatter 直接定義在 Skills、子代理和斜線命令中。這些 hooks 的作用範圍限於元件的生命週期，僅在該元件處於活動狀態時執行。41

帶有內嵌 hooks 的 Skill：

---
name: secure-deployment
description: Deployment skill with security validation
hooks:
  PreToolUse:
    - matcher: Bash
      command: ".claude/hooks/validate-deploy.sh"
  PostToolUse:
    - matcher: Bash
      command: ".claude/hooks/log-deploy.sh"
  Stop:
    - command: ".claude/hooks/cleanup.sh"
      once: true  # Run only once per session
---

支援的事件：PreToolUse、PostToolUse、Stop

once 選項（僅限 skills 和斜線命令）確保 hook 在每個工作階段中只執行一次，適用於清理或收尾任務。

長時間執行工作階段策略

對於通宵或無人值守的 Claude Code 工作階段，可設定 hooks 讓 Claude 在無需手動介入的情況下保持正軌。關鍵洞察：將 linting 和測試 hooks 作為護欄，迫使 Claude 在繼續之前修復問題。64

「測試通過前不准停止」模式：

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit",
        "hooks": [
          {
            "type": "command",
            "command": "npm run lint && npm run typecheck",
            "timeout": 60000
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "npm test || echo 'Tests failing - Claude should fix before stopping'"
          }
        ]
      }
    ]
  }
}

通宵工作階段策略：

  1. 起飛前檢查：使用 Setup hook 確認環境就緒
  2. 持續驗證：PostToolUse hooks 在每次變更後執行測試
  3. 完成關卡：Stop hooks 在 Claude 宣告「完成」前驗證所有驗收條件
  4. 通知：Stop hooks 可在 Claude 完成或卡住時透過 Slack/Pushover 通知您

搭配 --dangerously-skip-permissions 在沙箱容器中使用，即可實現完全自主的通宵運行。Claude 會持續迭代，直到測試通過或窮盡所有方案。

什麼是 MCP（Model Context Protocol）？

MCP 透過標準化協定，擴展 Claude Code 存取外部工具、資料庫、API 及服務的能力。此生態系統已蓬勃發展：MCP 目前擁有每月 1 億次下載量，並在 MCP.so 上索引了超過 3,000 個伺服器（2026年1月），穩固確立其作為連結 AI 與工具及資料的產業標準地位。354 理解 MCP 對於將 Claude 整合至您現有的工具鏈至關重要。

為什麼 MCP 對開發者至關重要： 沒有 MCP，Claude Code 只能讀取檔案和執行 bash 指令。有了 MCP，Claude 可以查詢您的正式環境資料庫、建立 Jira 工單、審查 GitHub PR、檢視 Sentry 錯誤，並與您團隊使用的任何 API 互動——全部透過自然語言請求完成。此協定標準化了 AI 工具連接外部服務的方式，避免供應商鎖定。請參閱決策框架以了解何時使用 MCP 及其他擴充機制的指引。

遠端 MCP 支援（2025年6月）

Claude Code 現已支援具備原生 OAuth 驗證的遠端 MCP 伺服器。28 無需管理本地伺服器即可連接工具和資料來源。只需驗證一次，Claude Code 即會自動處理權杖更新。

# Connect to remote MCP server with OAuth
claude mcp add --transport http linear https://mcp.linear.app/sse
# Browser opens for OAuth flow, tokens stored securely

claude.ai MCP 連接器（v2.1.46+）

Claude Code 現可使用您 claude.ai 帳號中設定的 MCP 連接器。這串連了網頁與 CLI 之間的落差：透過 claude.ai 介面設定的 MCP 伺服器會自動在 Claude Code 中可用，無需在本地重新設定。102

停用方式： 在您的環境變數或 settings.json 的 env 區塊中設定 ENABLE_CLAUDEAI_MCP_SERVERS=false，即可防止載入 claude.ai 的 MCP 伺服器。111

MCP 工具搜尋（v2.1.7+）

隨著 MCP 伺服器功能日益增長（部分伺服器暴露超過 50 個工具），工具描述開始佔用過多上下文。MCP 工具搜尋透過僅在需要時動態載入工具描述來解決此問題——這是一種 AI 工具的延遲載入機制。54

效能影響： 內部基準測試顯示準確度大幅提升： - Opus 4：MCP 評估從 49% 提升至 74% - Opus 4.5：MCP 評估從 79.5% 提升至 88.1% - 權杖開銷減少：85%

運作原理： 當 MCP 工具描述超過上下文視窗的 10%（預設閾值）時，Claude Code 會延遲載入完整描述，直到實際需要時才載入。Claude 可看到工具名稱，但按需取得描述。

設定方式：

{
  "mcpToolSearchAutoEnable": "auto:15"  // Enable when tools exceed 15% of context
}

可用值： - true — 永遠啟用工具搜尋 - false — 永遠停用（預先載入所有工具描述） - auto:N — 當工具超過上下文的 N% 時啟用（0-100）

進階技巧： 啟用工具搜尋後，您可以連接更多 MCP 伺服器而無需擔心上下文限制。95% 的上下文縮減意味著先前競爭上下文空間的伺服器現在可以和平共存。

MCP 引出（v2.1.76+）

MCP 伺服器現可透過互動式對話框，在任務執行中向使用者請求結構化輸入。125 當 MCP 伺服器需要額外資訊（例如選擇分支、輸入專案名稱、確認操作）時，會發送引出請求，Claude Code 將其呈現為表單欄位或瀏覽器 URL。

Hook 整合： 兩個新的 hook 事件——Elicitation（對話框出現前）和 ElicitationResult（使用者回應後）——讓您能以程式化方式攔截、驗證或覆寫引出回應。這使企業工作流程得以預填或依據政策限制 MCP 伺服器的提示。

互動式 MCP 設定精靈

執行 claude mcp add（不帶引數）即可啟動逐步引導介面來新增 MCP 伺服器。此精靈會引導您完成傳輸類型選擇、驗證及設定流程。15

傳輸類型

HTTP（建議用於遠端伺服器）：

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# With authentication
claude mcp add --transport http api https://api.example.com/mcp \
  --header "Authorization: Bearer $API_TOKEN"

SSE（已棄用但仍可運作）：

claude mcp add --transport sse asana https://mcp.asana.com/sse \
  --header "X-API-Key: your-key"

Stdio（本地伺服器）：

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

# Custom server
claude mcp add --transport stdio custom -- python /path/to/server.py --port 8000

Windows 的 stdio 需要 cmd 包裝器：

claude mcp add --transport stdio my-server -- cmd /c npx -y @some/package

範圍管理

MCP 伺服器存在於三個範圍層級，具有明確的優先順序（本地覆蓋專案，專案覆蓋使用者）：

範圍 儲存位置 可見性 使用情境
本地 ~/.claude.json（專案路徑） 僅限您自己，此專案 個人 API 金鑰
專案 .mcp.json 透過 git 分享給整個團隊 共享整合
使用者 ~/.claude.json（根目錄） 您自己，所有專案 個人工具

安裝時指定範圍：

claude mcp add --scope project --transport http github https://...
claude mcp add --scope user --transport stdio personal-tool -- ./my-tool

設定檔格式

.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": "${DATABASE_URL}"
      }
    },
    "sentry": {
      "type": "http",
      "url": "https://mcp.sentry.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${SENTRY_API_KEY}"
      }
    },
    "internal-api": {
      "type": "http",
      "url": "${API_BASE_URL:-https://api.example.com}/mcp",
      "headers": {
        "X-API-Key": "${INTERNAL_API_KEY}"
      }
    }
  }
}

環境變數使用 ${VAR} 語法展開，並支援可選的預設值：${VAR:-default}。

MCP 管理指令

claude mcp list                      # View all configured servers
claude mcp get github                # Get specific server details
claude mcp remove github             # Remove a server
claude mcp reset-project-choices     # Reset project-scoped approvals
claude mcp add-from-claude-desktop   # Import from Claude Desktop
claude mcp add-json weather '{"type":"http","url":"..."}'  # Add from JSON

# Within Claude Code REPL
> /mcp                               # Interactive MCP management

OAuth 驗證

對於需要 OAuth 的伺服器：

> /mcp
# Follow browser-based OAuth flow
# Tokens stored securely and auto-refreshed
# Use "Clear authentication" to revoke access

使用 MCP 資源與提示

參照資源：

@github:issue://123
@postgres:schema://users
@docs:file://api/authentication

MCP 提示作為斜線指令：

/mcp__github__list_prs
/mcp__github__pr_review 456
/mcp__jira__create_issue "Bug title" high

輸出限制

Claude Code 限制 MCP 輸出以防止上下文溢位： - 警告閾值：10,000 個權杖 - 預設上限：25,000 個權杖

如需增加：

export MAX_MCP_OUTPUT_TOKENS=50000

熱門 MCP 伺服器

伺服器 用途 主要功能
GitHub 儲存庫管理 PR、議題、CI/CD、程式碼審查
PostgreSQL 資料庫存取 查詢、結構描述檢視、資料分析
Sentry 錯誤監控 錯誤查詢、堆疊追蹤、部署關聯
Linear 專案管理 議題、專案、衝刺
Jira/Atlassian 企業專案管理 工單、看板、工作流程
Playwright 網頁自動化 端對端測試、無障礙樹狀結構
Stripe 支付 交易查詢、客戶資料
Cloudflare 基礎設施 DNS、workers、分析
Supabase 後端即服務 資料庫、驗證、儲存
Context7 文件 即時、版本特定的函式庫文件
Figma Dev Mode 設計轉程式碼 圖層階層、自動佈局、設計權杖。Figma 於2026年2月透過原生合作夥伴關係深化了與 Claude Code 的整合。42115
Sequential Thinking 問題解決 結構化推理、反思流程43
Magic UI 元件 React + Tailwind 行銷元件

實用 MCP 模式

GitHub 工作流程：

> Review PR #456
> List all open issues assigned to me
> Create a bug issue for the authentication failure we found

資料庫查詢：

> What's our total revenue this quarter?
> Show the schema for the users table
> Find customers with no purchases in 90 days

錯誤監控：

> What errors occurred in production today?
> Show the stack trace for error ABC123
> Which deployment introduced these errors?

企業 MCP 設定

系統管理員可透過 managed-mcp.json 強制執行 MCP 政策：

{
  "allowedMcpServers": [
    { "serverName": "github" },
    { "serverName": "sentry" },
    { "serverCommand": ["npx", "-y", "@approved/server"] }
  ],
  "deniedMcpServers": [
    { "serverName": "dangerous-server" }
  ]
}

存放位置： - macOS：/Library/Application Support/ClaudeCode/managed-mcp.json - Linux：/etc/claude-code/managed-mcp.json - Windows：C:\ProgramData\ClaudeCode\managed-mcp.json

拒絕清單具有絕對優先權。指令必須完全匹配，包括引數順序。

MCP Apps（2026年1月）

Anthropic 推出了 MCP Apps，這是 Model Context Protocol 的擴充，可在 Claude 介面中直接啟用互動式工具 UI。78 MCP Apps 讓使用者無需離開 Claude 即可檢視、編輯並與外部服務的內容互動，包括 Asana、Box、Canva、Figma、Hex、monday.com 和 Slack。任何 MCP 伺服器都可提供在 Claude 內呈現的互動式 UI。雖然 MCP Apps 目前出現在 claude.ai 網頁介面中，但隨著伺服器採用新的互動功能，底層的 MCP 協定擴充與 Claude Code 的 MCP 生態系統息息相關。

API 平台：程式碼執行工具 v2（2026年1月）

Anthropic 推出了公開測試版的程式碼執行工具 v2，以 Bash 指令執行和直接檔案操作取代了原本僅限 Python 的沙箱。79 主要變更： - 在沙箱容器中執行 Bash 指令（不僅限 Python） - 以任何語言編寫並執行程式碼 - 程式化工具呼叫（同為公開測試版）：Claude 可在程式碼執行中呼叫工具，減少多工具工作流程中的延遲和權杖使用量

v2 工具主要影響 API 使用者，但也預示了 Claude Code 雲端執行功能的發展方向。

什麼是子代理？

子代理是專門處理複雜任務的獨立Claude實例。它們是Claude Code中最強大的功能之一，也是最少被理解的功能之一。精通子代理能大幅擴展您可以完成的工作範圍。請參閱決策框架以了解 Agent Teams、子代理與平行會話的使用指引。

子代理存在的原因：Claude Code的主要對話只有單一上下文視窗。您討論的所有內容、Claude讀取的每個檔案、每個工具輸出：這些全都會消耗上下文。在長時間的會話中，上下文會被填滿，Claude會失去對先前決策的追蹤，效能也會下降。子代理透過隔離工作來解決這個問題：探索結果不會膨脹您的主要對話，只有摘要會回傳。Claude還可以同時運行多達10個子代理，實現循序執行不可能達成的並行工作。2

子代理的運作方式

當Claude遇到需要集中注意力的任務（深度探索、多步驟分析、專業化工作）時，它可以生成一個子代理。子代理會：

  1. 以乾淨的上下文開始（不受主要對話的污染）
  2. 可存取指定的工具
  3. 使用特定的模型運作（通常更便宜/更快）
  4. 將結果回傳給主要對話

這種架構在支援複雜工作流程的同時，防止了上下文溢出。

內建子代理類型

Explore（快速、唯讀）： - 模型：Haiku（超快速） - 模式：嚴格唯讀 - 工具：Glob、Grep、Read，以及安全的 bash 指令（ls、git status、git log、git diff、find、cat、head、tail） - 徹底程度：Quick、Medium、Very thorough - 用途：程式碼庫探索、尋找檔案、理解結構

General-purpose： - 模型：繼承自主要對話 - 模式：完整讀寫 - 工具：所有可用工具 - 用途：複雜的研究加修改任務

Plan： - 模型：繼承自主要對話（或使用 opusplan 時為 Opus） - 模式：唯讀 - 工具：Read、Glob、Grep、Bash - 用途：在執行前規劃複雜的實作

觸發子代理

Claude會根據任務類型自動委派給子代理。您也可以明確要求：

> Use the explore agent to find all authentication-related files

> Have a subagent analyze the database schema thoroughly

> Spawn an agent to research how error handling works in this codebase

專家技巧：對於複雜任務，明確要求子代理委派。「Use an explore agent to find…」可以防止主要對話的上下文膨脹。

建立自訂子代理

在 .claude/agents/（專案級）或 ~/.claude/agents/（個人級）中定義子代理：

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

You are a senior security engineer reviewing code for vulnerabilities.

When invoked:
1. Identify the files that were recently changed
2. Analyze for OWASP Top 10 vulnerabilities
3. Check for secrets, hardcoded credentials, SQL injection
4. Report findings with severity levels and remediation steps

Focus on actionable security findings, not style issues.

設定欄位：

欄位 必填 選項 用途
name 是 小寫字母加連字號 唯一識別碼
description 是 自然語言 何時呼叫（加入「PROACTIVELY」以鼓勵自動委派）
tools 否 逗號分隔 若省略則繼承所有工具。支援 Agent(agent_type) 來限制可生成的代理（v2.1.63+；Task(...) 仍可作為別名使用）
disallowedTools 否 逗號分隔 要拒絕的工具，從繼承或指定的清單中移除
model 否 sonnet、opus、haiku、inherit 預設為 inherit（與主要對話相同的模型）
permissionMode 否 default、acceptEdits、delegate、dontAsk、bypassPermissions、plan 權限處理方式。delegate 限制為僅團隊管理工具
maxTurns 否 整數 子代理停止前的最大代理輪次
memory 否 user、project、local 代理的持久記憶範圍（v2.1.33+）
skills 否 逗號分隔 啟動時自動載入技能內容到子代理上下文中
mcpServers 否 伺服器名稱或內聯定義 此子代理可用的MCP伺服器
hooks 否 Hook 設定物件 限定於此子代理執行範圍的生命週期 hooks
background 否 true、false 始終作為背景任務運行（v2.1.49+）
isolation 否 worktree 在臨時 git worktree 中運行以獲得隔離的儲存庫副本（v2.1.49+）

限制可生成的子代理（v2.1.33+，v2.1.63 重新命名）：tools 欄位支援 Agent(agent_type) 語法來限制代理可以生成的子代理類型。例如，tools: Read, Grep, Agent(Explore) 允許代理直接使用 Read 和 Grep，但只能委派給 Explore 類型的子代理。此限制可防止受限代理中的過度委派。注意：在 v2.1.63 中，Task 工具已重新命名為 Agent。設定和代理定義中現有的 Task(...) 參照仍可作為向後相容的別名使用。113

CLI定義的子代理（v2.1.32+）

在啟動時將子代理定義為JSON，用於快速測試或自動化。這些僅存在於該會話中，不會儲存到磁碟：96

claude --agents '{
  "code-reviewer": {
    "description": "Expert code reviewer. Use proactively after code changes.",
    "prompt": "You are a senior code reviewer. Focus on code quality and security.",
    "tools": ["Read", "Grep", "Glob", "Bash"],
    "model": "sonnet"
  }
}'

--agents 旗標接受與基於檔案的子代理相同前導資料欄位的JSON：description、prompt、tools、disallowedTools、model、permissionMode、mcpServers、hooks、maxTurns、skills 和 memory。

管理子代理

> /agents                    # 互動式管理
> /agents create             # 建立新子代理
> /agents edit               # 修改現有子代理
> /agents delete             # 移除子代理
> /agents list               # 檢視全部

CLI列表（v2.1.50+）：從命令列列出所有已設定的代理，無需啟動互動式會話：

claude agents                # Shows agents grouped by source (built-in, user, project, plugin)

遠端控制（v2.1.51+）：claude remote-control 子命令將您的本機環境提供給外部建置使用，讓所有使用者都能遠端存取本機環境的功能：105

claude remote-control                      # Start serving local environment
claude remote-control --name "My Project"  # Custom session title visible in claude.ai/code (v2.1.69+)[^117]

在背景運行代理

用於長時間運行的任務：

> Run a thorough security review in the background

> /agents  # Check status of running agents

稍後透過代理 ID 取得結果。

進階模式

鏈式子代理：

> First use the code-analyzer subagent to find performance issues, then use the optimizer subagent to fix them

平行探索：

> Have three explore agents search in parallel:
> 1. Authentication code
> 2. Database models
> 3. API routes

可恢復代理： 代理可以透過其 ID 恢復以繼續先前的工作：

> Resume agent abc123 and continue the analysis

非同步子代理（2025年12月）

非同步子代理為大型專案實現多工處理和平行執行：

> Run security review in the background while I continue frontend work
> /tasks                    # Check status of running agents

非同步代理透過統一的 TaskOutputTool 回傳結果，實現高效的管線式工作流程。

權限拒絕韌性（v2.1.0+）

從 v2.1.0 開始，子代理在權限被拒絕後會繼續工作，而非完全停止。當子代理遇到權限限制時，它會自動嘗試替代方法。此變更使自主工作流程更具韌性，並減少了人工介入的需求。47

Agent Teams（2026年2月，研究預覽）

Agent Teams 協調多個Claude Code實例協同工作。一個會話作為團隊領導，生成獨立工作在各自上下文視窗中的隊友，透過共享信箱和任務清單直接相互通訊。8691

與子代理不同（子代理在單一會話中運行且僅向呼叫者回報），隊友是完整的獨立會話，可以互相傳訊、質疑彼此的發現，並自行協調。

啟用：

// settings.json
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

或透過環境變數：export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

架構：

元件 角色
團隊領導 建立團隊、生成隊友、協調工作的主要會話
隊友 在指定任務上工作的獨立Claude Code實例
任務清單 隊友認領和完成的共享工作項目（檔案鎖定）
信箱 代理間通訊的訊息系統

顯示模式：

模式 方式 最適合
in-process（預設） 所有隊友在主終端機中。Shift+Up/Down 選擇。 任何終端機
tmux / iTerm2 每個隊友在自己的分割窗格中 視覺化監控

在設定中配置："teammateMode": "in-process" 或 "tmux"。或按會話配置：claude --teammate-mode in-process。

主要控制鍵： - Shift+Down：循環切換隊友（in-process 模式；最後一個隊友之後會回到領導） - Shift+Tab：啟用委派模式（限制領導僅進行協調，不修改程式碼） - Ctrl+T：切換共享任務清單 - 在隊友上按 Enter：檢視其會話；Escape 中斷其輪次

何時使用 Agent Teams 與子代理：

子代理 Agent Teams
通訊 僅回報結果 隊友直接互相傳訊
協調 主代理管理所有工作 共享任務清單與自行協調
最適合 僅需結果的專注任務 需要討論和協作的複雜工作
Token 成本 較低 較高（每個隊友 = 獨立的上下文視窗）

最佳使用情境： - 研究和審查（同時取得多種觀點） - 新模組/功能（隊友各自負責不同部分） - 以競爭假設進行除錯（平行測試不同理論） - 跨層協調（前端、後端、測試各由不同隊友負責）

隊友的計畫核准：對於複雜或高風險的任務，要求隊友在實作前先規劃。隊友在唯讀計畫模式下工作，直到領導審查並核准其方法：

Spawn an architect teammate to refactor the authentication module.
Require plan approval before they make any changes.

領導自主做出核准決策。透過條件來影響其判斷：「only approve plans that include test coverage」或「reject plans that modify the database schema」。

範例提示：

Create an agent team to review PR #142. Spawn three reviewers:
- One focused on security implications
- One checking performance impact
- One validating test coverage

Spawn a team with 4 teammates to refactor these modules in parallel.
Use Sonnet for each teammate.

儲存位置：團隊設定存放在 ~/.claude/teams/{team-name}/config.json（包含 name、agent ID、agent type 的成員陣列）。任務清單在 ~/.claude/tasks/{team-name}/。任務支援相依性：被阻擋的任務會在其相依項目完成時自動解除阻擋。91

Hook 整合：使用 TeammateIdle（exit code 2 可發送回饋並讓隊友繼續工作）和 TaskCompleted（exit code 2 可阻止完成）hooks 來對隊友執行品質閘門。

限制（實驗性）： - in-process 隊友不支援會話恢復（/resume 無法恢復它們） - 每個會話僅限一個團隊；不支援巢狀團隊 - 隊友無法生成自己的團隊 - 分割窗格需要 tmux 或 iTerm2（不支援 VS Code 終端機、Windows Terminal 或 Ghostty） - 所有隊友以領導的權限模式啟動 - Token 密集：每個隊友都是獨立的Claude實例

Agent Skills（2025年12月）

Agent Skills 是由指令、腳本和資源組成的有組織資料夾，代理可以動態發現和載入。31 它們提供可組合、可攜帶的領域專業知識：

.claude/skills/
├── security-review/
│   ├── skill.md           # Instructions and prompts
│   ├── checklist.md       # Security checklist
│   └── common-vulns.sh    # Detection scripts
└── performance-audit/
    ├── skill.md
    └── profiling-guide.md

Skills 與命令不同：命令需要明確呼叫，而 skills 會根據任務上下文自動啟動。Claude Agent SDK（從Claude Code SDK重新命名）提供了建構具有 skill 支援的自訂代理的框架。32

什麼是延伸思考模式？

延伸思考讓 Claude 在回應之前有更多時間來推理複雜問題。這對於架構決策、除錯棘手問題以及需要仔細分析的任務特別有價值。

目前狀態（2026年3月）

延伸思考現在預設為啟用狀態，預算為 31,999 個 token。70 Anthropic 做出此變更是因為延伸思考能顯著提升複雜規劃和推理任務的表現。

努力程度等級（v2.1.68+，v2.1.72 簡化版）： Opus 4.6 對 Max 和 Team 訂閱者預設為中等努力程度——在速度與深度之間取得最佳平衡。努力程度等級會在標誌和載入動畫中以簡化符號顯示：○（低）、◐（中）、●（高）。121 「ultrathink」關鍵字已重新引入以觸發高努力程度模式。其他自然語言觸發詞（「think」、「think hard」、「think harder」）仍然已棄用——請改用 MAX_THINKING_TOKENS 或 /config。70116

注意： Opus 4 和 Opus 4.1 已從第一方 API 的 Claude Code 中移除（v2.1.68）。已固定使用這些模型的使用者已自動遷移至 Opus 4.6。116

支援的模型

  • Claude Opus 4.6（也支援自適應思考，可自動判斷推理深度）
  • Claude Sonnet 4.6（也支援自適應思考）
  • Claude Opus 4.5
  • Claude Sonnet 4.5
  • Claude Haiku 4.5

控制延伸思考

在工作階段中快速切換：

Press Alt+T to toggle thinking on/off

注意：Anthropic 將思考切換鍵從 Tab 改為 Alt+T，以避免意外觸發。39

透過 /config： 前往 /config → Extended Thinking 以啟用/停用或調整預算。

環境變數（永久設定）：

# Set custom budget (default is 31,999)
export MAX_THINKING_TOKENS=8000
claude

# Double the default for complex tasks
export MAX_THINKING_TOKENS=63999
claude

停用以節省成本： 對於不需要深度推理的簡單任務，您可以透過在 /config 中停用思考或降低預算來減少費用：

export MAX_THINKING_TOKENS=8000  # Reduce from default 31,999

思考 Token 預算

預算 使用情境
1,024（最小值） 簡單推理任務
8,000 大多數程式編寫任務（成本效益高）
31,999（預設值） 複雜推理、架構決策
63,999（預設值的 2 倍） 全面分析（需要明確設定）

成本考量： Anthropic 將思考 token 計為輸出 token 來計費。預設的 31,999 預算對大多數任務來說表現良好，但對於簡單操作，您可以透過降低預算或完全停用思考來節省費用。

運作方式

當思考功能啟用時，Claude 會執行內部推理，這些推理會影響答案但不會出現在輸出中。Claude Code 會加密思考內容並在 signature 欄位中回傳以供驗證。

在使用工具的多輪對話中，思考區塊必須回傳給 API 以保持推理的連續性。Claude Code 會自動處理這個流程。

何時考慮停用/減少

延伸思考現在是預設啟用的，但在以下情況下可考慮降低預算或停用： - 簡單的檔案編輯 - 例行性重構 - 快速提問 - 程式碼格式化 - 大量操作導致費用累積時

快取行為

當思考參數變更時，Claude Code 會保留系統提示詞快取。在對話輪次之間變更思考預算或啟用狀態會使訊息快取失效。

輸出樣式

輸出樣式可自訂 Claude 呈現資訊的方式，這對於學習、文件撰寫或特定團隊偏好非常實用。19

內建樣式

樣式 用途
Explanatory 附帶推理的詳細說明
Learning 教學格式，包含概念解說
Concise 最精簡的輸出，僅包含重點

設定輸出樣式

> /output-style Explanatory
> /output-style Learning

或透過設定：

{
  "outputStyle": "Explanatory"
}

自訂輸出樣式

在 .claude/styles/ 中建立：

# my-style

## Instructions
- Always explain the WHY behind each decision
- Include relevant documentation links
- Format code examples with comments
- End with a "What to do next" section

## Format
Use markdown headers for organization.
Keep explanations under 200 words per section.

使用 /output-style my-style 來呼叫。

已棄用（v2.1.73+）： /output-style 已棄用。請改用 /config 來管理輸出樣式。122

Slash 指令

Slash 指令提供快速存取Claude Code功能的途徑，並支援自訂工作流程。相較於為常見操作輸入完整提示詞，使用指令更為迅速。

內建指令參考

指令 用途 備註
/init 以 CLAUDE.md 初始化專案 建立包含專案結構的記憶檔案
/memory 管理自動記憶 檢視與編輯自動記憶檔案（v2.1.59+）
/copy 複製程式碼區塊 互動式選取器可選擇個別程式碼區塊或完整回應；「Always copy full response」選項可在後續呼叫中跳過選取器；w 鍵可將選取內容直接寫入檔案——在SSH上特別實用；/copy N 複製第 N 個最近的助手回應（v2.1.59+，v2.1.63 增強，v2.1.72，v2.1.77）111121126
/context 檢視上下文視窗使用量 顯示視覺化分析與可操作建議（v2.1.74+）123
/compact 壓縮對話歷史 可加上焦點：/compact focus on tests
/cost 顯示 token 用量與費用 工作階段明細
/usage 顯示目前方案用量 僅限 VSCode（v2.1.14+）
/stats 使用統計 常用模型、使用量圖表、連續使用天數
/permissions 管理權限設定 互動式介面
/mcp 設定MCP伺服器 亦可使用 /mcp enable、/mcp disable
/hooks 檢視 hook 設定 除錯 hooks
/config 開啟設定介面 完整設定
/resume 恢復已命名的工作階段 /resume <n> 或 /resume session-name
/rename 為目前工作階段命名 /rename feature-auth
/branch 分支對話 在不遺失上下文的情況下探索替代方案（/fork 仍可作為別名使用，於 v2.1.77 更名）126
/clear 清除對話歷史 全新開始
/vim 啟用 vim 編輯模式 模態編輯
/ide 連接 IDE VS Code/JetBrains 整合
/sandbox 啟用沙箱模式 隔離環境
/status 檢視工作階段狀態 模型、設定等
/statusline 自訂狀態列 設定顯示內容
/model 切換 AI 模型 /model opus
/fast 切換快速模式 相同模型，更快輸出（v2.1.36+）
/output-style 設定輸出風格 v2.1.73+ 已棄用——請改用 /config122
/agents 管理 subagents 建立、編輯、刪除
/bashes 列出背景任務 長時間執行的指令
/tasks 列出背景代理 監控非同步任務
/export 匯出對話 儲存對話紀錄
/add-dir 新增工作目錄 擴展存取範圍
/terminal-setup 設定終端機 支援 Kitty、Alacritty、Zed、Warp25
/login 於工作階段中驗證身分 切換帳號或重新驗證
/logout 於工作階段中登出 清除憑證
/doctor 檢查安裝狀態 健康檢查
/bug 回報錯誤 向Anthropic提交問題
/release-notes 檢視版本說明 查看最新更新
/rewind 返回檢查點 復原變更（或按兩次 Esc）
/theme 管理主題 Ctrl+T 切換語法高亮
/plugin 管理外掛 安裝、更新、移除外掛
/passes 訪客通行證（僅限 Max） 分享 3 張Claude Code Pro 試用通行證62
/voice 切換語音模式 按住空白鍵說話的按鍵通話功能（2026年3月）118
/claude-api Claude API技能 使用Claude API/Anthropic SDK建構應用程式（v2.1.69+）117
/reload-plugins 重新載入外掛 無需重啟即可套用外掛變更（v2.1.69+）117
/security-review 安全性審查 審查程式碼漏洞（v2.1.70 修正 git 相容性）116
/color 設定提示顏色 為工作階段設定提示列顏色。/color default/gray/reset/none 可還原。所有使用者皆可使用（v2.1.75+）124
/simplify 簡化程式碼 內建 slash 指令（v2.1.63+）111
/batch 批次操作 內建 slash 指令（v2.1.63+）111
/effort 設定推理力度 將模型推理力度設為 low/medium/high（v2.1.76+）125
/loop 週期性任務 /loop 5m /foo 以固定間隔執行提示詞，預設 10 分鐘。適用於輪詢部署狀態、監看 PR 或定期檢查（v2.1.71+）119

建立自訂指令

在 .claude/commands/（專案層級）或 ~/.claude/commands/（個人層級）中建立可重複使用的指令：

---
description: Security-focused code review
allowed-tools: Read, Grep, Glob
model: claude-sonnet-4-5
---

Review this code for security vulnerabilities:

1. Injection attacks (SQL, command, XSS)
2. Authentication and authorization flaws
3. Sensitive data exposure
4. Insecure dependencies

Focus on actionable findings with specific line references.

儲存為 .claude/commands/security-review.md，以 /security-review 呼叫。

指令 Frontmatter 選項

---
description: Brief description for /help
allowed-tools: Read, Edit, Bash(npm:*)
model: opus
argument-hint: [arg1] [arg2]
disable-model-invocation: false
---
選項 用途
description 說明文字，用於 /help 顯示與自動委派比對
allowed-tools 限制可用工具
model 覆寫此指令使用的模型
argument-hint 記錄預期的參數
disable-model-invocation 防止 SlashCommand 工具被呼叫

參數插值

所有參數作為單一字串：

---
description: Fix GitHub issue
argument-hint: [issue-number]
---

Fix GitHub issue #$ARGUMENTS following our coding standards.

使用方式：/fix-issue 123

編號參數：

---
description: Create component
argument-hint: [name] [type]
---

Create a new $2 component named $1 in src/components/.

使用方式：/create-component Button functional

行內 Bash 執行

在指令提示詞中執行 bash 指令：

---
description: Git status summary
allowed-tools: Bash(git:*)
---

Current branch: !`git branch --show-current`
Recent commits: !`git log --oneline -5`
Changed files: !`git status --short`

Summarize the current state of this repository.

檔案參照

在指令中引入檔案內容：

---
description: Compare implementations
---

Compare these files:
@src/v1/handler.ts
@src/v2/handler.ts

Which implementation is more maintainable?

指令命名空間

將指令整理到子目錄中：

.claude/commands/
├── backend/
│   ├── test.md
│   └── deploy.md
├── frontend/
│   ├── test.md
│   └── build.md
└── review.md

同名指令會在說明中顯示其命名空間：/test (project:backend) 與 /test (project:frontend)。

Skills 的運作方式

Skills 代表了一種根本不同的 Claude Code 擴展方法。與您需要明確呼叫的斜線命令不同，skills 是由模型呼叫的——Claude 會根據上下文自動發現並使用它們。您將領域專業知識嵌入到 skill 中，Claude 會在情境需要時運用該專業知識，無需您記得去詢問。

為什麼 skills 改變了一切：考慮領域專業知識：支付處理規則、合規要求、您的團隊多年來精煉的架構模式。沒有 skills，您要麼每次會話都重新解釋這些上下文，要麼寄望 Claude 從程式碼註解中推斷出來。有了 skills，您只需編碼一次。Claude 讀取 skill 定義，並在相關情境中自動應用該專業知識。您的初級開發人員無需詢問就能獲得資深級別的指導。您的安全模式無需記得呼叫就能被執行。

這個區別很重要。斜線命令是您記得使用的捷徑。Skill 是 Claude 始終可用的知識。當您建立一個包含團隊特定漏洞模式和合規要求的安全審查 skill 時，Claude 會在遇到相關程式碼時自動應用該專業知識，無論是在 PR 審查、重構，還是任何安全重要的任務中。您不需要呼叫 /security-review；Claude 會識別上下文並自動應用該 skill。

Skills、命令與 Subagents 的比較

了解何時使用每種擴展機制可以避免重複並最大化效果：

面向 斜線命令 Skills Subagents
呼叫方式 使用者呼叫（/command） 模型呼叫（自動） 明確或自動委派
觸發條件 您記得使用它 Claude 識別上下文 任務需要委派
結構 單一 markdown 檔案 含資源的目錄 含 frontmatter 的 Markdown
上下文 主要對話 主要對話 獨立的上下文視窗
複雜度 簡單提示 多檔案能力 完整的代理人格
最適用於 明確的動作 領域專業知識 複雜任務委派

使用斜線命令當您需要明確控制時：/deploy、/test、/review PR 456。由您決定何時執行。

使用 skills當專業知識需要自動啟動時：安全模式、程式碼風格規範、領域特定知識。由 Claude 決定何時應用。

使用 subagents當任務需要隔離時：背景探索、平行分析、不應汙染主要對話的專門推理。

Skill 的結構與位置

Skills 存放在專用目錄中，包含必要的 SKILL.md 檔案以及可選的支援資源：

個人 skills（適用於您所有的專案）：

~/.claude/skills/
├── code-reviewer/
│   ├── SKILL.md
│   ├── SECURITY_PATTERNS.md
│   └── PERFORMANCE_CHECKLIST.md
├── sql-analyst/
│   ├── SKILL.md
│   └── QUERY_PATTERNS.md
└── api-designer/
    └── SKILL.md

專案 skills（透過 git 與團隊共享）：

.claude/skills/
├── domain-expert/
│   ├── SKILL.md
│   ├── BUSINESS_RULES.md
│   └── DATA_MODELS.md
└── deployment/
    ├── SKILL.md
    └── RUNBOOKS.md

專案 skills 提交到版本控制。當隊友拉取時，他們會自動獲得您的 skills，無需安裝，無需設定。自動分發讓團隊間的專業知識標準化。

SKILL.md 格式

每個 skill 都需要一個帶有 YAML frontmatter 的 SKILL.md 檔案：

---
name: code-reviewer
description: Review code for security vulnerabilities, performance issues, and best practice violations. Use when examining code changes, reviewing PRs, analyzing code quality, or when asked to review or audit code.
allowed-tools: Read, Grep, Glob
---

# Code Review Expertise

## Security Analysis

When reviewing code, check for:

### Input Validation
- All user input sanitized before use
- Parameterized queries for database operations
- Output encoding for rendered content

### Authentication & Authorization
- Session tokens properly validated
- Permission checks before sensitive operations
- No hardcoded credentials or API keys

### Data Exposure
- Sensitive data not logged
- PII properly masked in error messages
- API responses don't leak internal details

## Performance Patterns

### Database
- N+1 query detection
- Missing indexes on filtered columns
- Unbounded result sets

### Memory
- Large object lifecycle management
- Stream processing for big files
- Connection pool exhaustion risks

## Review Output Format

For each finding:
- **File**: path/to/file.ts:123
- **Severity**: Critical | High | Medium | Low
- **Category**: Security | Performance | Maintainability
- **Issue**: Clear description of the problem
- **Recommendation**: Specific fix with code example
- **Rationale**: Why this matters

See [SECURITY_PATTERNS.md](SECURITY_PATTERNS.md) for detailed vulnerability patterns.
See [PERFORMANCE_CHECKLIST.md](PERFORMANCE_CHECKLIST.md) for optimization guidelines.

Frontmatter 參考

欄位 必要 限制 用途
name 是 小寫字母、數字、連字號；最多 64 字元 唯一識別碼
description 是 最多 1024 字元 發現觸發條件：Claude 使用此欄位決定何時應用該 skill
allowed-tools 否 以逗號分隔的工具名稱 限制 Claude 使用此 skill 時的能力
context 否 fork 在隔離的上下文中執行 skill（v2.1.0+）。防止對主代理狀態產生副作用。47

字串替換（v2.1.9+）：Skills 可以使用 ${CLAUDE_SESSION_ID} 替換來存取會話上下文。適用於記錄、追蹤或產生特定於會話的輸出。51

description 欄位至關重要。Claude 透過將您的請求與 skill 描述進行比對來發現 skills。模糊的描述意味著 Claude 無法識別何時使用該 skill。具有明確觸發條件的具體描述則意味著可靠的啟動。

不佳的描述：

description: Helps with code

有效的描述：

description: Review code for security vulnerabilities, performance issues, and best practice violations. Use when examining code changes, reviewing PRs, analyzing code quality, or when asked to review, audit, or check code.

有效的描述包含： - skill 做什麼（針對特定問題審查程式碼） - 何時使用（檢視變更、PR、品質分析） - 觸發短語（review、audit、check）

工具限制

allowed-tools 欄位限制了 Claude 在 skill 啟動時可以執行的操作。工具限制對於唯讀或範圍受限的 skills 至關重要：

---
name: security-auditor
description: Audit code for security vulnerabilities without making changes
allowed-tools: Read, Grep, Glob
---

使用此設定，Claude 可以分析程式碼但無法編輯檔案、執行 bash 命令或進行修改。該 skill 強制執行唯讀行為。

常見的限制模式：

模式 工具 使用情境
唯讀分析 Read, Grep, Glob 安全稽核、程式碼審查
安全探索 Read, Grep, Glob, Bash(git log:*), Bash(git diff:*) 歷史分析
文件產生 Read, Grep, Glob, Write 產生文件但不編輯原始碼
完整存取 （省略欄位） Skill 繼承所有可用工具

支援檔案

Skills 可以包含多個檔案。Claude 在啟動時讀取主要的 SKILL.md，然後根據需要存取支援檔案，提供漸進式揭露以有效管理上下文。

結構模式：

my-skill/
├── SKILL.md           # Required: overview + quick reference
├── DETAILED_GUIDE.md  # Deep documentation
├── EXAMPLES.md        # Concrete examples
├── PATTERNS.md        # Reference patterns
├── templates/         # Reusable templates
│   └── component.tsx
└── scripts/           # Helper utilities
    └── validate.py

從 SKILL.md 參考支援檔案：

For detailed security patterns, see [SECURITY_PATTERNS.md](SECURITY_PATTERNS.md).

Use this template for new components:
@templates/component.tsx

Validate configurations with:
```bash
python scripts/validate.py config.json

**專家提示：**將重要資訊直接放在 SKILL.md 中。將支援檔案保留給深度參考資料。Claude 會立即讀取 SKILL.md，但僅在需要時才存取支援檔案。如果關鍵資訊埋藏在支援檔案中，Claude 可能找不到它。

### 完整範例：領域專家 Skill

以下是金融科技應用程式的生產級 skill：

**目錄結構：**

.claude/skills/payments-domain/ ├── SKILL.md ├── BUSINESS_RULES.md ├── COMPLIANCE.md └── DATA_MODELS.md

**SKILL.md：**
```markdown
---
name: payments-domain
description: Expert knowledge of payment processing domain including transaction flows, compliance requirements, and business rules. Use when working with payment code, transaction handling, refunds, disputes, or financial calculations.
---

# Payments Domain Expertise

## 核心概念

### 交易狀態

PENDING → AUTHORIZED → CAPTURED → SETTLED ↘ VOIDED AUTHORIZED → DECLINED CAPTURED → REFUNDED (partial or full) SETTLED → CHARGEBACK → REPRESENTED

### 金額處理規則
- 所有金額皆以整數儲存（以分為單位，而非元）
- 貨幣必須明確追蹤（絕不假設為美元）
- 捨入規則：計算時使用 HALF_EVEN，顯示時使用 HALF_UP
- 絕不使用浮點數處理金額

### 冪等性要求
每個支付操作都必須具備冪等性：
```typescript
// Required pattern
async function processPayment(idempotencyKey: string, amount: number) {
  const existing = await findByIdempotencyKey(idempotencyKey);
  if (existing) return existing; // Return cached result

  const result = await executePayment(amount);
  await storeWithIdempotencyKey(idempotencyKey, result);
  return result;
}

快速參考

手續費計算

  • 交換費：1.5% + $0.10（簽帳金融卡），2.1% + $0.10（信用卡）
  • 平台費用：2.9% + $0.30（標準），2.2% + $0.30（企業）
  • 國際交易：+1% 跨境手續費
  • 貨幣轉換：中間匯率 + 1%

合規門檻

  • $3,000：觸發加強盡職調查
  • $10,000：需申報貨幣交易報告（CTR）
  • $25,000：需要額外驗證

退款時限

  • 全額退款：自扣款日起120天內
  • 部分退款：自扣款日起180天內
  • 爭議退款時限：120天（Visa），180天（Mastercard）

關鍵檔案

  • src/payments/processor.ts — 核心支付邏輯
  • src/payments/refunds.ts — 退款處理
  • src/compliance/aml.ts — 反洗錢檢查
  • src/models/transaction.ts — 交易模型

詳細商業邏輯請參閱 BUSINESS_RULES.md。 法規要求請參閱 COMPLIANCE.md。 結構描述文件請參閱 DATA_MODELS.md。

有了這個 skill，Claude 在您處理交易程式碼、詢問退款邏輯或除錯支付流程時，會自動套用支付領域的專業知識。您不需要主動觸發任何操作——專業知識隨時待命。

### 建立有效的 Skills

**從描述開始。** 先撰寫描述，再根據描述建構 skill 內容。描述決定了 Claude 何時使用該 skill，因此務必精確：

1. 說明 skill 提供什麼
2. 列出具體觸發條件
3. 包含相關關鍵字和詞組

**保持 skills 聚焦。** 一個 skill 涵蓋一個領域或能力：

| 好的（聚焦） | 不好的（過於廣泛） |
|----------------|-----------------|
| `security-auditor` | `code-helper` |
| `react-patterns` | `frontend-stuff` |
| `postgres-optimization` | `database-expert` |
| `api-documentation` | `docs-generator` |

如果一個 skill 試圖涵蓋太多內容，其描述會變得模糊，Claude 將無法可靠地判斷何時該使用它。

**採用漸進式揭露。** 將最重要的資訊直接放在 SKILL.md 中，深入內容則透過參考檔案提供：

```markdown

## Quick Reference
[Essential patterns here - Claude sees this immediately]

## Deep Dive
For full coverage, see [DETAILED_GUIDE.md](DETAILED_GUIDE.md).

加入具體範例。 抽象描述不如具體模式來得實用：

## Input Validation

### Pattern
```typescript
// Good: Explicit validation with typed errors
const validated = PaymentSchema.safeParse(input);
if (!validated.success) {
  throw new ValidationError(validated.error.issues);
}

// Bad: Implicit coercion
const amount = Number(input.amount); // Silent NaN on invalid input

**用實際請求測試。** 建立 skill 後，測試 Claude 是否能正確啟用：

```text
> Review this payment processing code for issues
# Should activate payments-domain skill

> How should I handle refunds?
# Should activate payments-domain skill

> What's the weather like?
# Should NOT activate payments-domain skill

如果 Claude 未如預期啟用 skill，請修改描述以包含您使用的觸發詞組。

團隊分享策略

基於 Git 的分享（推薦用於專案 skills）：

# Add skill to project
mkdir -p .claude/skills/team-standard
# Create SKILL.md and supporting files

# Commit
git add .claude/skills/
git commit -m "Add team coding standards skill"
git push

# Teammates get it automatically
git pull
claude  # Skill now available

透過符號連結跨專案分享：

# Create canonical skill location
mkdir -p ~/shared-skills/security-reviewer
# Create SKILL.md

# Symlink into projects
ln -s ~/shared-skills/security-reviewer ~/.claude/skills/security-reviewer
# Now available in all your projects

Plugin 發佈方式： 若需更廣泛的發佈，可將 skills 打包為 plugins：

my-plugin/
├── .claude-plugin/
│   └── plugin.json
└── skills/
    └── my-skill/
        └── SKILL.md

打包在 plugins 中的 skills 會在使用者安裝 plugin 後自動可用。

除錯 Skills

Skill 未啟用：

  1. 檢查描述是否與您的請求相符： yaml # If you're saying "check this code" but description says "review" description: Review OR check code for issues...

  2. 確認檔案位置： ```bash # Personal ls ~/.claude/skills/my-skill/SKILL.md

# Project ls .claude/skills/my-skill/SKILL.md ```

  1. 驗證 YAML frontmatter：
  2. 第一行必須確切為 ---
  3. 在 markdown 內容前要有結束的 ---
  4. YAML 中不可使用 tab（請使用空格）

  5. name 欄位僅限小寫字母加連字號

  6. 以除錯模式執行： bash claude --debug # Watch for skill loading messages

Skill 意外啟用：

縮小描述範圍。如果您的 skill 在不應啟用時啟用了，代表描述過於廣泛：

# Too broad - activates on any "code" mention
description: Help with code

# Specific - activates only for security contexts
description: Audit code for security vulnerabilities including injection attacks, authentication flaws, and data exposure. Use when specifically asked about security, vulnerabilities, or when reviewing code for security issues.

找不到參考檔案：

  • 使用相對於 SKILL.md 位置的相對路徑
  • 僅使用正斜線（即使在 Windows 上）
  • 確認檔案確實存在：ls .claude/skills/my-skill/REFERENCED.md

何時建立 Skill

適合建立 skill 的情況： - 領域專業知識需自動啟用 - 多位團隊成員需要相同知識 - 您反覆解釋相同的模式或規則 - 上下文需在無明確觸發的情況下注入 - 知識橫跨多個檔案且需要組織

不適合建立 skill 的情況： - 您想要明確控制觸發時機（使用 slash command） - 任務需要獨立上下文（使用 subagent） - 只是一次性的提示（直接輸入即可） - 該「skill」實際上只是單一範本（使用 slash command）

進階技巧： 如果您發現自己在處理認證程式碼前反覆輸入 /security-review，請將其轉換為 skill。讓專業知識成為環境感知的，而非需要明確觸發的。如果您需要明確觸發，則保留為 command。

Plugin 系統

Plugins 將 Claude Code 擴充功能打包以便發佈。一個 plugin 可包含自訂 commands、subagents、skills、hooks 和 MCP 伺服器。Anthropic 於2025年12月正式推出 plugin marketplace，提供36個精選 plugins。47

Plugin 結構

my-plugin/
├── .claude-plugin/
│   └── plugin.json              # Required: metadata
├── commands/                     # Slash commands
│   └── hello.md
├── agents/                       # Subagents
│   └── helper.md
├── skills/                       # Skills
│   └── my-skill/
│       └── SKILL.md
├── hooks/                        # Event handlers
│   └── hooks.json
└── .mcp.json                     # MCP servers

Plugin 清單檔

最小化的 plugin.json：

{
  "name": "my-plugin",
  "description": "What this plugin does",
  "version": "1.0.0",
  "author": {
    "name": "Your Name"
  }
}

Plugin 管理

> /plugin                              # Interactive interface
> /plugin install name@marketplace     # Install
> /plugin enable name@marketplace      # Enable
> /plugin disable name@marketplace     # Disable
> /plugin uninstall name@marketplace   # Remove
> /plugin marketplace add ./local      # Add local marketplace
> /plugin marketplace list             # View marketplaces

本地開發

建立本地 marketplace 進行測試：

mkdir dev-marketplace && cd dev-marketplace
mkdir my-plugin
# Create plugin structure

cd ..
claude
> /plugin marketplace add ./dev-marketplace
> /plugin install my-plugin@dev-marketplace

Plugin 安裝改進（v2.1.51+）

Plugins 現在支援從 npm 來源安裝時使用自訂 npm registry 和特定版本鎖定。marketplace 操作的預設 git 逾時時間已從30秒增加至120秒，可透過 CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS 進行設定。105

Plugin 元件

  • Commands：以 slash commands 形式提供（/plugin-command）
  • Agents：顯示在 /agents 列表中
  • Skills：根據 skill 設定自動載入
  • Hooks：與使用者/專案 hooks 合併，並行執行
  • MCP 伺服器：Plugin 啟用時自動啟動

記憶功能如何運作？

Claude Code 的記憶系統可在不同工作階段之間維持持續的上下文。有效的記憶管理是 Claude 深入理解您的專案與將每次工作階段視為全新開始之間的關鍵差異。

CLAUDE.md 層級架構

位置 範圍 共享 使用場景
/Library/Application Support/ClaudeCode/CLAUDE.md（macOS） 企業 所有使用者 公司標準
./CLAUDE.md 或 ./.claude/CLAUDE.md 專案 透過 git 團隊上下文
~/.claude/CLAUDE.md 使用者 所有專案 個人偏好
./CLAUDE.local.md 專案本地 永不 個人專案筆記

有效的 CLAUDE.md 結構

# Project Context

## 架構
- 使用 /packages 中的套件的 Monorepo
- React 前端位於 /packages/ui
- Node.js API 位於 /packages/api
- 共用型別位於 /packages/types
- 透過 Prisma 連接 PostgreSQL 資料庫

## 程式碼標準
- 所有地方皆使用 TypeScript 嚴格模式
- 強制使用 ESLint + Prettier（pre-commit hooks）
- 禁止使用 default exports
- 所有公開 API 皆需 JSDoc 註解
- 所有新程式碼皆需撰寫測試

## 指令
- `npm test` - 執行所有測試
- `npm run test:watch` - 監看模式
- `npm run lint` - 檢查 linting
- `npm run lint:fix` - 自動修正 lint 問題
- `npm run build` - 正式環境建置
- `npm run dev` - 啟動開發伺服器
- `npm run db:migrate` - 執行資料庫遷移
- `npm run db:seed` - 填入種子資料

## 模式

### API 端點
建立於 packages/api/src/routes/
使用 Zod 進行請求/回應驗證
所有端點皆需 OpenAPI 文件

### React 元件
建立於 packages/ui/src/components/
使用 React Query 管理伺服器狀態
優先採用組合而非繼承

### 資料庫
Prisma schema 位於 packages/api/prisma/
Schema 變更時務必建立遷移檔案
多資料表操作使用交易（transactions）

## 重要注意事項
- 絕對不要提交 .env 檔案
- API 執行於 :3000，UI 執行於 :3001
- 本機資料庫：postgres://localhost:5432/myapp
- 功能旗標位於 packages/api/src/flags.ts

## 近期決策
- 2025-12-01：遷移至 React Query v5
- 2025-11-15：全面採用 Zod 進行驗證
- 2025-11-01：轉換為 ESM 模組

# 摘要指示
使用 compact 時，請著重於：
- 近期程式碼變更
- 測試結果
- 本次工作階段中做出的架構決策

檔案匯入

在 CLAUDE.md 中引用其他檔案：

See @README.md for project overview
Coding standards: @docs/STYLE_GUIDE.md
API documentation: @docs/API.md
Personal preferences: @~/.claude/preferences.md

匯入語法： - 相對路徑：@docs/file.md - 從專案根目錄的絕對路徑：@/absolute/path.md - 家目錄：@~/.claude/file.md - 最大深度：5 層匯入

記憶規則目錄

如需更有組織的記憶管理，可使用 .claude/rules/ 儲存分類的規則檔案：18

.claude/rules/
├── testing.md          # Testing conventions
├── security.md         # Security requirements
├── api-patterns.md     # API design patterns
└── deployments.md      # Deployment procedures

規則會自動載入，提供結構化的上下文，而不會讓 CLAUDE.md 變得雜亂。

快速新增記憶

使用 # 前綴在工作階段中新增筆記：

# Always run tests before committing
# The payment module is especially fragile
# Use the new logger from packages/api/src/logger.ts

系統會提示您選擇要將筆記儲存到哪個記憶檔案中。

自動記憶（v2.1.32+）

Claude Code 現在會自動記錄並在跨工作階段中回想專案上下文。87 在您工作的過程中，Claude 會將觀察到的內容（模式、慣例、除錯洞察、關鍵檔案路徑）寫入持久化的記憶檔案：

~/.claude/projects/{project-path}/memory/MEMORY.md

您會在工作階段開始時看到 Recalled memories，以及在工作階段中看到 Wrote memories。自動記憶與 # 前綴的差異如下：

自動記憶 # 前綴
觸發方式 Claude 隱式決定 您明確決定
內容 模式、慣例、架構 特定事實或指示
儲存位置 MEMORY.md（自動管理） 使用者選擇的記憶檔案
編輯方式 Claude 管理；您可以直接編輯檔案 由您控制儲存內容

自動記憶會始終載入到您的系統提示中（前 200 行）。請保持簡潔——建立獨立的主題檔案（例如 debugging.md、patterns.md）並從 MEMORY.md 連結，以記錄詳細筆記。

管理自動記憶（v2.1.59+）： 使用 /memory 直接在 Claude Code 中檢視和管理自動記憶檔案。107 這取代了先前 /memory 僅開啟 CLAUDE.md 編輯器的行為。您現在可以檢閱、編輯和整理 Claude 記住的內容。

記憶時間戳記（v2.1.75+）： 記憶檔案現在包含最後修改時間戳記，幫助 Claude 判斷哪些記憶是新鮮的、哪些是過時的。這透過在自動回想時降低過時記憶的優先順序來改善上下文品質。124

若要停用，請在啟動時傳入 --no-memory（停用所有記憶，包括 CLAUDE.md）。目前沒有可以僅停用自動記憶但保留 CLAUDE.md 的選項（這是一個已提出的功能需求）。

上下文管理指令

檢視上下文使用狀況：

> /context

顯示系統提示、對話、工具和檔案內容的上下文配置視覺化圖表。

壓縮對話：

> /compact
> /compact focus on the authentication changes
> /compact preserve test output and error messages

智慧地摘要較舊的對話內容，同時保留關鍵資訊。

自訂壓縮指示（在 CLAUDE.md 中）：

# Summary Instructions
When using compact, focus on:
- Test output and failures
- Code changes made this session
- Architecture decisions

擴展思考以增加上下文：

export MAX_THINKING_TOKENS=10000

更多思考 token 意味著更強的推理能力，但成本也更高。

上下文最佳化策略

  1. 使用具體的檔案引用，而非要求 Claude 搜尋
  2. 在不同任務之間使用 /clear 清除無關對話
  3. 在長時間工作階段中主動壓縮
  4. 使用 subagents 隔離探索性工作
  5. 將複雜任務拆解為聚焦的互動
  6. 恢復工作階段以繼續進行中的工作，而非重新說明

圖片與多模態輸入

Claude Code 可以分析圖片：螢幕截圖、圖表、設計稿、錯誤訊息、資料庫結構圖。

輸入方式

  1. 拖放：將圖片檔案拖放到 Claude Code 視窗中
  2. 貼上：使用 Ctrl+V（Mac 上不是 Cmd+V）從剪貼簿貼上
  3. 路徑引用：「分析這張圖片：/path/to/screenshot.png」

檢視附加圖片

當 Claude 在回應中引用圖片時，可點擊的圖片連結允許直接檢視：34

[Image #1]   # Click to open in default image viewer
[Image #2]   # Navigate attached screenshots

可點擊的連結在檢閱螢幕截圖或除錯視覺問題時非常有用。點擊引用即可查看 Claude 分析的確切內容。

使用情境

  • 除錯 UI 問題：「這是錯誤的螢幕截圖，是什麼原因造成的？」
  • 實作設計：「根據這個設計稿建構這個元件」
  • 分析圖表：「解釋這張架構圖」
  • 資料庫結構：「根據這個 ERD 建立 Prisma 模型」
  • 錯誤分析：「這個錯誤截圖是什麼意思？」

專家提示： 從設計稿實作時，附上多張顯示不同狀態的螢幕截圖（預設、懸停、載入中、錯誤）。提供越多視覺上下文，實作效果越好。

PDF 閱讀（v2.1.30+）

Claude Code 可以閱讀和分析 PDF 文件，並支援頁面層級的控制：83

基本 PDF 閱讀：

> Analyze this PDF: /path/to/document.pdf

閱讀指定頁面範圍：

> Read pages 1-5 of the PDF: /path/to/report.pdf

或透過 Read 工具的 pages 參數以程式化方式使用： - pages: "1-5" - 閱讀第 1 至第 5 頁 - pages: "1,3,7" - 閱讀指定頁面 - pages: "10-" - 從第 10 頁閱讀至結尾

限制： - 每次請求最多 100 頁 - 最大檔案大小 20MB - 超過 10 頁的大型 PDF 在使用 @ 提及時會回傳輕量級引用，完整內容則按需載入

語音模式（2026年3月）

語音模式將 Claude Code 變成一個可以用語音交談而非打字的結對程式設計夥伴。透過 /voice 啟用，它使用按住說話的方式精確控制何時擷取語音。118

啟用

> /voice           # Start voice mode

或在 settings.json 中設定 voiceEnabled: true，以在工作階段開始時自動啟用。

運作方式

按住空白鍵說話，放開即送出。Claude 會處理您的語音並如同您輸入提示一樣回應。按住說話的設計避免了在撰寫程式碼時意外觸發。

支援語言（共 20 種，v2.1.69+）

英語、西班牙語、法語、德語、葡萄牙語、義大利語、日語、韓語、中文、印地語、俄語、波蘭語、土耳其語、荷蘭語、烏克蘭語、希臘語、捷克語、丹麥語、瑞典語、挪威語。117

推出狀態

語音模式於2026年3月3日推出。逐步推出中（初始約 5%，隨後數週逐步擴大）。完全推出後所有訂閱方案皆可使用。118

最適合的使用場景

  • 在白板上繪圖時描述高階架構
  • 口述提交訊息和 PR 描述
  • 以對話方式解釋錯誤，同時雙手保持在鍵盤上
  • 快速委派任務：「執行測試套件並修正所有失敗的測試」

Git 整合如何運作？

Claude Code 具備深度的 git 整合功能，並內建安全協定。

安全協定

  • 自動遵循 .gitignore
  • 未經許可不會修改分支
  • 提交前顯示差異比較
  • 遵循專案的提交慣例
  • 未經明確要求絕不強制推送
  • 修改提交前檢查作者資訊

常見工作流程

建立提交：

> commit these changes
> create a commit with a meaningful message

Claude 會： 1. 執行 git status 和 git diff 2. 分析變更內容 3. 產生符合慣例的提交訊息 4. 等待核准後再提交

建立拉取請求：

> create a PR for this feature
> summarize the changes and create a PR

審查程式碼：

> review the changes in this PR
> what could go wrong with these changes?

GitHub Actions 整合

透過官方 action 在 CI/CD 中自動化 Claude：

快速設定：

> /install-github-app

手動工作流程檔案：

name: Claude Code Review
on:
  pull_request:
    types: [opened, synchronize]
  issue_comment:
    types: [created]

jobs:
  claude-review:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "Review this PR for bugs, security issues, and performance problems"
          claude_args: "--max-turns 5"

適用於 Bedrock（搭配 OIDC）：

- name: Configure AWS
  uses: aws-actions/configure-aws-credentials@v4
  with:
    role-to-assume: ${{ secrets.AWS_ROLE_TO_ASSUME }}
    aws-region: us-west-2

- uses: anthropics/claude-code-action@v1
  with:
    use_bedrock: "true"
    claude_args: '--model us.anthropic.claude-sonnet-4-5-20250929-v1:0'

Code Review [研究預覽]（2026年3月）

Code Review 是 Anthropic 的多代理系統，能自動審查拉取請求以捕捉人類審查者可能遺漏的錯誤。當開啟 PR 時，一組代理會平行派送——各自從不同角度檢查程式碼庫——然後交叉驗證結果以過濾誤報，並依嚴重程度排序問題。結果以單一總覽留言加上行內標註的形式呈現。120

可用性： 研究預覽版，適用於 Claude for Teams 和 Claude for Enterprise 客戶（2026年3月9日）。

運作方式： 1. 開發者開啟一個 PR 2. 多個 AI 代理平行分析程式碼 3. 代理互相交叉驗證發現 4. 最終代理彙總、去重並依嚴重程度排序 5. 結果以 PR 留言形式發布（總覽 + 行內標註）

效能指標（Anthropic 內部數據）：

指標 數值
大型 PR（1,000+ 行）收到發現 84%（平均 7.5 個問題）
小型 PR（<50 行）收到發現 31%（平均 0.5 個問題）
人類不同意率 不到 1% 的發現被標記為不正確
平均審查時間 約 20 分鐘
實質性 PR 留言 54% 的 PR（從 16% 提升）

費用： 每次審查 $15–25 美元，依 PR 大小和複雜度調整。組織可透過每月支出上限、儲存庫層級啟用和分析儀表板來管理開支。120

設定： 管理員在 Claude Code 設定中啟用此功能，安裝 GitHub App，並選擇目標儲存庫。開發者無需設定——一旦啟用，新 PR 會自動執行審查。

與 GitHub Action 的主要差異： 開源的 claude-code-action（如上所述）以單一 Claude 實例搭配提示詞運行。Code Review 則派送多代理團隊進行更深入的分析。人類核准仍為必要——Code Review 提供資訊但絕不核准合併。120

如何在 IDE 中使用 Claude Code？

VS Code 擴充功能

需求： VS Code 1.98.0+

安裝： 在擴充功能市集中搜尋「Claude Code」

功能： - 側邊欄面板（Spark 圖示） - 活動列中的工作階段列表，工作階段以完整編輯器開啟（v2.1.70+）116 - 計畫的完整 markdown 文件檢視，支援留言功能（v2.1.70+）116 - 透過聊天面板中的 /mcp 提供原生 MCP 伺服器管理對話框（v2.1.70+）116 - 壓縮顯示為可摺疊的「Compacted chat」卡片（v2.1.69+）117 - 計畫模式搭配差異預覽 - 自動接受編輯切換 - 延伸思考切換 - 檔案附加和圖片貼上 - 對話歷史記錄 - 多個同時工作階段

安全注意事項： Anthropic 已修補 IDE 擴充功能 v1.0.24+ 中的 WebSocket 驗證繞過漏洞（CVE-2025-52882）。請確保您的擴充功能已更新；Anthropic 已從擴充功能商店中移除所有存在漏洞的版本。38

第三方供應商設定（在 .claude/settings.json 中）：

{
  "env": {
    "CLAUDE_CODE_USE_BEDROCK": "1",
    "AWS_REGION": "us-east-1",
    "AWS_PROFILE": "your-profile"
  }
}

JetBrains 外掛

支援： IntelliJ IDEA、PyCharm、WebStorm、GoLand、PhpStorm、DataGrip

安裝： Settings → Plugins → 搜尋「Claude Code」→ Install → 重新啟動

快捷鍵： - Cmd+Esc（Mac）/ Ctrl+Esc（Windows）：快速啟動 - Cmd+Option+K（Mac）/ Alt+Ctrl+K（Windows）：新增檔案參考

功能： - 在 IDE 差異檢視器中查看差異 - 自動分享選取內容的上下文 - 診斷整合 - 多個工作階段

WSL2 設定： 將 Claude 命令設為：

wsl -d Ubuntu -- bash -lic "claude"

終端機整合

將外部終端機連接到您的 IDE：

> /ide

Claude Code 會自動偵測 VS Code、Cursor、Windsurf 和 JetBrains IDE。

Slack 整合（2025年12月）

Claude Code 現已直接與 Slack 整合，讓開發者能從聊天對話中委派程式碼任務。14

運作方式： 1. 在 Slack 頻道或對話串中提及 @Claude 2. Claude 審查訊息以判斷是否為程式碼任務 3. Claude Code 工作階段自動在 Anthropic 基礎設施上啟動 4. Claude 從近期頻道/對話串訊息中收集上下文 5. 進度更新會回傳到您的 Slack 對話串 6. 完成後提供審查變更和開啟 PR 的連結

使用情境： - 從 Slack 中發布的錯誤報告進行錯誤調查 - 根據團隊回饋進行快速程式碼審查 - 從功能需求實作小型功能

需求： - 透過 Slack App Marketplace 安裝 Claude 應用程式 - 付費 Slack 方案 - 存取網頁版 Claude Code

隱私： Claude 遵循 Slack 現有的權限結構。它無法存取您未被授權查看的對話或儲存庫。對話內容不會用於模型訓練。

進階使用模式

無介面和 CI 模式

在腳本和 CI 管線中執行 Claude Code：

#!/bin/bash
# Automated code review

result=$(claude -p "Review this code for quality issues" \
  --output-format json \
  --allowedTools "Read,Grep,Glob" \
  --permission-mode plan \
  --disable-slash-commands \
  --max-turns 5)

if echo "$result" | jq -e '.result | test("critical|high severity")' > /dev/null; then
  echo "Issues found:"
  echo "$result" | jq -r '.result'
  exit 1
fi

echo "Review passed"
exit 0

管道和鏈接

# Analyze logs
cat production.log | claude -p "summarize errors" > error-summary.md

# Process multiple files
find . -name "*.ts" -exec cat {} \; | claude -p "find security issues"

# Chain with jq
claude -p "generate config" --output-format json | jq -r '.result' > config.json

背景任務

執行長時間操作而不阻塞：

> start the build in the background

或在命令執行期間按 Ctrl+B。

管理背景任務：

> /bashes                    # List running tasks
> get output from task xyz   # Retrieve output

使用 Git Worktrees 進行平行工作階段

# Create worktrees for parallel work
git worktree add ../project-feature-a -b feature-a
git worktree add ../project-bugfix bugfix-123

# Run Claude in each worktree (separate project dirs = separate sessions)
cd ../project-feature-a && claude
cd ../project-bugfix && claude

每個 worktree 都是獨立的專案目錄，擁有自己的工作階段。

JSON 輸出解析

result=$(claude -p "analyze this code" --output-format json)

# Extract fields
echo "Result: $(echo $result | jq -r '.result')"
echo "Cost: $(echo $result | jq -r '.total_cost_usd')"
echo "Session: $(echo $result | jq -r '.session_id')"
echo "Duration: $(echo $result | jq -r '.duration_ms')ms"

程式化工作階段管理

# Name the current session for easy recall (inside Claude: /rename feature-auth)
# Then resume by name later:
claude --resume "feature-auth"

# Continue most recent session
claude -c "continue implementing the tests"

# List recent sessions to find one (shows up to 50 sessions, v2.1.47+)
claude --resume          # interactive picker

## 遠端與背景代理 [研究預覽]

Claude Code透過兩項互補功能將能力延伸至本機終端之外：**遠端**（雲端執行搭配本機傳送）與**背景代理**（平行任務執行，不阻塞您的終端）。兩者皆使用`&`前綴，並共享相同的雲端基礎架構。

### 核心概念

[claude.ai/code](https://claude.ai/code)的網頁介面可在雲端執行Claude Code。任務會在您離開終端時於背景執行。當您準備好繼續時，可將工作階段傳送至本機，從Claude上次停止的地方接續。

遠端執行實現了過去無法達成的工作流程：
- 在手機上啟動複雜的重構任務，通勤途中讓它執行，然後在工作站上完成
- 在網頁介面上排定多項任務，回到座位時再檢視結果
- 當您需要關閉筆電時，將長時間執行的作業交給雲端處理

### `&`前綴

將任務發送至Claude Code網頁版於背景執行：

& Build a complete REST API for user management with authentication, CRUD operations, and proper error handling

`&`前綴會將您的提示詞派送至雲端。Claude會非同步地處理它。您可以關閉終端、切換裝置，或繼續進行其他工作。claude.ai/code的網頁介面會顯示您正在執行和已完成的工作階段。

### `--teleport`旗標

將雲端工作階段拉取至您的本機終端：

```bash
claude --teleport session_abc123

此旗標會從網頁擷取工作階段狀態並在本機恢復。您會取得完整的對話歷史記錄、Claude修改過的所有檔案，並能如同您一直在場般繼續互動。

工作階段ID會顯示在網頁介面中。點擊任何工作階段即可查看其ID和目前狀態。

需求條件

Claude Code遠端功能適用於Pro、Max、Team（進階席位）及Enterprise（進階席位）訂閱者。73網頁介面執行於Anthropic的基礎架構上，執行與您在本機相同的Claude Code功能（檔案操作、bash指令、MCP整合），但在受管理的雲端環境中。Anthropic於2026年1月擴展了Team和Enterprise的存取權限；帳戶管理員可在Claude設定中切換存取權限。

iOS應用程式（2025年11月）：Claude Code也可在Claude iOS應用程式上使用，讓您在外出時啟動編碼任務，並從手機監控代理進度。22您可以在離開座位時啟動任務，之後準備好檢視時再將它們傳送至終端。

遠端控制（2026年2月）：一項工作階段行動性功能，讓您可以從手機、平板電腦或任何瀏覽器繼續本機的Claude Code工作階段。工作階段狀態——檔案參照、對話歷史記錄、工具設定、待處理操作——透過加密通道作為單一原子單元移動。以研究預覽形式提供給Max使用者（v2.1.58擴展了更多使用者的存取權限）。使用claude remote-control子指令（v2.1.51+）進行外部建置。108

實用工作流程

早晨通勤：

& Review all PRs assigned to me and prepare summaries with recommendations

在辦公桌前：

# Check what completed
# Visit claude.ai/code to see session list

# Pull the session locally to review and act on recommendations
claude --teleport pr-review-session-xyz

下班前：

& Run the full test suite, fix any failures, and prepare a summary of what was changed

隔天早晨：

claude --teleport test-fixes-session-abc
# Review what Claude did overnight, make final adjustments

Claude Code Security [研究預覽]（2026年2月）

Claude Code Security是內建於網頁版Claude Code的弱點掃描功能。104它會掃描程式碼庫中的安全弱點，並建議針對性的修補程式供人工審查。

可用性：提供給Enterprise、Team及開源維護者的有限研究預覽。

運作方式： 1. 將Claude Code Security指向一個儲存庫 2. 它會掃描程式碼庫中的弱點 3. 結果包含具體的修補建議供審查 4. 套用變更前需要人工審查

此功能利用了Opus 4.6已展現的能力，可直接在開源程式碼中發現500多個零日弱點。86

目前狀態

Claude Code遠端功能目前處於研究預覽階段。隨著Anthropic收集回饋，此功能預計會持續演進。核心工作流程（雲端執行搭配本機傳送）實現了持續的AI開發：Claude在您離開鍵盤時持續工作，而您可以從它停止的地方精確接續。

目前限制：工作階段傳送目前僅為單向：您可以將網頁工作階段拉取至終端，但無法將現有的終端工作階段推送至網頁。目前也無法在遠端機器（例如透過SSH連線的AWS執行個體）上繼續本機工作階段。

背景代理

背景代理在您繼續工作時執行，無需等待長時間執行的任務完成。17

背景代理的運作方式：

背景代理不會在Claude執行複雜任務時阻塞您的終端，而是： 1. 在獨立的處理程序中獨立執行 2. 即使您關閉終端也會繼續工作 3. 完成時透過通知回報結果 4. 可在執行期間進行監控和管理

啟動背景代理

使用Ctrl+B： 當Claude正在工作時，按下Ctrl+B將目前的任務發送至背景。您的終端將立即可用。

使用&前綴：

& Run all tests and fix any failures
& Refactor the authentication module to use JWT
& Generate complete API documentation

&前綴會派送至Claude Code遠端（雲端執行）。若要進行本機背景執行，請在已執行的任務上使用Ctrl+B。

監控背景任務

> /tasks                    # List all running tasks
> /task status abc123       # Check specific task
> /task cancel abc123       # Stop a task
> /task output abc123       # View task output so far

平行背景工作流程

同時執行多個代理：

& Fix all failing tests in src/
& Update documentation for the API module
& Run security scan on the codebase

每個代理獨立執行。使用/tasks監控進度，並在完成時拉取結果。

Claude in Chrome（2025年12月）

Claude Code現在透過Claude in Chrome擴充功能與您的瀏覽器整合，讓您可以直接從終端控制瀏覽器。24

前置需求

  • Chrome或基於Chromium的瀏覽器（Edge、Brave、Arc皆可使用）
  • Claude Code v2.0+在終端中執行
  • Pro、Max、Team或Enterprise方案（擴充功能不適用於Free方案）
  • 從https://claude.ai/chrome安裝Chrome擴充功能

設定

  1. 從https://claude.ai/chrome安裝Chrome擴充功能
  2. 收到提示時授予擴充功能權限（瀏覽器控制需要頁面存取權限）
  3. 啟動Claude Code——整合會透過本機WebSocket自動偵測
  4. 使用自然語言控制您的瀏覽器

擴充功能透過本機WebSocket連線與Claude Code通訊。兩者必須同時執行。

功能

從終端進行瀏覽器自動化：

> Navigate to github.com and open my repositories
> Fill out this form with the test user data
> Take a screenshot of the current page
> Click the submit button and wait for the page to load

網頁擷取與測試：

> Extract all product prices from this e-commerce page
> Run through the signup flow and report any issues
> Check if the mobile menu works correctly

使用情境

  • 端對端測試：直接從Claude Code執行整合測試
  • 網頁擷取：無需撰寫瀏覽器自動化程式碼即可從頁面擷取資料
  • 表單填寫：自動化重複性的網頁工作流程
  • 視覺驗證：截圖並分析頁面佈局

Chrome整合在您現有的瀏覽器工作階段中執行，可存取您已登入的狀態和Cookie，這對測試需要身份驗證的流程非常實用。

限制

  • 不支援多分頁：Claude僅控制使用中的分頁；無法同時跨多個分頁協調操作
  • JavaScript對話框會阻塞執行：alert()、confirm()和prompt()對話框會暫停擴充功能——請避免在自動化流程中觸發它們
  • 無法存取無痕模式，除非您明確在無痕模式中啟用該擴充功能
  • WebSocket連線：如果Claude Code重新啟動，Chrome擴充功能必須重新連線（通常在幾秒內自動完成）
  • 使用read_page從無障礙樹取得元素參照；使用ref而非座標進行互動

Claude Code in Slack（2025年12月）[研究預覽]

Anthropic推出了Claude Code in Slack，讓開發者可以直接從聊天對話串中委派程式碼任務。26

運作方式

  1. 在任何Slack頻道或對話串中標記@Claude
  2. 描述程式碼任務並提供背景資訊
  3. Claude分析Slack訊息以判斷對應的儲存庫
  4. 進度更新會顯示在對話串中
  5. Claude分享審查工作和開啟PR的連結

工作流程範例

@Claude The login form validation is broken on mobile devices.
Can you fix it? Check the bug report from earlier in this thread.

Claude會： 1. 閱讀對話串以了解脈絡 2. 識別相關的儲存庫 3. 複製並分析程式碼庫 4. 發布進度更新 5. 建立包含修復的PR 6. 分享PR連結以供審查

優點

  • 情境感知：Claude讀取Slack歷史紀錄中的錯誤報告、功能需求和討論
  • 團隊可見性：對話串中的進度更新讓所有人保持同步
  • 低摩擦：不需要終端機或IDE；直接從聊天開始
  • GitHub整合：自動建立附帶適當描述的PR

前置條件

  • 已安裝Claude應用程式的Slack工作區（工作區管理員必須核准）
  • 連接至Slack工作區的GitHub儲存庫
  • Pro、Max、Team或Enterprise方案
  • Claude必須擁有目標儲存庫的寫入權限（建立分支、建立PR）

限制

  • 儲存庫偵測：Claude從Slack情境（頻道主題、近期訊息、對話串內容）推斷儲存庫。若有歧義，請明確指定儲存庫：@Claude in repo org/my-app, fix the login bug
  • 無法存取本機檔案：Slack Claude完全在雲端執行——它會複製儲存庫、進行變更並建立PR，無法存取您的本機檔案系統
  • 對話串情境視窗：Claude讀取目前對話串，但對其他頻道或私訊的情境有限
  • 審核流程：所有變更都經過PR審查——Claude絕不會直接推送至main
  • 速率限制：受您方案的Claude Code使用量限制（與CLI和網頁使用量共享）

Slack整合目前為Pro、Max、Team和Enterprise使用者的研究預覽階段。

Claude Code on the Web [研究預覽]（2026年1月）

Claude Code on the web讓您可以從瀏覽器在claude.com/code委派程式碼任務，執行於Anthropic管理的雲端基礎設施上。73這是不需要終端機的Claude Code——指派任務、追蹤進度，然後取得Pull Request。

主要功能

  • 平行任務執行：從單一介面同時在不同儲存庫啟動多個程式碼任務
  • 即時進度追蹤：觀看Claude透過即時更新處理任務；可在過程中重新引導其方向
  • 自動建立PR：Claude產生附帶清晰變更摘要的Pull Request
  • 會話傳送：使用claude --teleport將網頁會話拉到本機終端機繼續工作
  • 行動裝置存取：早期階段的iOS應用程式讓您可以從手機指派和監控程式碼任務73

安全架構

任務在具有網路和檔案系統限制的隔離沙箱環境中執行。Git互動透過安全代理進行，將儲存庫存取限制在已授權的儲存庫。管理員可以設定Claude能存取的網域（例如，允許下載npm套件以進行測試）。73

可用性

方案 存取權限
Pro / Max 已包含
Team / Enterprise 需要Premium席位

雲端會話與所有其他Claude Code使用量（CLI、IDE、Slack）共享速率限制。

Web與終端機：何時使用哪個

情境 使用Web 使用終端機
錯誤積壓分類 平行指派5個錯誤 —
離開辦公桌時的快速修復 從手機指派 —
複雜的架構工作 — 完整程式碼庫情境
自訂hooks和MCP — 完整擴充層
夜間批次工作 睡前指派，早上審查 &背景代理

目前限制：會話傳送是單向的——您可以將網頁會話拉到終端機，但無法將終端機會話推送至網頁。73

效能最佳化

降低延遲

模型選擇： - Haiku：最快回應，最低成本 - Sonnet：良好的平衡 - Opus：最佳品質，最高延遲

串流： 所有回應預設為串流輸出，因此您可以在產生時即時看到輸出。

提示快取： 預設啟用。針對重複的情境（系統提示、工具定義）降低延遲。

快取策略

Claude Code自動快取系統提示和工具定義： - 快取持續時間：5分鐘（暫時性） - 快取命中：減少輸入token數量並加速回應

多輪對話會快取前幾輪的思考區塊。

如需針對特定模型停用快取：

export DISABLE_PROMPT_CACHING_SONNET=1
export DISABLE_PROMPT_CACHING_OPUS=1
export DISABLE_PROMPT_CACHING_HAIKU=1

平行操作

Subagent平行化： 多個subagent可以同時執行。每個都獨立運作，不會污染主要情境。

背景bash： 長時間執行的指令不會阻塞對話：

> run the full test suite in the background

Git worktrees（v2.1.49+）： 在隔離的git worktree中啟動Claude，進行平行工作而不影響您的主要工作目錄：

claude --worktree            # or -w; creates worktree in .claude/worktrees/
claude -w --name feature-x   # Named worktree

Subagent也支援在其定義中使用isolation: "worktree"，為每個subagent提供隔離的儲存庫副本，若未進行任何變更則自動清理。103ExitWorktree工具允許代理以程式方式離開worktree會話（v2.1.72+）。121對於非git版本控制系統，可設定WorktreeCreate/WorktreeRemove hooks來處理自訂的設定和清除。103

單一儲存庫的稀疏worktrees（v2.1.76+）：worktree.sparsePaths設定為大型單一儲存庫中的worktrees啟用git sparse-checkout，僅檢出您指定的路徑，而非整個儲存庫：125

{
  "worktree": {
    "sparsePaths": ["packages/my-service", "shared/utils"]
  }
}

跨worktrees的共享狀態（v2.1.63+）：專案設定（.claude/settings.json）和自動記憶現在可在同一儲存庫的git worktrees之間共享。在一個worktree中對設定或記憶的變更會在所有其他worktree中可見。111

記憶體最佳化

  • 指定具體檔案參考：使用@src/auth.ts而非「找到auth檔案」
  • 針對性搜尋：使用「在src/api中搜尋」而非「搜尋所有地方」
  • 全新會話：在不相關的任務之間使用/clear
  • 自訂壓縮：在CLAUDE.md中加入要保留內容的指示
  • 工具結果磁碟持久化（v2.1.51+）：大於50K字元的工具結果現在會持久化至磁碟（從100K降低），減少情境視窗使用量並改善長時間會話的對話持續性105
  • BashTool登入shell略過（v2.1.51+）：BashTool現在在有shell快照可用時預設略過登入shell的-l旗標，改善指令執行效能。先前需要設定CLAUDE_BASH_NO_LOGIN=true105

如何除錯問題？

安裝問題

WSL 路徑問題：

npm config set os linux
npm install -g @anthropic-ai/claude-code --force --no-os-check
which npm  # Should start with /usr not /mnt/c

Node 版本衝突（nvm）： 在 ~/.bashrc 或 ~/.zshrc 中加入：

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

權限錯誤： 使用原生安裝方式取代 npm：

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

驗證問題

# Complete reset
/logout
rm -rf ~/.config/claude-code/auth.json
claude  # Fresh login

效能問題

CPU/記憶體使用過高： - 使用 /compact 來縮減上下文 - 在重大任務之間重新啟動 - 將大型目錄加入 .gitignore - 執行 claude doctor

搜尋速度緩慢： 安裝系統層級的 ripgrep：

# macOS
brew install ripgrep

# Windows
winget install BurntSushi.ripgrep.MSVC

# Linux
sudo apt install ripgrep

然後：

export USE_BUILTIN_RIPGREP=0

WSL 上執行緩慢： - 將專案移至 Linux 檔案系統（而非 /mnt/c/） - 在搜尋時使用特定目錄篩選器

IDE 整合問題

JetBrains 未偵測到（WSL2）：

選項 1 - Windows 防火牆：

wsl hostname -I  # Get WSL IP
New-NetFirewallRule -DisplayName "Allow WSL2" -Direction Inbound -Protocol TCP -Action Allow -RemoteAddress 172.21.0.0/16

選項 2 - 鏡像網路（在 ~/.wslconfig 中加入）：

[wsl2]
networkingMode=mirrored

然後執行：wsl --shutdown

JetBrains 中 Escape 鍵無法使用： Settings → Tools → Terminal → 取消勾選「Move focus to the editor with Escape」

驗證管理（v2.1.41+）

claude auth login                # Log in or switch accounts
claude auth status               # Check current authentication state
claude auth logout               # Log out and clear stored credentials

當在 API 金鑰與 OAuth 之間切換，或在不同組織之間切換時，請使用 claude auth logout && claude auth login 來重設驗證。

除錯模式

claude --debug                    # Full debug output
ANTHROPIC_LOG=debug claude       # API request logging
claude doctor                    # Health check
/debug                           # Troubleshoot current session (v2.1.30+)

/debug 指令（v2.1.30+）提供工作階段特定的診斷資訊，包括： - 目前的模型和上下文使用量 - 啟用中的 MCP 伺服器及其狀態 - 權限狀態及最近的拒絕記錄 - 記憶體壓力指標

設定重設

# Reset user settings
rm ~/.claude.json
rm -rf ~/.claude/

# Reset project settings
rm -rf .claude/
rm .mcp.json

常見錯誤訊息

錯誤 原因 解決方案
“Rate limit exceeded” 請求過於頻繁 等待或降低頻率
“Context length exceeded” 對話過長 使用 /compact 或 /clear
“Authentication failed” 權杖無效或已過期 執行 claude auth login
“Tool not permitted” 權限被拒絕 檢查 settings.json 權限設定
“MCP server failed to start” 伺服器設定錯誤 檢查 claude mcp get <name>

企業部署

雲端供應商比較

功能 Anthropic Direct AWS Bedrock Google Vertex Microsoft Foundry
驗證 API 金鑰 IAM/API 金鑰 GCP 憑證 Entra ID/API 金鑰
成本追蹤 Console AWS Cost Explorer GCP Billing Azure Cost Mgmt
稽核日誌 有限 CloudTrail Cloud Audit Logs Azure Monitor
SSO 否 IAM IAM Entra ID

受管設定部署

透過 managed-settings.json 部署全組織範圍的政策：

位置： - macOS：/Library/Application Support/ClaudeCode/managed-settings.json - Linux：/etc/claude-code/managed-settings.json - Windows：C:\Program Files\ClaudeCode\managed-settings.json

範例政策：

{
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep",
      "Bash(npm run:*)",
      "Bash(git:*)"
    ],
    "deny": [
      "Bash(rm -rf:*)",
      "Bash(curl:*)",
      "Read(.env*)",
      "WebFetch"
    ],
    "defaultMode": "default"
  },
  "model": "claude-opus-4-6",
  "disableBypassPermissionsMode": "disable",
  "allowManagedPermissionRulesOnly": true,
  "allowManagedHooksOnly": true
}

僅限受管設定的金鑰：

金鑰 效果
allowManagedPermissionRulesOnly 阻止使用者/專案設定定義權限規則；僅套用受管規則
allowManagedHooksOnly 阻止使用者/專案/外掛 hooks 載入；僅執行受管和 SDK hooks
strictKnownMarketplaces 外掛市場的允許清單（空陣列 = 完全鎖定）
allowedMcpServers 使用者可設定的 MCP 伺服器允許清單（空陣列 = 完全鎖定）
deniedMcpServers MCP 伺服器的拒絕清單（優先於允許清單）
disableBypassPermissionsMode 阻止使用 --dangerously-skip-permissions

使用者無法覆寫受管設定。受管設定在設定層級架構中具有最高優先權。

平台原生部署（v2.1.51+）：除了 JSON 檔案外，受管設定還可透過 macOS 屬性清單（plist）或 Windows 登錄檔進行部署，實現與現有 MDM（行動裝置管理）和群組原則基礎架構的整合：114

  • macOS plist：透過 MDM 設定檔或 defaults write 部署至 com.anthropic.claude-code 網域
  • Windows 登錄檔：透過群組原則部署至 HKLM\SOFTWARE\Policies\ClaudeCode

平台原生來源會與 JSON 檔案合併。當某個金鑰同時出現在兩者中時，平台原生來源具有優先權。

企業 CLAUDE.md

部署全組織範圍的上下文：

位置： - macOS：/Library/Application Support/ClaudeCode/CLAUDE.md - Linux：/etc/claude-code/CLAUDE.md

內容：

# Company Standards

## Security Requirements
- Never commit secrets or credentials
- All external API calls require security review
- Use parameterized queries for all database access

## Code Standards
- Follow company style guide at @docs/STYLE.md
- All PRs require two approvals
- Test coverage minimum: 80%

## Approved Tools
- npm, yarn, pnpm for package management
- Jest for testing
- ESLint + Prettier for formatting

推行策略

  1. 從文件開始：在部署之前先完善 CLAUDE.md
  2. 試點小組：從 5-10 位開發人員開始
  3. 問答階段：讓試點人員使用 Claude 進行程式碼探索
  4. 引導式開發：逐步推進至小型錯誤修復
  5. 全面部署：搭配受管設定進行推行
  6. 監控成本：追蹤各團隊的使用量

稽核與合規

資料處理： - 工作階段記錄預設儲存在本機（除了 API 呼叫外，不會有資料離開裝置） - API 請求會發送至 api.anthropic.com（直連）或透過您的雲端供應商（Bedrock/Vertex/Foundry） - Anthropic 的商業條款載明 API 的輸入/輸出不會用於模型訓練 - 若有資料駐留要求，請使用 Bedrock（AWS 區域）或 Vertex（GCP 區域）將 API 流量限制在特定地理區域內

SSO 與身分驗證： - Anthropic Direct：透過 claude login 進行基於 OAuth 的驗證（不支援 SAML/SSO——如需 SSO 請使用雲端供應商） - AWS Bedrock：透過 AWS IAM Identity Center 使用 IAM 角色和 SSO - Google Vertex：GCP IAM 搭配 Workforce Identity Federation 支援 SAML/OIDC - Microsoft Foundry：Entra ID 搭配原生 SSO

合規框架： - Anthropic 發布 SOC 2 Type II 報告（可透過業務洽詢在保密協議下取得） - 雲端供應商（AWS、GCP、Azure）各自擁有合規認證（SOC 2、HIPAA BAA、ISO 27001、FedRAMP）——透過它們路由可繼承其合規態勢 - 對於受監管產業（醫療保健、金融），建議透過擁有適當 BAA 或合規附錄的雲端供應商路由，而非直接使用 API

日誌記錄與監控： - 使用雲端供應商的日誌記錄進行企業稽核（CloudTrail、Cloud Audit Logs、Azure Monitor） - 考慮使用 LiteLLM 代理伺服器進行跨團隊的詳細使用量追蹤 - 受管設定可強制執行合規政策 - Analytics API 提供每位使用者的每日使用量彙總（詳見下方）

Analytics API（管理員）

Enterprise 和 Team 方案可存取 Claude Code Analytics API，用於程式化的使用量追蹤。

端點：GET /v1/organizations/usage_report/claude_code

驗證：需要 Admin API 金鑰（sk-ant-admin...），由組織管理員在 Console 中佈建。

可用指標：

類別 指標
生產力 每位使用者的工作階段數、新增/移除行數、提交次數、PR 數量
工具使用 各工具的接受/拒絕率（Edit、Write、NotebookEdit）
成本 依使用者和模型的預估成本明細

請求參數： - starting_at - 每日彙總的日期（YYYY-MM-DD） - 回傳指定日期的使用者層級資料

範例：

curl -X GET "https://api.anthropic.com/v1/organizations/usage_report/claude_code?starting_at=2026-01-25" \
  -H "x-api-key: sk-ant-admin-..." \
  -H "anthropic-version: 2023-06-01"

限制： - 僅提供每日彙總（約 1 小時延遲以確保一致性） - 如需即時監控，請使用 OpenTelemetry 整合 - 僅追蹤第一方 API 使用量（不含 Bedrock/Vertex）

費用：擁有 Admin API 存取權的組織可免費使用。

鍵盤快捷鍵參考

一般控制

快捷鍵 動作
Ctrl+C 取消目前操作
Ctrl+D 結束工作階段（EOF）
Ctrl+L 清除畫面（保留歷史記錄）
Ctrl+O 切換詳細輸出
Ctrl+R 搜尋指令歷史
Ctrl+V 從剪貼簿貼上圖片
Ctrl+B 將目前操作移至背景執行
Ctrl+F 終止所有背景代理（v2.1.47+）
Ctrl+Y 貼上（從刪除環貼上）
Ctrl+S 暫存提示草稿（儲存目前輸入）
Alt+Y 循環貼上（在 Ctrl+Y 後循環刪除環）
Esc Esc 回退上一次變更
Tab 接受提示建議
! + Tab Bash 歷史自動補全（v2.1.14+）
Shift+Tab 循環切換權限模式
Alt+P / Option+P 在輸入提示時切換模型
Alt+T 切換思考模式（較安全的替代方式）
Ctrl+T 在 /theme 中切換語法高亮
Ctrl+G 開啟外部編輯器（在 AskUserQuestion 的「其他」輸入中）
Shift+Down 循環切換代理團隊成員（可循環，v2.1.47+）
Up/Down 瀏覽指令歷史
? 顯示快捷鍵

自訂按鍵綁定（v2.1.18+）：執行 /keybindings 來自訂鍵盤快捷鍵。支援情境專屬綁定、和弦序列（多鍵組合）以及完整的個人化設定。Claude Code 將按鍵綁定儲存在 ~/.claude/keybindings.json。請參閱按鍵綁定文件以取得完整的設定參考。77

提示建議（2025年12月）：Claude 現在會建議提示以加速您的工作流程。按 Tab 接受建議，或按 Enter 提交您自己的提示。13

多行輸入

方法 按鍵
跳脫換行 \ 然後 Enter
macOS Option+Enter
開箱即用（v2.1.0+） 在 iTerm2、WezTerm、Ghostty、Kitty 中使用 Shift+Enter37
其他終端機 Shift+Enter（請先執行 /terminal-setup）
控制字元 Ctrl+J
自訂按鍵綁定（v2.1.47+） 透過 /keybindings 將任意鍵綁定至 chat:newline102

快速前綴

前綴 動作 範例
# 加入記憶 # Always use TypeScript
/ 斜線指令 /review
! 直接執行 bash ! git status
@ 檔案參照 @src/index.ts
& 傳送至雲端 & Build the API

檔案參照效能（2026年1月）：@ 提及在 git 儲存庫中的速度現在快了3倍。Claude Code 在建議檔案補全時也會遵循 .ignore 和 .rgignore 檔案，這對於從建議中排除建置產物或自動產生的檔案非常實用。35

Vim 模式

使用 /vim 啟用：

一般模式： - h/j/k/l - 方向導覽 - w/e/b - 單字移動 - 0/$ - 行首/行尾 - gg/G - 緩衝區開頭/結尾 - dd - 刪除整行 - cc/C - 變更整行/變更至行尾 - dw/de/db - 刪除單字變體 - x - 刪除字元 - . - 重複上一次編輯

插入模式： - i/I - 在游標前/行首插入 - a/A - 在游標後/行尾插入 - o/O - 在下方/上方開新行 - Esc - 返回一般模式

最佳實踐

工作階段策略

在 Claude 中使用 /rename 為工作階段命名，之後依名稱恢復：

# Inside a session, name it:
> /rename feature-auth

# Later, resume by name:
claude --resume "feature-auth"

# Or continue the most recent session:
claude -c

恢復工作階段以繼續進行中的工作，而非重新解釋上下文。

CLAUDE.md 設計

保持易於瀏覽。 Claude 每次工作階段都會讀取此檔案，冗長的文字會浪費上下文空間。

聚焦於非顯而易見的內容。 記錄專案特定的模式、不尋常的慣例和決策。跳過 Claude 能從程式碼推斷出的內容。

持續更新。 在開發過程中使用 # 新增筆記，每週審閱並整合。

包含指令參考。 記錄您經常執行的指令。

安全性：不受信任的儲存庫

警告： 在複製並對不受信任的儲存庫執行 Claude Code 時，請注意儲存庫中的 CLAUDE.md 檔案、.claude/settings.json 和 hook 腳本會被讀取並可能被執行。惡意儲存庫可以利用這些來注入提示詞、覆寫權限或執行任意指令。在對非您擁有的儲存庫執行 Claude Code 之前，請務必審閱 CLAUDE.md、.claude/settings.json 和任何 hook 腳本。僅在受信任的程式碼庫上使用 --dangerously-skip-permissions。

已知 CVE（請保持 Claude Code 更新）： - CVE-2025-59536（已於 v1.0.111 修復）：透過不受信任的目錄工具初始化進行程式碼注入。 - CVE-2026-21852（已於 v2.0.65 修復）：專案載入流程中的資訊洩漏，允許從惡意儲存庫竊取 API 金鑰。109

自訂指令

為重複性工作流程建立指令：

---
description: Start new feature
allowed-tools: Bash(git:*), Read, Edit
---

1. Create branch: !`git checkout -b feature/$ARGUMENTS`
2. Pull latest main
3. Set up boilerplate
4. Begin implementation

有效的提示技巧

具體明確：

# Good
"Add email validation to LoginForm in src/components/LoginForm.tsx"

# Too vague
"Improve the login"

直接引用檔案：

"Review @src/auth/middleware.ts for security issues"

提供約束條件：

"Refactor using the same pattern as @src/repositories/UserRepository.ts"

使用子代理進行探索：

"Have an explore agent find all places where we handle errors"

成本控制

  • 定期使用 /cost
  • 簡單任務和子代理使用 Haiku
  • 僅在需要時設定 MAX_THINKING_TOKENS
  • 自動化腳本使用 --max-turns
  • 在長時間工作階段中主動壓縮上下文

安全性

  • 在 .claude/settings.json 中設定拒絕規則以保護敏感檔案
  • 對不受信任的專案使用沙箱模式
  • 絕不允許 Bash(rm -rf:*) 或 Bash(sudo:*)
  • 使用 hooks 阻止存取機密資訊
  • 為企業部署受管設定

社群技巧與技術5658

Claude Code 社群發現了許多超越官方文件的強大模式。這些技巧來自進階使用者，包括 Boris Cherny（Claude Code 創造者）和 40 多個技巧的儲存庫。

在撰寫程式碼前使用規劃模式

如果您只記住一個技巧，就記住這個。 您花越多時間規劃，Claude 成功的可能性就越高。在開始實作前按 Shift+Tab 切換到規劃模式。完整文件請參閱規劃模式。

頻繁清除上下文

經常使用 /clear。每次開始新任務時，清除聊天記錄。您不需要舊的歷史記錄消耗 token 或觸發昂貴的壓縮呼叫。直接清除並繼續前進。

使用圖片和螢幕截圖

Claude 擅長處理視覺輸入。在 macOS 上：Cmd+Ctrl+Shift+4 將螢幕截圖擷取到剪貼簿，然後 Ctrl+V 直接貼到 Claude Code 中。用此方式分享 UI 模型、錯誤訊息或設計參考。

安裝 GitHub 應用程式進行 PR 審閱

執行 /install-github-app，Claude 將自動審閱您的 PR。隨著 AI 輔助開發增加 PR 數量，自動審閱特別有價值。Claude 經常能捕捉到人類審閱者遺漏的邏輯錯誤和安全問題。

基於容器的自主運作

若要完全自主運作，請在 Docker 容器中使用 tmux 作為控制層執行 Claude Code。您本機的 Claude Code 控制容器化實例，該實例可以在無需手動核准的情況下執行長時間或實驗性任務。如果出現問題，它會被沙箱隔離。

# Conceptual pattern (varies by setup)
# Local Claude Code → tmux → Container Claude Code
# Results pulled back when complete

Docker 沙箱模式（快速入門）： 在 Docker 容器中執行 Claude Code，以便在探索不受信任的程式碼庫或執行實驗性提示時獲得完全隔離。63

# Run Claude Code in a Docker container (mount your project as a volume)
docker run -it --rm -v /path/to/project:/workspace anthropic/claude-code

# Or use the open-source sandbox runtime
# See: github.com/anthropic-experimental/sandbox-runtime

在以下情況使用沙箱模式： - 探索不熟悉或不受信任的程式碼庫 - 測試可能修改檔案的實驗性提示 - 執行您希望完全隔離的自主工作階段 - 在不影響實際檔案的情況下學習 Claude Code

Gemini CLI 作為備用方案

Claude Code 的 WebFetch 工具無法存取某些網站（如 Reddit）。建立一個 skill 告知 Claude 使用 Gemini CLI 作為備用方案。Gemini 具有網路存取能力，可以擷取 Claude 無法直接連線的網站內容。

元代理工廠模式

與其建立執行任務的代理，不如建立一個能建立其他代理的代理。此模式真正地為複雜自動化工作流程倍增生產力，而非透過巧妙的遞迴。

Claude Squad：多代理管理器

Claude Squad 可平行管理多個 Claude Code 實例，每個實例都在自己的 tmux 工作階段中擁有獨立的工作樹。同時在不同任務上執行多個代理，從單一儀表板監控其進度，並在完成後提取結果。65

# Install (Homebrew)
brew install claude-squad

# Or install via script (puts `cs` in ~/.local/bin)
curl -fsSL https://raw.githubusercontent.com/smtg-ai/claude-squad/main/install.sh | bash

# Launch the TUI — manages instances, tasks, and git worktrees
cs

# Auto-accept mode (experimental)
cs --autoyes

使用案例： - 跨代理平行化獨立功能 - 執行探索性提示而不阻塞您的主要工作階段 - 將自主程式設計擴展到超越單一上下文視窗的規模

進階使用者生產力統計

Boris Cherny 展示了 Claude Code 的潛力：在 30 天內，他提交了 259 個 PR，包含 497 個提交：新增 40,000 行程式碼並移除 38,000 行。這些數字展示了當 Claude Code 完全整合到開發工作流程中時所能達成的成果。

值得關注的人物

透過關注以下帳號，掌握 Claude Code 的最新發展：

Anthropic 團隊（主要來源）

誰 平台 關注理由
Boris Cherny @boris_cherny Claude Code 創造者。發布功能、宣布更新、舉辦聚會。主要來源。
Cat Wu @_catwu Anthropic。Claude Code 功能公告、子代理更新。
@adocomplete X Advent of Claude 系列——深入的每日教學（hooks、plugins、提示暫存）。
Thariq @trq212 Anthropic Claude Code 團隊工程師。解決問題、發布更新。
Anthropic @AnthropicAI 官方公告和重大版本發布。

頂尖內容創作者

誰 專注領域 代表作
@dani_avila7 教學 Hooks 深度指南、規則說明
@mattpocockuk MCP/技巧 10 課 MCP 教學、Docker 沙箱、JSON 最佳化
ykdojo GitHub 技巧 40 多個技巧儲存庫、狀態列腳本、系統提示最佳化
@ai_for_success MCP/工作流程 Hyperbrowser MCP、文件快取模式
@jerryjliu0 代理 逐步代理建構教學

重要資源

  • GitHub 版本發布: anthropics/claude-code/releases - 僅關注版本發布
  • Discord: Anthropic 社群頻道
  • 完整清單: 請參閱 ~/.claude/docs/following-list.md 取得 20 多個精選帳號

Boris 和 Anthropic 團隊會在功能發布時即時分享，這通常是在文件更新前了解新功能的最快途徑。

常見反模式

學習「不該做什麼」通常比最佳實踐更有價值。以下模式會持續導致問題：

成本反模式

反模式 問題 解決方案
所有事情都使用 Opus 5 倍成本，通常不必要 預設使用 Sonnet，僅架構設計時使用 Opus
從不檢查 /cost 帳單超出預期 在重大任務後檢查成本
簡單任務啟用延伸思考 浪費 token 對例行工作關閉（Alt+T）
在主要上下文中執行探索 上下文膨脹 改用 Explore 子代理

上下文反模式

反模式 問題 解決方案
忽略上下文直到膨脹 推理品質下降、遺忘決策 在 50% 容量時主動 /compact
只需要部分內容卻讀取整個檔案 在無關程式碼上浪費上下文 引用特定行範圍
從不使用子代理 所有內容填滿主要上下文 委派探索和分析任務
巨大的 CLAUDE.md 檔案 每次工作階段都浪費上下文 保持在 500 行以下，使用匯入

工作流程反模式

反模式 問題 解決方案
建立重疊的 skills 和指令 混淆、行為不可預測 每個用途使用一種機制
對必須執行的動作使用提示 Claude 可能跳過或遺忘 對必須執行的動作使用 hooks
沒有格式化 hooks 程式碼風格不一致 為每次 Edit/Write 掛載格式化工具
預設允許所有 bash 指令 安全風險 明確允許清單中列出安全指令

設定反模式

反模式 問題 解決方案
所有設定放在使用者設定中 團隊無法共享 團隊標準使用專案設定
提交個人偏好設定 覆蓋隊友設定 個人設定使用 settings.local.json
沒有拒絕規則 Claude 可以存取敏感檔案 拒絕 .env、憑證、機密資訊
忽略受管設定 企業政策被繞過 使用受管設定確保合規

提示反模式

反模式 問題 解決方案
「讓它更好」 模糊、結果差 明確指定「更好」的含義
不引用檔案 Claude 猜測路徑 使用 @path/to/file.ts 語法
忽略 Claude 的問題 基於錯誤假設工作 先回答再繼續
摘要即可卻提供完整文件 浪費上下文 擷取相關段落

工作流程範例

常見情境的端對端模式。

範例 1：啟動新專案

# 1. Initialize
cd my-project
claude

# 2. Let Claude understand the codebase
> "Explore this codebase and summarize the architecture"

# 3. Set up project configuration
> /init

# 4. Create CLAUDE.md with learned patterns
> "Create CLAUDE.md documenting the patterns you observed"

# 5. Add team commands
> "Create a /test command that runs our test suite"
> "Create a /deploy command for staging deployment"

範例 2：日常開發流程

# 1. Continue yesterday's session
claude -c

# 2. Quick context recap
> "What did we work on yesterday?"

# 3. Check current state
> /status

# 4. Work on feature (Sonnet handles most tasks)
> "Implement the user profile endpoint"

# 5. Proactive context management
> /compact  # Before context exceeds 50%

# 6. Check spending
> /cost

# 7. End session cleanly
> "Summarize what we accomplished today"

範例 3：複雜重構

# 1. Use Opus for planning, Sonnet for execution
> /model opusplan

# 2. Plan the refactoring
> "Plan refactoring our authentication from sessions to JWT"

# 3. Review the plan
# (Claude presents approach, you approve or modify)

# 4. Execute with Sonnet
> "Execute the plan"

# 5. Verify nothing broke
> "Have an explore agent verify all auth-related tests pass"

# 6. Review the diff
> !git diff

範例 4：PR 審查自動化

# In CI/CD (GitHub Actions, etc.)
cat pr_diff.txt | claude -p "Review this PR diff for:" \
  --output-format json \
  --permission-mode plan \
  --max-turns 5 << EOF
- Security vulnerabilities
- Performance issues
- Code style violations
- Missing test coverage
Provide findings in JSON format.
EOF

範例 5：除錯正式環境問題

# 1. Configure Sentry MCP for error access
claude --add-mcp sentry

# 2. Get error context
> "Fetch the last 10 errors from Sentry for the auth service"

# 3. Deep dive with thinking
> Alt+T  # Enable extended thinking
> "Analyze these errors and identify the root cause"

# 4. Fix and verify
> "Implement a fix and add a regression test"
> !npm test

遷移指南

從其他 AI 程式碼工具轉換過來？以下是概念對應說明。

從 GitHub Copilot 遷移

Copilot 概念 Claude Code 對應功能
Tab 自動補全 非主要重點：Claude Code 執行代理式編輯
聊天 + 代理式 CLI REPL 對話搭配工具執行
Copilot 指示 CLAUDE.md + Skills
專用代理（Explore、Plan） Subagents（Task 工具）+ 代理團隊
MCP 支援 300+ MCP 整合 + 遠端 OAuth
ACP（Agent Client Protocol） Hooks（12+ 生命週期事件）
IDE + CLI 終端機原生 + IDE 擴充功能

您獲得的優勢：作業系統層級沙箱隔離、22 個 hook 生命週期事件、搭配 OAuth 的遠端 MCP、具獨立上下文的 subagent 委派，以及 --teleport 雲端到本地交接功能。Copilot CLI（2026年1月以後）現已具備代理式功能——此比較旨在區分功能差異，並非能力落差。

交叉整合（2026年2月）： Claude（Opus 4.6 和 Sonnet 4.6）現已作為程式碼代理在 GitHub Copilot for Business 和 Pro 訂閱中免費提供——先前僅限 Enterprise 和 Pro+ 方案。您可以在 github.com、GitHub Mobile 和 VS Code 的現有 GitHub 工作流程中直接執行 Claude、Codex 和 Copilot。112

從 Cursor 遷移

Cursor 概念 Claude Code 對應功能
Composer 具完整工具存取的工作階段
Chat 搭配 subagent 委派的 REPL
程式碼庫索引 即時檔案存取（Glob、Grep、Read）
Tab 自動補全 非主要重點
IDE 整合 終端機原生 + IDE 擴充功能
MCP 支援（內建） MCP 支援（300+ 整合、遠端 OAuth）
Cursor rules (.mdc) + AGENTS.md CLAUDE.md + Skills
背景代理 遠端代理（& 前綴、--teleport）

您獲得的優勢：22 個 hook 生命週期事件用於自動化、具獨立上下文的 subagent 委派、作業系統層級沙箱隔離（seatbelt/bubblewrap）、搭配原生 OAuth 的遠端 MCP，以及終端機原生工作流程。兩款工具都支援 MCP——Claude Code 的差異化在於遠端 OAuth 和工具搜尋自動延遲載入。

從 ChatGPT / Claude 網頁版遷移

網頁介面 Claude Code
複製貼上程式碼 直接檔案存取
手動建立檔案 直接寫入檔案
無法執行 完整 bash、git、npm 等支援
上下文重置 工作階段延續（-c 旗標）
無程式碼庫感知 Glob、Grep、Read 工具
無自動化 Hooks、CI/CD 整合

您獲得的優勢：一切皆有。網頁介面需要複製貼上的工作流程；Claude Code 直接在您的程式碼庫上操作。

關鍵思維轉變

  1. 停止複製程式碼。Claude Code 直接寫入檔案。
  2. 停止切換上下文。MCP 將外部工具帶入工作階段中。
  3. 積極委派。Subagents 處理探索任務而不會膨脹您的上下文。
  4. 用 hooks 自動化。格式化、程式碼檢查、日誌記錄自動執行。
  5. 以工作階段思考。使用 -c 延續工作，而非開啟全新對話。

受眾專屬指南

給開發者： - Haiku 成本約為 Opus 的五分之一；可用於 subagents 和簡單任務 - 在長時間工作階段中主動使用 /compact 管理上下文 - 編碼上下文的工作階段 ID（feature-${branch}-${timestamp}）有助於定位先前的工作 - 在常用提示詞前加上 # 可加入持久記憶，無需額外輸入

給 DevOps 和平台團隊： - 無頭模式（-p 旗標）啟用 CI/CD 整合，支援 JSON 輸出格式供解析 - Hooks 保證執行不受模型行為影響；可用於程式碼檢查、格式化、安全檢測 - MCP 擴展至資料庫、GitHub、Sentry 及 300+ 整合的能力 - 背景任務（& 前綴）在 Claude Code Remote 上非同步執行

給安全團隊： - 權限規則採用先匹配先生效；請謹慎組織允許/拒絕清單 - 沙箱模式隔離檔案系統和網路，適用於不受信任的程式碼庫 - Bash 模式僅匹配前綴，因此 Bash(curl:*) 會封鎖所有 curl，而非僅特定 URL - 企業管理設定無法被使用者覆寫

給團隊主管： - Skills 根據上下文自動啟動；無需明確呼叫即可嵌入領域專業知識 - 專案 skills 提交至 git；團隊成員自動獲得標準化專業知識 - 透過 /cost 追蹤成本，顯示工作階段明細；根據團隊規模為每位使用者規劃 10k-300k TPM 預算 - .claude/commands/ 中的自訂指令建立可重複使用的工作流程

給企業架構師： - 管理設定透過 /etc/claude-code/managed-settings.json 部署全組織政策 - AWS Bedrock、Google Vertex AI 和 Microsoft Foundry 整合現有雲端帳務 - Opus 4.6 搭配 1M 上下文視窗，可在單一提示中處理整個程式碼庫 - 代理團隊（v2.1.32+）啟用平行多代理協調處理複雜任務 - 建議先以 5-10 位開發者進行試點，再全面推行

快速參考卡

列印出來，貼在螢幕旁邊。

╔═══════════════════════════════════════════════════════════════╗
║                    CLAUDE CODE QUICK REFERENCE                 ║
╠═══════════════════════════════════════════════════════════════╣
║  MODELS                                                        ║
║    haiku     $1/$5/M     Exploration, simple tasks            ║
║    sonnet    $3/$15/M    Daily coding (default)               ║
║    opus      $5/$25/M    Opus 4.6: architecture, hard probs  ║
║    opus[1m]  $10/$37.50  1M context (default for Max/Team)   ║
║    sonnet[1m] $6/$22.50/M Large codebases (1M context)        ║
╠═══════════════════════════════════════════════════════════════╣
║  ESSENTIAL COMMANDS                                            ║
║    /compact        Reduce context (do at 50% capacity)        ║
║    /cost           Check session spending                     ║
║    /model opus     Switch to Opus                             ║
║    /status         Show current state                         ║
║    /voice          Toggle voice mode (push-to-talk)           ║
║    /init           Set up project config                      ║
║    /mcp            Configure integrations                     ║
║    /copy [N]       Copy code blocks (Nth-latest response)     ║
║    /memory         View and manage auto-memory                ║
║    /claude-api     Build apps with Claude API/SDK             ║
║    /simplify       Simplify code (bundled, v2.1.63+)         ║
║    /batch          Batch operations (bundled, v2.1.63+)      ║
║    /effort         Set effort level (low/medium/high)        ║
║    /loop 5m /foo   Run prompt on recurring interval          ║
║    claude -n name  Start session with display name           ║
║    claude agents   List all configured agents (CLI)           ║
║    claude -w       Start in isolated git worktree             ║
║    claude remote-control  Serve local env for external builds ║
╠═══════════════════════════════════════════════════════════════╣
║  KEYBOARD SHORTCUTS                                            ║
║    Alt+T           Toggle extended thinking                   ║
║    Shift+Tab       Cycle permission modes                     ║
║    Ctrl+C          Interrupt current operation                ║
║    Ctrl+F          Kill all background agents                 ║
║    Esc → Esc       Rewind last change                         ║
║    Ctrl+L          Clear screen                               ║
╠═══════════════════════════════════════════════════════════════╣
║  PREFIXES                                                      ║
║    #message        Add to persistent memory                   ║
║    @path/file      Reference file in prompt                   ║
║    !command        Execute bash directly                      ║
║    &task           Send to cloud (async)                      ║
╠═══════════════════════════════════════════════════════════════╣
║  CONFIG FILE HIERARCHY (first found wins)                      ║
║    .claude/settings.local.json    Personal (gitignored)       ║
║    .claude/settings.json          Project (shared)            ║
║    ~/.claude/settings.json        User global                 ║
║    /etc/.../managed-settings.json Enterprise (locked)         ║
║    CLAUDE.md                      Project context             ║
╠═══════════════════════════════════════════════════════════════╣
║  DAILY WORKFLOW                                                ║
║    1. claude -c              Continue session                 ║
║    2. Work on features       Use Sonnet                       ║
║    3. /compact               Before context bloats            ║
║    4. /cost                  Check spending                   ║
║    5. Summarize              Clean exit                       ║
╠═══════════════════════════════════════════════════════════════╣
║  DECISION RULES                                                ║
║    Simple task?        → Haiku                                ║
║    Hard reasoning?     → Opus                                 ║
║    Everything else?    → Sonnet                               ║
║    Must always run?    → Hook (not prompt)                    ║
║    Auto-apply wisdom?  → Skill (not command)                  ║
║    Needs isolation?    → Subagent                             ║
╚═══════════════════════════════════════════════════════════════╝

變更日誌

本參考文件為持續更新的文件。隨著 Claude Code 的演進，內容會同步更新。

| 日期 | 變更內容 | 來源 | | 2026-03-19 | 指南 v2.20：新增 v2.1.78 與 v2.1.79 功能。StopFailure hook 事件（共 23 個）。Plugin 持久狀態（${CLAUDE_PLUGIN_DATA}）。Agent frontmatter：effort、maxTurns、disallowedTools 適用於 plugin agents。ANTHROPIC_CUSTOM_MODEL_OPTION 環境變數用於自訂 /model 選項。逐行回應串流。Tmux 通知透傳。--console 旗標用於 claude auth login。/remote-control VS Code 指令。VS Code 中 AI 產生的工作階段標題。啟動記憶體減少約 18MB。安全修正：沙箱相依套件缺失時顯示可見警告。SessionEnd hooks 現於 /resume 工作階段切換時觸發。超過 20 項錯誤修正。 | 127 128 | | 2026-03-18 | CLI 2.1.79：--console 旗標用於 API 帳單驗證、/remote-control VS Code 指令、VS Code 中 AI 工作階段標題、啟動記憶體減少約 18MB、2 分鐘非串流逾時、SessionEnd hooks 於 /resume 切換時觸發。修正：-p 作為子程序時當機、print 模式下 Ctrl+C、/btw 輸出錯誤、語音模式啟動、企業版 429 重試。 | 128 | | 2026-03-17 | CLI 2.1.78：StopFailure hook 事件、${CLAUDE_PLUGIN_DATA} plugin 狀態、agent frontmatter（effort/maxTurns/disallowedTools）、ANTHROPIC_CUSTOM_MODEL_OPTION、tmux 通知透傳、逐行串流。安全性：沙箱相依套件缺失時顯示可見警告。修正：大型工作階段截斷問題（>5MB）、無限 stop hook 迴圈、沙箱路徑處理、語音 WSL2、VS Code 中 Homebrew PATH。 | 127 | | 2026-03-17 | 指南 v2.19：新增 v2.1.77 功能。Opus 4.6 預設輸出 token 數提升至 64K，Opus 4.6 與 Sonnet 4.6 上限提升至 128K。allowRead 沙箱檔案系統設定，可在 denyRead 區域內重新允許讀取存取。/copy N 複製第 N 個最近的助理回應。/fork 更名為 /branch（/fork 仍作為別名保留）。Agent 工具不再接受 resume 參數——改用 SendMessage({to: agentId}) 延續 agent；SendMessage 會自動恢復已停止的 agent。工作階段在接受計畫內容後自動命名。背景 bash 任務在輸出達 5GB 時終止。claude plugin validate 檢查 skill/agent/command frontmatter 及 hooks/hooks.json。macOS 啟動加速約 60ms（平行 keychain 讀取）。--resume 速度提升達 45%，峰值記憶體減少約 100-150MB。安全修正：PreToolUse hooks 回傳 "allow" 時不再繞過 deny 權限規則（包括受管理設定）。超過 25 項錯誤修正，包括複合 bash「永遠允許」儲存無效規則、自動更新記憶體洩漏、Write 工具 CRLF 轉換、過期 worktree 清理競態條件、vim 模式修正、tmux 剪貼簿修正。 | 126 | | 2026-03-14 | 指南 v2.18：新增 v2.1.76 功能。MCP 引導式輸入支援——MCP 伺服器可在任務進行中透過互動式對話框請求結構化輸入。3 個新 hook 事件：Elicitation、ElicitationResult、PostCompact（共 22 個）。-n/--name CLI 旗標，用於啟動時設定工作階段顯示名稱。worktree.sparsePaths 用於大型 monorepo 的 sparse-checkout。/effort 斜線指令，用於設定模型 effort 等級。錯誤修正：deferred tools 在壓縮後遺失 schema、計畫模式重新核准、語音模式按鍵、自動壓縮斷路器（最多 3 次嘗試）、tmux over SSH 的剪貼簿、Remote Control 工作階段穩定性。 | 125 | | 2026-03-13 | 指南 v2.17：新增 v2.1.75 功能。Opus 4.6 的 1M context window 現為預設，適用於 Max、Team 與 Enterprise 方案（不再需要 [1m] 後綴）。/color 指令開放所有使用者使用。記憶檔案現包含最後修改時間戳，便於判斷資訊新鮮度。Hook 權限提示現顯示來源（settings/plugin/skill）。工作階段名稱顯示於提示列，可用 /rename 更改。錯誤修正：語音模式啟動、Bash 管道指令中 ! 問題、token 估算過度計算導致過早壓縮、macOS 啟動效能。重大變更：移除已棄用的 Windows 受管理設定備援路徑。 | 124 | |------|--------|--------| | 2026-03-12 | 指南 v2.16：新增 v2.1.73 與 v2.1.74 功能。v2.1.73：modelOverrides 設定用於自訂 provider 模型 ID（Bedrock/Vertex/Foundry）、棄用 /output-style（改用 /config）、雲端 provider 預設使用 Opus 4.6、中斷後按上鍵可還原提示並回溯、/effort 可在回應中使用、SSL 憑證錯誤指引、CPU 凍結與死鎖修正、SessionStart hooks 觸發兩次的修正。v2.1.74：/context 可操作建議、autoMemoryDirectory 設定、--plugin-dir 覆寫行為變更、CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS 可設定逾時、受管理策略執行修正、記憶體洩漏修正（串流緩衝區）、RTL 文字呈現修正、MCP OAuth 修正。 | 122123 | | 2026-03-11 | 指南 v2.15：新增 v2.1.72 功能與 Code Review 產品。Code Review〔研究預覽〕：多 agent PR 審查系統，調度平行 agent 進行交叉驗證發現。Team/Enterprise，每次審查 $15-25，約 20 分鐘。v2.1.72：/plan 接受描述參數、/copy 中 w 鍵用於寫入檔案、ExitWorktree 工具、CLAUDE_CODE_DISABLE_CRON 環境變數、擴充 bash 允許清單（lsof、pgrep、tput、ss、fd、fdfind）、恢復 Agent 工具的 model 參數用於每次調用覆寫、簡化 effort 符號（○ ◐ ●）、/config 導覽改進（Esc/Enter/Space）、套件大小 −510KB、VSCode URI handler。 | 120121 | | 2026-03-10 | 新增：v2.1.72——Tool search 在設定 ENABLE_TOOL_SEARCH 時可與 ANTHROPIC_BASE_URL 搭配啟用。/copy 中 w 鍵可將選取內容寫入檔案（適合 SSH）。/plan 接受選用描述。ExitWorktree 工具用於離開 worktree 工作階段。CLAUDE_CODE_DISABLE_CRON 停止排程任務。Bash 允許清單：lsof、pgrep、tput、ss、fd、fdfind。恢復 Agent 工具的 model 用於每次調用模型覆寫。Effort 等級簡化為 ○/◐/● 符號。/config 導覽：Esc 取消、Enter 儲存、Space 切換。套件大小 −510KB。語音轉錄精準度提升。VSCode URI handler 用於程式化開啟分頁。修正 Windows/OneDrive plugin 安裝、平行工具呼叫串聯、agent 進度追蹤。 | 121 | | 2026-03-09 | Code Review 正式上線。 多 agent PR 審查系統——調度平行 agent 進行交叉驗證發現，並依嚴重性排序。每次審查 $15-25。Team/Enterprise 研究預覽。54% 的 PR 收到實質性評論（原為 16%）。不正確發現率低於 1%。 | 120 | | 2026-03-09 | 指南 v2.14：新增 /loop 循環任務指令（v2.1.71）。新增獨立的「Claude Code on the Web」章節，涵蓋功能、安全架構、可用性，以及 web 與終端機決策表。新增行動應用程式（iOS）說明。更新快速參考卡片加入 /loop。 | 119 | | 2026-03-07 | 新增：v2.1.71——/loop 指令用於定期執行提示（/loop 5m /foo）。語音快捷鍵自訂。Bash 自動核准允許清單擴充。Stdin 凍結修正。macOS CoreAudio 啟動最佳化。 | 119 | | 2026-03-06 | 指南 v2.13：語音模式章節（/voice、按住說話、20 種 STT 語言）。v2.1.68 effort 變更（Max/Team 的 Opus 4.6 預設為 medium effort，重新引入 ultrathink，移除 Opus 4/4.1）。v2.1.69 功能：/claude-api skill、InstructionsLoaded hook 事件、agent_id/agent_type/worktree hook 欄位、${CLAUDE_SKILL_DIR}、/reload-plugins、CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS、sandbox.enableWeakerNetworkIsolation、remote-control 自訂名稱、Ctrl+U 退出 bash 模式、數字鍵盤支援。v2.1.70 修正：第三方閘道的 API 400 錯誤、effort 參數錯誤、ToolSearch 後空回應。VS Code：spark 圖示工作階段清單、markdown 計畫檢視、原生 MCP 管理。效能：prompt 重新呈現減少 74%、Remote Control 輪詢率降低 300 倍。更新 subagent 模型預設為 inherit。共 18 個 hook 事件。 | 116117118 | | 2026-03-06 | 新增：v2.1.70——修正使用 ANTHROPIC_BASE_URL 第三方閘道時的 API 400 錯誤（tool search 於代理端點停用 tool_reference 區塊）。修正自訂 Bedrock 推論設定檔的 effort 參數錯誤。修正 ToolSearch 後模型空回應。改進壓縮以保留圖片供 prompt cache 重用。/rename 可在 Claude 處理中使用。Prompt 重新呈現減少約 74%。Remote Control /poll 降至 1/10 分鐘（約 300 倍降幅）。VS Code：spark 圖示工作階段清單作為完整編輯器、完整 markdown 計畫檢視含註解、原生 /mcp 對話框。每次 --resume 節省約 600 token（skill list 重新注入修正）。多項 Windows/語音/plugin/安全修正。 | 116 | | 2026-03-05 | 新增：v2.1.69——/claude-api skill。InstructionsLoaded hook 事件。hook 事件中新增 agent_id/agent_type/worktree 欄位。${CLAUDE_SKILL_DIR} skill 自我參照變數。/reload-plugins 指令。sandbox.enableWeakerNetworkIsolation 用於 Go/MITM 代理。includeGitInstructions 設定 + CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS 環境變數。Remote-control 自訂名稱（--name）。語音 STT 新增 10 種語言（共 20 種）。Effort 等級顯示。Ctrl+U 退出 bash 模式。數字鍵盤支援。git-subdir plugin 來源類型。MCP 伺服器的 oauth.authServerMetadataUrl。Sonnet 4.5→4.6 自動遷移。安全性：從 gitignore 目錄發現巢狀 skill、symlink 寫入逃逸、trust 對話框啟用所有 .mcp.json 伺服器。超過 70 項錯誤修正，包括 macOS keychain 損壞、teammate 巢狀產生、記憶體洩漏。 | 117 | | 2026-03-04 | 新增：v2.1.68——Opus 4.6 於 Max/Team 訂閱者預設為 medium effort。重新引入「ultrathink」關鍵字對應 high effort。從第一方 API 的 Claude Code 中移除 Opus 4 與 Opus 4.1。 | 116 | | 2026-03-03 | 語音模式上線。 /voice 啟動按住說話功能（按住空白鍵說話）。逐步推出（初始約 5%）。專業配對程式設計風格設計，非休閒語音助理。 | 118 | | 2026-03-02 | 指南 v2.12：記錄 Task tool → Agent tool 更名（Agent(agent_type) 語法，Task(...) 作為別名）。macOS plist 與 Windows Registry 支援受管理設定（v2.1.51）。Figma 合作整合說明。 | 113114115 | | 2026-02-28 | 指南 v2.11：新增 v2.1.63 功能。/simplify 與 /batch 內建斜線指令。Worktree 共享的專案設定與自動記憶。ENABLE_CLAUDEAI_MCP_SERVERS=false 用於退出 claude.ai MCP 連接器。HTTP hooks 正式 type: "http" handler 文件。/copy「永遠複製完整回應」選項。VSCode 工作階段重新命名/移除。/clear skill 快取重設修正。多項記憶體洩漏修正。REPL bridge 競態條件修正。GitHub Copilot Business/Pro Claude 可用性交叉參照。 | 111112 | | 2026-02-27 | 指南 v2.10：新增 v2.1.58–v2.1.62 功能。/copy 指令（互動式程式碼區塊選擇器）。/memory 指令增強用於自動記憶管理。Remote Control 擴展至更多使用者（v2.1.58）。產業採用統計：GitHub 提交量的 4%（每日約 135K）。CVE-2025-59536 與 CVE-2026-21852 安全公告新增至不受信任倉庫警告。Prompt 建議快取修正（v2.1.62）。Windows 並行寫入時設定檔損壞修正（v2.1.61）。改進複合指令的 bash「永遠允許」前綴建議。多 agent 工作階段的記憶體使用改進。MCP OAuth token 更新競態條件修正。 | 107108109110 | | 2026-02-25 | 指南 v2.9：新增 v2.1.52–v2.1.56 錯誤修正。修正 Agent Teams 導覽（僅 Shift+Down，非 Shift+Up/Down）。新增團隊儲存路徑與任務相依性細節。新增 TeammateIdle/TaskCompleted hook 整合說明。 | 106 | | 2026-02-25 | 新增：v2.1.53–v2.1.56——VS Code 在 Windows 上的當機修正、修正提交後輸入框短暫消失的 UI 閃爍、修正批次 agent 終止（Ctrl+F）改為發送單一彙總通知、修正 Remote Control 優雅關閉時留下過期工作階段、修正首次啟動時 --worktree 有時被忽略、修正 Windows 上 BashTool EINVAL、修正 Windows ARM64 與 Linux/Windows x64 上 WASM 直譯器的當機。 | 106 | | 2026-02-23 | 指南 v2.8：新增 v2.1.51 功能。claude remote-control 子指令用於外部建置。HTTP hook 安全性：allowedEnvVars 為 header 中環境變數內插所必需；HTTP hooks 透過沙箱代理路由。工具結果磁碟持久化門檻降至 50K 字元（原為 100K）。BashTool 預設略過 login shell。Plugin 改進：自訂 npm 登錄檔、版本鎖定、可設定 git 逾時。/model 選擇器顯示易讀標籤。SDK 呼叫者身分環境變數。Agent Teams 計畫核准用於 teammate。 | 105 | | 2026-02-24 | 新增：v2.1.51——claude remote-control 子指令用於外部建置、allowedEnvVars 用於 HTTP hook 環境變數內插安全性、HTTP hooks 透過沙箱網路代理路由、工具結果 >50K 字元持久化至磁碟（原為 100K）、BashTool 預設略過 login shell、plugin marketplace git 逾時可設定（CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS）、plugin 的自訂 npm 登錄檔與版本鎖定、/model 選擇器易讀標籤、CLAUDE_CODE_ACCOUNT_UUID/CLAUDE_CODE_USER_EMAIL/CLAUDE_CODE_ORGANIZATION_UUID SDK 環境變數、statusLine/fileSuggestion hooks 需要工作區信任。修正：重複 control_response API 400 錯誤、YAML 陣列 SKILL.md 描述的斜線指令自動完成當機。 | 105 | | 2026-02-22 | 指南 v2.7：修正 fast mode 定價表——移除不正確的 >200K 分層定價（$60/$225）。官方 Anthropic 定價確認為全 context window 均一費率 $30/$150，無長 context 加價。新增 web fetch（免費）至隱藏工具費用表。新增含 web_search/web_fetch 工具時程式碼執行免費。新增失敗的 web 搜尋不計費。 | 1 | | 2026-02-21 | 指南 v2.6：新增 v2.1.49 與 v2.1.50 功能。新 hook 事件：ConfigChange、WorktreeCreate、WorktreeRemove（共 17 個）。新 --worktree/-w 旗標用於隔離的 git worktree。Subagent isolation: "worktree" 與 background: true 欄位。claude agents CLI 指令。CLAUDE_CODE_DISABLE_1M_CONTEXT 環境變數。Opus 4.6 fast mode 現包含完整 1M context。Claude Code Security（研究預覽）。 | — | | 2026-02-20 | 新增：v2.1.50——LSP 伺服器的 startupTimeout、WorktreeCreate/WorktreeRemove hook 事件用於自訂 VCS 設定/清除、agent 定義中的 isolation: worktree、claude agents CLI 指令、CLAUDE_CODE_DISABLE_1M_CONTEXT 環境變數、Opus 4.6 fast mode 現包含完整 1M context window、VSCode /extra-usage 指令支援。CLAUDE_CODE_SIMPLE 現停用 MCP 工具、附件、hooks 與 CLAUDE.md 載入。修正：symlink 工作階段不可見、SSH 斷線時工作階段資料遺失、agent teams 記憶體洩漏（已完成任務未回收）、/mcp reconnect 對不存在的伺服器凍結、LSP 診斷資料記憶體洩漏、prompt 建議快取回歸、Edit 工具 Unicode 彎引號損壞。Linux：修正 glibc < 2.30（RHEL 8）上的原生模組。多項長工作階段記憶體最佳化改進。 | 103 | | 2026-02-19 | 新增：v2.1.49——--worktree（-w）旗標用於在隔離的 git worktree 中啟動 Claude、subagent 支援 isolation: "worktree" 用於暫時 git worktree 工作、agent 定義支援 background: true 永遠作為背景任務執行、ConfigChange hook 事件用於企業安全稽核、plugin 可附帶 settings.json 作為預設設定、SDK 模型資訊現包含 supportsEffort/supportedEffortLevels/supportsAdaptiveThinking 欄位。CLAUDE_CODE_SIMPLE 現包含檔案編輯工具。移除 Sonnet 4.5 的 1M context，改為 Sonnet 4.6。改進 MCP OAuth 的 step-up auth 與 discovery 快取。修正：背景 agent 時 Ctrl+C 與 ESC 被忽略、無限制 WASM 記憶體成長、disableAllHooks 受管理設定層級、--resume 顯示原始 XML 標籤。改進權限提示以顯示限制原因。 | 103 | | 2026-02-20 | Claude Code Security（研究預覽）：內建於 Claude Code on the web 的弱點掃描功能。掃描程式碼庫並建議修補供人工審查。適用於 Enterprise、Team 與開源維護者。 | 104 | | 2026-02-18 | 新增：v2.1.47——Ctrl+F 終止所有背景 agent（取代雙擊 ESC）、Stop/SubagentStop hook 輸入中的 last_assistant_message 欄位、chat:newline 快捷鍵動作、statusline JSON 中的 added_dirs、/rename 更新終端機分頁標題、resume 選擇器顯示 50 個工作階段（原為 10）、teammate 導覽簡化為僅 Shift+Down。效能：啟動改進約 500ms（延遲 SessionStart hooks）、記憶體改進（釋放 API 串流緩衝區、O(n²) 進度更新修正）。修正：壓縮後保留 plan mode、Edit 工具 Unicode 彎引號損壞、CJK 全形字元對齊、並行 agent API 400 錯誤、/resume 丟棄大型工作階段（>16KB）、壓縮後工作階段名稱遺失、背景 agent 結果回傳原始 transcript、多項 Windows 修正（透過 Git Bash 的 hooks、CWD 追蹤清理、磁碟代號大小寫、WSL2 上 BMP 貼上）。 | 102 | | 2026-02-18 | 新增：v2.1.46——Claude Code 中支援 claude.ai MCP 連接器、修正 macOS 終端機斷線後孤立的 CC 程序。v2.1.45——spinnerTipsOverride 設定、SDKRateLimitInfo/SDKRateLimitEvent SDK 類型、修正 Bedrock/Vertex/Foundry 上的 Agent Teams、修正 macOS 沙箱暫存檔錯誤、啟動與記憶體改進。 | 102 | | 2026-02-18 | 指南 v2.5：新增 Ctrl+F 與 Shift+Down 至鍵盤快捷鍵、spinnerTipsOverride 至設定參考、last_assistant_message hook 欄位、chat:newline 快捷鍵、claude.ai MCP 連接器章節、resume 選擇器 50 個工作階段更新。 | — | | 2026-02-17 | 重大更新：Claude Sonnet 4.6 發佈。 模型 ID：claude-sonnet-4-6。取代 Sonnet 4.5 作為 claude.ai 與 Claude Cowork 的預設模型。相同定價（$3/$15 每 MTok）。改進 agentic 搜尋效能並減少 token 使用。支援 adaptive thinking、extended thinking 與 1M token context window（beta）。64K 最大輸出。知識截止：可靠至 2025 年 8 月，訓練至 2026 年 1 月。Sonnet 4.5 移至 legacy。另外：API 程式碼執行在搭配 web search/web fetch 時免費、web search 工具與程式化工具呼叫正式 GA（不再需要 beta header）。 | 100 | | 2026-02-17 | 指南 v2.4：更新所有模型表格以納入 Sonnet 4.6、將 Sonnet 4.6 新增至 extended thinking 支援模型、更新腳註與定價參考。 | — | | 2026-02-14 | 新增：v2.1.44——修正深層巢狀目錄路徑的 ENAMETOOLONG 錯誤、修正 auth 更新錯誤。v2.1.43——修正 AWS auth 更新當機（3 分鐘逾時）、修正 .claude/agents/ 中非 agent markdown 檔案的多餘警告、修正 Vertex/Bedrock 上無條件發送 structured-outputs beta header。 | 101 | | 2026-02-16 | 指南 v2.3：移除已過期的 fast mode 促銷定價（2 月 16 日截止已過）、新增 >200K 長 context fast mode 層級（$60/$225）、修正 protect-files.sh exit code（1→2 用於阻擋）、修正 3 處過時的 Tab→Alt+T 快捷鍵參考、重寫 Copilot/Cursor 遷移表格（兩者現均有 agentic CLI+MCP）、修正 Claude Squad 安裝指令（brew/curl、cs 二進位、TUI 應用程式）、新增 4 個遺漏的目錄項目（Output Styles、Slash Commands、Plugin System）、更新 7 個腳註 URL（docs.anthropic.com→code.claude.com 正規化）、新增 55 遺漏的 URL、修正 9 重新導向說明、新增受管理設定鍵值表（allowManagedPermissionRulesOnly、allowManagedHooksOnly 等）、新增不受信任倉庫的 prompt injection 安全警告。新增快速入門章節、專用 Plan Mode 章節、擴充非互動模式（-p）文件含 exit code 與 CI/CD 模式、修正所有 --session-id 範例（需要 UUID；遷移至 /rename + --resume）、新增〔研究預覽〕標記至 Remote 與 Slack 章節、標記 1 個未標記的程式碼區塊、驗證所有 35 個目錄錨點。評估後修正：TL;DR 模型建議改為層級中立、jq // 模式修正為 select()、--input-file 虛構旗標替換為 pipe、Docker 沙箱語法修正、「sub-agent」連字號統一為「subagent」、新增 /login 與 /logout 至斜線指令表。 | — | | 2026-02-13 | 新增：v2.1.42——修正 /resume 將中斷訊息顯示為工作階段標題、修正 Opus 4.6 啟動公告對 Bedrock/Vertex/Foundry 使用者顯示、改進多圖片尺寸限制錯誤訊息並建議使用 /compact。 | 97 | | 2026-02-13 | 新增：v2.1.41——claude auth 子指令（login、status、logout）用於驗證管理而無需進入 REPL、Windows ARM64 原生二進位支援、/rename 無引數時自動從對話脈絡產生工作階段名稱。修正：AWS auth 更新無限期當機（新增 3 分鐘逾時）、含錨點片段的 @-mentions（例如 @README.md#installation）、FileReadTool 在 FIFO//dev/stdin/大型檔案上阻塞、串流 Agent SDK 模式下背景任務通知、分類器規則輸入中游標跳動、markdown 連結顯示文字被丟棄改為原始 URL、自動壓縮失敗通知對使用者顯示、subagent 經過時間含權限等待時間、plan mode 中觸發主動 tick、設定變更時過期權限規則未清除、hook 阻擋錯誤在 UI 中顯示 stderr。 | 97 | | 2026-02-12 | 準確性與完整性審查：修正 hooks 表格——Stop、SubagentStop、TeammateIdle、TaskCompleted 均可透過 exit code 2 進行阻擋。新增 PostToolUseFailure 事件。新增基於 prompt 的 hooks（type: "prompt"）與基於 agent 的 hooks（type: "agent"）文件。更新 PreToolUse 至建議的 hookSpecificOutput 格式（棄用頂層 decision）。新增 hook 環境變數（$CLAUDE_PROJECT_DIR、$CLAUDE_ENV_FILE）。新增 CLI --agents 旗標用於工作階段範圍的 subagent 定義。擴充 subagent 設定表：disallowedTools、maxTurns、mcpServers、hooks、delegate 權限模式。 | 96 | | 2026-02-10 | 新增：v2.1.39——改進終端機呈現效能。修正：致命錯誤被吞沒而非顯示、工作階段關閉後程序當機、終端機螢幕邊界字元遺失、詳細 transcript 檢視中的空白行。 | 95 | | 2026-02-10 | 新增：v2.1.38——安全性：在沙箱模式下阻擋對 .claude/skills 的寫入（防止 prompt injection 修改 skill 定義）、改進 heredoc 分隔符解析以防止指令注入。修正：VS Code 終端機捲動至頂部回歸、Tab 鍵將斜線指令加入佇列而非自動完成、使用環境變數包裝器指令的 bash 權限比對、非串流模式下工具使用之間的文字消失、VS Code 中 resume 時重複工作階段。 | 95 | | 2026-02-08 | 新增：v2.1.37——修正啟用 /extra-usage 後 /fast 無法立即使用。 | 93 | | 2026-02-08 | 新增：v2.1.36——Fast mode 現已支援 Opus 4.6。 相同模型，更快輸出，採用進階定價（標準費率 6 倍，促銷折扣 50% 至 2 月 16 日）。使用 /fast 切換。 | 93 | | 2026-02-07 | 新增：v2.1.34——安全修正：透過 sandbox.excludedCommands 或 dangerouslyDisableSandbox 排除沙箱的指令，在啟用 autoAllowBashIfSandboxed 時可繞過 Bash ask 權限規則。另修正 agent teams 設定在呈現間變更時的當機。 | 94 | | 2026-02-05 | 新增：v2.1.33——TeammateIdle 與 TaskCompleted hook 事件用於多 agent 工作流程、Task(agent_type) 語法限制 agent tools frontmatter 中可產生的 subagent、memory frontmatter 欄位用於 agent（user/project/local 範圍）、plugin 名稱顯示於 skill 描述與 /skills 選單。修正：tmux 中 agent teammate 工作階段無法收發訊息、不支援方案上的 agent teams 可用性警告、提交新訊息時 extended thinking 中斷、中途中止時含空白+thinking 區塊的 API 錯誤、API proxy 404 串流備援、settings.json 環境變數中的 proxy 設定未套用至 WebFetch、/resume 工作階段選擇器顯示原始 XML 標記。改進：API 連線錯誤訊息現顯示具體原因（ECONNREFUSED、SSL 錯誤）。VSCode：OAuth 使用者的遠端工作階段支援、工作階段選擇器中的 git 分支+訊息計數含分支搜尋、捲動至底部修正。 | 92 | | 2026-02-05 | 重大更新：Claude Opus 4.6 發佈。 模型 ID：claude-opus-4-6。1M token context window（beta）——首個具備此容量的 Opus 級模型。128K 最大輸出 token。Adaptive thinking（自動推理深度）。Effort 控制（low/medium/high/max）。Context compaction beta。Agent teams 研究預覽（多 agent 平行協調）。Terminal-Bench 2.0 業界最高分。GDPval-AA：比 GPT-5.2 高 +144 Elo，比 Opus 4.5 高 +190。1M MRCR v2 8-needle 測試 76% 準確率（競爭對手約 18.5%）。開箱即用發現 500+ 個開源程式碼零日弱點。與 Opus 4.5 相同定價：$5/$25 每 MTok。長 context（>200K 輸入）：$10/$37.50。 | 86 | | 2026-02-05 | 新增：v2.1.32——Opus 4.6 支援、agent teams 研究預覽（需要 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1）、自動記憶記錄/回想、訊息選擇器中「從此處摘要」用於部分對話摘要、來自 --add-dir 目錄的 skill 自動載入、skill 字元預算隨 context window 擴展（context 的 2%）。修正：子目錄中 @ 檔案補全不正確的相對路徑、--resume 現重用先前工作階段的 --agent 值、heredoc 中 JavaScript 範本文字的 bash「Bad substitution」錯誤、泰文/寮文間距母音呈現。VSCode：斜線指令執行修正、過去對話清單的 spinner。 | 87 | | 2026-02-04 | GitHub 整合：Claude 與 Codex 現已在 GitHub 上公開預覽——作為 Copilot Pro+ 與 Enterprise 客戶的程式撰寫 agent 透過 Agent HQ 使用。Opus 4.6 正式於 GitHub Copilot 上可用。90 | 90 | | 2026-02-04 | 新增：v2.1.31——退出時顯示工作階段 resume 提示說明如何繼續、日文 IME 全形（zenkaku）空格輸入在核取方塊選擇中。修正：PDF 錯誤永久鎖定工作階段、沙箱模式中 bash「read-only file system」錯誤、缺少 ~/.claude.json 欄位時 plan mode 當機、串流 API 中 temperatureOverride 被靜默忽略、LSP 關閉相容性。改進：系統提示引導模型使用專用工具（Read、Edit、Glob、Grep）而非 bash 等效指令、PDF/請求大小錯誤訊息（100 頁、20MB 限制）。 | 82 | | 2026-02-03 | 新增：v2.1.30——Read 工具的 PDF pages 參數（讀取特定頁面範圍，例如 pages: "1-5"）、大型 PDF（>10 頁）在 @-mentioned 時回傳輕量參考、為不支援 DCR 的 MCP 伺服器（例如 Slack）預設 OAuth 客戶端憑證、/debug 指令用於疑難排解、唯讀模式中額外 git log/git show 旗標、Task 工具結果中的 token 計數/工具使用次數/持續時間指標、reducedMotion 設定選項。--resume 記憶體減少 68%（透過 stat-based 工作階段載入）。修正：API 歷史中的幻影「(no content)」文字區塊（減少 token 浪費）、工具變更的 prompt cache 失效、含 thinking 區塊的 /login 後 400 錯誤、損壞 transcript resume 時當機、Max 20x 的速率限制訊息、權限對話框搶奪焦點、subagent 無法存取 SDK 提供的 MCP 工具、Windows bash 與 .bashrc。 | 83 | | 2026-01-31 | 新增：v2.1.29——修正含 saved_hook_context 的工作階段 resume 時啟動效能回歸。 | 92 | | 2026-02-01 | 企業採用：ServiceNow 選擇 Claude 作為 ServiceNow Build Agent 的預設模型，向 29,000+ 員工推出 Claude Code——將銷售準備時間縮短 95%。Allianz 宣布合作夥伴關係，讓所有員工可使用 Claude Code。 | 84 | | 2026-01-30 | 重大更新：Xcode 26.3 引入原生 Claude Agent SDK 整合——與驅動 Claude Code 的相同引擎——在 Xcode 中直接啟用 subagent、背景任務與 plugin，無需離開 IDE。在 SwiftUI 開發期間擷取 Xcode Previews 用於視覺迭代。 | 85 | | 2026-01-30 | 新增：v2.1.27——--from-pr 旗標用於 resume 與 GitHub PR 編號/URL 連結的工作階段、透過 gh pr create 建立時工作階段自動連結至 PR、debug 日誌中的工具呼叫失敗/拒絕、VSCode Claude in Chrome 整合啟用。修正：gateway 使用者的 context 管理驗證、/context 彩色輸出、狀態列重複背景任務指示器、權限優先順序（內容層級 ask > 工具層級 allow）。Windows：bash 執行與 .bashrc、主控台視窗閃爍。VSCode：OAuth token 過期導致 401 錯誤。 | 81 | | 2026-01-29 | 新增：v2.1.25——修正 Bedrock 與 Vertex gateway 使用者的 beta header 驗證錯誤。解決方案：CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1。 | 80 | | 2026-01-28 | 新增：v2.1.23——spinnerVerbs 設定用於自訂 spinner 文字、企業環境的 mTLS/proxy 連線修正、每使用者暫存目錄隔離、ripgrep 逾時錯誤報告（原為靜默回傳空結果）、prompt footer 中已合併 PR 紫色狀態指示器、bash 逾時時間顯示。修正：prompt caching 競態條件、headless 模式下未取消的待處理非同步 hooks、tab completion 未更新輸入、headless 模式下 Bedrock 區域顯示。 | 76 | | 2026-01-28 | 新增：v2.1.22——修正非互動（-p）模式的 structured outputs。 | 75 | | 2026-01-28 | 新增：v2.1.21——VSCode 中 Python venv 自動啟動（claudeCode.usePythonEnvironment 設定）、日文 IME 全形（zenkaku）數字輸入支援、Read/search 進度指示器（「Reading…」→「Read」）、Claude 現偏好檔案操作工具而非 bash 等效指令。修正：退出時 shell completion 快取截斷、工具執行中斷時 resume 工作階段的 API 錯誤、大輸出限制模型上自動壓縮過早觸發、刪除後 task ID 重用、VSCode 中 Windows 檔案搜尋。 | 74 | | 2026-01-28 | 新增：MCP Apps（Claude 內互動式工具 UI，適用於 Asana、Figma、Slack 等）。Code Execution Tool v2（Bash 執行取代僅限 Python，程式化工具呼叫）。Claude Code on the web 擴展至 Team/Enterprise 進階席位。 | 737879 | | 2026-01-27 | 新增：v2.1.20——--add-dir 旗標用於從額外目錄載入 CLAUDE.md（需要 CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1）、prompt footer 中 PR 審查狀態指示器（彩色圓點顯示 approved/changes requested/pending/draft）、透過 TaskUpdate 工具刪除任務、vim 方向鍵歷史導覽、/copy 指令開放所有使用者、附時間戳的設定備份（輪替保留最近 5 個）。修正：resume 時工作階段壓縮載入完整歷史、agent 工作中忽略使用者訊息、全形字元（emoji/CJK）呈現偽影、MCP 回應中含 Unicode 的 JSON 解析。 | 72 | | 2026-01-26 | 增強：Analytics API 章節新增詳細端點文件、指標表格、curl 範例與限制。現包含驗證需求、可用指標（生產力、工具使用、成本）與即時監控替代方案。 | 53 | | 2026-01-24 | 新增：v2.1.19——$0、$1 自訂指令引數簡寫（從 $ARGUMENTS.0 改為 $ARGUMENTS[0] 方括號語法）、CLAUDE_CODE_ENABLE_TASKS 環境變數用於停用新任務系統、不需額外權限/hooks 的 skill 不再需要核准。VSCode：所有使用者啟用工作階段分岔與回溯。SDK：queued_command 重播為 SDKUserMessageReplay 事件。修正：終端機關閉時的殘留程序、git worktree 中的 /rename//tag、prompt stash（Ctrl+S）時貼上文字遺失、agent 模型顯示、背景化 hook 指令未提前回傳、檔案寫入預覽遺漏空行。 | 71 | | 2026-01-24 | 新增：v2.1.17——修正不支援 AVX 指令集處理器上的當機。 | 71 | | 2026-01-24 | 重大變更： Extended thinking 現預設啟用，配額 31,999 token。自然語言觸發詞（think、think hard、ultrathink）已棄用，不再分配 thinking token——改用 MAX_THINKING_TOKENS 環境變數或 /config。更新 Extended Thinking 章節反映目前行為。 | 70 | | 2026-01-24 | 新增：v2.1.18——可自訂鍵盤快捷鍵，含 context 特定按鍵綁定、chord 序列與完整個人化，透過 /keybindings 指令設定。設定儲存於 ~/.claude/keybindings.json。 | 77 | | 2026-01-24 | 新增：v2.1.16——含相依性追蹤的任務管理系統、VSCode 原生 plugin 管理支援、OAuth 使用者可從 Sessions 對話框瀏覽/resume 遠端工作階段。修正：subagent resumption 時記憶體不足當機、/compact 警告可見性、工作階段標題語言設定、Windows IDE 競態條件。 | 69 | | 2026-01-21 | 新增：v2.1.15——npm 安裝棄用通知（偏好原生二進位）、React Compiler UI 效能改進。修正：/compact 警告未清除、MCP stdio 伺服器逾時未終止子程序（可能導致 UI 凍結）。 | 68 | | 2026-01-20 | 新增：v2.1.14——bash 模式中基於歷史的自動完成（! + Tab）、已安裝清單中的 plugin 搜尋、將 plugin 釘選至 git commit SHA、VSCode /usage 指令。重大修正：context window 阻擋限制（約 65%→約 98%）、平行 subagent 記憶體當機、長工作階段記憶體洩漏、bash 模式中 @ 符號檔案自動完成、/feedback 無效 URL、/context token 計數顯示、斜線指令自動完成選錯。 | 67 | | 2026-01-20 | 新增：v2.1.12（訊息呈現錯誤修正）。修正 Setup hook 版本為 v2.1.10 並附完整發行說明：c 鍵盤快捷鍵用於 OAuth URL 複製、改進啟動時按鍵擷取、檔案建議作為可移除附件、VSCode plugin 安裝次數與信任警告。新增 teleport 單向限制說明。 | 66 | | 2026-01-19 | 文件更新：新增 SubagentStart hook 至事件表、擴充 PreToolUse hooks 的 additionalContext 文件（v2.1.9）、擴充 LSP 工具功能章節、增強 People to Follow 加入內容創作者與官方資源。 | — | | 2026-01-19 | 新增：Setup hook 事件（v2.1.10）——透過 --init、--init-only 或 --maintenance CLI 旗標觸發，用於環境設定任務。 | 60 | | 2026-01-18 | 新增：多帳號政策章節（允許事項、技術限制、禁止事項）。新增社群技巧章節（plan mode 自動清除 context、/clear、截圖、container 模式）。新增推薦追蹤人物（Boris Cherny、Thariq、Jeffrey Emanuel）。新增 API token 定價表。 | 56575859 | | 2026-01-17 | 新增：v2.1.11 版本——修正 HTTP/SSE 傳輸的過多 MCP 連線請求（重度 MCP 使用者的穩定性改進）。 | 55 | | 2026-01-16 | 新增：MCP Tool Search 章節含效能基準（Opus 4：49%→74%、Opus 4.5：79.5%→88.1%、token 開銷減少 85%）。更新 MCP 生態系統統計（每月下載量 1 億、3,000+ 伺服器）。 | 54 | | 2026-01-16 | 新增：Claude Code Analytics API 章節——透過 Admin API 端點 /v1/organizations/usage_report/claude_code 以程式方式存取 Team/Enterprise 使用指標（工作階段、提交、PR、程式碼行數）。記錄 ${CLAUDE_SESSION_ID} skill 替換（v2.1.9）。 | 5153 | | 2026-01-15 | 新增：v2.1.9 MCP tool search 門檻的 auto:N 語法、plansDirectory 設定、AskUserQuestion 中的外部編輯器（Ctrl+G）、web 工作階段提交/PR 的工作階段 URL 歸屬、PreToolUse hooks additionalContext。修正平行工具呼叫 API 錯誤、MCP 重新連線當機、Kitty 中 Ctrl+Z。新增 Cowork（面向非技術使用者的 GUI 版本）。 | 5152 | | 2026-01-15 | 新增：v2.1.7 權限回饋功能（接受權限提示時可提供回饋）。GitHub Action v1.0 GA 發佈。文件小幅更新。 | 48 | | 2026-01-14 | 新增：v2.1.7 MCP tool search auto 模式預設啟用（延遲佔 context >10% 的工具）、showTurnDuration 設定、任務通知中內嵌 agent 回應、萬用字元權限比對複合指令的安全修正。v2.1.6：/config 搜尋、/doctor Updates 章節、/stats 日期範圍篩選、巢狀 .claude/skills 發現、context_window.used_percentage/remaining_percentage 欄位、shell 行接續權限繞過的安全修正。v2.1.5：CLAUDE_CODE_TMPDIR 環境變數。 | 484950 | | 2026-01-13 | 新增：URL 從 console.anthropic.com 變更為 platform.claude.com（v2.1.4）。新增 context: fork skill frontmatter 選項用於隔離 context。新增 subagent 的權限拒絕韌性（v2.1.0+）。新增 plugin marketplace 上線資訊（2025 年 12 月 36 個精選 plugin）。 | 47 | | 2026-01-12 | 新增：v2.1.4 CLAUDE_CODE_DISABLE_BACKGROUND_TASKS 環境變數用於停用所有背景任務功能，包括自動背景化與 Ctrl+B 快捷鍵。修正 OAuth token 更新用於「Help improve Claude」設定。 | 46 | | 2026-01-10 | 新增：沙箱功能減少 84% 的權限提示（來自 Anthropic 工程部落格）、Opus 4.5 SWE-bench 效能（80.9%）與 token 效率改進。文件小幅更新。 | 45 | | 2026-01-10 | 新增：v2.1.3 合併斜線指令與 skill（統一心智模型）、/config 中的發佈頻道切換（stable/latest）、/doctor 偵測無法觸及的權限規則、hook 執行逾時從 60 秒提升至 10 分鐘。錯誤修正：/clear 後 plan 檔案持續存在、ExFAT 上 skill 重複偵測、背景任務計數不符、subagent 在壓縮時使用錯誤模型。VSCode：權限的可點擊目標選擇器。 | 44 | | 2026-01-09 | 新增：v2.1.1（109 項 CLI 改進）、元件範圍 Hooks（skill/command frontmatter 中的 hooks 含 once 選項）、新 MCP 伺服器（Figma Dev Mode、Sequential Thinking、Magic UI、Context7）。更新 MCP 生態系統數量至 3,000+ 伺服器。 | 414243 | | 2026-01-08 | 新增：language 與 respectGitignore 設定至 settings.json 參考。新增 IS_DEMO 環境變數。更新多行輸入以顯示 Shift+Enter 在 iTerm2/WezTerm/Ghostty/Kitty 中開箱即用。新增每組織/月 1,550 小時免費程式碼執行時間。 | 3740 | | 2026-01-08 | 新增：v2.1.2 工具輸出中可點擊檔案路徑（iTerm 的 OSC 8）、Windows Package Manager（winget）支援、plan mode 中 Shift+Tab「自動接受編輯」、FORCE_AUTOUPDATE_PLUGINS 環境變數、SessionStart hook 中 agent_type 欄位。安全修正：bash 處理中的指令注入、tree-sitter 記憶體洩漏。更新 thinking 切換為 Alt+T。新增 MCP 萬用字元權限語法（mcp__server__*）。新增 PreToolUse hooks updatedInput 含 ask 權限。 | 39 | | 2026-01-07 | 新增：v2.1.0 自動 skill 熱重載（~/.claude/skills 或 .claude/skills 中的 skill 立即可用，無需重啟）。安全性：CVE-2025-52882 WebSocket 驗證繞過已在 IDE 擴充功能 v1.0.24+ 中修補。 | 3738 | | 2026-01-06 | 新增：v2.0.74 可點擊圖片連結（[Image #N]）、/context 分組顯示、git repo 中檔案 @ mentions 速度提升 3 倍、.ignore 與 .rgignore 支援、Claude Agent SDK v0.1.74 | 343536 | | 2025-12-28 | 新增：命名工作階段（/rename、/resume <n>）、plugin discover 搜尋篩選、--fork-session 含自訂工作階段 ID、Agent Skills 章節、非同步 subagent、Claude Agent SDK（從 Claude Code SDK 更名）、Alt+Y yank-pop、Alt+T thinking 切換、Ctrl+T 語法高亮切換、節日促銷（12 月 25-31 日 2 倍限額） | 2930313233 | | 2025-12-24 | 新增：Claude in Chrome 章節、Claude Code in Slack 章節、LSP 工具、遠端 MCP OAuth 支援、「ultrathink」指令、/theme 與 /plugin 指令、Kitty/Alacritty/Zed/Warp 終端機支援 | 232425262728 | | 2025-12-14 | 新增：Pro 使用者 Opus 4.5 存取權、訂閱方案表、速率限制（2025 年 8 月）、iOS 應用程式可用性 | 202122 | | 2025-12-12 | 新增：Background Agents 章節、Output Styles 章節、隱藏工具費用、/stats、/fork、/rename、/statusline、/tasks 指令、.claude/rules/ 記憶目錄、Batch API 技巧 | 16171819 | | 2025-12-12 | 新增：Slack 整合、prompt 建議、Alt+P 模型切換、/release-notes 指令、/rewind 指令、互動式 MCP 設定精靈 | 131415 | | 2025-12-12 | 初始 10.0 版本：架構心智模型、決策框架、反模式、工作流程範本、遷移指南、快速參考卡片 | — |

執行 /update-cc-guide 以掃描並套用最新 Claude Code 更新。

參考文獻

  1. Anthropic Pricing。「Claude API 定價。」2025年12月。 ↩↩↩↩↩↩↩↩

  2. Claude Code Subagents。「Subagents 文件。」2025年12月。 ↩

  3. MCPcat。「MCP 伺服器下載量成長統計。」2025年12月。 ↩

  4. Claude Code Docs。「Claude Code 文件。」2025年12月從 docs.anthropic.com 重新導向；2026年2月更新正式網址。 ↩

  5. Claude Code Docs。「CLI 參考。」2025年12月從 docs.anthropic.com 重新導向；2026年2月更新正式網址。 ↩

  6. Claude Code Docs。「設定文件。」2025年12月從 docs.anthropic.com 重新導向；2026年2月更新正式網址。 ↩

  7. Claude Code Docs。「Hooks 指南。」2025年12月從 docs.anthropic.com 重新導向；2026年2月更新正式網址。 ↩

  8. Claude Code Docs。「MCP 文件。」2025年12月從 docs.anthropic.com 重新導向；2026年2月更新正式網址。 ↩

  9. Anthropic。「Claude Code 最佳實踐。」2025年4月。注意：原始網址現已重新導向至 code.claude.com/docs（內容已併入主文件）。另見 Claude Code Docs。 ↩

  10. Anthropic。「遠端 MCP 支援。」2025年12月。 ↩

  11. Anthropic。「使用 Claude Agent SDK 建構代理。」2025年12月。 ↩

  12. GitHub。「Claude Code GitHub Action。」2025年12月。 ↩

  13. Claude Code CHANGELOG。「提示建議：Claude 現在會建議您可能想做的下一步。」2025年12月16日。另見 TechCrunch 2025年12月功能報導。 ↩↩

  14. Anthropic。「Claude Slack 整合。」2025年12月。 ↩↩

  15. Claude Code Docs。「互動式 MCP 設定。」2025年12月從 docs.anthropic.com 重新導向；2026年2月更新正式網址。 ↩↩

  16. Northflank。「Claude Code 隱藏工具費用。」2025年7月。 ↩↩

  17. Anthropic。「背景代理。」2025年12月。 ↩↩

  18. Claude Code Docs。「Memory 規則目錄。」2025年12月。 ↩↩

  19. GitHub。「輸出樣式發布。」2025年12月。 ↩↩

  20. GitHub CHANGELOG。「Pro 使用者現在可透過訂閱使用 Opus 4.5。」2025年12月。 ↩↩↩

  21. Northflank。「2025年8月速率限制變更。」2025年7月。 ↩↩

  22. Claude Blog。「Claude Code 網頁版與 iOS App。」2025年11月。 ↩↩

  23. Claude Blog。「Claude Code 網頁版供 Team 與 Enterprise 使用者使用。」2025年11月。 ↩

  24. GitHub Releases。「Claude in Chrome（Beta）功能。」2025年12月。 ↩↩

  25. GitHub Releases。「LSP 工具與終端機支援更新（v2.0.74）。」2025年12月。 ↩↩↩

  26. TechCrunch。「Claude Code 進入 Slack 公告。」2025年12月。 ↩↩

  27. GitHub Releases。「思考模式觸發：think、think harder、ultrathink。」2025年12月。 ↩

  28. Anthropic。「使用 OAuth 的遠端 MCP 支援。」2025年6月。 ↩↩

  29. GitHub Releases。「具名工作階段：/rename 與 /resume。」2025年12月。 ↩

  30. GitHub Releases。「Plugin discover 搜尋篩選、使用 –fork-session 自訂工作階段 ID（v2.0.73-74）。」2025年12月。 ↩

  31. Anthropic Engineering。「Agent Skills：可重複使用的任務專屬模組。」2025年12月。 ↩↩

  32. Anthropic Engineering。「Claude Agent SDK（從 Claude Code SDK 更名）。」2025年12月。 ↩↩

  33. Apidog。「Claude Code 於2025年12月25日至31日為 Pro/Max 訂閱者提供2倍用量限額。」2025年12月。 ↩

  34. GitHub Releases。「v2.0.73-74：可點擊圖片連結、/context 分組顯示、ctrl+t 語法高亮切換。」2026年1月。 ↩↩

  35. GitHub Releases。「v2.0.72：git 儲存庫中 @ 提及檔案建議速度提升3倍、支援 .ignore 與 .rgignore 檔案。」2026年1月。 ↩↩

  36. GitHub Claude Agent SDK。「Claude Agent SDK v0.1.74 與 Claude Code v2.0.74 同步。」2026年1月。 ↩

  37. GitHub Releases。「v2.1.0：技能自動熱重載、回應語言 language 設定、settings.json 中的 respectGitignore、IS_DEMO 環境變數、Shift+Enter 在 iTerm2/WezTerm/Ghostty/Kitty 中開箱即用。」2026年1月。 ↩↩↩

  38. Datadog Security Labs。「CVE-2025-52882：Claude Code IDE 擴充套件中的 WebSocket 驗證繞過漏洞，已於 v1.0.24+ 修補。」2026年1月。 ↩↩

  39. GitHub Releases。「v2.1.2：可點擊檔案路徑（OSC 8）、winget 支援、計畫模式中 Shift+Tab 自動接受、FORCE_AUTOUPDATE_PLUGINS、SessionStart hook 中的 agent_type、安全性修復（命令注入、記憶體洩漏）、思考切換鍵改為 Alt+T、MCP 萬用字元權限、PreToolUse updatedInput 含 ask。」2026年1月。 ↩↩↩

  40. Anthropic Pricing。「每個組織每月享有1,550小時的免費程式碼執行工具用量。」2026年1月。 ↩↩

  41. VentureBeat。「Claude Code 2.1.0 引入基礎架構級功能。Hooks 用於代理、技能與斜線命令，含範圍化 PreToolUse、PostToolUse 及 Stop 邏輯。」2026年1月。Medium。「Claude Code 2.1.1 包含109項 CLI 改進。」 ↩↩

  42. Builder.io。「Figma 官方 Dev Mode MCP 伺服器公開您所選圖層的即時結構——階層、自動佈局、變體、文字樣式和設計 token 參照。」2025年12月。 ↩↩

  43. Apidog。「Sequential Thinking MCP 伺服器讓 Claude 能以結構化、反思性的思考流程有條理地解決問題。」2026年1月。MCP.so。「已索引超過3,000個 MCP 伺服器。」 ↩↩

  44. GitHub Releases。「v2.1.3：合併斜線命令與技能、/config 中的發行頻道切換、/doctor 偵測不可達權限、hook 逾時增至10分鐘。」2026年1月。 ↩

  45. Anthropic。「沙箱安全地減少84%的權限提示。」2026年1月。Anthropic。「Claude Opus 4.5 在 SWE-bench Verified 達到80.9%，同時 token 用量減半。」 ↩↩

  46. GitHub Releases。「v2.1.4：新增 CLAUDE_CODE_DISABLE_BACKGROUND_TASKS 環境變數，修復『Help improve Claude』設定的 OAuth token 刷新問題。」2026年1月。 ↩

  47. VentureBeat。「Claude Code 2.1.0：透過技能 frontmatter 中的 context: fork 分叉子代理上下文，代理在權限拒絕後繼續執行。」2026年1月。GitHub ykdojo/claude-code-tips。「Anthropic 於2025年12月正式推出包含36個精選外掛的 plugin marketplace。」 ↩↩↩↩

  48. GitHub Releases。「v2.1.7：MCP 工具搜尋自動模式預設啟用、showTurnDuration 設定、任務通知中的行內代理回應、萬用字元權限安全性修復。」2026年1月。 ↩↩

  49. GitHub Releases。「v2.1.6：/config 搜尋、/doctor 更新區段、/stats 日期範圍篩選、巢狀技能探索、context_window 百分比欄位、shell 行接續安全性修復。」2026年1月。 ↩

  50. GitHub Releases。「v2.1.5：CLAUDE_CODE_TMPDIR 環境變數用於覆寫暫存目錄。」2026年1月。 ↩

  51. GitHub Releases。「v2.1.9：新增 MCP 工具搜尋閾值的 auto:N 語法、plansDirectory 設定、AskUserQuestion 中的外部編輯器（Ctrl+G）、工作階段 URL 歸屬至提交/PR、PreToolUse hooks additionalContext。修復平行工具呼叫 API 錯誤、MCP 重新連線卡住、Kitty 中的 Ctrl+Z。」2026年1月。 ↩↩↩↩

  52. Wikipedia。「一個名為『Cowork』的圖形化介面版本，面向非技術使用者，[於] 2026年1月推出。」2026年1月。 ↩

  53. Claude Docs。「透過程式化方式存取您組織的 Claude Code 使用分析與生產力指標，使用 Claude Code Analytics Admin API。」2026年1月。 ↩↩↩

  54. VentureBeat。「MCP Tool Search：Opus 4 準確率從49%提升至74%，Opus 4.5 從79.5%提升至88.1%。Boris Cherny：『每位 Claude Code 使用者都獲得了更多上下文。』」2026年1月。Anthropic。「MCP 月下載量已達1億次，成為業界標準。」2026年1月。 ↩↩↩

  55. GitHub Releases。「Claude Code v2.1.11：修復 HTTP/SSE 傳輸的過多 MCP 連線請求。」2026年1月17日。 ↩↩

  56. Medium。「Boris Cherny：30天內使用 Claude Code 完成259個 PR、497次提交、新增40,000行、刪除38,000行。」2026年1月。 ↩↩

  57. Anthropic Pricing。「API Token 定價：Haiku 4.5（$1/$5）、Sonnet 4.6（$3/$15）、Opus 4.6（$5/$25）。」2026年2月。 ↩

  58. GitHub ykdojo/claude-code-tips。「社群技巧集錦：計畫模式、常用 /clear、截圖、GitHub app 用於 PR。」2026年1月。 ↩↩

  59. Anthropic Usage Policy。多帳號政策。Anthropic Support。「同一電話號碼最多可驗證三個帳號。支援同一網路的多個付費訂閱。」2026年1月。 ↩↩

  60. GitHub Releases。「v2.1.10：新增透過 –init、–init-only 或 –maintenance CLI 旗標觸發的 Setup hook 事件；登入時按 ‘c’ 鍵複製 OAuth URL；改善啟動按鍵擷取；檔案建議以可移除附件呈現；VSCode 外掛安裝計數與信任警告。」2026年1月17日。 ↩↩

  61. @adocomplete。「Claude 降臨曆第15天：–dangerously-skip-permissions 旗標（YOLO 模式）實現全自動運作。」2026年1月。 ↩

  62. @adocomplete。「Claude Max 訂閱者可獲得3張訪客通行證，透過 /passes 命令與他人分享 Claude Code Pro 試用。」2026年1月。 ↩

  63. @mattpocockuk。「Docker 沙箱模式用於安全探索不受信任的程式碼庫。」2026年1月。 ↩

  64. Daisy Hollman。「通宵 hooks 策略：使用 linting 與測試 hooks 作為護欄，讓 Claude 持續迭代直到測試通過。」2026年1月。 ↩

  65. @moofeez。「Claude Squad：多代理管理器，用於在隔離工作樹中執行平行 Claude Code 實例。」2026年1月。 ↩

  66. GitHub Releases。「v2.1.12：修復訊息渲染錯誤。」2026年1月17日。 ↩

  67. GitHub Releases。「v2.1.14：bash 模式中基於歷史的自動完成、外掛搜尋、將外掛釘選至 git SHA、VSCode /usage 命令。修復：上下文視窗阻塞限制（~65%→~98%）、平行子代理的記憶體崩潰、長工作階段的記憶體洩漏、@ 符號檔案自動完成、/feedback URL、/context token 計數、斜線命令自動完成。」2026年1月20日。 ↩

  68. GitHub Releases。「v2.1.15：npm 安裝棄用通知、React Compiler UI 效能改進。修復：/compact 警告持續顯示、MCP stdio 伺服器逾時未終止子程序（UI 凍結修復）。」2026年1月21日。 ↩

  69. GitHub Releases。「v2.1.16：具有依賴追蹤的任務管理系統、VSCode 原生外掛管理、OAuth 使用者可瀏覽/恢復遠端工作階段。修復：子代理恢復時的 OOM 崩潰、/compact 警告可見性、工作階段標題語言、Windows IDE 競態條件。」2026年1月22日。 ↩

  70. GitHub Issues。「Ultrathink 已棄用。思考模式預設啟用，配有31,999個 token。’think’、’think hard’、’ultrathink’ 等關鍵字不再分配思考 token——請改用 MAX_THINKING_TOKENS 環境變數。」2026年1月。Decode Claude。「UltraThink 已死。Extended Thinking 萬歲。」 ↩↩↩

  71. GitHub Releases。「v2.1.19：自訂命令引數的 $0/$1 簡寫、CLAUDE_CODE_ENABLE_TASKS 環境變數、VSCode 工作階段分叉/倒回功能開放所有使用者。v2.1.17：修復不支援 AVX 指令集處理器的崩潰問題。」2026年1月23-24日。 ↩↩

  72. Claude Code Docs。「v2.1.20：–add-dir 旗標用於從額外目錄載入 CLAUDE.md、PR 審查狀態指示器、透過 TaskUpdate 刪除任務、vim 方向鍵歷史導覽、/copy 命令開放所有使用者、帶時間戳的設定備份。修復：工作階段壓縮問題、代理忽略使用者訊息、寬字元渲染、含 Unicode 的 JSON 解析。」2026年1月27日。 ↩

  73. Anthropic。「Claude Code 網頁版現以研究預覽形式提供給擁有 premium 席位的 Team 與 Enterprise 使用者，以及 Pro 和 Max 使用者。」2026年1月26日。 ↩↩↩↩↩↩

  74. GitHub Releases。「v2.1.21：日文 IME 全形數字輸入、VSCode 中 Python venv 自動啟動（claudeCode.usePythonEnvironment）、Read/search 進度指示器、Claude 優先使用檔案工具而非 bash。修復：shell 完成快取、工作階段恢復 API 錯誤、自動壓縮時序、任務 ID 重用、Windows 檔案搜尋。」2026年1月27日。 ↩

  75. GitHub Releases。「v2.1.22：修復非互動（-p）模式的結構化輸出。」2026年1月27日。 ↩

  76. GitHub Releases。「v2.1.23：spinnerVerbs 設定、mTLS/proxy 連線修復、每使用者暫存目錄隔離、ripgrep 逾時回報、已合併 PR 紫色指示器、bash 逾時顯示。修復：prompt 快取競態條件、headless 中的非同步 hooks、tab 完成、Bedrock 區域字串。」2026年1月28日。 ↩

  77. Claude Code Docs。「v2.1.18：可自訂鍵盤快捷鍵，含上下文相關鍵位綁定、組合鍵序列與個人化設定。執行 /keybindings 進行設定。」2026年1月22日。 ↩↩

  78. Help Net Security。「Anthropic 為 Claude 新增互動式工具支援（MCP Apps），讓使用者可在 Claude 介面內直接與 Asana、Box、Canva、Figma、Hex、monday.com 和 Slack 互動。」2026年1月26日。 ↩↩

  79. Anthropic Developer Platform。「Code Execution Tool v2 公開測試版：Bash 命令執行、檔案操作，以及在程式碼執行中進行程式化工具呼叫。」2026年1月。 ↩↩

  80. GitHub Releases。「v2.1.25：修復 Bedrock 與 Vertex 閘道使用者的 beta header 驗證錯誤。替代方案：CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1。」2026年1月29日。 ↩

  81. GitHub Releases。「v2.1.27：–from-pr 旗標用於 PR 關聯工作階段、透過 gh pr create 自動關聯工作階段至 PR、除錯日誌中的工具呼叫失敗、VSCode Claude in Chrome 整合。修復：上下文管理驗證、/context 彩色輸出、狀態列重複、權限優先順序、Windows bash/.bashrc、Windows 主控台閃爍、VSCode OAuth 401 錯誤。」2026年1月30日。 ↩↩

  82. GitHub Releases。「v2.1.31：工作階段恢復提示、日文 IME 全形空白輸入、PDF 過大錯誤導致工作階段永久鎖定修復、沙箱中 bash 唯讀檔案系統錯誤修復、temperatureOverride 靜默忽略修復、LSP 關閉相容性、改善系統提示以優先使用專屬工具而非 bash。」2026年2月。 ↩

  83. GitHub Releases。「v2.1.30：Read 工具的 PDF pages 參數、大型 PDF 回傳輕量參照、為 MCP（Slack）預設 OAuth、/debug 命令、–resume 記憶體減少68%、phantom ‘(no content)’ 文字區塊修復、prompt 快取失效修復、子代理存取 SDK MCP 工具修復。」2026年1月30日。 ↩↩

  84. Anthropic。「ServiceNow 選擇 Claude 作為 ServiceNow Build Agent 的預設模型，向29,000多名員工推出 Claude Code——銷售準備時間縮短95%。」2026年1月。 ↩

  85. IT Brief Asia。「Xcode 26.3 引入原生 Claude Agent SDK 整合——與驅動 Claude Code 相同的架構——可直接在 Xcode 中使用子代理、背景任務與外掛。」2026年1月。 ↩

  86. Anthropic。「推出 Claude Opus 4.6。」2026年2月5日。100萬 token 上下文（beta）、128K 最大輸出、自適應思考、effort 控制、agent teams、Terminal-Bench 2.0 最高分、GDPval-AA 相較 GPT-5.2 +144 Elo、發現500+個零日漏洞。$5/$25 每 MTok。另見 TechCrunch、CNBC、Anthropic Pricing。 ↩↩↩↩↩↩↩↩↩

  87. GitHub Releases。「v2.1.32：Opus 4.6 支援、agent teams 研究預覽、自動記憶錄製、從此處摘要、來自 –add-dir 的技能自動載入、技能字元預算隨上下文視窗縮放、bash heredoc JS 模板字面量修復、泰文/寮文渲染修復。」2026年2月。 ↩↩

  88. Dev Genius。「Claude Code 非同步 hooks：功能介紹與使用時機。Hooks 現可使用 async: true 在背景執行而不阻塞 Claude Code。」2026年1月25日。 ↩

  89. Anthropic Engineering。「讓 Claude Code 更安全且更自主。」沙箱使用作業系統層級原語（macOS seatbelt、Linux bubblewrap）。已於 github.com/anthropic-experimental/sandbox-runtime 開源。2026年1月。 ↩

  90. GitHub Blog。「Claude 與 Codex 現已在 GitHub 上公開預覽。」2026年2月4日。另見：GitHub Blog。「Claude Opus 4.6 現已正式提供給 GitHub Copilot 使用。」2026年2月5日。 ↩↩

  91. Claude Code Docs。「協調 Claude Code 工作階段團隊。」2026年2月5日。Boris Cherny：「正式推出：Teams，即 Claude Code 中的 Agent Swarms。」另見 Lydia Hallie。「Claude Code 現支援 agent teams（研究預覽中）——主導代理可委派多個隊友平行進行研究、除錯與建構，同時互相協調。」 ↩↩

  92. GitHub Releases。「v2.1.33：TeammateIdle 與 TaskCompleted hook 事件、Task(agent_type) 子代理限制語法、代理的 memory frontmatter、外掛名稱顯示於技能描述中。修復：tmux agent teammate 工作階段、agent teams 計畫警告、extended thinking 中斷、API proxy 404 備援、WebFetch 的 proxy 設定、/resume XML 標記。VSCode：OAuth 的遠端工作階段、工作階段選擇器中的 git 分支。」2026年2月。 ↩↩

  93. GitHub Releases。「v2.1.36：Opus 4.6 現可使用快速模式。」2026年2月7日。Simon Willison。「Claude：使用快速模式加速回應。」快速模式定價：標準費率的6倍（Opus 4.6 ≤200K 輸入為 $30/$150 每 MTok；>200K 輸入為 $60/$225）。上市促銷（5折優惠）至2026年2月16日止。v2.1.37：修復啟用 /extra-usage 後 /fast 無法立即使用的問題。Anthropic Pricing。 ↩↩↩↩

  94. GitHub Releases。「v2.1.34：修復 agent teams 設定在渲染間變更時的崩潰。修復啟用 autoAllowBashIfSandboxed 時，排除於沙箱之外的命令可繞過 Bash ask 權限規則的問題。」2026年2月6日。 ↩↩

  95. GitHub Releases。「v2.1.38：修復 VS Code 終端機捲動至頂端的回歸問題、Tab 鍵斜線命令佇列、環境變數包裝器的 bash 權限比對、非串流模式下工具使用間文字消失、VS Code 恢復時的重複工作階段。改善 heredoc 分隔符號解析以防止命令注入。於沙箱模式中阻止寫入 .claude/skills。」2026年2月10日。v2.1.39：改善終端機渲染效能，修復致命錯誤被吞噬、工作階段關閉後程序掛起、終端機邊界字元遺失問題。 ↩↩↩

  96. Claude Code Docs。「Hooks 參考：基於提示的 hooks、基於代理的 hooks、hook 環境變數（$CLAUDE_PROJECT_DIR、$CLAUDE_ENV_FILE）、PreToolUse 的 hookSpecificOutput 格式。」2026年2月。Claude Code Docs。「建立自訂子代理：–agents CLI 旗標、disallowedTools、maxTurns、mcpServers、delegate 權限模式。」2026年2月。 ↩↩↩↩↩↩

  97. Claude Code GitHub Releases。v2.1.41（2月13日）：claude auth 子命令、Windows ARM64 支援、/rename 自動產生。v2.1.42（2月13日）：/resume 標題修復、Bedrock/Vertex/Foundry 公告修復。 ↩↩↩

  98. Anthropic。「模型概覽。」所有 Claude 3.5 和 Claude 4.x 模型預設支援200K token 輸入上下文。Opus 4.6 beta 擴展至100萬 token。 ↩

  99. Claude Code Docs。「開始使用 Claude Code。」系統需求：macOS 10.15+、Ubuntu 20.04+/Debian 10+、Windows 10+（WSL 或 Git Bash）、至少4 GB RAM、有效的網際網路連線。 ↩

  100. Anthropic。「Claude Sonnet 4.6。」2026年2月17日。Claude Developer Platform Release Notes。「Sonnet 4.6：改進的代理式搜尋、更少 token、extended thinking、100萬上下文（beta）。claude.ai 預設模型。Sonnet 4.5 移至舊版。」模型 ID：claude-sonnet-4-6。Anthropic Models Overview。「64K 最大輸出，知識截止：可靠至2025年8月/訓練至2026年1月。」 ↩↩↩↩

  101. Claude Code GitHub Releases。v2.1.43：AWS auth 刷新3分鐘逾時修復、.claude/agents/ markdown 虛假警告修復、Vertex/Bedrock 的 structured-outputs beta header 修復。v2.1.44：深層巢狀目錄的 ENAMETOOLONG 修復、auth 刷新錯誤修復。 ↩

  102. Claude Code GitHub CHANGELOG。v2.1.45（2月17日）：Sonnet 4.6 支援、spinnerTipsOverride 設定、SDKRateLimitInfo/SDKRateLimitEvent 類型、Agent Teams Bedrock/Vertex/Foundry 修復、沙箱暫存檔修復。v2.1.46（2月18日）：Claude Code 中的 claude.ai MCP 連接器、macOS 孤兒程序修復。v2.1.47（2月18日）：Ctrl+F 終止背景代理、Stop/SubagentStop hooks 中的 last_assistant_message、chat:newline 鍵位綁定、added_dirs statusline 欄位、/rename 終端機分頁標題、恢復選擇器50個工作階段、啟動速度提升約500ms、memory 改進、CJK 對齊修復、計畫模式壓縮修復、Edit 工具 Unicode 修復、多項 Windows 修復。 ↩↩↩↩

  103. Claude Code GitHub CHANGELOG。v2.1.49（2月19日）：--worktree（-w）旗標、子代理的 isolation: "worktree"、代理定義的 background: true、ConfigChange hook 事件、MCP OAuth step-up auth、SDK supportsEffort/supportedEffortLevels/supportsAdaptiveThinking 欄位、CLAUDE_CODE_SIMPLE 包含 Edit 工具、Sonnet 4.5 1M 移除改用 Sonnet 4.6、WASM 記憶體修復、權限限制原因。v2.1.50（2月20日）：WorktreeCreate/WorktreeRemove hooks、LSP 伺服器的 startupTimeout、claude agents CLI 命令、CLAUDE_CODE_DISABLE_1M_CONTEXT 環境變數、Opus 4.6 快速模式完整100萬上下文、CLAUDE_CODE_SIMPLE 停用 MCP/hooks/CLAUDE.md、VSCode /extra-usage、agent teams 記憶體洩漏修復、LSP 診斷洩漏修復、Linux glibc < 2.30 修復、多項記憶體優化。 ↩↩↩↩↩

  104. Cyber Unit。「Claude Code 安全性：企業應了解 Anthropic AI 驅動漏洞掃描器的要點。」2026年2月20日。以限量研究預覽形式提供給 Enterprise、Team 與開源維護者。Anthropic。「Claude Code Security 掃描程式碼庫中的安全漏洞，並建議針對性修補供人工審查。」 ↩↩

  105. GitHub Releases。「v2.1.51（2月24日）：claude remote-control 子命令、HTTP hook 安全性的 allowedEnvVars、透過沙箱代理的 HTTP hooks、超過50K字元的工具結果磁碟持久化、BashTool login shell 跳過、外掛 npm registry/版本釘選、/model 人性化標籤、SDK 呼叫者身份環境變數、statusLine/fileSuggestion 工作區信任。」2026年2月24日。Claude Code Docs。「Agent Teams：隊友的計畫審批、TeammateIdle/TaskCompleted 品質 hooks。」 ↩↩↩↩↩↩↩↩↩

  106. GitHub Releases。「v2.1.52–v2.1.56（2月24-25日）：VS Code Windows 崩潰修復、UI 閃爍修復、批次代理終止聚合通知、Remote Control 過期工作階段清理、–worktree 首次啟動修復、Windows 上 BashTool EINVAL、Windows ARM64/WASM 直譯器崩潰修復。」2026年2月25日。Claude Code Docs。「Team 設定：~/.claude/teams/{team-name}/config.json。任務清單：~/.claude/tasks/{team-name}/。任務依賴自動解鎖。Shift+Down 切換隊友（循環至主導者）。」 ↩↩

  107. GitHub Releases。「v2.1.59（2月26日）：Claude 自動將實用上下文儲存至 auto-memory（透過 /memory 管理）。/copy 命令含程式碼區塊互動選擇器。改善複合 bash 命令的『始終允許』前綴建議。多代理工作階段的記憶體用量改善。MCP OAuth token 刷新競態條件修復。並行寫入的設定檔損壞修復。」2026年2月26日。 ↩↩

  108. Anthropic。「Claude Code Remote Control：工作階段行動化功能，可從手機、平板或瀏覽器繼續本機工作階段。加密通道、原子性工作階段狀態傳輸。」2026年2月。GitHub Releases。「v2.1.58：擴展 Remote Control 至更多使用者。」 ↩↩

  109. Check Point Research。「CVE-2025-59536：不受信任目錄中的程式碼注入（已於 v1.0.111 修復）。CVE-2026-21852：透過專案載入流程的資訊洩漏（已於 v2.0.65 修復）。」2026年2月。 ↩↩

  110. Anthropic/GitHub Statistics。「4%的公開 GitHub 提交（約每天135,000次）由 Claude Code 撰寫。13個月內成長42,896倍。Anthropic 自身90%的程式碼由 AI 撰寫（Dario Amodei，2026年2月）。」2026年2月5日。 ↩↩

  111. GitHub Releases。「v2.1.63（2月28日）：/simplify 與 /batch 內建斜線命令、worktree 共享專案設定與 auto-memory、ENABLE_CLAUDEAI_MCP_SERVERS=false 退出選項、HTTP hooks type: http 處理程式、/copy 『始終複製完整回應』選項、VSCode 工作階段重新命名/移除、/clear 重設技能快取、多項記憶體洩漏修復、REPL bridge 競態條件修復。」2026年2月28日。 ↩↩↩↩↩↩↩

  112. GitHub Blog。「Claude 與 Codex 現已提供給 Copilot Business 與 Pro 使用者。」2026年2月26日。將 Claude 的可用範圍從 Copilot Pro+ 與 Enterprise 擴展至所有付費 Copilot 方案。 ↩↩

  113. Claude Code Docs。「在 2.1.63 版本中，Task 工具已更名為 Agent。設定與代理定義中現有的 Task(...) 參照仍作為別名運作。」2026年2月28日。 ↩↩

  114. GitHub Releases。「v2.1.51：受管理設定——支援 macOS plist 與 Windows Registry 以用於企業部署。」2026年2月24日。 ↩↩

  115. CNBC。「Figma 與 Anthropic 合作開發整合 Claude Code 的 AI 功能。」2026年2月17日。 ↩↩

  116. GitHub Releases。「v2.1.68：Opus 4.6 對 Max/Team 預設使用 medium effort、重新引入 ultrathink 用於 high effort、移除 Opus 4/4.1。v2.1.70：修復使用 ANTHROPIC_BASE_URL 時的 API 400 錯誤、effort 參數錯誤、ToolSearch 後的空回應、改善壓縮時的圖片保留、VS Code spark 圖示與 MCP 管理。」2026年3月。 ↩↩↩↩↩↩↩↩↩

  117. GitHub Releases。「v2.1.69：/claude-api 技能、InstructionsLoaded hook 事件、hook 事件中的 agent_id/agent_type/worktree、${CLAUDE_SKILL_DIR}、/reload-plugins、sandbox.enableWeakerNetworkIsolation、includeGitInstructions 設定、remote-control 自訂名稱、Voice STT 新增10種語言（共20種）、effort 等級顯示、Ctrl+U 退出 bash、數字鍵盤支援、Sonnet 4.5→4.6 自動遷移。70+項錯誤修復。」2026年3月5日。 ↩↩↩↩↩↩↩

  118. TechCrunch。「Claude Code 推出語音模式功能。/voice 啟動按鍵通話。逐步推出（初始約5%）。」2026年3月3日。9to5Mac。「Anthropic 以漸進式方式為 Claude Code 新增語音模式。」 ↩↩↩↩↩

  119. GitHub Releases。「v2.1.71：/loop 命令用於循環提示、語音鍵位綁定自訂、bash 自動核准允許清單擴展、stdin 凍結修復、CoreAudio 啟動優化。」2026年3月7日。Threads/@boris_cherny。「Claude Code 2.1.0 已發布：/loop、shift+enter 換行、代理/技能 frontmatter 中的 hooks。」 ↩↩↩

  120. Anthropic Blog。「Claude Code 的 Code Review：多代理 PR 審查系統。派遣平行代理、交叉驗證發現、按嚴重性排序。每次審查 $15-25，約20分鐘。54%的 PR 收到實質性評論（從16%提升），錯誤率低於1%。以研究預覽形式提供給 Team/Enterprise。」2026年3月9日。TechCrunch。「Anthropic 推出程式碼審查工具。」 ↩↩↩↩↩

  121. GitHub Releases。「v2.1.72：使用 ANTHROPIC_BASE_URL 的工具搜尋、/copy 中按 w 鍵寫入檔案、/plan 描述引數、ExitWorktree 工具、CLAUDE_CODE_DISABLE_CRON、擴展 bash 允許清單（lsof/pgrep/tput/ss/fd/fdfind）、Agent 工具恢復 model 參數、簡化 effort 符號（○/◐/●）、/config 導覽改善、套件大小減少510KB、VSCode URI 處理程式。」2026年3月10日。 ↩↩↩↩↩

  122. GitHub Releases。「v2.1.73：modelOverrides 設定用於自訂供應商模型 ID（Bedrock/Vertex/Foundry）。棄用 /output-style（改用 /config）。Bedrock/Vertex/Foundry 上預設 Opus 改為4.6。中斷後按上方向鍵恢復提示並倒回。回應中 /effort 可用。SSL 憑證錯誤指引。錯誤修復：CPU 凍結、死鎖、SessionStart hooks 觸發兩次。」2026年3月11日。 ↩↩↩

  123. GitHub Releases。「v2.1.74：/context 可操作建議。autoMemoryDirectory 設定。--plugin-dir 覆寫行為變更。CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS 可設定逾時。受管理策略強制修復（ask 規則被使用者 allow 繞過）。記憶體洩漏修復（串流緩衝區）。RTL 文字渲染修復。MCP OAuth 修復。」2026年3月12日。 ↩↩

  124. GitHub Releases。「v2.1.75：Max/Team/Enterprise 預設啟用 Opus 4.6 的100萬上下文視窗。/color 命令開放所有使用者。提示列顯示工作階段名稱。Memory 檔案最後修改時間戳。權限提示中顯示 hook 來源。語音模式啟動修復。Bash 管線命令中 ! 修復。Token 估算過度計算修復。macOS 啟動效能改善。重大變更：移除已棄用的 Windows 受管理設定備援。」2026年3月13日。 ↩↩↩↩↩↩

  125. GitHub Releases。「v2.1.76：MCP elicitation 支援——MCP 伺服器可透過互動式對話框（表單欄位或瀏覽器 URL）在任務中請求結構化輸入。新增 Elicitation 與 ElicitationResult hooks。-n/--name CLI 旗標用於工作階段顯示名稱。worktree.sparsePaths 用於 monorepo 中的 git sparse-checkout。PostCompact hook。/effort 斜線命令。工作階段品質問卷（feedbackSurveyRate）。錯誤修復：壓縮後延遲載入工具遺失輸入結構描述、計畫模式重新核准、語音模式按鍵、自動壓縮斷路器（最多3次嘗試）、tmux 透過 SSH 的剪貼簿複製、Remote Control 工作階段穩定性。」2026年3月14日。 ↩↩↩↩↩↩↩

  126. GitHub CHANGELOG。「v2.1.77：Opus 4.6 預設最大輸出 token 增至64K，Opus 4.6 和 Sonnet 4.6 上限增至128K。allowRead 沙箱檔案系統設定。/copy N 複製第N個最新回應。/fork 更名為 /branch。Agent 工具移除 resume 參數（改用 SendMessage）。SendMessage 自動恢復已停止的代理。工作階段從計畫自動命名。背景 bash 任務於5GB時終止。claude plugin validate 檢查 frontmatter + hooks。macOS 啟動加速約60ms、--resume 速度提升45%且記憶體減少約100-150MB。安全性：PreToolUse allow 不再繞過 deny 規則。25+項錯誤修復。」2026年3月17日。 ↩↩↩↩↩↩

  127. GitHub Releases v2.1.78。「v2.1.78：StopFailure hook 事件、${CLAUDE_PLUGIN_DATA} 持久外掛狀態、代理 frontmatter（effort/maxTurns/disallowedTools）、ANTHROPIC_CUSTOM_MODEL_OPTION、tmux 通知 passthrough、逐行回應串流。安全性：缺少沙箱依賴時顯示警告。修復：超過5MB的大型工作階段截斷、無限 stop hook 迴圈、沙箱絕對路徑、WSL2 語音、VS Code 中的 Homebrew PATH。」2026年3月17日。 ↩↩↩

  128. GitHub Releases v2.1.79。「v2.1.79：--console 旗標用於 API 計費驗證、/remote-control VS Code 命令、VS Code 中 AI 產生的工作階段標題、CLAUDE_CODE_PLUGIN_SEED_DIR 多目錄支援、啟動記憶體減少約18MB、非串流 API 2分鐘逾時、SessionEnd hooks 在 /resume 切換時觸發。修復：-p 作為子程序時掛起、print 模式中的 Ctrl+C、/btw 錯誤輸出、語音模式啟動、企業 429 重試。」2026年3月18日。 ↩↩

$ echo "Maintained by Blake Crosley"
Maintained by Blake Crosley | Last updated 2026-03-21
NORMAL claude-code.md EOF
實驗室

開發中

ResumeGeni

resumegeni.com

AI驅動的履歷優化

開發中

Return

941return.com

健康追蹤與洞察

開發中

Banana List

941getbananas.com

智慧購物清單

開發中

H3arted

h3arted.com

社交連結平台

開發中