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

Claude Code CLI: The Complete Guide

#

words: 8069 read_time: 87m updated: 2026-03-05 07:24
$ 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搜尋特定的旗標、指令或設定鍵。末尾的快速參考卡提供所有主要指令的速覽摘要。

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 │
└─────────────────────────────────────────────────────────┘

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

委派層（Delegation Layer）：Subagents 以乾淨的上下文啟動，執行專注的工作，並回傳摘要。探索結果不會膨脹您的主要對話；只有結論會回傳。您可以將 subagents 導向較便宜的模型層級進行探索，或在品質比成本更重要時全程使用您的主要模型。

擴充層（Extension Layer）：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. Git 整合如何運作？
  20. 如何在 IDE 中使用 Claude Code？
  21. 進階使用模式
  22. 遠端與背景代理 [研究預覽]
  23. Claude in Chrome
  24. Claude Code in Slack [研究預覽]
  25. 效能最佳化
  26. 如何除錯問題？
  27. 企業部署
  28. 鍵盤快捷鍵參考
  29. 最佳實踐
  30. 工作流程範例
  31. 遷移指南
  32. 特定對象指引
  33. 快速參考卡
  34. 更新日誌
  35. 參考資料

如何安裝 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. 安裝並啟動：**
```bash
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 即可進入互動式讀取-求值-輸出迴圈（REPL）：

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 的工作。

命名工作階段（2025年12月）： 為工作階段命名並管理，方便日後快速召回：

# 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 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
  }
}

環境變數參考

驗證與 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]

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 最大輸出、自適應思考及代理團隊功能。86定價與 Opus 4.5 相同（每 MTok $5/$25）。長上下文（>200K 輸入）費用為每 MTok $10/$37.50。模型 ID：claude-opus-4-6。1

Sonnet 4.6（2026年2月17日）：全新均衡模型，取代 Sonnet 4.5 成為 claude.ai 和 Claude Cowork 的預設模型。100定價與 Sonnet 4.5 相同（每 MTok $3/$15）。提升了代理搜尋效能，同時消耗更少的 token。支援延伸思考、自適應思考及 1M token 上下文視窗（測試版）。64K 最大輸出。知識截止日期：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 便宜約 5 倍且回應更快。非常適合不需要深度推理的背景任務。

Sonnet：日常開發的主力模型。能妥善處理大部分編碼任務：實作功能、修復錯誤、撰寫測試、程式碼審查。建議將此設為您的預設模型。Sonnet 4.6（2026年2月）相較於 Sonnet 4.5，提供了改進的代理搜尋和更佳的 token 效率，並支援自適應思考及 1M 上下文視窗測試版。100

Opus：保留給真正複雜的推理任務：架構決策、棘手的除錯、理解複雜系統、安全性分析。Opus 4.6（2026年2月）是一次顯著的提升：它規劃更謹慎、代理任務持續更久、在大型程式碼庫中運作更穩定，且在程式碼審查時更善於發現自身錯誤。86它具備測試版的 1M token 上下文視窗，並引入自適應思考功能，可自動判斷推理深度。據 Anthropic 表示，在 Terminal-Bench 2.0 上，Opus 4.6 取得了業界最高的代理編碼分數。在 GDPval-AA（具經濟價值的知識工作）上，Anthropic 報告其以約 144 Elo 分的差距超越 GPT-5.2。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 (beta)

或在工作階段中：

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

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

延伸上下文的每 token 費用較高（輸入 token >200K 時，輸入費用為 2 倍、輸出費用為 1.5 倍）。請在確實需要時才使用，不要將其設為預設值。

查看目前模型

> /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快速模式定價會與提示快取和資料駐留乘數疊加，但不會與長上下文定價疊加。快速模式不適用於批次 API。

何時使用快速模式： - 在延遲為瓶頸時快速迭代小型變更 - 產生測試、樣板或重複性程式碼，速度比成本更重要時 - 依序處理一系列類似任務時

何時不該使用快速模式： - 長時間執行的代理任務（以 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

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

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

多帳號政策59

可以擁有多個 Claude 帳號嗎？ 可以，適用於合理的使用情境。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 延伸思考會增加成本 僅在需要時使用
提示快取 降低重複輸入成本 保持啟用（預設）

實際成本範例

任務 模型 輸入 輸出 成本
快速搜尋檔案 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 進行探索性子代理任務，使用 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 典型額外開銷

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

節省成本策略

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

監控使用量

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

背景 Token 消耗

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

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

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

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

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

需求： - 管理員 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 可以協調多個代理同時並行處理不同的子任務。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.

何時使用 Extended Thinking？

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 背景代理 長時間執行，不需要本機檔案
審查 PR Subagent 或 --from-pr 隔離的上下文，專注的輸出
產生變更日誌 claude -p 一次性執行，可腳本化
每次提交時執行 lint 和測試 Hook（PreCommit） 必須始終執行，確定性的
跨多個儲存庫搜尋模式 Subagent（Explore） 避免上下文膨脹
將遷移套用至暫存環境 背景代理 需要遠端存取
快速程式碼說明 主 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 個代理 共享儲存庫，各自獨立上下文 Opus 協調 高（N 個代理）
Subagents 無限制（由您管理） 無（隔離的） 透過 prompt 協調 每個代理中等
平行工作階段 受終端數量限制 無 手動 每個工作階段中等

該使用哪種 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 自動核准檔案編輯，shell 命令仍需提示 受信任的專案
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 的寫入，防止提示注入修改 skills 定義。95

Hooks 如何運作？

Hooks 在 Claude Code 工作流程的特定時間點執行確定性的 shell 命令。與提示 Claude 執行操作不同，hooks 無論模型行為如何都能保證執行。它們對於強制執行團隊標準和自動化重複性任務至關重要。請參閱決策框架中的「該使用哪種 Hook 類型？」決策樹，涵蓋 command、prompt 和 agent 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
ConfigChange 工作階段中設定檔變更 是 稽核設定變更、強制執行安全策略（v2.1.49+）
WorktreeCreate 正在建立 worktree 是 自訂版控設定（取代預設 git 行為）（v2.1.50+）
WorktreeRemove 正在移除 worktree 否 自訂版控清理（v2.1.50+）
PreCompact 上下文壓縮之前 否 驗證、記錄
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"
}

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：成功：操作繼續進行。標準輸出在詳細模式下顯示（Ctrl+O）。對於 UserPromptSubmit 和 SessionStart，標準輸出會加入上下文。 - 2：阻擋錯誤：操作停止。標準錯誤成為回饋給 Claude 的錯誤訊息。 - 1、3 等：非阻擋錯誤：操作繼續。標準錯誤在詳細模式下顯示為警告。

如需進階控制，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 使用與 command 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 不支援 prompt/agent hooks。

Hook 環境變數

Hooks 可以存取環境變數來解析路徑：96

變數 可用範圍 說明
$CLAUDE_PROJECT_DIR 所有 hooks 專案根目錄（路徑含空格時請加引號）
${CLAUDE_PLUGIN_ROOT} 外掛 hooks 外掛的根目錄
$CLAUDE_ENV_FILE 僅限 SessionStart 用於為後續 Bash 命令持久化環境變數的檔案路徑
$CLAUDE_CODE_REMOTE 所有 hooks 在遠端網頁環境中設為 "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）

元件範圍 Hooks（v2.1.0+）

Hooks 可以直接在 Skills、子代理和斜線命令中使用 frontmatter 定義。這些 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 要將 Claude 整合到您現有的工具鏈中，理解 MCP 是不可或缺的。

為什麼 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 設定精靈

執行 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： - 模型：Sonnet - 模式：完整讀寫 - 工具：所有可用工具 - 適用於：複雜的研究與修改任務

Plan： - 模型：Sonnet（或使用 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 否 逗號分隔 啟動時自動將 skill 內容載入子代理上下文
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，使用與檔案式子代理相同的 frontmatter 欄位：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 for external builds

在背景中執行代理

適用於長時間執行的任務：

> 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（結束碼 2 發送回饋並讓隊友繼續工作）和 TaskCompleted（結束碼 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年1月）

延伸思考現在預設為啟用，預算為 31,999 個 token，這是先前由「ultrathink」觸發的最大預算。70 Anthropic 做出此變更是因為延伸思考能顯著提升複雜規劃和推理任務的效能。

重要： 自然語言觸發詞如「think」、「think hard」、「think harder」和「ultrathink」已不再有效。Claude 現在會將這些關鍵字視為一般提示指令，不會分配思考 token。思考預算完全由 MAX_THINKING_TOKENS 環境變數或透過 /config 控制。70

支援的模型

  • 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 叫用。

斜線命令

斜線命令提供快速存取 Claude Code 功能並啟用自訂工作流程。對於常見操作，它們比輸入完整提示更快速。

內建命令參考

命令 用途 備註
/init 以 CLAUDE.md 初始化專案 建立包含專案結構的記憶檔案
/memory 管理自動記憶 檢視和編輯自動記憶檔案（v2.1.59+）
/copy 複製程式碼區塊 互動式選取器可選擇個別程式碼區塊或完整回應；「Always copy full response」選項可跳過未來呼叫的選取器（v2.1.59+，v2.1.63 增強）111
/context 檢視上下文視窗使用量 顯示視覺化分析
/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
/fork 分支對話 在不遺失上下文的情況下探索替代方案
/clear 清除對話歷史 全新開始
/vim 啟用 vim 編輯模式 模態編輯
/ide 連接 IDE VS Code/JetBrains 整合
/sandbox 啟用沙箱模式 隔離環境
/status 檢視工作階段狀態 模型、設定等
/statusline 自訂狀態列 設定顯示內容
/model 變更 AI 模型 /model opus
/fast 切換快速模式 相同模型，更快輸出（v2.1.36+）
/output-style 設定輸出樣式 Explanatory、Learning、自訂
/agents 管理 subagents 建立、編輯、刪除
/bashes 列出背景任務 長時間執行的命令
/tasks 列出背景代理 監控非同步任務
/export 匯出對話 儲存記錄
/add-dir 新增工作目錄 擴展存取範圍
/terminal-setup 設定終端機 支援 Kitty、Alacritty、Zed、Warp25
/login 在工作階段中驗證 切換帳號或重新驗證
/logout 在工作階段中登出 清除憑證
/doctor 檢查安裝狀態 健康檢查
/bug 回報錯誤 向 Anthropic 提交問題
/release-notes 檢視版本說明 查看最新變更
/rewind 返回檢查點 復原變更（或按 Esc×2）
/theme 管理主題 Ctrl+T 切換語法高亮
/plugin 管理外掛程式 安裝、更新、移除外掛程式
/passes 訪客通行證（僅限 Max） 分享 3 張 Claude Code Pro 試用通行證62
/simplify 簡化程式碼 內建斜線命令（v2.1.63+）111
/batch 批次操作 內建斜線命令（v2.1.63+）111

自訂命令建立

在 .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 叫用。

命令前置中繼資料選項

---
description: Brief description for /help
allowed-tools: Read, Edit, Bash(npm:*)
model: opus
argument-hint: [arg1] [arg2]
disable-model-invocation: false
---
選項 用途
description 說明文字與自動委派匹配
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

### 金額處理規則
- 所有金額值以整數儲存（以分為單位，非元）
- 幣別必須明確追蹤（絕不假設為 USD）
- 捨入方式：計算時使用 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;
}

快速參考

手續費計算

  • Interchange：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 - AML 檢查
  • 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 是否會啟用它：

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）：**
```bash
# 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： - 您想要明確控制呼叫時機（使用斜線指令） - 任務需要獨立的上下文（使用 subagent） - 這是一次性的提示（直接輸入即可） - 這個「skill」實際上只是單一範本（使用斜線指令）

進階技巧： 如果您發現自己在處理驗證程式碼前反覆輸入 /security-review，請將其轉換為 skill。讓專業知識成為環境中的背景，而非需要明確呼叫的功能。如果您需要明確呼叫，則保留為指令。

Plugin 系統

Plugins 將 Claude Code 的擴充功能封裝以便發佈。一個 plugin 可以包含自訂指令、subagents、skills、hooks 和 MCP 伺服器。Anthropic 於 2025 年 12 月正式推出了 plugin 市集，收錄了 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

本地開發

建立本地市集以供測試：

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 registry 以及從 npm 來源安裝時的特定版本鎖定。市集操作的預設 git 逾時時間從 30 秒增加至 120 秒，可透過 CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS 進行設定。105

Plugin 元件

  • 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

## 架構
- 單一儲存庫（Monorepo），套件位於 /packages
- 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` - 檢查程式碼風格
- `npm run lint:fix` - 自動修正程式碼風格問題
- `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 變更時務必建立 migration
多資料表操作請使用交易（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 所記錄的內容。

若要停用，可在啟動時傳入 --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 可以分析圖片：截圖、圖表、設計稿、錯誤訊息、資料庫 schema。

輸入方式

  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 問題：「這是錯誤的截圖，是什麼原因造成的？」
  • 實作設計稿：「根據這份設計稿建立此元件」
  • 分析圖表：「解釋這張架構圖」
  • 資料庫 schema：「根據這份 ERD 建立 Prisma models」
  • 錯誤分析：「這張錯誤截圖代表什麼意思？」

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

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 - 大型 PDF（>10 頁）在使用 @ 提及時會返回輕量參照，完整內容按需載入

Git 整合如何運作？

Claude Code 具備深度 git 整合，並內建安全防護機制。

安全防護機制

  • 自動遵守 .gitignore
  • 未經許可不會修改分支
  • 提交前顯示差異
  • 遵循專案的提交慣例
  • 未經明確要求絕不執行 force push
  • 修改提交前檢查作者身份

常見工作流程

建立提交：

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

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

建立 pull request：

> 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'

## 如何在 IDE 中使用 Claude Code？

### VS Code 擴充功能

**需求：** VS Code 1.98.0+

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

**功能：**
- 側邊欄面板（Spark 圖示）
- Plan mode 搭配差異預覽
- 自動接受編輯切換
- 延伸思考切換
- 檔案附加與圖片貼上
- 對話歷史記錄
- 多個同時進行的工作階段

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

**第三方供應商設定**（在 `.claude/settings.json` 中）：
```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的網頁介面在雲端運行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旗標

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

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使用者的研究預覽版。

效能最佳化

降低延遲

模型選擇： - 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

平行操作

子代理平行化： 多個子代理可同時執行。每個子代理獨立運作，不會污染主要情境。

背景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

子代理也支援在其定義中使用isolation: "worktree"，為每個子代理提供隔離的儲存庫副本，若未進行任何變更將自動清理。103對於非git版本控制系統，可設定WorktreeCreate/WorktreeRemove hooks來處理自訂的建立和拆除流程。103

跨worktree共享狀態（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+）：當shell快照可用時，BashTool現在預設略過登入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

使用claude auth logout && claude auth login在API key和OAuth之間切換，或在不同組織之間切換時重設驗證。

除錯模式

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” 無效或過期的token 執行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 報告（可透過業務團隊在 NDA 下取得） - 雲端供應商（AWS、GCP、Azure）各自擁有合規認證（SOC 2、HIPAA BAA、ISO 27001、FedRAMP）——透過它們路由即可繼承其合規態勢 - 對於受監管產業（醫療、金融），建議透過具備適當 BAA 或合規附錄的雲端供應商路由，而非直接使用 API

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

Analytics API（管理員）

企業版和團隊版方案可存取 Claude Code Analytics API，進行程式化用量追蹤。

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

驗證方式： 需要管理員 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）

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

鍵盤快捷鍵參考

一般控制

快捷鍵 動作
Ctrl+C 取消目前操作
Ctrl+D 結束會話（EOF）
Ctrl+L 清除畫面（保留歷史記錄）
Ctrl+O 切換詳細輸出
Ctrl+R 搜尋指令歷史
Ctrl+V 從剪貼簿貼上圖片
Ctrl+B 將目前操作轉至背景執行
Ctrl+F 終止所有背景代理（v2.1.47+）
Ctrl+Y 貼上（從 kill ring 貼上）
Ctrl+S 暫存提示草稿（儲存目前輸入）
Alt+Y 循環貼上（在 Ctrl+Y 後循環 kill ring）
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經常能發現人類審查者遺漏的邏輯錯誤和安全問題。

基於容器的自主化操作

若要完全自主化操作，可在帶有 tmux 作為控制層的Docker容器中執行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、prompt stashing）。
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 Releases：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 擴充套件

您獲得的優勢：作業系統層級沙箱、12+ hook 生命週期事件、搭配 OAuth 的遠端 MCP、具隔離上下文的 subagent 委派，以及 --teleport 雲端到本地交接。Copilot CLI（2026年1月起）現已具備代理式功能——此比較為功能差異化，而非能力落差。

交叉整合（2026年2月）： Claude（Opus 4.6 和 Sonnet 4.6）現已作為程式碼代理內建於 GitHub Copilot，供 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 規則（.mdc）+ AGENTS.md CLAUDE.md + Skills
背景代理 遠端代理（& 前綴、--teleport）

您獲得的優勢：12+ 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  Opus 4.6 with 1M context (beta)     ║
║    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                         ║
║    /init           Set up project config                      ║
║    /mcp            Configure integrations                     ║
║    /copy           Copy code blocks (interactive picker)      ║
║    /memory         View and manage auto-memory                ║
║    /simplify       Simplify code (bundled, v2.1.63+)         ║
║    /batch          Batch operations (bundled, v2.1.63+)      ║
║    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-02 指南 v2.12：Task 工具→Agent 工具重新命名文件化（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" 處理器文件。/copy「永遠複製完整回覆」選項。VSCode 工作階段重新命名/移除。/clear 技能快取重設修正。多項記憶體洩漏修正。REPL 橋接競爭條件修正。GitHub Copilot Business/Pro Claude 可用性交叉參照。 111112
2026-02-27 指南 v2.10：新增 v2.1.58–v2.1.62 功能。/copy 命令（互動式程式碼區塊選擇器）。/memory 命令增強自動記憶管理。Remote Control 擴展至更多使用者（v2.1.58）。業界採用統計：4% 的GitHub提交（約 135K/天）。CVE-2025-59536 及 CVE-2026-21852 安全公告新增至不受信任儲存庫警告。提示建議快取修正（v2.1.62）。Windows 並行寫入設定檔損毀修正（v2.1.61）。改善 bash「永遠允許」複合命令前綴建議。多代理工作階段記憶體使用改善。MCP OAuth 權杖刷新競爭條件修正。 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 閃爍、修正批次代理終止（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 為標頭中環境變數插值的必要條件；HTTP hooks 透過沙箱代理路由。工具結果磁碟持久化閾值降至 50K 字元（原為 100K）。BashTool 預設跳過登入 shell。外掛改善：自訂 npm 登錄檔、版本固定、可設定 git 逾時。/model 選擇器顯示人類可讀標籤。SDK 呼叫者身分環境變數。Agent Teams 隊友計畫核准。 105
2026-02-24 新增：v2.1.51——claude remote-control 子命令用於外部建置、allowedEnvVars 用於 HTTP hook 環境變數插值安全性、HTTP hooks 透過沙箱網路代理路由、工具結果 >50K 字元持久化至磁碟（原為 100K）、BashTool 預設跳過登入 shell、外掛市集 git 逾時可設定（CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS）、外掛自訂 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：修正快速模式定價表——移除錯誤的 >200K 分級定價（$60/$225）。官方Anthropic定價確認全上下文視窗統一 $30/$150，無長上下文附加費。新增 web fetch（免費）至隱藏工具費用表。新增包含 web_search/web_fetch 工具時程式碼執行免費。新增失敗的網路搜尋不計費。 1
2026-02-21 指南 v2.6：新增 v2.1.49 及 v2.1.50 功能。新 hook 事件：ConfigChange、WorktreeCreate、WorktreeRemove（共 17 個）。新 --worktree/-w 旗標用於隔離式 git worktrees。子代理 isolation: "worktree" 及 background: true 欄位。claude agents CLI 命令。CLAUDE_CODE_DISABLE_1M_CONTEXT 環境變數。Opus 4.6 快速模式現包含完整 1M 上下文。Claude Code Security（研究預覽）。 —
2026-02-20 新增：v2.1.50——LSP 伺服器 startupTimeout、WorktreeCreate/WorktreeRemove hook 事件用於自訂 VCS 設定/拆卸、代理定義中的 isolation: worktree、claude agents CLI 命令、CLAUDE_CODE_DISABLE_1M_CONTEXT 環境變數、Opus 4.6 快速模式現包含完整 1M 上下文視窗、VSCode /extra-usage 命令支援。CLAUDE_CODE_SIMPLE 現停用MCP工具、附件、hooks 及 CLAUDE.md 載入。修正：符號連結工作階段不可見、SSH斷線時工作階段資料遺失、代理團隊記憶體洩漏（已完成任務未被 GC 回收）、/mcp reconnect 對不存在的伺服器凍結、LSP 診斷資料記憶體洩漏、提示建議快取回歸、Edit 工具 Unicode 彎引號損毀。Linux：修正 glibc < 2.30（RHEL 8）上的原生模組。長時間工作階段的多項記憶體最佳化改善。 103
2026-02-19 新增：v2.1.49——--worktree（-w）旗標在隔離式 git worktree 中啟動Claude、子代理支援 isolation: "worktree" 用於臨時 git worktree 工作、代理定義支援 background: true 永遠以背景任務執行、ConfigChange hook 事件用於企業安全稽核、外掛可附帶 settings.json 作為預設設定、SDK 模型資訊現包含 supportsEffort/supportedEffortLevels/supportsAdaptiveThinking 欄位。CLAUDE_CODE_SIMPLE 現包含檔案編輯工具。Sonnet 4.5 含 1M 上下文已移除，改用 Sonnet 4.6。改善MCP OAuth的逐步驗證及探索快取。修正：背景代理時 Ctrl+C 及 ESC 被忽略、無限制 WASM 記憶體增長、disableAllHooks 受管理設定階層、--resume 顯示原始 XML 標籤。改善權限提示以顯示限制原因。 103
2026-02-20 Claude Code Security（研究預覽）：內建於網頁版Claude Code的弱點掃描。掃描程式碼庫並建議修補供人工審查。提供給 Enterprise、Team 及開源維護者。 104
2026-02-18 新增：v2.1.47——Ctrl+F 終止所有背景代理（取代雙擊 ESC）、Stop/SubagentStop hook 輸入中的 last_assistant_message 欄位、chat:newline 快捷鍵動作、statusline JSON 中的 added_dirs、/rename 更新終端分頁標題、恢復選擇器顯示 50 個工作階段（原為 10 個）、隊友導覽簡化為僅 Shift+Down。效能：約 500ms 啟動改善（延遲 SessionStart hooks）、記憶體改善（釋放API串流緩衝區、O(n²) 進度更新修正）。修正：壓縮後保留計畫模式、Edit 工具 Unicode 彎引號損毀、CJK 全形字元對齊、並行代理API 400 錯誤、/resume 丟棄大型工作階段（>16KB）、壓縮後工作階段名稱遺失、背景代理結果回傳原始逐字稿、多項 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 連接器章節、恢復選擇器 50 個工作階段更新。 —
2026-02-17 重大更新：Claude Sonnet 4.6 發布。模型 ID：claude-sonnet-4-6。取代 Sonnet 4.5 成為 claude.ai 及Claude Cowork 的預設模型。定價不變（$3/$15 每 MTok）。改善代理搜尋效能並減少權杖用量。支援自適應思考、延伸思考及 1M 權杖上下文視窗（測試版）。64K 最大輸出。知識截止日期：可靠至 2025 年 8 月，訓練至 2026 年 1 月。Sonnet 4.5 移至舊版。另：API程式碼執行搭配 web search/web fetch 現為免費，web search 工具及程式化工具呼叫現已正式推出（無需 beta 標頭）。 100
2026-02-17 指南 v2.4：更新所有模型表格以納入 Sonnet 4.6、新增 Sonnet 4.6 至延伸思考支援模型、更新註腳及定價參考。 —
2026-02-14 新增：v2.1.44——修正深層巢狀目錄路徑的 ENAMETOOLONG 錯誤、修正驗證刷新錯誤。v2.1.43——修正 AWS 驗證刷新卡住（3 分鐘逾時）、修正 .claude/agents/ 中非代理 markdown 檔案的多餘警告、修正 Vertex/Bedrock 上無條件發送結構化輸出 beta 標頭。 101
2026-02-16 指南 v2.3：移除已過期的快速模式促銷定價（2 月 16 日截止已過）、新增 >200K 長上下文快速模式層級（$60/$225）、修正 protect-files.sh 結束碼（1→2 用於阻擋）、修正 3 處過時的 Tab→Alt+T 快捷鍵參考、改寫 Copilot/Cursor 遷移表（兩者現皆有代理式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 等）、新增不受信任儲存庫的提示注入安全警告。新增快速入門章節、專門計畫模式章節、擴展非互動模式（-p）文件含結束碼及 CI/CD 模式、修正所有 --session-id 範例（需 UUID；遷移至 /rename + --resume）、新增 [RESEARCH PREVIEW] 標記至 Remote 及 Slack 章節、標記 1 個未標記的程式碼區塊、驗證所有 35 個目錄錨點。評估後修正：TL;DR 模型建議改為層級中立、jq // 模式修正為 select()、--input-file 虛構旗標替換為管道、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 驗證刷新無限期卡住（新增 3 分鐘逾時）、含錨點片段的 @-mentions（如 @README.md#installation）、FileReadTool 在 FIFOs//dev/stdin/大型檔案上阻塞、串流 Agent SDK 模式中的背景任務通知、分類器規則輸入中游標跳動、markdown 連結顯示文字在原始 URL 時丟失、自動壓縮失敗通知顯示給使用者、子代理經過時間納入權限等待時間、計畫模式中的主動 ticks 觸發、設定變更時過期權限規則未清除、hook 阻擋錯誤在 UI 中顯示 stderr。 97
2026-02-12 準確性及完整性審查：修正 hooks 表——Stop、SubagentStop、TeammateIdle、TaskCompleted 皆可透過結束碼 2 阻擋。新增 PostToolUseFailure 事件。新增提示型 hooks（type: "prompt"）及代理型 hooks（type: "agent"）文件。更新 PreToolUse 為偏好的 hookSpecificOutput 格式（棄用頂層 decision）。新增 hook 環境變數（$CLAUDE_PROJECT_DIR、$CLAUDE_ENV_FILE）。新增CLI --agents 旗標用於工作階段範圍的子代理定義。擴展子代理設定表：disallowedTools、maxTurns、mcpServers、hooks、delegate 權限模式。 96
2026-02-10 新增：v2.1.39——改善終端渲染效能。修正：致命錯誤被吞掉而非顯示、工作階段關閉後程序卡住、終端螢幕邊界字元遺失、詳細逐字稿檢視中的空白行。 95
2026-02-10 新增：v2.1.38——安全性：沙箱模式下阻擋寫入 .claude/skills（防止提示注入修改技能定義）、改善 heredoc 分隔符號解析以防止命令走私。修正：VS Code 終端捲動至頂部回歸、Tab 鍵排入斜線命令而非自動完成、使用環境變數包裝器命令的 bash 權限比對、非串流模式下工具使用之間的文字消失、VS Code 中恢復時重複工作階段。 95
2026-02-08 新增：v2.1.37——修正啟用 /extra-usage 後 /fast 未立即可用。 93
2026-02-08 新增：v2.1.36——Opus 4.6 現可使用快速模式。相同模型，更快輸出，採用進階定價（標準費率的 6 倍，至 2 月 16 日前 50% 促銷折扣）。使用 /fast 切換。 93
2026-02-07 新增：v2.1.34——安全修正：透過 sandbox.excludedCommands 或 dangerouslyDisableSandbox 排除於沙箱外的命令，在啟用 autoAllowBashIfSandboxed 時可繞過 Bash 詢問權限規則。另修正代理團隊設定在渲染間變更時的當機。 94
2026-02-05 新增：v2.1.33——多代理工作流程的 TeammateIdle 及 TaskCompleted hook 事件、Task(agent_type) 語法用於限制代理 tools frontmatter 中可生成的子代理、代理 memory frontmatter 欄位（user/project/local 範圍）、外掛名稱顯示於技能描述及 /skills 選單。修正：tmux 中代理隊友工作階段無法發送/接收訊息、不支援方案上的代理團隊可用性警告、提交新訊息時延伸思考中斷、含空白+思考區塊的中途中止API錯誤、API代理 404 串流回退、settings.json 環境變數的代理設定未套用至 WebFetch、/resume 工作階段選擇器顯示原始 XML 標記。改善：API連線錯誤訊息現顯示具體原因（ECONNREFUSED、SSL 錯誤）。VSCode：OAuth使用者的遠端工作階段支援、工作階段選擇器中的 git 分支+訊息數量及分支搜尋、捲動至底部修正。 92
2026-02-05 重大更新：Claude Opus 4.6 發布。模型 ID：claude-opus-4-6。1M 權杖上下文視窗（測試版）——首個具備此容量的 Opus 級模型。128K 最大輸出權杖。自適應思考（自動推理深度）。投入程度控制（低/中/高/最大）。上下文壓縮測試版。代理團隊研究預覽（多代理並行協調）。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。長上下文（>200K 輸入）：$10/$37.50。 86
2026-02-05 新增：v2.1.32——Opus 4.6 支援、代理團隊研究預覽（需 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1）、自動記憶錄製/回憶、訊息選擇器中「從此處摘要」用於部分對話摘要、--add-dir 目錄中的技能自動載入、技能字元預算隨上下文視窗縮放（上下文的 2%）。修正：子目錄中 @ 檔案完成的錯誤相對路徑、--resume 現重用上次工作階段的 --agent 值、JavaScript heredoc 中的樣板字面值導致 bash「Bad substitution」錯誤、泰文/寮文間距母音渲染。VSCode：斜線命令執行修正、過往對話列表的載入指示器。 87
2026-02-04 GitHub整合：Claude及 Codex 現於GitHub公開預覽——透過 Agent HQ 提供給 Copilot Pro+ 及 Enterprise 客戶作為編碼代理。Opus 4.6 於GitHub Copilot 正式推出。90 90
2026-02-04 新增：v2.1.31——退出時顯示工作階段恢復提示、日文 IME 全形（全角）空格在核取方塊選擇中的輸入。修正：PDF 錯誤永久鎖定工作階段、沙箱模式中 bash「唯讀檔案系統」錯誤、缺少 ~/.claude.json 欄位時計畫模式當機、串流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伺服器預設OAuth客戶端憑證（如 Slack）、/debug 命令用於疑難排解、唯讀模式新增 git log/git show 旗標、Task 工具結果中的權杖計數/工具使用次數/持續時間指標、reducedMotion 設定選項。--resume 記憶體減少 68%（基於統計的工作階段載入）。修正：API歷史中的幽靈「(no content)」文字區塊（減少權杖浪費）、工具變更的提示快取失效、/login 後含思考區塊的 400 錯誤、恢復損毀逐字稿時卡住、Max 20x 的速率限制訊息、權限對話框搶奪焦點、子代理無法存取SDK提供的MCP工具、Windows bash 搭配 .bashrc。 83
2026-01-31 新增：v2.1.29——修正恢復含 saved_hook_context 工作階段時的啟動效能回歸。 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 中直接啟用子代理、背景任務及外掛，無需離開 IDE。在 SwiftUI 開發期間擷取 Xcode Previews 進行視覺迭代。 85
2026-01-30 新增：v2.1.27——--from-pr 旗標恢復連結至GitHub PR 編號/URL 的工作階段、透過 gh pr create 建立時工作階段自動連結至 PR、除錯日誌中的工具呼叫失敗/拒絕、VSCode Claude in Chrome 整合啟用。修正：閘道器使用者的上下文管理驗證、/context 彩色輸出、狀態列重複背景任務指示器、權限優先順序（內容層級 ask > 工具層級 allow）。Windows：bash 執行搭配 .bashrc、主控台視窗閃爍。VSCode：OAuth權杖過期導致 401 錯誤。 81
2026-01-29 新增：v2.1.25——修正 Bedrock 及 Vertex 閘道器使用者的 beta 標頭驗證錯誤。替代方案：CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1。 80
2026-01-28 新增：v2.1.23——spinnerVerbs 設定用於自訂載入動畫文字、企業環境的 mTLS/代理連線修正、每使用者暫存目錄隔離、ripgrep 逾時錯誤回報（原為靜默回傳空結果）、提示頁尾中已合併 PR 的紫色狀態指示器、bash 逾時持續時間顯示。修正：提示快取競爭條件、無頭模式中待處理非同步 hooks 未被取消、Tab 完成未更新輸入、無頭模式中 Bedrock 區域顯示。 76
2026-01-28 新增：v2.1.22——修正非互動（-p）模式的結構化輸出。 75
2026-01-28 新增：v2.1.21——VSCode 中的Python venv 自動啟用（claudeCode.usePythonEnvironment 設定）、日文 IME 全形（全角）數字輸入支援、Read/搜尋進度指示器（「Reading…」→「Read」）、Claude現優先使用檔案操作工具而非 bash 等效工具。修正：退出時 shell 完成快取截斷、恢復工具執行期間中斷的工作階段時的API錯誤、大輸出限制模型上自動壓縮過早觸發、刪除後任務 ID 重用、VSCode 中 Windows 檔案搜尋。 74
2026-01-28 新增：MCP Apps（Claude內的互動式工具 UI，用於 Asana、Figma、Slack 等）。Code Execution Tool v2（Bash 執行取代僅限Python，程式化工具呼叫）。網頁版Claude Code擴展至 Team/Enterprise 進階席位。 737879
2026-01-27 新增：v2.1.20——--add-dir 旗標從額外目錄載入 CLAUDE.md（需 CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1）、提示頁尾中的 PR 審查狀態指示器（彩色圓點顯示已核准/要求變更/待審/草稿）、透過 TaskUpdate 工具刪除任務、vim 方向鍵歷史導覽、/copy 命令對所有使用者開放、帶時戳的設定備份（輪換，保留最近 5 份）。修正：恢復時工作階段壓縮載入完整歷史、代理工作中忽略使用者訊息、全形字元（表情符號/CJK）渲染偽影、MCP回應中含 Unicode 的JSON解析。 72
2026-01-26 增強：分析API章節含詳細端點文件、指標表、curl 範例及限制。現包含驗證需求、可用指標（生產力、工具使用、成本）及即時監控替代方案。 53
2026-01-24 新增：v2.1.19——自訂命令引數的 $0、$1 簡寫（從 $ARGUMENTS.0 改為 $ARGUMENTS[0] 方括號語法）、CLAUDE_CODE_ENABLE_TASKS 環境變數停用新任務系統、無額外權限/hooks 的技能不再需要核准。VSCode：所有使用者啟用工作階段分叉及倒回。SDK：queued_command 重播為 SDKUserMessageReplay 事件。修正：終端關閉時殘留程序、git worktrees 中的 /rename//tag、提示暫存（Ctrl+S）時貼上文字遺失、代理模型顯示、背景化 hook 命令未提前返回、檔案寫入預覽省略空行。 71
2026-01-24 新增：v2.1.17——修正不支援 AVX 指令集處理器上的當機。 71
2026-01-24 重大變更：延伸思考現預設啟用，配置 31,999 個權杖。自然語言觸發器（think、think hard、ultrathink）已棄用，不再分配思考權杖——請改用 MAX_THINKING_TOKENS 環境變數或 /config。已更新延伸思考章節為當前行為。 70
2026-01-24 新增：v2.1.18——可自訂鍵盤快捷鍵，含上下文專屬按鍵綁定、組合序列及透過 /keybindings 命令完全個人化。設定儲存於 ~/.claude/keybindings.json。 77
2026-01-24 新增：v2.1.16——含相依性追蹤的任務管理系統、VSCode 原生外掛管理支援、OAuth使用者可從 Sessions 對話方塊瀏覽/恢復遠端工作階段。修正：子代理恢復時記憶體不足當機、/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）、已安裝列表中的外掛搜尋、將外掛固定至 git commit SHA、VSCode /usage 命令。關鍵修正：上下文視窗阻擋限制（約 65%→約 98%）、並行子代理記憶體當機、長時間工作階段記憶體洩漏、bash 模式中 @ 符號檔案自動完成、/feedback 無效 URL、/context 權杖計數顯示、斜線命令自動完成選擇錯誤。 67
2026-01-20 新增：v2.1.12（訊息渲染錯誤修正）。修正 Setup hook 版本為 v2.1.10 含完整發行說明：’c’ 鍵盤快捷鍵用於OAuth URL 複製、改善啟動按鍵擷取、檔案建議作為可移除附件、VSCode 外掛安裝計數及信任警告。新增 teleport 單向限制說明。 66
2026-01-19 文件更新：新增 SubagentStart hook 至事件表、擴展 PreToolUse hooks 的 additionalContext 文件（v2.1.9）、擴展 LSP 工具功能章節、增強「值得關注的人物」含內容創作者及官方資源。 —
2026-01-19 新增：Setup hook 事件（v2.1.10）——透過 --init、--init-only 或 --maintenance CLI旗標觸發，用於環境設定任務。 60
2026-01-18 新增：多帳號政策章節（允許事項、技術限制、禁止事項）。新增社群技巧章節（計畫模式自動清除上下文、/clear、截圖、容器模式）。新增值得關注的人物（Boris Cherny、Thariq、Jeffrey Emanuel）。新增API權杖定價表。 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%，85% 權杖開銷降低）。更新MCP生態系統統計（每月 1 億次下載、3,000+ 伺服器）。 54
2026-01-16 新增：Claude Code Analytics API章節——Team/Enterprise 透過 Admin API端點 /v1/organizations/usage_report/claude_code 程式化存取使用指標（工作階段、提交、PR、程式碼行數）。記錄 ${CLAUDE_SESSION_ID} 技能替換（v2.1.9）。 5153
2026-01-15 新增：v2.1.9 MCP tool search 閾值的 auto:N 語法、plansDirectory 設定、AskUserQuestion 中的外部編輯器（Ctrl+G）、網頁工作階段提交/PR 的工作階段 URL 歸因、PreToolUse hooks additionalContext。修正並行工具呼叫API錯誤、MCP重連卡住、Kitty 中的 Ctrl+Z。新增 Cowork（面向非技術使用者的 GUI 版本）。 5152
2026-01-15 新增：v2.1.7 權限回饋功能（接受權限提示時提供回饋）。GitHub Action v1.0 正式發布。小幅文件更新。 48
2026-01-14 新增：v2.1.7 MCP tool search 自動模式預設啟用（超過 10% 上下文的工具延遲載入）、showTurnDuration 設定、任務通知中的內嵌代理回應、萬用字元權限比對複合命令的安全修正。v2.1.6：/config 搜尋、/doctor 更新章節、/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 技能 frontmatter 選項用於隔離式上下文。新增子代理權限拒絕復原能力（v2.1.0+）。新增外掛市集上線資訊（2025 年 12 月 36 個精選外掛）。 47
2026-01-12 新增：v2.1.4 CLAUDE_CODE_DISABLE_BACKGROUND_TASKS 環境變數停用所有背景任務功能，包含自動背景化及 Ctrl+B 快捷鍵。修正OAuth權杖刷新的「Help improve Claude」設定。 46
2026-01-10 新增：沙箱減少 84% 權限提示（來自Anthropic工程部落格）、Opus 4.5 SWE-bench 效能（80.9%）及權杖效率改善。小幅文件更新。 45
2026-01-10 新增：v2.1.3 合併斜線命令及技能（統一心智模型）、/config 中的發行通道切換（stable/latest）、/doctor 偵測無法觸及的權限規則、hook 執行逾時從 60 秒增加至 10 分鐘。錯誤修正：/clear 後計畫檔案持續存在、ExFAT 上的技能重複偵測、背景任務計數不一致、壓縮期間子代理使用錯誤模型。VSCode：權限的可點擊目標選擇器。 44
2026-01-09 新增：v2.1.1（109 項CLI改進）、元件範圍 Hooks（技能/命令 frontmatter 中的 hooks 含 once 選項）、新MCP伺服器（Figma Dev Mode、Sequential Thinking、Magic UI、Context7）。更新MCP生態系統計數至 3,000+ 伺服器。 414243
2026-01-08 新增：settings.json 參考中的 language 及 respectGitignore 設定。新增 IS_DEMO 環境變數。更新多行輸入以顯示 Shift+Enter 在 iTerm2/WezTerm/Ghostty/Kitty 中開箱即用。新增每組織每月 1,550 小時免費程式碼執行。 3740
2026-01-08 新增：v2.1.2 工具輸出中可點擊的檔案路徑（iTerm 的 OSC 8）、Windows Package Manager（winget）支援、計畫模式中 Shift+Tab 用於「自動接受編輯」、FORCE_AUTOUPDATE_PLUGINS 環境變數、SessionStart hook 中的 agent_type 欄位。安全修正：bash 處理中的命令注入、tree-sitter 記憶體洩漏。更新思考切換為 Alt+T。新增MCP萬用字元權限語法（mcp__server__*）。新增 PreToolUse hooks 搭配 ask 權限的 updatedInput。 39
2026-01-07 新增：v2.1.0 自動技能熱重載（~/.claude/skills 或 .claude/skills 中的技能無需重啟即時可用）。安全性：CVE-2025-52882 WebSocket 驗證繞過已於 IDE 擴充 v1.0.24+ 修補。 3738
2026-01-06 新增：v2.0.74 可點擊的圖片連結（[Image #N]）、/context 分組顯示、git 儲存庫中檔案 @ mentions 快 3 倍、.ignore 及 .rgignore 支援、Claude Agent SDK v0.1.74 343536
2025-12-28 新增：具名工作階段（/rename、/resume <n>）、外掛探索搜尋篩選、--fork-session 含自訂工作階段 ID、Agent Skills 章節、非同步子代理、Claude Agent SDK（從Claude Code SDK重新命名）、Alt+Y yank-pop、Alt+T 思考切換、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 整合、提示建議、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。「子代理文件。」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 應用程式。」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。「外掛探索搜尋篩選、透過 –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 Pro/Max 訂閱用戶2025年12月25日至31日使用量加倍。」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 含 ask 的 updatedInput。」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 伺服器公開您所選圖層的即時結構——層級架構、自動佈局、變體、文字樣式和設計代幣參照。」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 環境變數，修復「協助改善 Claude」設定的 OAuth token 刷新問題。」2026年1月。 ↩

  47. VentureBeat。「Claude Code 2.1.0：透過技能前文 context: fork 分叉子代理上下文，代理在權限拒絕後繼續執行。」2026年1月。GitHub ykdojo/claude-code-tips。「Anthropic 於2025年12月正式推出外掛市集，包含36個精選外掛。」 ↩↩↩↩

  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 應用程式處理 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。「Advent of Claude 第15天：–dangerously-skip-permissions 旗標（YOLO 模式）用於完全自主運作。」2026年1月。 ↩

  62. @adocomplete。「Claude Max 訂閱用戶可透過 /passes 命令獲得3張訪客通行證，與他人分享 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 網頁版現已提供研究預覽版，供擁有高級席位的 Team 和 Enterprise 使用者使用，Pro 和 Max 使用者亦可使用。」2026年1月26日。 ↩↩

  74. GitHub Releases。「v2.1.21：日文 IME 全形數字輸入、VSCode 中 Python venv 自動啟用（claudeCode.usePythonEnvironment）、Read/搜尋進度指示器、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/代理連線修復、每使用者暫存目錄隔離、ripgrep 逾時報告、已合併 PR 紫色指示器、bash 逾時顯示。修復：提示快取競爭條件、無頭模式中的非同步 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 標頭驗證錯誤。暫時解決方案：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 回傳輕量參照、OAuth 預設 MCP 設定（Slack）、/debug 命令、–resume 記憶體使用減少68%、幽靈 ‘(no content)’ 文字區塊修復、提示快取失效修復、子代理存取 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日。1M token 上下文（測試版）、128K 最大輸出、自適應思考、努力控制、代理團隊、Terminal-Bench 2.0 最高分、GDPval-AA 比 GPT-5.2 高 +144 Elo、發現超過500個零日漏洞。每 MTok $5/$25。另請參閱 TechCrunch、CNBC、Anthropic Pricing。 ↩↩↩↩↩↩↩↩↩

  87. GitHub Releases。「v2.1.32：Opus 4.6 支援、代理團隊研究預覽、自動記憶記錄、從此處摘要、來自 –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 現在支援代理團隊（研究預覽版）——主導代理可委派給多個隊友，這些隊友可平行進行研究、除錯和建構，同時相互協調。」 ↩↩

  92. GitHub Releases。「v2.1.33：TeammateIdle 和 TaskCompleted hook 事件、Task(agent_type) 子代理限制語法、代理的 memory 前文、外掛名稱顯示在技能描述中。修復：tmux 代理隊友工作階段、代理團隊計畫警告、擴展思考中斷、API 代理 404 回退、WebFetch 代理設定、/resume XML 標記。VSCode：OAuth 遠端工作階段、工作階段選擇器中的 git 分支。」2026年2月。 ↩↩

  93. GitHub Releases。「v2.1.36：Opus 4.6 現已提供 Fast 模式。」2026年2月7日。Simon Willison。「Claude：使用 fast 模式加速回應。」Fast 模式定價：標準費率的6倍（Opus 4.6 ≤200K 輸入每 MTok $30/$150；>200K 輸入 $60/$225）。上市促銷（50%折扣）持續至2026年2月16日。v2.1.37：修復啟用 /extra-usage 後 /fast 無法立即使用的問題。Anthropic Pricing。 ↩↩↩↩

  94. GitHub Releases。「v2.1.34：修復代理團隊設定在渲染間變更時的崩潰。修復啟用 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 在測試版中將此擴展至1M 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、擴展思考、1M 上下文（測試版）。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 驗證刷新3分鐘逾時修復、偽 .claude/agents/ markdown 警告修復、Vertex/Bedrock 的結構化輸出 beta 標頭修復。v2.1.44：深層巢狀目錄的 ENAMETOOLONG 修復、驗證刷新錯誤修復。 ↩

  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 狀態列欄位、/rename 終端機分頁標題、恢復選擇器50個工作階段、約500毫秒啟動改進、記憶體改進、CJK 對齊修復、計畫模式壓縮修復、Edit 工具 Unicode 修復、多項 Windows 修復。 ↩↩↩↩

  103. Claude Code GitHub CHANGELOG。v2.1.49（2月19日）：--worktree（-w）旗標、子代理的 isolation: "worktree"、代理定義的 background: true、ConfigChange hook 事件、MCP OAuth 逐步驗證、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 fast 模式完整1M 上下文、CLAUDE_CODE_SIMPLE 停用 MCP/hooks/CLAUDE.md、VSCode /extra-usage、代理團隊記憶體洩漏修復、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 跳過登入 shell、外掛 npm 登錄檔/版本釘選、/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。「團隊設定：~/.claude/teams/{team-name}/config.json。任務清單：~/.claude/tasks/{team-name}/。任務相依性自動解除阻塞。Shift+Down 循環切換隊友（回繞至主導）。」 ↩↩

  107. GitHub Releases。「v2.1.59（2月26日）：Claude 自動將有用的上下文儲存至自動記憶（透過 /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。「公開 GitHub 提交的4%（每天約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 內建斜線命令、工作樹共享專案設定和自動記憶、ENABLE_CLAUDEAI_MCP_SERVERS=false 停用選項、HTTP hooks type: http 處理器、/copy「永遠複製完整回應」選項、VSCode 工作階段重新命名/移除、/clear 重設技能快取、多項記憶體洩漏修復、REPL 橋接競爭條件修復。」2026年2月28日。 ↩↩↩↩↩↩↩

  112. GitHub Blog。「Claude 和 Codex 現已提供給 Copilot Business 和 Pro 使用者。」2026年2月26日。將 Claude 的可用範圍從 Copilot Pro+ 和 Enterprise 擴展至所有付費 Copilot 方案。 ↩↩

  113. Claude Code Docs。「在 v2.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日。 ↩↩

$ echo "Maintained by Blake Crosley"
Maintained by Blake Crosley | Last updated 2026-03-05
NORMAL claude-code.md EOF
實驗室

開發中

ResumeGeni

resumegeni.com

AI驅動的履歷優化

開發中

Return

941return.com

健康追蹤與洞察

開發中

Banana List

941getbananas.com

智慧購物清單

開發中

H3arted

h3arted.com

社交連結平台

開發中