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

Claude Code CLI: The Complete Guide

# Claude Code CLI: The Definitive Technical Reference

words: 9031 read_time: 97m updated: 2026-03-21 06:34

Claude Code CLI: The Definitive Technical Reference

Last updated: 2026-03-21 · 97 分钟阅读 · 9K+ words

$ less claude-code.md

概要： Claude Code是一个智能代理式CLI，能够读取您的代码库、执行命令，并通过分层的权限系统、hooks、MCP集成和subagents来修改文件。掌握五大核心系统（配置、权限、hooks、MCP和subagents），您将获得成倍提升的生产力。根据每项任务选择合适的模型层级——Opus用于复杂推理，Sonnet用于日常工作，Haiku用于快速探索——或者如果质量是您唯一的考量，则统一使用Opus。对于必须始终执行的操作，请使用hooks（而非提示词）。

Claude Code作为智能代理系统运行，而非具备编程知识的聊天界面。该CLI能够读取您的代码库、执行命令、修改文件、管理git工作流、通过MCP连接外部服务，并将复杂任务委派给专门的subagents。所有操作都通过命令行界面完成，与开发者的实际工作方式无缝集成。截至2026年2月，4%的公开GitHub提交（约每天135,000次）由Claude Code完成——自研究预览版发布13个月以来增长了42,896倍——且Anthropic自身90%的代码由AI编写。110

随意使用与高效使用Claude Code之间的差异，归结于五大核心系统。 掌握这些系统，Claude Code将成为您的效能倍增器：

  1. 配置层级：控制行为
  2. 权限系统：管控操作
  3. Hook系统：实现确定性自动化
  4. MCP协议：扩展能力
  5. Subagent系统：处理复杂的多步骤任务

核心要点

  • 五大系统决定您的使用效能：配置层级、权限、hooks、MCP和subagents控制着从行为到自动化的方方面面。
  • 将工作下推至委派层：subagents通过在独立的上下文窗口中隔离探索任务来防止上下文膨胀，仅返回摘要结果。
  • Hooks保证执行，提示词则不然：对于每次都必须运行的代码检查、格式化和安全检查，请使用hooks，不受模型行为影响。
  • 模型分层可在不牺牲质量的前提下节省成本：将subagent探索任务路由至较低成本的模型，将Opus保留给真正的架构推理——或者如果质量是您唯一的考量，则统一使用Opus。
  • MCP将Claude连接到您的工具链：数据库、GitHub、Sentry以及3,000+集成服务将Claude的能力扩展到文件读取和bash命令之外。

我花了数月时间在生产代码库、CI/CD流水线和企业部署环境中深度测试Claude Code的极限。本指南将这些经验提炼为我入门时期望拥有的完整参考手册。每个功能都包含实际语法、真实配置示例，以及容易绊倒资深用户的边界情况。

如何使用本指南

这是一份5,000+行的参考手册——您无需从头到尾通读。根据您的经验水平选择起点：

经验水平 从这里开始 然后探索
Claude Code新手 如何安装？ → 快速入门 → 思维模型 配置、权限
日常用户 Hooks、Subagents、Skills MCP、计划模式
团队负责人/企业用户 企业部署 → 最佳实践 决策框架、工作流配方
从其他工具迁移 针对不同受众的指引 决策框架

使用浏览器的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 │
└─────────────────────────────────────────────────────────┘

核心层：您的主要对话空间。每条消息、文件读取和工具输出都会消耗共享窗口中的上下文（标准200K token98，使用Opus 4.6或扩展上下文模型时可达1M token）。当上下文被填满时，Claude会丢失对早期决策的追踪，质量随之下降。此层按token计费。

委托层：Subagents以干净的上下文启动，执行专注的任务，然后返回摘要。探索结果不会膨胀您的主对话；只有结论被返回。可以将subagents路由到更低成本的模型层级进行探索，或在质量优先于成本时全程使用您的主模型。

扩展层：MCP连接外部服务（数据库、GitHub、Sentry）。Hooks确保shell命令的执行不受模型行为影响。Skills编码领域专业知识，Claude会自动应用。Plugins将这些功能打包以便分发。

关键洞察：大多数用户完全在核心层中工作，看着上下文膨胀和成本攀升。高级用户将探索和专业化工作推送到委托层，保持扩展层针对其工作流进行配置，仅将核心层用于编排和最终决策。

目录

  1. 如何安装Claude Code？
  2. 快速入门：您的第一次会话
  3. 核心交互模式
  4. 配置系统深入解析
  5. 应该选择哪个模型？
  6. Claude Code的费用是多少？
  7. 决策框架
  8. 权限系统如何工作？
  9. Hooks如何工作？
  10. 什么是MCP（Model Context Protocol）？
  11. 什么是Subagents？
  12. 什么是扩展思考模式？
  13. 输出样式
  14. 斜杠命令
  15. Skills如何工作？
  16. 插件系统
  17. 记忆功能如何工作？
  18. 图像与多模态输入
  19. 语音模式
  20. Git集成如何工作？
  21. 如何在IDE中使用Claude Code？
  22. 高级使用模式
  23. 远程与后台Agents【研究预览】
  24. Claude in Chrome
  25. Claude Code in Slack【研究预览】
  26. Claude Code on the Web【研究预览】
  27. 性能优化
  28. 如何调试问题？
  29. 企业部署
  30. 键盘快捷键参考
  31. 最佳实践
  32. 工作流程配方
  33. 迁移指南
  34. 面向不同受众的指南
  35. 速查卡片
  36. 更新日志
  37. 参考文献

如何安装Claude Code？

系统要求

Claude Code可在macOS 10.15+、Ubuntu 20.04+/Debian 10+以及Windows 10+（通过WSL或Git Bash）上运行。系统最低需要4 GB RAM和活跃的互联网连接。99 Shell兼容性在Bash、Zsh或Fish下表现最佳。

对于Windows，WSL 1和WSL 2均可使用。如果您偏好原生Windows环境，Git Bash同样适用。Alpine Linux及其他基于musl的系统需要安装额外的软件包：

apk add libgcc libstdc++ ripgrep
export USE_BUILTIN_RIPGREP=0

安装方式

原生安装（推荐）

原生二进制文件提供最简洁的体验，无需依赖Node.js：

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

# Homebrew alternative
brew install --cask claude-code

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

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

安装特定版本：

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

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

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

NPM安装（已弃用）

注意： 自v2.1.15起，npm安装会显示弃用提示。现在推荐使用原生二进制文件进行安装。请使用claude install进行迁移。

对于仍需使用npm的旧环境：

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

切勿在npm安装时使用sudo。这会导致权限问题，使后续操作变得更加复杂。

从现有安装迁移

如果您使用的是较早的npm安装版本，请迁移到原生二进制文件：

claude install

认证选项

Claude Code支持三种认证方式，各有不同的权衡：

Claude Console（API计费）

通过platform.claude.com（之前为console.anthropic.com）直接连接到Anthropic的API。创建账户、设置计费，并通过CLI进行认证。Console提供基于用量的计费模式，可完整访问API。系统会自动创建专用的”Claude Code”工作区；您无法为此工作区创建API密钥，但可以监控使用情况。

Claude Pro或Max订阅

使用您的claude.ai账户凭据。订阅同时涵盖Web界面和CLI的使用，统一为一个月度计划。对于希望获得可预测费用的个人用户，订阅方式简化了计费流程。

企业平台

AWS Bedrock、Google Vertex AI和Microsoft Foundry均提供企业级访问，并可使用现有的云计费关系：

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

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

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

对于位于代理服务器后方或通过LLM网关的企业部署：

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

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

验证

claude doctor

该命令会报告安装类型、版本、系统配置以及检测到的任何问题。

认证管理（v2.1.41+）

无需进入REPL即可管理认证：97

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

切换账户或组织的常见工作流程：

claude auth logout && claude auth login

另请参阅：如何调试问题？了解认证故障排除方法。

更新

Claude Code默认自动更新，在启动时和会话期间定期检查更新。更新会在后台下载，并在下次启动时生效。

禁用自动更新：

export DISABLE_AUTOUPDATER=1

或在settings.json中设置：

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

手动更新：

claude update

卸载

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

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

原生安装（Windows PowerShell）：

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

清除配置（删除所有设置）：

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

快速入门：您的第一次会话

1. 安装并启动：

claude                           # Launch in current directory

2. 导航到项目目录：

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

3. 让Claude执行操作：

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

4. 在会话中使用快捷键：

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

5. 稍后继续：

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

专家提示： 在项目根目录创建一个CLAUDE.md文件，其中包含构建命令、编码规范和架构说明。Claude每次会话都会读取该文件——这是您提升输出质量最有效的方法。

核心交互模式

交互式REPL

不带参数启动Claude Code即可进入交互式读取-求值-打印循环：

cd your-project
claude

REPL在多轮对话间保持上下文。直接输入查询，接收响应，持续交互直到使用/exit或Ctrl+D退出。

使用初始提示词启动以聚焦会话：

claude "explain the authentication flow in this project"

专家提示： REPL在压缩事件中保持状态。当上下文变得过大时，Claude会自动摘要较早的对话内容，同时保留关键决策和代码片段。您可以使用/compact手动触发此操作，也可以添加自定义指令来指定需要保留的内容。

非交互模式

打印模式（-p）执行单个查询后退出：

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

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

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

生成适合在脚本中解析的结构化输出：

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

JSON输出包含自动化所需的所有信息：

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

实时处理流式输出：

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

输出格式选项：

格式 标志 用途
文本（默认） --output-format text 人类可读输出，管道传输到文件
JSON --output-format json 脚本解析、CI/CD集成
流式JSON --output-format stream-json 实时处理、进度监控

退出码：

代码 含义
0 成功
1 错误（运行时失败、API错误或Claude报告了错误）

在-p模式下控制代理行为：

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

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

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

CI/CD集成模式：

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

会话管理

会话持久化对话历史以便继续。会话持久化对于复杂的多会话工作至关重要：

# Continue most recent session
claude -c

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

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

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

PR关联会话（v2.1.27+）： 启动与特定Pull Request关联的会话：81

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

当您在会话期间通过gh pr create创建PR时，会话也会自动关联到该PR。这使得后续恢复特定PR的工作变得更加便捷。

命名会话： 在启动时或会话期间为会话命名：

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

# Name current session
> /rename auth-refactor

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

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

注意： --session-id需要有效的UUID（例如550e8400-e29b-41d4-a716-446655440000）。如需人类可读的会话命名，请改用/rename和--resume。

Claude Code将会话存储为JSONL转录文件。代理执行会分配唯一的agentId值，转录文件存储为agent-{agentId}.jsonl。恢复会话时会保留前次对话的完整上下文。

计划模式

计划模式将Claude限制为只读探索——不进行文件编辑、不执行bash命令、不做任何破坏性操作。Claude设计实现方案，将其写入计划文件，并等待您的批准后才执行任何操作。

进入计划模式：

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

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

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

工作原理：

  1. Claude进入计划模式（对于复杂任务自动进入，或通过Shift+Tab手动切换）
  2. 使用只读工具探索代码库：Read、Glob、Grep、WebSearch、WebFetch
  3. 将计划写入.claude/plans/{session-slug}.md
  4. 使用ExitPlanMode退出计划模式，向您展示计划
  5. 您批准、请求修改或拒绝

计划模式中可用的工具： Read、Glob、Grep、LS、WebSearch、WebFetch、AskUserQuestion。编辑工具（Edit、Write、Bash、NotebookEdit）被禁用。

计划批准后（v2.1.32+）： Claude提供三个选项： - “Yes, clear context and auto-accept edits”（Shift+Tab）——以全新上下文开始，专注于计划执行 - “Yes, and manually approve edits”——保留上下文，您逐一批准每项更改 - “Yes, auto-accept edits”——保留上下文，Claude无需逐项审批直接执行

批准时自动清除上下文是推荐的工作流程。它为计划提供全新的上下文窗口，能显著提升计划执行的准确性——Claude能更长时间地保持正轨，不会受到旧对话的干扰。

何时使用计划模式： - 涉及架构决策的新功能实现 - 需要先审查方案的多文件重构 - 在不熟悉的代码库中，修改前应先进行探索 - 存在多种有效方案且需要您参与决策的任何任务

专家提示： 在计划模式中投入的时间越多，Claude在实现阶段成功的可能性就越大。计划模式本质上是零成本的探索——没有高风险的工具调用，没有浪费的编辑操作。请大胆使用。

配置系统深入解析

Claude Code使用分层配置系统。理解其层级结构至关重要，因为较高层级会覆盖较低层级的设置，而企业级设置则完全无法被绕过。

配置层级结构

层级 位置 作用范围 可否覆盖
企业级 /etc/claude-code/managed-settings.json（Linux） 所有用户 否
/Library/Application Support/ClaudeCode/managed-settings.json（macOS）
C:\Program Files\ClaudeCode\managed-settings.json（Windows）
CLI标志 命令行参数 当前会话 是
本地项目 .claude/settings.local.json 个人使用，当前项目 是
共享项目 .claude/settings.json 通过 git 共享给团队 是
用户级 ~/.claude/settings.json 您的所有项目 是
状态 ~/.claude.json 运行时状态、OAuth、MCP 不适用

专家提示： 在共享项目中使用.claude/settings.local.json存储个人偏好设置（将其添加到.gitignore中）。使用.claude/settings.json存储纳入版本控制的团队级配置。

完整的 settings.json 参考

展示所有主要选项的完整配置：

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

环境变量参考

认证与API：

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

模型配置：

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

云服务提供商配置：

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

行为控制：

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

工具配置：

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

网络与代理：

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

界面与终端：

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

技能变量（v2.1.69+）：

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

SDK调用者身份（v2.1.51+）：

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

调试：

ANTHROPIC_LOG=debug                             # Enable API request logging

如何选择合适的模型？

为每项任务选择合适的模型，对成本和质量都有显著影响。Claude Code 提供了多层级的灵活模型切换机制。

可用模型

别名 模型 适用场景 输入/1M 输出/1M
opus Claude Opus 4.6 复杂推理、架构设计、长上下文工作 $5.00 $25.00
sonnet Claude Sonnet 4.6 日常编码、均衡性能 $3.00 $15.00
haiku Claude Haiku 4.5 简单任务、快速操作 $1.00 $5.00
default 取决于账户 通用用途 不定 不定
opus[1m] Opus 4.6 搭配 1M 上下文 大规模代码库、长会话 $10.00 $37.50
sonnet[1m] Sonnet 4.6 搭配 1M 上下文 大型代码库 $6.00 $22.50
opusplan Opus（规划）+ Sonnet（执行） 复杂重构 混合 混合

Opus 4.6（2026年2月5日）： 最新旗舰模型，支持 1M token 上下文窗口、128K 最大输出、自适应思维和 agent teams。86 定价与 Opus 4.5 相同（$5/$25 每 MTok）。自 v2.1.75（2026年3月13日）起，Max、Team 和 Enterprise 方案默认启用 1M 上下文窗口 —— 这些方案不再需要 [1m] 后缀。124 自 v2.1.77（2026年3月17日）起，Opus 4.6 的默认输出 token 上限提升至 64K，最高可达 128K。126 仅通过 API 使用时，长上下文（>200K 输入）费用仍为 $10/$37.50 每 MTok。模型 ID：claude-opus-4-6。1

Sonnet 4.6（2026年2月17日）： 新的均衡模型，取代 Sonnet 4.5 成为 claude.ai 和 Claude Cowork 的默认选项。100 定价与 Sonnet 4.5 相同（$3/$15 每 MTok）。提升了 agentic 搜索性能，同时消耗更少的 token。支持扩展思维、自适应思维和 1M token 上下文窗口（beta）。最大输出 64K（v2.1.77 中上限提升至 128K）。126 知识截止日期：2025年8月（可靠），2026年1月（训练数据）。模型 ID：claude-sonnet-4-6。Sonnet 4.5 现已成为旧版模型。100

为何价格差异至关重要： 一次典型的编码会话消耗 50K-200K 输入 token 和 10K-50K 输出 token。使用 Haiku 每次会话约 $0.10-$0.45，而 Opus 同样的会话则需 $0.50-$2.25，贵了 5 倍。建议将 Opus 留给真正高难度的问题。1

各模型的使用时机

Haiku：适用于执行探索任务的 subagents、简单文件搜索和快速问答。比 Opus 便宜约 5 倍且响应更快，非常适合无需深度推理的后台任务。

Sonnet：日常开发的主力模型。能出色应对大多数编码任务：实现功能、修复 bug、编写测试、代码审查。建议将其作为默认选择。Sonnet 4.6（2026年2月）在 agentic 搜索和 token 效率方面较 Sonnet 4.5 均有提升，并支持自适应思维和 1M 上下文窗口 beta。100

Opus：留给真正需要复杂推理的场景：架构决策、棘手的调试、理解复杂系统、安全分析。Opus 4.6（2026年2月）是一次质的飞跃：规划更审慎、agentic 任务续航更持久、在大型代码库中运行更稳定，代码审查时自我纠错能力也更强。86 它支持 1M token 上下文窗口（beta），并引入了自适应思维——能自动判断所需的推理深度。据 Anthropic 报告，在 Terminal-Bench 2.0 上，Opus 4.6 取得了业界最高的 agentic 编码分数。在 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

或在会话中切换：

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

自 v2.1.75（2026年3月13日）起，Opus 4.6 在 Max、Team 和 Enterprise 方案中默认使用 1M 上下文 —— 无需添加 [1m] 后缀。124 Sonnet 以及仅通过 API 使用的用户仍需 [1m] 后缀。

Opus 4.6 是首个原生支持 1M 上下文的 Opus 级模型。在 MRCR v2 的 8-needle 1M 变体测试中准确率达 76%（竞品约 18.5%），是长上下文检索能力最强的模型。86

扩展上下文的 token 单价更高（输入 token 超过 200K 时，输入费用翻倍，输出费用为 1.5 倍）。对于 Sonnet 的 [1m] 模式，建议按需使用，而非设为默认。

查看当前模型

> /status

该命令会显示当前模型、账户信息、已应用的设置及其他会话状态。

模型选择器标签（v2.1.51+）： /model 选择器现在显示易读的标签（如 “Sonnet 4.6”），而非原始模型 ID。对于固定版本，还会在有新版本可用时显示升级提示。105

快速模式（v2.1.36+）

快速模式能显著加快同一模型的输出速度，并不会切换到更低档的模型。在会话中使用 /fast 切换。93

> /fast            # Toggle fast mode on/off

定价（Opus 4.6 快速模式）：

标准模式 快速模式
输入 $5/MTok $30/MTok（6 倍）
输出 $25/MTok $150/MTok（6 倍）

快速模式定价适用于整个上下文窗口，包括超过 200K 输入 token 的请求——快速模式下没有额外的长上下文附加费。1 快速模式定价与 prompt 缓存和数据驻留倍率叠加，但不与长上下文定价叠加。快速模式不支持 Batch API。

适合使用快速模式的场景： - 快速迭代小改动，延迟是瓶颈时 - 生成测试、样板代码或重复性代码，速度比成本更重要时 - 按顺序处理一系列相似任务时

不适合使用快速模式的场景： - 长时间运行的 agentic 任务（6 倍费率下成本累积很快） - 后台 subagent 工作（无人等待输出） - 预算敏感的会话

Opus 4.6 快速模式现已包含完整的 1M 上下文窗口（v2.1.50+）。此前快速模式仅限标准上下文，现在可以在快速模式下获得同样的 1M token 容量。103

进阶技巧： 快速模式与 opusplan 混合模式搭配效果极佳：在 Sonnet 执行阶段使用快速模式加速迭代，同时 Opus 规划阶段保持标准费率。注意 /fast 需要先启用 /extra-usage（v2.1.37 修复）。93

Claude Code 的费用是多少？

了解和控制费用对于可持续使用 Claude Code 至关重要。另请参阅模型选择了解模型能力，以及决策框架了解如何为每项任务选择合适的模型。

查看费用

> /cost

输出：

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

订阅计划

计划 价格 用量 访问权限
免费 $0 有限 无 Claude Code 访问权限
Pro $20/月 免费版的5倍 Claude Code + Opus 访问权限20
Max（5x） $100/月 Pro的5倍 优先访问，增强性能
Max（20x） $200/月 Pro的20倍 最高优先级，可购买额外用量

速率限制（2025年8月）： Anthropic 为付费订阅用户引入了每周速率限制。Max 订阅用户可以按标准 API 费率购买超出速率限制的额外用量。21

API Token 定价（2026年2月）186

对于按 API 计费的用户，每百万 token 定价：

模型 输入 输出 备注
Haiku 4.5 $1 $5 速度与效率
Sonnet 4.6 $3 $15 智能与成本的平衡（取代 Sonnet 4.5）
Opus 4.6 $5 $25 旗舰模型（与 Opus 4.5 同价）
Opus 4.5 $5 $25 上一代旗舰模型

长上下文定价（输入 token 超过200K）：

模型 标准输入 长输入 标准输出 长输出
Opus 4.6 $5 $10 $25 $37.50
Sonnet 4.6/4.5/4 $3 $6 $15 $22.50

200K阈值基于总输入 token 数（包括缓存读取/写入）。超过该阈值后，Anthropic 将按长上下文费率对所有 token 计费。1

数据驻留定价： 通过 inference_geo 指定仅限美国推理会在所有 token 定价上增加1.1倍乘数（仅适用于 Opus 4.6+ 模型）。1

提示缓存可显著降低重复输入成本：缓存写入费用为基础价格的1.25倍（5分钟缓存）或2倍（1小时缓存），但缓存读取仅需0.1倍，节省90%。对于多智能体系统和具有重复上下文的代码助手，缓存可将成本降低88-95%。

批量 API 提供50%折扣，24小时完成周转，适用于非紧急任务，如夜间测试套件。

多账户政策59

可以拥有多个 claude.ai 账户吗？ 可以，只要用于合理用途。Anthropic 明确允许在不同目的下使用多个账户。

允许的情况：

场景 示例 状态
家庭成员 您和配偶各有一个 Max 账户 允许
工作 + 个人 个人账户 + 雇主管理的工作账户 允许
个人 + 团队 个人 Pro/Max 账户与组织账户并存 允许
同一网络 同一家庭 WiFi 下的多个账户 允许
同一电脑 在一台机器上切换账户 允许

技术限制： - 同一电话号码最多可验证 3个账户 - 明确支持来自同一 IP/网络的多个付费订阅 - 账户完全独立；账户之间无法转移聊天记录或项目

禁止的行为（根据使用政策）： - 被封禁后创建账户以逃避封禁 - 跨账户协调恶意活动以避免被检测 - 使用多个账户绕过速率限制或免费额度

真实案例： 2026年1月，重度用户 Jeffrey Emanuel（@doodlestein）的22个 Max 账户被自动标记并临时封禁。Anthropic 员工 Thariq（@trq212）在确认合理使用后4小时内解决了问题。如果您在多个账户上广泛使用 Claude Code 进行工作和个人项目，这正是该服务的设计用途，但请不要试图钻系统漏洞。

如有疑问： 请联系 Anthropic 支持以书面形式确认您的具体使用情况。

费用因素

因素 影响 优化方式
模型选择 Opus >> Sonnet >> Haiku 简单任务使用 Haiku
输入 token 更多上下文 = 更高成本 保持 CLAUDE.md 精简
输出 token 更长的响应成本更高 设置 MAX_OUTPUT_TOKENS
思考 token 扩展思考增加成本 仅在需要时使用
提示缓存 降低重复输入成本 保持启用（默认）

真实费用示例

任务 模型 输入 输出 费用
快速文件搜索 Haiku 20K 2K $0.03
带测试的 Bug 修复 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.ai 控制台：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 提交数
pull_requests_by_claude_code 创建的 PR 数
terminal_type 环境（vscode、iTerm.app、tmux 等）
customer_type api（API 客户）或 subscription（Pro/团队）

示例请求：

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"

使用场景： - 开发者生产力分析（会话、提交、PR） - 工具使用指标（Edit、Write 等的接受/拒绝率） - 跨团队的成本追踪和分配 - AI 编码工具的投资回报率论证

注意： 数据在活动完成后1小时内出现。为确保一致性，响应中仅包含超过1小时的数据。

决策框架

仅仅了解功能的存在是不够的，您还需要知道何时使用每个功能。这些决策树将知识转化为行动。

应该使用哪个模型？

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

经验法则：从 Sonnet 开始。subagents 降级使用 Haiku。仅当 Sonnet 的回答显得浅薄时才升级到 Opus 4.6。使用 agent teams（v2.1.32+）时，Opus 可以协调多个 agents 并行处理不同的子任务。86

命令 vs Skill vs Subagent vs Agent Team？

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

Hook 还是 Prompt？

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

何时使用扩展思考？

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

在会话中使用 Alt+T 切换。较高的思考预算会增加成本；从最低级别开始，仅在回答感觉仓促时才增加。

Opus 4.6 自适应思考：Opus 4.6 会根据问题复杂度自动调整思考深度。对于大多数任务，无需显式控制思考预算——Opus 会为困难问题增加思考深度，为简单问题保持快速响应。手动切换思考模式在使用 Sonnet 时最有用，当您想强制进行更深入的分析时。

选择哪个执行环境？

Where should this work happen?
│
├── Requires YOUR local files and tools
│   │
│   ├── Interactive, iterative work → Main REPL session
│   ├── One-shot scripted task → claude -p "prompt" (print mode)
│   ├── CI/CD automation → claude -p --json (non-interactive + structured output)
│   └── Parallel isolated tasks → Subagents via Task tool
│
├── Requires SOMEONE ELSE'S environment
│   │
│   └── Remote codebase or server → Background agent (cloud)
│
└── Doesn't require any environment
    │
    ├── Research or analysis → Subagent with Explore type
    └── Web content extraction → WebFetch / WebSearch tools
场景 执行环境 原因
调试失败的测试 主 REPL 需要本地文件，迭代操作
分类处理20个 GitHub issues 后台 agent 长时间运行，无需本地文件
审查 PR Subagent 或 --from-pr 隔离上下文，聚焦输出
生成变更日志 claude -p 一次性任务，可脚本化
每次提交时执行 lint + test Hook（PreCommit） 必须始终运行，确定性执行
跨仓库搜索模式 Subagent（Explore） 防止上下文膨胀
将迁移应用到暂存环境 后台 agent 需要远程访问
快速代码解释 主 REPL 或 /fast 交互式，需要快速响应
多模块重构 Agent team 跨文件并行工作

Agent Teams vs Subagents vs 并行会话

Do you need multiple agents working on related subtasks?
│
├── YES → Are the subtasks independent (no shared state)?
│         │
│         ├── YES → Can they share the same codebase?
│         │         │
│         │         ├── YES → Use Agent Team (v2.1.32+)
│         │         │         Opus coordinates. Agents share repo access.
│         │         │         Example: "Review auth, API, and DB modules in parallel"
│         │         │
│         │         └── NO → Use Parallel Sessions (separate terminals)
│         │                  Each has its own working directory.
│         │                  Example: "Fix repo-A and repo-B simultaneously"
│         │
│         └── NO → Use Sequential Subagents
│                  Results from one feed into the next.
│                  Example: "Explore → Plan → Implement"
│
└── NO → Use Single Subagent or Main REPL
方式 最大并行度 共享上下文 协调方式 成本
Agent Team 5-10 agents 共享仓库，独立上下文 Opus 编排 高（N 个 agents）
Subagents 无限制（自行管理） 无（隔离） 通过 prompts 编排 每个 agent 中等
并行会话 受终端数量限制 无 手动 每个会话中等

选择哪种 Hook 类型？

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

何时使用 /fast？

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

/fast 切换当前会话的快速模式。它使用相同的模型（Opus 4.6）并优化输出速度——并不会切换到更低价的模型。

权限系统如何运作？

Claude Code 的权限系统提供了对可执行操作的精细控制。理解这一系统对于安全保障和工作流效率都至关重要。另请参阅企业部署了解如何在组织范围内通过托管设置强制执行权限策略。

权限层级

只读工具（自动批准）： - Read - 读取文件内容 - Glob - 按模式查找文件 - Grep - 搜索文件内容 - WebSearch - 搜索网页 - LSP - 代码智能（跳转定义、查找引用、悬停文档）25

LSP 工具功能（v2.0.74+）： LSP 工具提供类似 IDE 的代码智能功能： - 跳转定义：直接跳转到符号的定义位置 - 查找引用：列出符号在整个代码库中的所有使用位置 - 悬停文档：获取任意符号的类型信息和文档 - 支持 TypeScript、Python、Go、Rust 以及其他具备 LSP 支持的语言 - 需要语言服务器可用（通常随工具链一起安装）

修改工具（需要批准）： - Edit - 修改现有文件 - Write - 创建新文件 - Bash - 执行 shell 命令 - WebFetch - 获取 URL 内容 - NotebookEdit - 修改 Jupyter notebook

修改工具首次运行时，Claude Code 会提示用户批准。除非另行配置，批准在当前会话内持续有效。

权限模式

模式 行为 适用场景
default 每个工具首次使用时提示 常规开发
acceptEdits 自动批准文件编辑，Bash 仍需提示 受信任的项目
plan 不允许执行或编辑 仅供分析
bypassPermissions 跳过所有提示 CI/CD 自动化

YOLO 模式（v2.0.68+）： 如需完全自主运行，可使用 --dangerously-skip-permissions 标志。该标志对所有操作一律放行：文件编辑、Bash 命令、全部工具调用。名称中特意包含”dangerous”一词，请在沙箱环境中使用，或在完全信任代码库时使用。61

claude --dangerously-skip-permissions

通过 CLI 设置模式：

claude --permission-mode acceptEdits

在会话中切换：

Shift+Tab  # Cycles through modes

在 settings.json 中配置：

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

权限规则语法

精细规则控制特定操作。规则按顺序评估，首条匹配即生效。

Bash 命令模式：

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

星号提供前缀匹配：Bash(npm run test:*) 允许 npm run test、npm run test:unit 和 npm run test:integration。

重要限制： Bash 模式仅匹配前缀，不支持正则表达式。例如 Bash(curl http:*) 无法匹配 curl -X GET http://...，因为选项参数位于 URL 之前。要可靠地阻止某命令，应完整拒绝：Bash(curl:*)。

文件操作模式：

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

路径语法： - 相对路径：Edit(src/**)——相对于工作目录 - 相对于设置文件的绝对路径：Edit(/build/**)——相对于设置文件所在位置 - 真正的绝对路径：Edit(//tmp/**)——以 // 开头 - 主目录：Read(~/.zshrc)

MCP 工具模式：

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

使用通配符语法 mcp__server__* 可批量允许或拒绝特定 MCP 服务器的所有工具。39 通配符语法便于快速启用受信任服务器的全部工具，或一次性屏蔽不受信任来源的整个服务器。

WebFetch 模式：

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

附加目录

将 Claude 的访问范围扩展到当前项目之外：

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

附加目录对于 monorepo 或 Claude 需要引用同级目录中代码的场景必不可少。

沙箱模式

启用文件系统和网络隔离：

> /sandbox

或在设置中配置：

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

沙箱启用后： - 文件系统访问限制在项目目录内 - 网络访问受控 - 特定命令可豁免沙箱限制 - 若 autoAllowBashIfSandboxed 为 true，Bash 命令自动放行

专家提示： 沙箱模式非常适合在不受信任的代码库上运行 Claude。探索陌生项目或需要额外安全保障时，建议启用此模式。Anthropic 内部测试表明，沙箱化可减少 84% 的权限提示。45 沙箱使用操作系统级原语（macOS seatbelt、Linux bubblewrap）实现文件系统和网络隔离，即便提示注入攻击得逞也会被完全隔离。Anthropic 已开源沙箱运行时，供构建自有 Agent 的团队使用。89

安全说明（v2.1.34+）： 通过 sandbox.excludedCommands 或 dangerouslyDisableSandbox 豁免沙箱的命令，此前在 autoAllowBashIfSandboxed 启用时可绕过 Bash 请求权限规则；该问题已在 v2.1.34 中修复。94 自 v2.1.38 起，沙箱模式下禁止写入 .claude/skills，防止提示注入篡改 skill 定义。95 v2.1.77 新增 allowRead 沙箱文件系统设置，可在 denyRead 区域内重新允许读取访问——适用于需要屏蔽大部分目录树但允许特定子目录的场景。126

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
InstructionsLoaded 加载 CLAUDE.md 或 .claude/rules/*.md 时 否 响应指令文件变更、注入上下文（v2.1.69+）
ConfigChange 会话期间配置文件变更时 是 审计设置变更、执行安全策略（v2.1.49+）
WorktreeCreate 创建工作树时 是 自定义 VCS 配置（替代默认 git 行为）（v2.1.50+）
WorktreeRemove 移除工作树时 否 自定义 VCS 清理（v2.1.50+）
PreCompact 上下文压缩前 否 验证、日志记录
PostCompact 上下文压缩后 否 日志记录、缓存复用优化（v2.1.76+）125
Elicitation MCP 服务器请求结构化输入时 是 拦截/覆盖 MCP 引导对话框（v2.1.76+）125
ElicitationResult 用户响应 MCP 引导时 是 验证/转换引导响应（v2.1.76+）125
StopFailure 因 API 错误（速率限制、认证失败）结束回合时 否 错误警报、重试逻辑（v2.1.78+）127
PermissionRequest 显示权限对话框时 是 自定义审批逻辑

Hook 配置

在 settings.json 或专用 hooks.json 中定义 hooks：

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write \"$FILE_PATH\""
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/validate-bash.sh"
          }
        ]
      }
    ],
    "UserPromptSubmit": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/inject-context.sh"
          }
        ]
      }
    ]
  }
}

匹配器

matcher 字段决定哪些工具触发 hook：

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

Hook 输入/输出协议

Hooks 通过 stdin 接收 JSON：

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

Hook 事件增强（v2.1.69+）： 所有 hook 事件在由子代理或 --agent 会话触发时，现在都包含 agent_id 和 agent_type 字段，状态栏 hook 命令中还包含 worktree 字段。117

Stop/SubagentStop hooks（v2.1.47+） 额外接收 last_assistant_message 字段，包含 Claude 的最终响应文本，无需解析会话记录文件即可检查输出：

{
  "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
          }
        ]
      }
    ]
  }
}

适用场景： - 不应拖慢会话的通知（Slack、邮件、Pushover） - 可在后台运行的日志记录和遥测 - 非关键后处理（分析、备份）

不适用场景： - 格式化（必须在下次编辑前完成） - 验证（失败时必须阻断） - 任何需要修改工具输入/输出的 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 响应。适用于 webhook、外部通知服务或基于 API 的验证（v2.1.63+）：111

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

HTTP hooks 使用与命令 hooks 相同的决策格式（返回包含 decision 和 reason 的 JSON）。启用沙箱时，它们通过沙箱网络代理路由。SessionStart/Setup 事件不支持此类型。

代理 hooks（type: "agent"）生成具有工具访问权限（Read、Grep、Glob）的子代理，用于多轮验证。当检查需要实际检视文件或测试输出时使用：

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

使用 $ARGUMENTS 作为 hook JSON 输入的占位符。两种类型均支持 model（默认为快速模型）和 timeout 字段。支持的事件：PreToolUse、PostToolUse、PostToolUseFailure、PermissionRequest、UserPromptSubmit、Stop、SubagentStop、TaskCompleted。TeammateIdle 不支持提示/代理 hooks。

Hook 环境变量

Hooks 可以访问用于解析路径的环境变量：96

变量 可用范围 说明
$CLAUDE_PROJECT_DIR 所有 hooks 项目根目录（路径含空格时需加引号）
${CLAUDE_PLUGIN_ROOT} 插件 hooks 插件的根目录
$CLAUDE_ENV_FILE 仅 SessionStart 用于为后续 Bash 命令持久化环境变量的文件路径
$CLAUDE_CODE_REMOTE 所有 hooks 在远程 Web 环境中设置为 "true"

从 SessionStart 持久化环境变量：

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

HTTP hook 安全性（v2.1.51+）： 将环境变量插值到请求头中的 HTTP hooks 现在需要显式的 allowedEnvVars 列表。这防止了通过请求头值任意导出环境变量。启用沙箱时，HTTP hooks 也通过沙箱网络代理路由，强制执行域名白名单。SessionStart/Setup 事件不支持 HTTP hooks。105

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

Hook 工作区信任（v2.1.51+）： statusLine 和 fileSuggestion hook 命令在交互模式下现在需要接受工作区信任后才能执行，堵住了一个潜在的安全向量。105

实用 Hook 示例

编辑后自动格式化 TypeScript 文件：

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

记录所有 bash 命令：

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

阻止访问敏感文件：

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

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

代码更改后运行测试：

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

自定义通知系统：

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

向提示注入动态上下文：

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

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

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

Hook 调试

启用调试模式排查 hooks 问题：

claude --debug

调试模式记录： - Hook 执行耗时 - 输入/输出数据 - 错误消息和堆栈跟踪 - 决策结果（allow/reject/ask）

Hook 来源显示（v2.1.75+）： 当 hook 需要用户确认时，权限提示现在会显示 hook 的来源（settings、插件或 skill），便于识别是哪个组件在请求访问权限。124

组件作用域 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 理解MCP对于将Claude集成到您现有的工具链中至关重要。

为什么MCP对开发者很重要： 没有MCP，Claude Code只能读取文件和运行bash命令。有了MCP，Claude可以查询您的生产数据库、创建Jira工单、审查GitHub PR、检查Sentry错误，以及与您团队使用的任何API交互，所有这些都通过自然语言请求完成。该协议标准化了AI工具连接外部服务的方式，防止供应商锁定。请参阅决策框架了解何时使用MCP与其他扩展机制的指导。

远程MCP支持（2025年6月）

Claude Code现已支持具有原生OAuth认证的远程MCP服务器。28 无需管理本地服务器即可连接工具和数据源。只需认证一次，Claude Code会自动处理令牌刷新。

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

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

Claude Code现在可以使用您在claude.ai账户中配置的MCP连接器。这弥合了Web和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 Elicitation（v2.1.76+）

MCP服务器现在可以通过交互式对话框在任务执行过程中向用户请求结构化输入。125 当MCP服务器需要额外信息时（例如选择分支、输入项目名称、确认操作），它会发送一个elicitation请求，Claude Code将其渲染为表单字段或浏览器URL。

Hook集成： 两个新的hook事件——Elicitation（对话框出现之前）和ElicitationResult（用户响应之后）——允许您以编程方式拦截、验证或覆盖elicitation响应。这使得企业工作流中MCP服务器提示可以按策略预填充或约束成为可能。

交互式MCP设置向导

不带参数运行claude mcp add即可启动逐步添加MCP服务器的交互界面。该向导将引导您完成传输类型选择、认证和配置。15

传输类型

HTTP（推荐用于远程服务器）：

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

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

SSE（已弃用但仍可用）：

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

Stdio（本地服务器）：

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

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

Windows需要使用cmd包装器来运行stdio：

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、Issues、CI/CD、代码审查
PostgreSQL 数据库访问 查询、模式检查、数据分析
Sentry 错误监控 错误查找、堆栈跟踪、部署关联
Linear 项目管理 Issues、项目、Sprint
Jira/Atlassian 企业项目管理 工单、看板、工作流
Playwright Web自动化 端到端测试、可访问性树
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 Web界面中，但随着服务器采用新的交互功能，底层MCP协议扩展与Claude Code的MCP生态系统密切相关。

API平台：代码执行工具v2（2026年1月）

Anthropic推出了代码执行工具v2公开测试版，用Bash命令执行和直接文件操作替代了原来仅支持Python的沙箱。79 主要变化： - 在沙箱化容器中执行Bash命令（不仅仅是Python） - 用任何语言编写和运行代码 - 编程式工具调用（同为公开测试版）：Claude可以在代码执行过程中调用工具，减少多工具工作流中的延迟和令牌使用量

v2工具主要影响API用户，但预示了Claude Code云执行能力的发展方向。

什么是子代理？

子代理是专门处理复杂任务的独立Claude实例。它们是Claude Code中最强大的功能之一，也是最不被理解的功能之一。掌握子代理能显著扩展您可以完成的工作范围。请参阅决策框架了解代理团队、子代理与并行会话的选择指导。

子代理存在的原因： 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） - 详尽程度：快速、中等、非常详尽 - 用途：代码库探索、查找文件、理解结构

通用型： - 模型：继承主对话的模型 - 模式：完全读写 - 工具：所有可用工具 - 用途：复杂的研究+修改任务

Plan： - 模型：继承主对话的模型（使用opusplan时为Opus） - 模式：只读 - 工具：Read、Glob、Grep、Bash - 用途：在执行之前规划复杂的实现方案

触发子代理

Claude会根据任务类型自动委派给子代理。您也可以显式请求：

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

> Have a subagent analyze the database schema thoroughly

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

专家提示： 对于复杂任务，请显式请求子代理委派。使用”Use an explore agent to find…”可以防止主对话的上下文膨胀。

创建自定义子代理

在.claude/agents/（项目级）或~/.claude/agents/（个人级）中定义子代理：

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

You are a senior security engineer reviewing code for vulnerabilities.

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

Focus on actionable security findings, not style issues.

配置字段：

字段 必需 选项 用途
name 是 小写字母+连字符 唯一标识符
description 是 自然语言 何时调用（包含”PROACTIVELY”以鼓励自动委派）
tools 否 逗号分隔 省略时继承所有工具。支持Agent(agent_type)语法限制可生成的代理类型（v2.1.63+；Task(...)仍作为别名有效）
disallowedTools 否 逗号分隔 要禁止的工具，从继承或指定的列表中移除
model 否 sonnet、opus、haiku、inherit 默认为inherit（与主对话使用相同模型）
permissionMode 否 default、acceptEdits、delegate、dontAsk、bypassPermissions、plan 权限处理方式。delegate仅限团队管理工具
maxTurns 否 整数 子代理停止前的最大代理轮次数
memory 否 user、project、local 代理的持久化记忆范围（v2.1.33+）
skills 否 逗号分隔 启动时自动将技能内容加载到子代理上下文中
mcpServers 否 服务器名称或内联定义 此子代理可用的MCP服务器
hooks 否 Hook配置对象 作用于此子代理执行的生命周期hooks
background 否 true、false 始终作为后台任务运行（v2.1.49+）
isolation 否 worktree 在临时git worktree中运行以获得隔离的仓库副本（v2.1.49+）

限制可生成的子代理（v2.1.33+，v2.1.63重命名）： tools字段支持Agent(agent_type)语法来限制代理可以生成哪些子代理类型。例如，tools: Read, Grep, Agent(Explore)允许代理直接使用Read和Grep，但只能委派给Explore类型的子代理。此限制可防止受约束的代理过度委派。注意： 在v2.1.63中，Task工具被重命名为Agent。设置和代理定义中现有的Task(...)引用仍作为向后兼容的别名有效。113

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

在启动时将子代理定义为JSON，用于快速测试或自动化。这些子代理仅在当前会话中存在，不会保存到磁盘：96

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

--agents标志接受与基于文件的子代理相同frontmatter字段的JSON：description、prompt、tools、disallowedTools、model、permissionMode、mcpServers、hooks、maxTurns、skills和memory。

管理子代理

> /agents                    # 交互式管理
> /agents create             # 创建新子代理
> /agents edit               # 修改现有子代理
> /agents delete             # 删除子代理
> /agents list               # 查看所有子代理

CLI列出（v2.1.50+）： 从命令行列出所有已配置的代理，无需启动交互式会话：

claude agents                # 按来源分组显示代理（内置、用户、项目、插件）

远程控制（v2.1.51+）： claude remote-control子命令为外部构建提供您的本地环境服务，使所有用户能够远程访问本地环境能力：105

claude remote-control                      # 开始提供本地环境服务
claude remote-control --name "My Project"  # 自定义会话标题，在claude.ai/code中可见（v2.1.69+）[^117]

在后台运行代理

对于长时间运行的任务：

> Run a thorough security review in the background

> /agents  # Check status of running agents

稍后使用代理ID检索结果。

高级模式

链式子代理：

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

并行探索：

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

可恢复代理： 代理可以通过其ID恢复以继续之前的工作：

> Resume agent abc123 and continue the analysis

异步子代理（2025年12月）

异步子代理为大规模项目提供多任务处理和并行执行能力：

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

异步代理通过统一的TaskOutputTool返回结果，实现高效的流水线式工作流。

权限拒绝恢复能力（v2.1.0+）

从v2.1.0开始，子代理在权限被拒绝后会继续工作，而不是完全停止。当子代理遇到权限限制时，它会自动尝试替代方法。此变更使自主工作流更具弹性，减少了人工干预的需要。47

代理团队（2026年2月，研究预览）

代理团队协调多个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中断其回合

何时使用代理团队vs子代理：

子代理 代理团队
通信 仅将结果报告回来 队友之间直接相互通信
协调 主代理管理所有工作 共享任务列表，自行协调
最适用于 只需要结果的专注任务 需要讨论和协作的复杂工作
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的members数组）。任务列表保存在~/.claude/tasks/{team-name}/。任务支持依赖关系：当依赖的任务完成时，被阻塞的任务会自动解除阻塞。91

Hook集成： 使用TeammateIdle（退出码2发送反馈并让队友继续工作）和TaskCompleted（退出码2阻止完成）hooks对队友实施质量门控。

限制（实验性）： - in-process模式的队友不支持会话恢复（/resume无法恢复它们） - 每个会话一个团队；不支持嵌套团队 - 队友不能生成自己的团队 - 分割窗格需要tmux或iTerm2（VS Code终端、Windows Terminal或Ghostty不支持） - 所有队友以负责人的权限模式启动 - Token密集：每个队友都是独立的Claude实例

代理技能（2025年12月）

代理技能是由指令、脚本和资源组成的有序文件夹，代理可以动态发现和加载。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

技能与命令不同：命令需要显式调用，而技能会根据任务上下文自动激活。Claude Agent SDK（从Claude Code SDK重命名）为构建支持技能的自定义代理提供了框架。32

什么是扩展思考模式？

扩展思考为Claude提供更多时间来推理复杂问题，然后再作出回应。这对于架构决策、调试棘手问题以及需要仔细分析的任务特别有价值。

当前状态（2026年3月）

扩展思考现在默认启用，预算为31,999个token。70 Anthropic做出此更改是因为扩展思考显著提升了复杂规划和推理任务的性能。

effort级别（v2.1.68+，v2.1.72简化）：Opus 4.6对Max和Team订阅者默认使用medium effort——在速度和深度之间的最佳平衡点。effort级别会在logo和加载动画中以简化符号显示：○（low）、◐（medium）、●（high）。121 “ultrathink”关键词已重新引入，用于触发high effort模式。其他自然语言触发词（”think”、”think hard”、”think harder”）仍然已弃用——请改用MAX_THINKING_TOKENS或/config。70116

注意：Opus 4和Opus 4.1已从第一方API的Claude Code中移除（v2.1.68）。已固定使用这些模型的用户已自动迁移至Opus 4.6。116

支持的模型

  • Claude Opus 4.6（同时支持自适应思考，可自动确定推理深度）
  • Claude Sonnet 4.6（同时支持自适应思考）
  • Claude Opus 4.5
  • Claude Sonnet 4.5
  • Claude Haiku 4.5

控制扩展思考

会话中快速切换：

Press Alt+T to toggle thinking on/off

注意：Anthropic将思考切换快捷键从Tab更改为Alt+T，以避免意外触发。39

通过/config： 导航至/config → Extended Thinking以启用/禁用或调整预算。

环境变量（永久设置）：

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

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

禁用以节省成本： 对于不需要深度推理的简单任务，您可以通过在/config中禁用思考或降低预算来减少成本：

export MAX_THINKING_TOKENS=8000  # Reduce from default 31,999

思考token预算

预算 使用场景
1,024（最小值） 简单推理任务
8,000 大多数编码任务（性价比高）
31,999（默认值） 复杂推理、架构决策
63,999（默认值的2倍） 详尽分析（需要显式设置）

成本考量：Anthropic将思考token作为输出token计费。默认的31,999预算对大多数任务效果良好，但对于简单操作，您可以通过降低预算或完全禁用思考来节省成本。

工作原理

启用思考后，Claude会进行影响回答但不会出现在输出中的内部推理。Claude Code会加密思考内容并在signature字段中返回以供验证。

在使用工具的多轮对话中，思考块必须传回API以保持推理的连续性。Claude Code会自动处理此过程。

何时考虑禁用/降低预算

扩展思考现在是默认设置，但在以下情况下可考虑降低预算或禁用： - 简单的文件编辑 - 常规重构 - 快速提问 - 代码格式化 - 成本累积的高频操作

缓存行为

当思考参数更改时，Claude Code会保留系统提示缓存。在轮次之间更改思考预算或启用状态会使消息缓存失效。

输出样式

输出样式可自定义Claude呈现信息的方式，适用于学习、文档编写或特定团队偏好。19

内置样式

样式 用途
Explanatory 带有推理过程的详细解释
Learning 带有概念讲解的教学格式
Concise 最少输出，仅保留要点

设置输出样式

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

或通过设置：

{
  "outputStyle": "Explanatory"
}

自定义输出样式

在.claude/styles/中创建：

# my-style

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

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

使用/output-style my-style调用。

弃用（v2.1.73+）：/output-style已弃用。请改用/config来管理输出样式。122

斜杠命令

斜杠命令提供快速访问 Claude Code 功能的途径，并支持自定义工作流。相比为常见操作输入完整提示词，斜杠命令更加高效便捷。

内置命令参考

命令 用途 备注
/init 使用 CLAUDE.md 初始化项目 创建包含项目结构的记忆文件
/memory 管理自动记忆 查看和编辑自动记忆文件（v2.1.59+）
/copy 复制代码块 交互式选择器，可选择单个代码块或完整回复；”Always copy full response”选项可跳过后续调用的选择器；w 键可将选中内容直接写入文件——在 SSH 上尤为实用；/copy N 复制最近第 N 条助手回复（v2.1.59+，v2.1.63、v2.1.72、v2.1.77 增强）111121126
/context 查看上下文窗口使用情况 显示可视化分析及可操作建议（v2.1.74+）123
/compact 压缩对话历史 可添加焦点：/compact focus on tests
/cost 显示 token 用量和费用 会话明细
/usage 显示当前计划用量 仅限 VSCode（v2.1.14+）
/stats 使用统计 常用模型、用量图表、连续使用天数
/permissions 管理权限设置 交互式界面
/mcp 配置 MCP 服务器 也可用 /mcp enable、/mcp disable
/hooks 查看 hooks 配置 调试 hooks
/config 打开设置界面 完整配置
/resume 恢复命名会话 /resume <n> 或 /resume session-name
/rename 命名当前会话 /rename feature-auth
/branch 分支对话 在不丢失上下文的情况下探索替代方案（/fork 仍可作为别名使用，v2.1.77 中重命名）126
/clear 清除对话历史 全新开始
/vim 启用 vim 编辑模式 模态编辑
/ide 连接至 IDE VS Code/JetBrains 集成
/sandbox 启用沙箱模式 隔离环境
/status 查看会话状态 模型、设置等
/statusline 自定义状态栏 配置显示内容
/model 切换 AI 模型 /model opus
/fast 切换快速模式 同一模型，更快输出（v2.1.36+）
/output-style 设置输出样式 v2.1.73+ 已弃用——请改用 /config122
/agents 管理 subagents 创建、编辑、删除
/bashes 列出后台任务 长时间运行的命令
/tasks 列出后台代理 监控异步任务
/export 导出对话 保存记录
/add-dir 添加工作目录 扩展访问范围
/terminal-setup 配置终端 支持 Kitty、Alacritty、Zed、Warp25
/login 在会话中认证 切换账户或重新认证
/logout 在会话中登出 清除凭据
/doctor 检查安装状态 健康检查
/bug 报告问题 向 Anthropic 提交 issue
/release-notes 查看发布说明 了解最新变更
/rewind 回退到检查点 撤销更改（或按两次 Esc）
/theme 管理主题 Ctrl+T 切换语法高亮
/plugin 管理插件 安装、更新、移除插件
/passes 访客通行证（仅限 Max） 分享 3 个 Claude Code Pro 试用通行证62
/voice 切换语音模式 按住空格键说话，按键通话模式（2026年3月）118
/claude-api Claude API 技能 使用 Claude API/Anthropic SDK 构建应用（v2.1.69+）117
/reload-plugins 重新加载插件 无需重启即可应用插件更改（v2.1.69+）117
/security-review 安全审查 审查代码漏洞（v2.1.70 修复了 git 兼容性）116
/color 设置提示栏颜色 为会话设置提示栏颜色。/color default/gray/reset/none 恢复默认。所有用户可用（v2.1.75+）124
/simplify 简化代码 内置斜杠命令（v2.1.63+）111
/batch 批量操作 内置斜杠命令（v2.1.63+）111
/effort 设置推理力度 将模型推理力度设置为 low/medium/high，作用于当前会话（v2.1.76+）125
/loop 循环任务 /loop 5m /foo 按指定间隔运行提示词，默认 10 分钟。适用于轮询部署状态、监控 PR 或定期检查（v2.1.71+）119

自定义命令创建

在 .claude/commands/（项目级）或 ~/.claude/commands/（个人级）中创建可复用命令：

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

Review this code for security vulnerabilities:

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

Focus on actionable findings with specific line references.

保存为 .claude/commands/security-review.md，使用 /security-review 调用。

命令前置元数据选项

---
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字段限制了skill激活时Claude可以执行的操作。工具限制对于只读或范围受限的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;
}

快速参考

费率计算

  • 交换费：1.5% + $0.10（借记卡），2.1% + $0.10（信用卡）
  • 平台费：2.9% + $0.30（标准），2.2% + $0.30（企业）
  • 国际交易：+1%跨境费
  • 货币转换：中间市场汇率 + 1%

合规阈值

  • $3,000：触发增强尽职调查
  • $10,000：需要提交CTR报告
  • $25,000：需要额外验证

退款时限

  • 全额退款：自捕获之日起120天
  • 部分退款：自捕获之日起180天
  • 拒付时限：120天（Visa），180天（Mastercard）

关键文件

  • src/payments/processor.ts - 核心支付逻辑
  • src/payments/refunds.ts - 退款处理
  • src/compliance/aml.ts - 反洗钱检查
  • src/models/transaction.ts - 交易模型

请参阅BUSINESS_RULES.md了解详细业务逻辑。 请参阅COMPLIANCE.md了解监管要求。 请参阅DATA_MODELS.md了解数据模型文档。

启用此skill后，当您处理交易代码、询问退款逻辑或调试支付流程时，Claude会自动应用支付领域的专业知识。您无需手动调用任何内容，专业知识会自动生效。

### 创建有效的Skills

**从描述开始。** 先编写描述，然后构建与之匹配的skill内容。描述决定了Claude何时使用该skill，因此务必准确：

1. 说明skill提供的功能
2. 列出具体的触发条件
3. 包含相关的关键词和短语

**保持skills的专注性。** 一个skill只覆盖一个领域或能力：

| 好的（专注） | 不好的（太宽泛） |
|--------------|------------------|
| `security-auditor` | `code-helper` |
| `react-patterns` | `frontend-stuff` |
| `postgres-optimization` | `database-expert` |
| `api-documentation` | `docs-generator` |

如果一个skill试图覆盖太多内容，其描述会变得模糊，Claude将无法可靠地识别何时使用它。

**使用渐进式披露。** 将最重要的信息直接放在SKILL.md中，通过引用支持文件提供更深入的内容：

```markdown

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

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

包含具体示例。 抽象描述不如具体模式有用：

## Input Validation

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

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

**使用真实请求进行测试。** 创建skill后，测试Claude是否能正确激活它：

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

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

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

如果Claude未在预期时激活skill，请修改描述以包含您使用的触发短语。

团队共享策略

基于Git的共享（推荐用于项目skills）：

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

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

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

通过符号链接跨项目共享：

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

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

插件分发： 如需更广泛的分发，可将skills打包为插件：

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

打包在插件中的skills会在用户安装插件后自动可用。

调试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前置元数据：
  2. 第一行必须是---
  3. 在markdown内容之前有闭合的---
  4. YAML中不能使用制表符（使用空格）

  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。让专业知识成为环境式的，而非显式调用的。如果您需要显式调用，则保留为命令。

插件系统

插件将Claude Code的扩展打包以供分发。一个插件可以包含自定义命令、subagents、skills、hooks和MCP服务器。Anthropic于2025年12月正式推出了插件市场，包含36个精选插件。47

插件结构

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.json：

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

插件管理

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

插件安装改进（v2.1.51+）

插件现在支持自定义npm注册表以及从npm源安装时的特定版本固定。市场操作的默认git超时时间从30秒增加到120秒，可通过CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS进行配置。105

插件组件

  • 命令：作为斜杠命令可用（/plugin-command）
  • Agents：出现在/agents列表中
  • Skills：根据skill配置自动加载
  • Hooks：与用户/项目hooks合并，并行运行
  • MCP服务器：启用插件时自动启动

记忆系统如何工作？

Claude Code的记忆系统实现了跨会话的持久化上下文。有效的记忆管理决定了Claude是深入理解您的项目，还是将每次会话都视为全新的开始。

CLAUDE.md层级结构

位置 范围 是否共享 用途
/Library/Application Support/ClaudeCode/CLAUDE.md（macOS） 企业级 所有用户 公司标准
./CLAUDE.md或./.claude/CLAUDE.md 项目级 通过git 团队上下文
~/.claude/CLAUDE.md 用户级 所有项目 个人偏好
./CLAUDE.local.md 项目本地 永不共享 个人项目笔记

有效的CLAUDE.md结构

# Project Context

## 架构
- 使用 /packages 目录的 Monorepo 结构
- React 前端位于 /packages/ui
- Node.js API 位于 /packages/api
- 共享类型位于 /packages/types
- 通过 Prisma 使用 PostgreSQL 数据库

## 代码规范
- 全面启用 TypeScript 严格模式
- 强制使用 ESLint + Prettier（pre-commit hooks）
- 禁止默认导出
- 所有公共 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 变更时务必创建迁移文件
多表操作使用事务

## 重要注意事项
- 绝对不要提交 .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 行）。请保持简洁——从 MEMORY.md 链接创建独立的主题文件（如 debugging.md、patterns.md）以存储详细笔记。

管理自动记忆（v2.1.59+）： 使用 /memory 可直接在 Claude Code 中查看和管理自动记忆文件。107 这取代了之前 /memory 仅打开 CLAUDE.md 编辑器的行为。您现在可以查看、编辑和组织 Claude 记住的内容。

记忆时间戳（v2.1.75+）： 记忆文件现在包含最后修改时间戳，帮助 Claude 判断哪些记忆是新鲜的、哪些是过时的。这通过在自动回忆时降低过时记忆的优先级来提高上下文质量。124

如需退出，启动时传入 --no-memory（禁用所有记忆，包括 CLAUDE.md）。目前没有仅禁用自动记忆而保留 CLAUDE.md 的选项（这是一个已提交的功能请求）。

上下文管理命令

查看上下文使用情况：

> /context

以可视化网格显示系统提示词、对话、工具和文件内容的上下文分配情况。

压缩对话：

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

智能摘要较早的对话内容，同时保留关键信息。

自定义压缩说明（在 CLAUDE.md 中）：

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

扩展思考上下文：

export MAX_THINKING_TOKENS=10000

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

上下文优化策略

  1. 使用具体的文件引用，而非让 Claude 搜索
  2. 在切换任务时使用 /clear 清除无关对话
  3. 在长会话期间主动压缩
  4. 使用 subagents 隔离探索性工作
  5. 将复杂任务拆分为聚焦的交互
  6. 恢复会话以继续进行中的工作，而非重新解释

图像与多模态输入

Claude Code 可以分析图像：截图、图表、设计稿、错误信息、数据库 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 问题：”这是 bug 的截图，是什么原因导致的？”
  • 实现设计稿：”根据这个设计稿构建此组件”
  • 分析图表：”解释这个架构图”
  • 数据库 schema：”根据这个 ERD 创建 Prisma 模型”
  • 错误分析：”这个错误截图是什么意思？”

专家提示： 根据设计稿实现功能时，提供多张截图展示不同状态（默认、悬停、加载中、错误）。视觉上下文越丰富，实现效果越好。

PDF 阅读（v2.1.30+）

Claude Code 可以阅读和分析 PDF 文档，支持页面级控制：83

基本 PDF 阅读：

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

读取指定页面范围：

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

或通过 Read 工具的 pages 参数以编程方式操作： - pages: "1-5" - 读取第 1 至 5 页 - pages: "1,3,7" - 读取指定页面 - pages: "10-" - 从第 10 页读取到末尾

限制： - 每次请求最多 100 页 - 最大文件大小 20MB - 大型 PDF（超过 10 页）在使用 @ 引用时返回轻量级引用，完整内容按需加载

语音模式（2026年3月）

语音模式将 Claude Code 变成一个可以对话而非打字交流的结对编程伙伴。通过 /voice 激活，使用按键说话模式精确控制语音捕获时机。118

激活方式

> /voice           # Start voice mode

或在 settings.json 中设置 voiceEnabled: true 以在会话启动时自动激活。

工作原理

按住空格键说话，松开即发送。Claude 处理您的语音并像您输入了提示词一样进行响应。按键说话的设计避免了编码过程中的意外触发。

支持的语言（共 20 种，v2.1.69+）

英语、西班牙语、法语、德语、葡萄牙语、意大利语、日语、韩语、中文、印地语、俄语、波兰语、土耳其语、荷兰语、乌克兰语、希腊语、捷克语、丹麦语、瑞典语、挪威语。117

推出状态

语音模式于2026年3月3日发布。逐步推出（初始约 5%，数周内扩大）。全面推出后所有订阅层级均可使用。118

最佳使用场景

  • 在白板上画草图时描述高层架构
  • 口述提交信息和 PR 描述
  • 以对话方式解释 bug，同时保持双手在键盘上
  • 快速任务委派：”运行测试套件并修复所有失败的测试”

Git集成如何工作？

Claude Code具有深度的git集成，并内置了安全协议。

安全协议

  • 自动遵守.gitignore
  • 未经许可不会修改分支
  • 提交前显示差异
  • 遵循项目的提交规范
  • 未经明确请求不会强制推送
  • 在修改提交前检查作者身份

常见工作流

创建提交：

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

Claude将会： 1. 运行git status和git diff 2. 分析变更 3. 生成符合规范的提交消息 4. 等待批准后再提交

创建拉取请求：

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

审查代码：

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

GitHub Actions集成

通过官方Action在CI/CD中自动化Claude：

快速设置：

> /install-github-app

手动工作流文件：

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

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

用于Bedrock（配合OIDC）：

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

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

代码审查 [研究预览]（2026年3月）

代码审查是Anthropic的多智能体系统，可自动审查拉取请求，捕获人工审查者容易遗漏的缺陷。当PR被打开时，一组智能体并行派遣——每个智能体从不同角度检查代码库——然后交叉验证发现结果以过滤误报，并按严重性排序。结果以单条总览评论加内联标注的形式呈现。120

可用性：研究预览版，面向Claude for Teams和Claude for Enterprise客户开放（2026年3月9日）。

工作原理： 1. 开发者打开一个PR 2. 多个AI智能体并行分析代码 3. 智能体交叉验证彼此的发现 4. 最终智能体进行汇总、去重并按严重性排序 5. 结果以PR评论形式发布（总览+内联标注）

性能指标（Anthropic内部数据）：

指标 数值
大型PR（1,000+行）收到发现 84%（平均7.5个问题）
小型PR（<50行）收到发现 31%（平均0.5个问题）
人工不同意率 <1%的发现被标记为不正确
平均审查时间 约20分钟
实质性PR评论 54%的PR（从16%提升）

费用：每次审查15–25美元，随PR大小和复杂度而变化。组织可以通过月度支出上限、仓库级别启用和分析仪表板来管理支出。120

设置：管理员在Claude Code设置中启用此功能，安装GitHub App，并选择目标仓库。开发者无需配置——启用后，审查会在新PR上自动运行。

与GitHub Action的关键区别：开源的claude-code-action（如上所述）使用单个Claude实例配合提示运行。代码审查则派遣多智能体团队进行更深入的分析。人工审批仍然是必需的——代码审查仅提供信息，不会自动批准合并。120

如何在IDE中使用Claude Code？

VS Code扩展

要求：VS Code 1.98.0+

安装：在扩展市场中搜索”Claude Code”

功能： - 侧边栏面板（Spark图标） - 活动栏中的会话列表，会话以完整编辑器形式打开（v2.1.70+）116 - 计划的完整Markdown文档视图，支持评论功能（v2.1.70+）116 - 通过聊天面板中的/mcp原生管理MCP服务器对话框（v2.1.70+）116 - 压缩显示为可折叠的”Compacted chat”卡片（v2.1.69+）117 - 计划模式，带差异预览 - 自动接受编辑开关 - 扩展思考开关 - 文件附件和图片粘贴 - 对话历史 - 多个同时会话

安全提示：Anthropic已修补IDE扩展v1.0.24+中的WebSocket身份验证绕过漏洞（CVE-2025-52882）。请确保您的扩展已更新；Anthropic已从扩展商店中移除所有存在漏洞的版本。38

第三方提供商配置（在.claude/settings.json中）：

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

JetBrains插件

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

安装：Settings → Plugins → 搜索”Claude Code” → Install → 重启

快捷键： - Cmd+Esc（Mac）/ Ctrl+Esc（Windows）：快速启动 - Cmd+Option+K（Mac）/ Alt+Ctrl+K（Windows）：添加文件引用

功能： - 在IDE差异查看器中查看差异 - 选中内容自动共享上下文 - 诊断信息集成 - 多个会话

WSL2配置： 将Claude命令设置为：

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

终端集成

将外部终端连接到您的IDE：

> /ide

Claude Code自动检测VS Code、Cursor、Windsurf和JetBrains IDE。

Slack集成（2025年12月）

Claude Code现已直接与Slack集成，使开发者能够从聊天对话中委派编码任务。14

工作原理： 1. 在Slack频道或对话中提及@Claude 2. Claude审查消息以确定是否为编码任务 3. Claude Code会话自动在Anthropic基础设施上启动 4. Claude从最近的频道/对话消息中收集上下文 5. 进度更新会回发到您的Slack对话中 6. 完成后提供审查变更和打开PR的链接

使用场景： - 根据Slack中发布的缺陷报告进行缺陷调查 - 基于团队反馈进行快速代码审查 - 根据功能请求实现小型功能

要求： - 通过Slack App Marketplace安装Claude应用 - 付费Slack计划 - 访问Web端的Claude Code

隐私：Claude遵守Slack现有的权限结构。它无法访问您未被授权查看的对话或仓库。对话不会用于模型训练。

高级使用模式

无头模式和CI模式

在脚本和CI管道中运行Claude Code：

#!/bin/bash
# Automated code review

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

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

echo "Review passed"
exit 0

管道和链式操作

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

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

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

后台任务

在不阻塞的情况下运行长时间操作：

> start the build in the background

或在命令执行期间按Ctrl+B。

管理后台任务：

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

使用Git Worktrees的并行会话

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

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

每个worktree是一个独立的项目目录，拥有自己的会话。

JSON输出解析

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

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

程序化会话管理

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

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

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

## 远程与后台代理 [研究预览]

Claude Code的能力超越了本地终端，通过两个互补功能实现扩展：**远程执行**（云端执行并可传送到本地）和**后台代理**（并行任务执行，不阻塞终端）。两者都使用`&`前缀，共享相同的云基础设施。

### 核心概念

[claude.ai/code](https://claude.ai/code)上的网页界面在云端运行Claude Code。任务在后台执行，即使您离开终端也不受影响。当您准备继续时，可以将会话传送到本地机器，从Claude停下的地方精确接续。

远程执行实现了以前不可能的工作流程：
- 在手机上启动一个复杂的重构任务，让它在通勤途中运行，然后在工作站上完成
- 在网页界面上排队多个任务，回到办公桌时查看结果
- 在需要合上笔记本电脑时，将长时间运行的操作交给云端

### `&`前缀

将任务发送到Claude Code网页端在后台运行：

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

`&`前缀将您的提示词分发到云端。Claude异步处理该任务。您可以关闭终端、切换设备或继续其他工作。claude.ai/code上的网页界面会显示您正在运行和已完成的会话。

### `--teleport`标志

将云端会话拉取到本地终端：

```bash
claude --teleport session_abc123

该标志从网页端检索会话状态并在本地恢复。您可以获取完整的对话历史记录、Claude修改过的所有文件，并像一直在场一样继续交互。

会话ID显示在网页界面中。点击任何会话即可查看其ID和当前状态。

要求

Claude Code远程功能适用于Pro、Max、Team（高级席位）和Enterprise（高级席位）订阅者。73网页界面运行在Anthropic的基础设施上，执行与您本地相同的Claude Code功能（文件操作、bash命令、MCP集成），但在托管的云环境中运行。Anthropic于2026年1月扩展了Team和Enterprise的访问权限；账户管理员可以在Claude设置中切换访问权限。

iOS应用（2025年11月）： Claude Code也可在Claude iOS应用上使用，允许您在移动中启动编码任务并从手机监控代理进度。22您可以在离开办公桌时启动任务，之后在准备好审查时将其传送到终端。

远程控制（2026年2月）： 这是一个会话移动功能，允许您从手机、平板电脑或任何浏览器继续本地Claude Code会话。会话状态——文件引用、对话历史、工具配置、待处理操作——通过加密隧道作为单个原子单元移动。作为研究预览功能向Max用户开放（v2.1.58扩展了更多用户的访问权限）。使用claude remote-control子命令（v2.1.51+）进行外部构建。108

实际工作流程

早晨通勤：

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

在办公桌前：

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

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

下班前：

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

第二天早上：

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

Claude Code Security [研究预览]（2026年2月）

Claude Code Security是内置于网页端Claude Code中的漏洞扫描功能。104它扫描代码库中的安全漏洞，并建议有针对性的补丁供人工审查。

可用性： 面向Enterprise、Team和开源维护者的有限研究预览。

工作原理： 1. 将Claude Code Security指向一个代码仓库 2. 它扫描代码库中的漏洞 3. 结果包含供审查的具体补丁建议 4. 在应用更改前需要人工审查

此功能利用了Opus 4.6已展示的开箱即用发现开源代码中500多个零日漏洞的能力。86

当前状态

Claude Code远程功能目前处于研究预览阶段。随着Anthropic收集反馈，该功能预计会持续演进。核心工作流程（云端执行配合本地传送）实现了持续的AI开发：Claude在您离开键盘时持续工作，您回来时从它停下的地方精确接续。

当前限制： 会话传送目前仅支持单向操作：您可以将网页会话拉取到终端，但无法将现有终端会话推送到网页端。目前还无法在远程机器上继续本地会话（例如通过SSH访问的AWS实例）。

后台代理

后台代理在您继续工作的同时运行，无需等待长时间任务完成。17

后台代理的工作原理：

后台代理不会在Claude运行复杂任务时阻塞您的终端，而是： 1. 在单独的进程中独立执行 2. 即使您关闭终端也会继续工作 3. 完成后通过通知报告结果 4. 运行期间可以监控和管理

启动后台代理

使用Ctrl+B： 当Claude正在工作时，按Ctrl+B将当前任务发送到后台。您的终端将立即可用。

使用&前缀：

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

&前缀会分发到Claude Code远程端（云端执行）。要在本地后台执行，请对已在运行的任务使用Ctrl+B。

监控后台任务

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

并行后台工作流程

同时运行多个代理：

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

每个代理独立运行。使用/tasks监控进度，完成后拉取结果。

Claude in Chrome（2025年12月）

Claude Code现在通过Claude in Chrome扩展程序与您的浏览器集成，可直接从终端控制浏览器。24

前提条件

  • Chrome或基于Chromium的浏览器（Edge、Brave、Arc均可）
  • Claude Code v2.0+在终端中运行
  • Pro、Max、Team或Enterprise计划（扩展程序在Free计划下不可用）
  • 从https://claude.ai/chrome安装Chrome扩展程序

设置

  1. 从https://claude.ai/chrome安装Chrome扩展程序
  2. 在提示时授予扩展程序权限（需要页面访问权限以进行浏览器控制）
  3. 启动Claude Code——集成功能通过本地WebSocket自动检测
  4. 使用自然语言控制您的浏览器

扩展程序通过本地WebSocket连接与Claude Code通信。两者必须同时运行。

功能

从终端进行浏览器自动化：

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

网页抓取和测试：

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

使用场景

  • 端到端测试：直接从Claude Code运行集成测试
  • 网页抓取：无需编写浏览器自动化代码即可从页面提取数据
  • 表单填写：自动化重复性的网页工作流程
  • 视觉验证：截图并分析页面布局

Chrome集成在您现有的浏览器会话中运行，可访问您的登录状态和Cookie，这对于测试需要认证的流程非常有用。

限制

  • 不支持多标签页：Claude仅控制活动标签页；无法同时跨多个标签页进行操作
  • JavaScript对话框会阻塞执行：alert()、confirm()和prompt()对话框会暂停扩展程序——在自动化流程中应避免触发它们
  • 无隐身模式访问权限，除非您在隐身模式中明确启用扩展程序
  • WebSocket连接：如果Claude Code重启，Chrome扩展程序需要重新连接（通常在几秒内自动完成）
  • 使用read_page从无障碍树中获取元素引用；使用ref而非坐标进行交互

Claude Code in Slack（2025年12月）[研究预览]

Anthropic推出了Claude Code in Slack，允许开发者直接从聊天线程中委派编码任务。26

工作原理

  1. 在任何Slack频道或线程中标记@Claude
  2. 描述编码任务并提供上下文
  3. Claude分析Slack消息以确定相关代码仓库
  4. 进度更新会显示在线程中
  5. Claude分享审查工作和打开PR的链接

示例工作流

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

Claude将会： 1. 阅读线程以获取上下文 2. 识别相关代码仓库 3. 克隆并分析代码库 4. 发布进度更新 5. 创建包含修复的PR 6. 分享PR链接供审查

优势

  • 上下文感知：Claude可以阅读Slack历史记录中的错误报告、功能请求和讨论
  • 团队可见性：线程中的进度更新让所有人保持知情
  • 低摩擦：无需终端或IDE；直接从聊天开始
  • GitHub集成：自动创建带有完善描述的PR

前提条件

  • 已安装Claude应用的Slack工作区（需要工作区管理员批准）
  • 连接到Slack工作区的GitHub代码仓库
  • Pro、Max、Team或Enterprise计划
  • Claude必须拥有目标仓库的写入权限（分支创建、PR创建）

限制

  • 仓库检测：Claude从Slack上下文（频道主题、最近消息、线程内容）推断代码仓库。如果不明确，请显式指定仓库：@Claude in repo org/my-app, fix the login bug
  • 无本地文件访问：Slack Claude完全在云端运行——它会克隆仓库、进行修改并创建PR，无法访问您的本地文件系统
  • 线程上下文窗口：Claude可以阅读当前线程，但对其他频道或私信的上下文访问有限
  • 审批流程：所有更改都通过PR审查——Claude永远不会直接推送到main分支
  • 速率限制：受您计划的Claude Code使用限制约束（与CLI和Web使用共享）

Slack集成目前处于研究预览阶段，面向Pro、Max、Team和Enterprise用户。

Claude Code on the Web [研究预览]（2026年1月）

Claude Code on the Web让您可以通过浏览器在claude.com/code上委派编码任务，运行在Anthropic管理的云基础设施上。73这是无需终端的Claude Code——分配任务、跟踪进度，然后获取Pull Request。

核心能力

  • 并行任务执行：从单一界面同时在不同代码仓库中启动多个编码任务
  • 实时进度跟踪：观看Claude处理任务的实时更新；在会话进行中重新引导其方向
  • 自动创建PR：Claude生成带有清晰变更摘要的Pull Request
  • 会话传送：使用claude --teleport将Web会话拉取到本地终端，继续在本地工作
  • 移动端访问：早期阶段的iOS应用让您可以从手机分配和监控编码任务73

安全架构

任务在隔离的沙箱环境中执行，具有网络和文件系统限制。Git交互通过安全代理进行，该代理将仓库访问限制为仅授权的仓库。管理员可以配置Claude可以访问的域名（例如，允许下载npm包用于测试）。73

可用性

计划 访问权限
Pro / Max 已包含
Team / Enterprise 需要高级席位

云端会话与所有其他Claude Code使用（CLI、IDE、Slack）共享速率限制。

Web与终端：何时使用哪个

场景 使用Web 使用终端
错误积压分类 并行分配5个错误 —
离开办公桌时的快速修复 从手机分配 —
复杂架构工作 — 完整的代码库上下文
自定义hooks和MCP — 完整的扩展层
夜间批量工作 睡前分配，早上审查 &后台代理

当前限制：会话传送是单向的——您可以将Web会话拉取到终端，但无法将终端会话推送到Web。73

性能优化

减少延迟

模型选择： - Haiku：最快响应，最低成本 - Sonnet：良好的平衡 - Opus：最佳质量，最高延迟

流式输出： 所有响应默认以流式方式返回，因此您可以在生成过程中看到输出。

提示缓存： 默认启用。减少重复上下文（系统提示、工具定义）的延迟。

缓存策略

Claude Code自动缓存系统提示和工具定义： - 缓存持续时间：5分钟（临时） - 缓存命中：减少输入token数量并加快响应速度

多轮对话会缓存前几轮的思考块。

如需按模型禁用缓存：

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

并行操作

子代理并行化： 多个子代理可以同时运行。每个子代理独立运行，不会污染主上下文。

后台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"，为每个子代理提供隔离的仓库副本，如果没有进行更改则会自动清理。103ExitWorktree工具允许代理以编程方式离开worktree会话（v2.1.72+）。121对于非git版本控制系统，可以配置WorktreeCreate/WorktreeRemove hooks来处理自定义设置和清理。103

单仓库的稀疏worktree（v2.1.76+）：worktree.sparsePaths设置为大型单仓库中的worktree启用git sparse-checkout，仅检出您指定的路径而非整个仓库：125

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

跨worktree共享状态（v2.1.63+）：项目配置（.claude/settings.json）和自动记忆现在可以在同一仓库的git worktree之间共享。在一个worktree中对设置或记忆的更改在所有其他worktree中可见。111

内存优化

  • 指定文件引用：使用@src/auth.ts而非”find the auth file”
  • 定向搜索：使用”search in src/api”而非”search everywhere”
  • 刷新会话：在不相关的任务之间使用/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）：

方案一 - Windows 防火墙：

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

方案二 - 镜像网络（添加到 ~/.wslconfig）：

[wsl2]
networkingMode=mirrored

然后执行：wsl --shutdown

JetBrains 中 Escape 键无效： Settings → Tools → Terminal → 取消勾选 “Move focus to the editor with Escape”

认证管理（v2.1.41+）

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

在 API 密钥与 OAuth 之间切换，或在不同组织之间切换时，使用 claude auth logout && claude auth login 来重置认证。

调试模式

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

/debug 命令（v2.1.30+）提供会话级别的诊断信息，包括： - 当前模型和上下文使用情况 - 活跃的 MCP 服务器及其状态 - 权限状态和最近的拒绝记录 - 内存压力指标

配置重置

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

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

常见错误消息

错误 原因 解决方案
“Rate limit exceeded” 请求过于频繁 等待或降低请求频率
“Context length exceeded” 对话过长 使用 /compact 或 /clear
“Authentication failed” 令牌无效或已过期 运行 claude auth login
“Tool not permitted” 权限被拒绝 检查 settings.json 权限配置
“MCP server failed to start” 服务器配置错误 检查 claude mcp get <name>

企业部署

云服务提供商对比

功能 Anthropic 直连 AWS Bedrock Google Vertex Microsoft Foundry
认证 API 密钥 IAM/API 密钥 GCP 凭证 Entra ID/API 密钥
成本追踪 控制台 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. 引导式开发：逐步过渡到小型 Bug 修复
  5. 全面部署：配合托管设置进行推广
  6. 监控成本：按团队追踪使用量

审计与合规

数据处理： - 会话记录默认存储在本地（除 API 调用外，没有数据离开本机） - API 请求发送至 api.anthropic.com（直连）或通过您的云服务提供商（Bedrock/Vertex/Foundry） - Anthropic 的商业条款声明 API 输入/输出不会用于模型训练 - 如有数据驻留要求，请使用 Bedrock（AWS 区域）或 Vertex（GCP 区域）将 API 流量限制在特定地理区域内

SSO 与身份管理： - Anthropic 直连：通过 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...），由组织管理员在控制台中配置。

可用指标：

类别 指标
生产力 每用户的会话数、添加/删除行数、提交数、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 粘贴（从删除环中粘贴）
Ctrl+S 暂存提示词草稿（保存当前输入）
Alt+Y 循环粘贴（在 Ctrl+Y 后循环删除环）
Esc Esc 撤销上次更改
Tab 接受提示建议
! + Tab Bash 历史自动补全（v2.1.14+）
Shift+Tab 循环切换权限模式
Alt+P / Option+P 输入提示词时切换模型
Alt+T 切换思考模式（更安全的替代方式）
Ctrl+T 在 /theme 中切换语法高亮
Ctrl+G 打开外部编辑器（在 AskUserQuestion “Other” 输入中）
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 和 hooks 脚本会被读取并可能被执行。恶意仓库可以利用这些文件注入提示、覆盖权限或执行任意命令。在对非您拥有的仓库运行 Claude Code 之前，请始终审查 CLAUDE.md、.claude/settings.json 和所有 hooks 脚本。仅在受信任的代码库上使用 --dangerously-skip-permissions。

已知 CVE（请保持 Claude Code 更新）： - CVE-2025-59536（已在 v1.0.111 中修复）：通过不受信任的目录工具初始化进行的代码注入。 - CVE-2026-21852（已在 v2.0.65 中修复）：项目加载流程中的信息泄露，允许从恶意仓库窃取 API 密钥。109

自定义命令

为重复性工作流创建命令：

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

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

有效提示

具体明确：

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

# Too vague
"Improve the login"

直接引用文件：

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

提供约束条件：

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

使用子代理进行探索：

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

成本控制

  • 定期使用 /cost
  • 对简单任务和子代理使用 Haiku
  • 仅在需要时设置 MAX_THINKING_TOKENS
  • 对自动化脚本使用 --max-turns
  • 在长会话中主动压缩上下文

安全

  • 在 .claude/settings.json 中配置拒绝规则以保护敏感文件
  • 对不受信任的项目使用沙箱模式
  • 永远不要允许 Bash(rm -rf:*) 或 Bash(sudo:*)
  • 使用 hooks 阻止访问密钥
  • 为企业部署托管设置

社区技巧与技术5658

Claude Code 社区发现了许多超越官方文档的强大模式。这些技巧来自资深用户，包括 Boris Cherny（Claude Code 创建者）和 40 多条技巧仓库。

编码前使用计划模式

如果您只记住一个技巧，就记住这个。 您在规划上花的时间越多，Claude 成功的可能性就越大。按 Shift+Tab 切换到计划模式后再开始实现。完整文档请参阅计划模式。

频繁清除上下文

经常使用 /clear。每次开始新任务时，清除聊天记录。您不需要旧历史记录消耗 token 或触发昂贵的压缩调用。直接清除然后继续工作。

使用图片和截图

Claude 擅长处理视觉输入。在 macOS 上：Cmd+Ctrl+Shift+4 将截图捕获到剪贴板，然后 Ctrl+V 直接粘贴到 Claude Code。用于分享 UI 原型、错误消息或设计参考。

安装 GitHub 应用以进行 PR 审查

运行 /install-github-app，Claude 将自动审查您的 PR。随着 AI 辅助开发增加了 PR 数量，自动审查变得尤为重要。Claude 经常能发现人工审查者遗漏的逻辑错误和安全问题。

基于容器的自主运行

要实现完全自主运行，请在 Docker 容器中运行 Claude Code，使用 tmux 作为控制层。您本地的 Claude Code 控制容器化实例，该实例可以运行长时间或实验性任务，无需手动批准。如果出现问题，它是隔离的。

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

Docker 沙箱模式（快速开始）： 在 Docker 容器中运行 Claude Code，以便在探索不受信任的代码库或运行实验性提示时实现完全隔离。63

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

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

在以下情况下使用沙箱模式： - 探索不熟悉或不受信任的代码库 - 测试可能修改文件的实验性提示 - 运行需要完全隔离的自主会话 - 学习 Claude Code 而不影响实际文件

Gemini CLI 作为后备方案

Claude Code 的 WebFetch 工具无法访问某些网站（如 Reddit）。创建一个 skill 告诉 Claude 使用 Gemini CLI 作为后备方案。Gemini 具有网络访问能力，可以获取 Claude 无法直接访问的网站内容。

元代理工厂模式

不要创建执行任务的代理，而是创建一个能创建其他代理的代理。这种模式真正地倍增了复杂自动化工作流的生产力，而不是通过巧妙的递归。

Claude Squad：多代理管理器

Claude Squad 可并行管理多个 Claude Code 实例，每个实例在自己的 tmux 会话中运行，拥有隔离的工作树。同时在不同任务上运行多个代理，从单一仪表板监控其进度，并在完成后拉取结果。65

# Install (Homebrew)
brew install claude-squad

# Or install via script (puts `cs` in ~/.local/bin)
curl -fsSL https://raw.githubusercontent.com/smtg-ai/claude-squad/main/install.sh | bash

# Launch the TUI — manages instances, tasks, and git worktrees
cs

# Auto-accept mode (experimental)
cs --autoyes

用例： - 跨代理并行化独立功能 - 运行探索性提示而不阻塞主会话 - 将自主编码扩展到单一上下文窗口之外

资深用户生产力数据

Boris Cherny 展示了 Claude Code 的潜力：在 30 天内，他提交了 259 个 PR，包含 497 次提交：新增 40,000 行代码，删除 38,000 行。这些数据展示了当 Claude Code 完全融入开发工作流后的可能性。

值得关注的人

关注以下账号以了解 Claude Code 的最新动态：

Anthropic 团队（主要来源）

人物 平台 关注理由
Boris Cherny @boris_cherny Claude Code 创建者。发布功能、宣布更新、主持聚会。第一手来源。
Cat Wu @_catwu Anthropic。Claude Code 功能公告、子代理更新。
@adocomplete X Advent of Claude 系列——深度每日教程（hooks、plugins、提示存储）。
Thariq @trq212 Anthropic Claude Code 团队工程师。解决问题、发布更新。
Anthropic @AnthropicAI 官方公告和重大发布。

顶级内容创作者

人物 专注领域 代表作
@dani_avila7 教程 Hooks 深度指南、规则详解
@mattpocockuk MCP/技巧 10 课 MCP 教程、Docker 沙箱、JSON 优化
ykdojo GitHub 技巧 40 多条技巧仓库、状态栏脚本、系统提示优化
@ai_for_success MCP/工作流 Hyperbrowser MCP、文档缓存模式
@jerryjliu0 代理 逐步代理构建教程

关键资源

  • GitHub 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 挂载格式化 hook
默认允许所有 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） 子智能体（Task 工具）+ 智能体团队
MCP 支持 300+ MCP 集成 + 远程 OAuth
ACP（Agent Client Protocol） Hooks（12+ 生命周期事件）
IDE + CLI 终端原生 + IDE 扩展

您将获得：操作系统级沙箱隔离、22个 hook 生命周期事件、支持 OAuth 的远程 MCP、具有隔离上下文的子智能体委派，以及用于云端到本地交接的 --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 支持子智能体委派的 REPL
代码库索引 实时文件访问（Glob、Grep、Read）
Tab 自动补全 非主要功能
IDE 集成 终端原生 + IDE 扩展
MCP 支持（内置） MCP 支持（300+ 集成，远程 OAuth）
Cursor 规则（.mdc）+ AGENTS.md CLAUDE.md + Skills
后台智能体 远程智能体（& 前缀，--teleport）

您将获得：22个 hook 生命周期事件用于自动化、具有隔离上下文的子智能体委派、操作系统级沙箱隔离（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. 大胆委派任务。子智能体处理探索工作，不会膨胀您的上下文。
  4. 利用 hooks 实现自动化。格式化、代码检查、日志记录自动完成。
  5. 以会话为单位思考。使用 -c 继续工作，而非开启新对话。

面向不同受众的指南

面向开发者： - Haiku 的成本约为 Opus 的1/5；可用于子智能体和简单任务 - 在长会话中主动使用 /compact 管理上下文 - 编码上下文信息的会话 ID（feature-${branch}-${timestamp}）有助于定位之前的工作 - 在常用提示前加 # 可将其添加到持久记忆中，无需额外输入

面向 DevOps 和平台团队： - 无头模式（-p 标志）支持 CI/CD 集成，提供 JSON 输出用于解析 - Hooks 保证执行，不受模型行为影响；可用于代码检查、格式化、安全检查 - MCP 将功能扩展到数据库、GitHub、Sentry 及 300+ 集成 - 后台任务（& 前缀）在 Claude Code Remote 上异步执行

面向安全团队： - 权限规则按首次匹配原则执行；请仔细组织允许/拒绝列表 - 沙箱模式隔离文件系统和网络，适用于不受信任的代码库 - Bash 模式仅匹配前缀，因此 Bash(curl:*) 会阻止所有 curl，而非仅特定 URL - 企业托管设置无法被用户覆盖

面向团队负责人： - Skills 根据上下文自动激活；无需显式调用即可嵌入领域专业知识 - 项目 skills 提交到 git；团队成员自动获得标准化的专业知识 - 通过 /cost 进行费用跟踪，显示会话明细；根据团队规模为每位用户预算 10k-300k TPM - .claude/commands/ 中的自定义命令可创建可复用的工作流

面向企业架构师： - 托管设置通过 /etc/claude-code/managed-settings.json 部署组织范围的策略 - AWS Bedrock、Google Vertex AI 和 Microsoft Foundry 与现有云计费集成 - Opus 4.6 拥有 1M 上下文窗口，能够在单个提示中处理整个代码库 - 智能体团队（v2.1.32+）支持并行多智能体协调，处理复杂任务 - 建议先在5-10名开发者中试点，再全面推广

快速参考卡

打印出来，贴在显示器旁边。

╔═══════════════════════════════════════════════════════════════╗
║                    CLAUDE CODE QUICK REFERENCE                 ║
╠═══════════════════════════════════════════════════════════════╣
║  MODELS                                                        ║
║    haiku     $1/$5/M     Exploration, simple tasks            ║
║    sonnet    $3/$15/M    Daily coding (default)               ║
║    opus      $5/$25/M    Opus 4.6: architecture, hard probs  ║
║    opus[1m]  $10/$37.50  1M context (default for Max/Team)   ║
║    sonnet[1m] $6/$22.50/M Large codebases (1M context)        ║
╠═══════════════════════════════════════════════════════════════╣
║  ESSENTIAL COMMANDS                                            ║
║    /compact        Reduce context (do at 50% capacity)        ║
║    /cost           Check session spending                     ║
║    /model opus     Switch to Opus                             ║
║    /status         Show current state                         ║
║    /voice          Toggle voice mode (push-to-talk)           ║
║    /init           Set up project config                      ║
║    /mcp            Configure integrations                     ║
║    /copy [N]       Copy code blocks (Nth-latest response)     ║
║    /memory         View and manage auto-memory                ║
║    /claude-api     Build apps with Claude API/SDK             ║
║    /simplify       Simplify code (bundled, v2.1.63+)         ║
║    /batch          Batch operations (bundled, v2.1.63+)      ║
║    /effort         Set effort level (low/medium/high)        ║
║    /loop 5m /foo   Run prompt on recurring interval          ║
║    claude -n name  Start session with display name           ║
║    claude agents   List all configured agents (CLI)           ║
║    claude -w       Start in isolated git worktree             ║
║    claude remote-control  Serve local env for external builds ║
╠═══════════════════════════════════════════════════════════════╣
║  KEYBOARD SHORTCUTS                                            ║
║    Alt+T           Toggle extended thinking                   ║
║    Shift+Tab       Cycle permission modes                     ║
║    Ctrl+C          Interrupt current operation                ║
║    Ctrl+F          Kill all background agents                 ║
║    Esc → Esc       Rewind last change                         ║
║    Ctrl+L          Clear screen                               ║
╠═══════════════════════════════════════════════════════════════╣
║  PREFIXES                                                      ║
║    #message        Add to persistent memory                   ║
║    @path/file      Reference file in prompt                   ║
║    !command        Execute bash directly                      ║
║    &task           Send to cloud (async)                      ║
╠═══════════════════════════════════════════════════════════════╣
║  CONFIG FILE HIERARCHY (first found wins)                      ║
║    .claude/settings.local.json    Personal (gitignored)       ║
║    .claude/settings.json          Project (shared)            ║
║    ~/.claude/settings.json        User global                 ║
║    /etc/.../managed-settings.json Enterprise (locked)         ║
║    CLAUDE.md                      Project context             ║
╠═══════════════════════════════════════════════════════════════╣
║  DAILY WORKFLOW                                                ║
║    1. claude -c              Continue session                 ║
║    2. Work on features       Use Sonnet                       ║
║    3. /compact               Before context bloats            ║
║    4. /cost                  Check spending                   ║
║    5. Summarize              Clean exit                       ║
╠═══════════════════════════════════════════════════════════════╣
║  DECISION RULES                                                ║
║    Simple task?        → Haiku                                ║
║    Hard reasoning?     → Opus                                 ║
║    Everything else?    → Sonnet                               ║
║    Must always run?    → Hook (not prompt)                    ║
║    Auto-apply wisdom?  → Skill (not command)                  ║
║    Needs isolation?    → Subagent                             ║
╚═══════════════════════════════════════════════════════════════╝

更新日志

本参考指南为动态文档，随着 Claude Code 的发展持续更新。

| 日期 | 变更 | 来源 | | 2026-03-19 | 指南 v2.20：新增 v2.1.78 和 v2.1.79 功能。StopFailure hook 事件（共 23 个）。插件持久化状态（${CLAUDE_PLUGIN_DATA}）。Agent frontmatter：effort、maxTurns、disallowedTools 用于插件代理。ANTHROPIC_CUSTOM_MODEL_OPTION 环境变量用于自定义 /model 条目。逐行响应流式输出。Tmux 通知透传。--console 标志用于 claude auth login。/remote-control VS Code 命令。VS Code 中 AI 生成的会话标题。启动内存减少约 18MB。安全修复：沙箱依赖缺失时显示可见警告。SessionEnd hooks 现在在 /resume 切换会话时触发。修复 20 余项缺陷。 | 127 128 | | 2026-03-18 | CLI 2.1.79：--console 标志用于 API 计费认证，/remote-control VS Code 命令，VS Code 中 AI 会话标题，启动内存减少约 18MB，2 分钟非流式超时，SessionEnd hooks 在 /resume 切换时触发。修复：-p 作为子进程时挂起、print 模式下 Ctrl+C、/btw 输出错误、语音模式启动、企业级 429 重试。 | 128 | | 2026-03-17 | CLI 2.1.78：StopFailure hook 事件、${CLAUDE_PLUGIN_DATA} 插件状态、agent frontmatter（effort/maxTurns/disallowedTools）、ANTHROPIC_CUSTOM_MODEL_OPTION、tmux 通知透传、逐行流式输出。安全：沙箱依赖缺失时显示可见警告。修复：大型会话截断（>5MB）、stop hook 无限循环、沙箱路径处理、语音 WSL2、VS Code 中 Homebrew PATH。 | 127 | | 2026-03-17 | 指南 v2.19：新增 v2.1.77 功能。Opus 4.6 默认输出 token 增至 64K，Opus 4.6 和 Sonnet 4.6 上限提升至 128K。allowRead 沙箱文件系统设置，用于在 denyRead 区域内重新允许读取访问。/copy N 复制第 N 条最新助手响应。/fork 更名为 /branch（/fork 保留为别名）。Agent 工具不再接受 resume 参数——使用 SendMessage({to: agentId}) 继续代理；SendMessage 自动恢复已停止的代理。会话在接受计划内容时自动命名。后台 bash 任务在输出达 5GB 时终止。claude plugin validate 检查 skill/agent/command frontmatter 和 hooks/hooks.json。macOS 启动加速约 60ms（并行钥匙串读取）。--resume 速度提升最高 45%，峰值内存减少约 100-150MB。安全修复：PreToolUse hooks 返回 "allow" 不再绕过 deny 权限规则（包括托管设置）。修复 25 余项缺陷，包括复合 bash “Always Allow” 保存无效规则、自动更新器内存泄漏、Write 工具 CRLF 转换、过期 worktree 清理竞态条件、vim 模式修复、tmux 剪贴板修复。 | 126 | | 2026-03-14 | 指南 v2.18：新增 v2.1.76 功能。MCP 信息引出支持——MCP 服务器可在任务执行中通过交互式对话框请求结构化输入。3 个新 hook 事件：Elicitation、ElicitationResult、PostCompact（共 22 个）。-n/--name CLI 标志，用于在启动时设置会话显示名称。worktree.sparsePaths 用于大型 monorepo 中的稀疏检出。/effort 斜杠命令用于设置模型努力级别。缺陷修复：压缩后延迟工具丢失 schema、计划模式重新审批、语音模式按键、自动压缩断路器（最多 3 次尝试）、tmux 上 SSH 的剪贴板、Remote Control 会话稳定性。 | 125 | | 2026-03-13 | 指南 v2.17：新增 v2.1.75 功能。1M 上下文窗口现为 Opus 4.6 默认配置，适用于 Max、Team 和 Enterprise 计划（无需 [1m] 后缀）。/color 命令向所有用户开放。记忆文件现包含最后修改时间戳，用于新鲜度推理。Hook 权限提示现显示来源（settings/plugin/skill）。会话名称显示在提示栏上，可通过 /rename 修改。缺陷修复：语音模式激活、Bash ! 在管道命令中的处理、token 估算过度计数导致过早压缩、macOS 启动性能。重大变更：移除已弃用的 Windows 托管设置回退路径。 | 124 | |------|--------|--------| | 2026-03-12 | 指南 v2.16：新增 v2.1.73 和 v2.1.74 功能。v2.1.73：modelOverrides 设置用于自定义提供商模型 ID（Bedrock/Vertex/Foundry），弃用 /output-style（改用 /config），云提供商默认使用 Opus 4.6，中断后按上箭头恢复提示并回退，/effort 在响应时可用，SSL 证书错误指引，CPU 冻结和死锁修复，SessionStart hooks 重复触发修复。v2.1.74：/context 可操作建议，autoMemoryDirectory 设置，--plugin-dir 覆盖行为变更，CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS 可配置超时，托管策略执行修复，内存泄漏修复（流式缓冲区），RTL 文本渲染修复，MCP OAuth 修复。 | 122123 | | 2026-03-11 | 指南 v2.15：新增 v2.1.72 功能和 Code Review 产品。Code Review [研究预览]：多代理 PR 审查系统，调度并行代理进行交叉验证。Team/Enterprise，每次审查 $15-25，约 20 分钟。v2.1.72：/plan 接受描述参数，/copy 中 w 键用于写入文件，ExitWorktree 工具，CLAUDE_CODE_DISABLE_CRON 环境变量，bash 允许列表扩展（lsof、pgrep、tput、ss、fd、fdfind），Agent 工具恢复 model 参数用于逐次调用覆盖，简化努力级别符号（○ ◐ ●），/config 导航改进（Esc/Enter/Space），包体积减少 510KB，VSCode URI 处理器。 | 120121 | | 2026-03-10 | 新增：v2.1.72——配置 ANTHROPIC_BASE_URL 时，设置 ENABLE_TOOL_SEARCH 可激活工具搜索。/copy 中 w 键将选中内容写入文件（SSH 友好）。/plan 接受可选描述。ExitWorktree 工具用于退出 worktree 会话。CLAUDE_CODE_DISABLE_CRON 停止定时任务。Bash 允许列表：lsof、pgrep、tput、ss、fd、fdfind。Agent 工具恢复 model 用于逐次调用模型覆盖。努力级别简化为 ○/◐/● 符号。/config 导航：Esc 取消、Enter 保存、Space 切换。包体积减少 510KB。语音转录准确度提升。VSCode URI 处理器支持程序化标签页打开。修复：Windows/OneDrive 插件安装、并行工具调用级联、代理进度追踪。 | 121 | | 2026-03-09 | Code Review 发布。多代理 PR 审查系统——调度并行代理交叉验证发现并按严重程度排序。每次审查 $15-25。Team/Enterprise 研究预览。54% 的 PR 收到实质性评论（此前为 16%）。错误发现率低于 1%。 | 120 | | 2026-03-09 | 指南 v2.14：新增 /loop 循环任务命令（v2.1.71）。新增专门的”Claude Code on the Web”章节，涵盖功能、安全架构、可用性及网页与终端对比决策表。提及移动应用（iOS）。更新快速参考卡片，加入 /loop。 | 119 | | 2026-03-07 | 新增：v2.1.71——/loop 命令用于按间隔执行循环提示（/loop 5m /foo）。语音快捷键自定义。Bash 自动审批允许列表扩展。标准输入冻结修复。macOS CoreAudio 启动优化。 | 119 | | 2026-03-06 | 指南 v2.13：语音模式章节（/voice、按住说话、20 种 STT 语言）。v2.1.68 努力级别变更（Opus 4.6 默认为中等努力，适用于 Max/Team；重新引入 ultrathink；移除 Opus 4/4.1）。v2.1.69 功能：/claude-api skill、InstructionsLoaded hook 事件、hook 事件中的 agent_id/agent_type/worktree 字段、${CLAUDE_SKILL_DIR}、/reload-plugins、CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS、sandbox.enableWeakerNetworkIsolation、remote-control 自定义名称、Ctrl+U 退出 bash 模式、数字键盘支持。v2.1.70 修复：第三方网关 API 400 错误、努力参数错误、ToolSearch 后空响应。VS Code：闪光图标会话列表、Markdown 计划视图、原生 MCP 管理。性能：提示渲染减少 74%、Remote Control 轮询率降低 300 倍。子代理模型默认值更新为 inherit。共 18 个 hook 事件。 | 116117118 | | 2026-03-06 | 新增：v2.1.70——修复使用 ANTHROPIC_BASE_URL 第三方网关时的 API 400 错误（工具搜索为代理端点禁用 tool_reference 块）。修复自定义 Bedrock 推理配置的努力参数错误。修复 ToolSearch 后模型空响应。改进压缩以保留图像供提示缓存复用。/rename 在 Claude 处理时可用。提示重渲染减少约 74%。Remote Control /poll 降至 1/10 分钟（约 300 倍降低）。VS Code：闪光图标会话列表作为完整编辑器、完整 Markdown 计划视图含评论、原生 /mcp 对话框。--resume 每次节省约 600 token（skill 列表重注入修复）。多项 Windows/语音/插件/安全修复。 | 116 | | 2026-03-05 | 新增：v2.1.69——/claude-api skill。InstructionsLoaded hook 事件。hook 事件中的 agent_id/agent_type/worktree 字段。${CLAUDE_SKILL_DIR} skill 自引用变量。/reload-plugins 命令。sandbox.enableWeakerNetworkIsolation 用于 Go/MITM 代理。includeGitInstructions 设置 + CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS 环境变量。Remote-control 自定义名称（--name）。语音 STT 新增 10 种语言（共 20 种）。努力级别显示。Ctrl+U 退出 bash 模式。数字键盘支持。git-subdir 插件源类型。MCP 服务器的 oauth.authServerMetadataUrl。Sonnet 4.5→4.6 自动迁移。安全：gitignored 目录中嵌套 skill 发现、符号链接写入逃逸、信任对话框启用所有 .mcp.json 服务器。修复 70 余项缺陷，包括 macOS 钥匙串损坏、teammate 嵌套生成、内存泄漏。 | 117 | | 2026-03-04 | 新增：v2.1.68——Opus 4.6 对 Max/Team 订阅者默认为中等努力级别。重新引入”ultrathink”关键词对应高努力级别。从第一方 API 上的 Claude Code 中移除 Opus 4 和 Opus 4.1。 | 116 | | 2026-03-03 | 语音模式发布。/voice 激活按住说话功能（按住空格键说话）。逐步推出（初始约 5%）。专业结对编程设计，而非休闲语音助手。 | 118 | | 2026-03-02 | 指南 v2.12：Task 工具→Agent 工具重命名文档化（Agent(agent_type) 语法，Task(...) 作为别名）。macOS plist 和 Windows 注册表支持托管设置（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 skill 缓存重置修复。多项内存泄漏修复。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 “always allow”前缀建议改进。多代理会话内存使用改善。MCP OAuth token 刷新竞态条件修复。 | 107108109110 | | 2026-02-25 | 指南 v2.9：新增 v2.1.52–v2.1.56 缺陷修复。修复 Agent Teams 导航（仅 Shift+Down，而非 Shift+Up/Down）。添加团队存储路径和任务依赖详情。添加 TeammateIdle/TaskCompleted hook 集成说明。 | 106 | | 2026-02-25 | 新增：v2.1.53–v2.1.56——VS Code 在 Windows 上崩溃修复，修复提交后输入框短暂消失的 UI 闪烁，修复批量代理终止（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 计划审批适用于 teammates。 | 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 工具时代码执行免费说明。添加失败的 web 搜索不计费说明。 | 1 | | 2026-02-21 | 指南 v2.6：新增 v2.1.49 和 v2.1.50 功能。新 hook 事件：ConfigChange、WorktreeCreate、WorktreeRemove（共 17 个）。新 --worktree/-w 标志用于隔离 git worktree。子代理 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 设置/拆除，agent 定义中的 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 断开时会话数据丢失、agent teams 内存泄漏（已完成任务未被 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 工作，agent 定义支持 background: true 以始终作为后台任务运行，ConfigChange hook 事件用于企业安全审计，插件可附带 settings.json 作为默认配置，SDK 模型信息现包含 supportsEffort/supportedEffortLevels/supportsAdaptiveThinking 字段。CLAUDE_CODE_SIMPLE 现包含文件编辑工具。移除带 1M 上下文的 Sonnet 4.5，改为 Sonnet 4.6。改进 MCP OAuth 的阶梯认证和发现缓存。修复：后台代理时 Ctrl+C 和 ESC 被忽略、无限制 WASM 内存增长、disableAllHooks 托管设置层级、--resume 显示原始 XML 标签。改进权限提示以显示限制原因。 | 103 | | 2026-02-20 | Claude Code Security（研究预览）：内置于 Claude Code on the web 的漏洞扫描。扫描代码库并建议补丁供人工审查。适用于 Enterprise、Team 和开源维护者。 | 104 | | 2026-02-18 | 新增：v2.1.47——Ctrl+F 终止所有后台代理（替代双击 ESC），Stop/SubagentStop hook 输入中的 last_assistant_message 字段，chat:newline 键绑定动作，statusline JSON 中的 added_dirs，/rename 更新终端标签页标题，恢复选择器显示 50 个会话（原为 10 个），teammate 导航简化为仅 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）。以更少 token 提升代理搜索性能。支持自适应推理、扩展推理和 1M token 上下文窗口（beta）。最大输出 64K。知识截止：可靠至 2025 年 8 月，训练至 2026 年 1 月。Sonnet 4.5 转为旧版。另外：API 代码执行配合 web search/web fetch 现在免费，web search 工具和程序化工具调用正式 GA（无需 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 上无条件发送 structured-outputs 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 将中断消息显示为会话标题，修复 Bedrock/Vertex/Foundry 用户看到 Opus 4.6 发布公告，改进多图尺寸限制错误消息并建议使用 /compact。 | 97 | | 2026-02-13 | 新增：v2.1.41——claude auth 子命令（login、status、logout）用于无需进入 REPL 即可管理认证，Windows ARM64 原生二进制支持，/rename 不带参数调用时从对话上下文自动生成会话名称。修复：AWS 认证刷新无限挂起（添加 3 分钟超时）、带锚点片段的 @ 提及（如 @README.md#installation）、FileReadTool 在 FIFO//dev/stdin/大文件上阻塞、流式 Agent SDK 模式下后台任务通知、分类器规则输入中光标跳转、Markdown 链接显示文本被丢弃为原始 URL、自动压缩失败通知展示给用户、子代理耗时中包含权限等待时间、计划模式中主动 tick 触发、设置变更后过期权限规则未清除、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 的写入（防止提示注入修改 skill 定义），改进 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 ask 权限规则。另修复代理团队设置在渲染间变更时的崩溃。 | 94 | | 2026-02-05 | 新增：v2.1.33——TeammateIdle 和 TaskCompleted hook 事件用于多代理工作流，Task(agent_type) 语法用于限制 agent tools frontmatter 中可生成的子代理，memory frontmatter 字段用于代理（user/project/local 范围），插件名称显示在 skill 描述和 /skills 菜单中。修复：tmux 中代理 teammate 会话无法收发消息、不支持计划上代理团队可用性警告、提交新消息时扩展推理中断、中途中止带空白+思考块的 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 token 上下文窗口（beta）——首个具备此容量的 Opus 级模型。最大输出 128K token。自适应推理（自动推理深度）。努力级别控制（low/medium/high/max）。上下文压缩 beta。Agent teams 研究预览（多代理并行协调）。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 支持，agent teams 研究预览（需 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1），自动记忆记录/调用，消息选择器中”从此处总结”用于部分对话总结，--add-dir 目录中的 skills 自动加载，skill 字符预算随上下文窗口扩展（上下文的 2%）。修复：子目录中 @ 文件补全的错误相对路径、--resume 现复用上次会话的 --agent 值、heredoc 中 JavaScript 模板字面量导致的 bash “Bad substitution”错误、泰语/老挝语间距元音渲染。VSCode：斜杠命令执行修复、过往对话列表加载动画。 | 87 | | 2026-02-04 | GitHub 集成：Claude 和 Codex 现以公开预览形式登陆 GitHub——作为 Copilot Pro+ 和 Enterprise 客户的编码代理通过 Agent HQ 提供。Opus 4.6 面向 GitHub Copilot 正式可用。90 | 90 | | 2026-02-04 | 新增：v2.1.31——退出时显示会话恢复提示（展示如何继续），日语 IME 全角（全角）空格输入用于复选框选择。修复：PDF 错误永久锁定会话、沙箱模式下 bash “read-only file system”错误、缺少 ~/.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 页）通过 @ 提及时返回轻量引用，为无 DCR 的 MCP 服务器（如 Slack）预配置 OAuth 客户端凭证，/debug 命令用于故障排除，只读模式下额外的 git log/git show 标志，Task 工具结果中的 token 计数/工具使用次数/耗时指标，reducedMotion 配置选项。--resume 内存减少 68%（基于 stat 的会话加载）。修复：API 历史中的虚假”(no content)”文本块（减少 token 浪费）、工具变更的提示缓存失效、带思考块 /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 token 过期导致 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）模式下的 structured outputs。 | 75 | | 2026-01-28 | 新增：v2.1.21——VSCode 中 Python venv 自动激活（claudeCode.usePythonEnvironment 设置），日语 IME 全角数字输入支持，Read/搜索进度指示器（”Reading…”→”Read”），Claude 现优先使用文件操作工具而非 bash 等效工具。修复：退出时 shell 补全缓存截断、恢复工具执行期间中断的会话时 API 错误、大输出限制模型上自动压缩过早触发、删除后任务 ID 复用、Windows VSCode 中的文件搜索。 | 74 | | 2026-01-28 | 新增：MCP Apps（Claude 内用于 Asana、Figma、Slack 等的交互式工具 UI）。Code Execution Tool v2（Bash 执行替代 Python 独占、程序化工具调用）。Claude Code on the web 扩展至 Team/Enterprise 高级席位。 | 737879 | | 2026-01-27 | 新增：v2.1.20——--add-dir 标志用于从额外目录加载 CLAUDE.md（需 CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1），提示页脚中 PR 审查状态指示器（彩色圆点显示 approved/changes requested/pending/draft），通过 TaskUpdate 工具删除任务，vim 箭头键历史导航，/copy 命令向所有用户开放，带时间戳的配置备份（轮换，保留最近 5 份）。修复：恢复时会话压缩加载完整历史、代理工作时忽略用户消息、宽字符（emoji/CJK）渲染伪影、MCP 响应中含 Unicode 的 JSON 解析。 | 72 | | 2026-01-26 | 增强：Analytics API 章节，含详细端点文档、指标表、curl 示例和限制说明。现包括认证要求、可用指标（生产力、工具使用、成本）和实时监控替代方案。 | 53 | | 2026-01-24 | 新增：v2.1.19——自定义命令参数简写 $0、$1（从 $ARGUMENTS.0 变更为 $ARGUMENTS[0] 方括号语法），CLAUDE_CODE_ENABLE_TASKS 环境变量用于禁用新任务系统，无需额外权限/hooks 的 skills 不再要求审批。VSCode：会话分叉和回退向所有用户开放。SDK：queued_command 重放为 SDKUserMessageReplay 事件。修复：终端关闭时悬挂进程、git worktrees 中 /rename//tag、提示暂存（Ctrl+S）时粘贴文本丢失、代理模型显示、后台 hook 命令未提前返回、文件写入预览遗漏空行。 | 71 | | 2026-01-24 | 新增：v2.1.17——修复不支持 AVX 指令集处理器上的崩溃。 | 71 | | 2026-01-24 | 重大变更：扩展推理现默认启用，token 上限 31,999。自然语言触发器（think、think hard、ultrathink）已弃用，不再分配推理 token——请改用 MAX_THINKING_TOKENS 环境变量或 /config。已更新扩展推理章节反映当前行为。 | 70 | | 2026-01-24 | 新增：v2.1.18——可自定义键盘快捷键，支持上下文相关键绑定、组合键序列，通过 /keybindings 命令完全个性化。配置存储在 ~/.claude/keybindings.json。 | 77 | | 2026-01-24 | 新增：v2.1.16——带依赖追踪的任务管理系统，VSCode 原生插件管理支持，OAuth 用户可从会话对话框浏览/恢复远程会话。修复：子代理恢复时内存溢出崩溃、/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 token 计数显示，斜杠命令自动补全选择错误。 | 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 token 定价表。 | 56575859 | | 2026-01-17 | 新增：v2.1.11 版本——修复 HTTP/SSE 传输的过多 MCP 连接请求（重度 MCP 用户的稳定性改善）。 | 55 | | 2026-01-16 | 新增：MCP 工具搜索章节，含基准数据（Opus 4：49%→74%，Opus 4.5：79.5%→88.1%，token 开销减少 85%）。更新 MCP 生态统计（每月 1 亿次下载，3,000 多个服务器）。 | 54 | | 2026-01-16 | 新增：Claude Code Analytics API 章节——通过 Admin API 端点 /v1/organizations/usage_report/claude_code 以编程方式访问 Team/Enterprise 使用指标（会话、提交、PR、代码行数）。记录 ${CLAUDE_SESSION_ID} skill 替换（v2.1.9）。 | 5153 | | 2026-01-15 | 新增：v2.1.9 MCP 工具搜索阈值 auto:N 语法，plansDirectory 设置，AskUserQuestion 中的外部编辑器（Ctrl+G），web 会话提交/PR 的会话 URL 归属，PreToolUse hooks additionalContext。修复并行工具调用 API 错误、MCP 重连挂起、Kitty 中 Ctrl+Z。添加 Cowork（面向非技术用户的 GUI 版本）。 | 5152 | | 2026-01-15 | 新增：v2.1.7 接受权限提示时的权限反馈功能。GitHub Action v1.0 正式发布。小幅文档刷新。 | 48 | | 2026-01-14 | 新增：v2.1.7 MCP 工具搜索自动模式默认启用（延迟超过 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 skill frontmatter 选项用于隔离上下文。添加子代理权限拒绝弹性（v2.1.0+）。添加插件市场发布信息（2025 年 12 月 36 个精选插件）。 | 47 | | 2026-01-12 | 新增：v2.1.4 CLAUDE_CODE_DISABLE_BACKGROUND_TASKS 环境变量用于禁用所有后台任务功能，包括自动后台化和 Ctrl+B 快捷键。修复 OAuth token 刷新用于”Help improve Claude”设置。 | 46 | | 2026-01-10 | 新增：沙箱将权限提示减少 84%（来自 Anthropic 工程博客），Opus 4.5 SWE-bench 性能（80.9%）和 token 效率改善。小幅文档刷新。 | 45 | | 2026-01-10 | 新增：v2.1.3 合并斜杠命令和 skills（统一心智模型），/config 中发布渠道切换（stable/latest），/doctor 检测不可达权限规则，hook 执行超时从 60 秒增至 10 分钟。缺陷修复：/clear 后计划文件持久化、ExFAT 上 skill 重复检测、后台任务计数不匹配、子代理压缩时使用错误模型。VSCode：权限的可点击目标选择器。 | 44 | | 2026-01-09 | 新增：v2.1.1（109 项 CLI 改进），组件范围 Hooks（skill/command frontmatter 中的 hooks 含 once 选项），新 MCP 服务器（Figma Dev Mode、Sequential Thinking、Magic UI、Context7）。更新 MCP 生态计数至 3,000 多个服务器。 | 414243 | | 2026-01-08 | 新增：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 updatedInput 含 ask 权限。 | 39 | | 2026-01-07 | 新增：v2.1.0 自动 skill 热重载（~/.claude/skills 或 .claude/skills 中的 skills 无需重启即时可用）。安全：CVE-2025-52882 WebSocket 认证绕过已在 IDE 扩展 v1.0.24+ 中修补。 | 3738 | | 2026-01-06 | 新增：v2.0.74 可点击图片链接（[Image #N]），/context 分组显示，git 仓库中文件 @ 提及速度提升 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 粘贴弹出，Alt+T 推理切换，Ctrl+T 语法高亮切换，节日促销（12 月 25-31 日限额翻倍） | 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 定价。”Claude API 定价。”2025年12月。 ↩↩↩↩↩↩↩↩

  2. Claude Code 子代理。”子代理文档。”2025年12月。 ↩

  3. MCPcat。”MCP 服务器下载量增长统计。”2025年12月。 ↩

  4. Claude Code 文档。”Claude Code 文档。”2025年12月从 docs.anthropic.com 重定向；2026年2月更新规范 URL。 ↩

  5. Claude Code 文档。”CLI 参考。”2025年12月从 docs.anthropic.com 重定向；2026年2月更新规范 URL。 ↩

  6. Claude Code 文档。”设置文档。”2025年12月从 docs.anthropic.com 重定向；2026年2月更新规范 URL。 ↩

  7. Claude Code 文档。”Hooks 指南。”2025年12月从 docs.anthropic.com 重定向；2026年2月更新规范 URL。 ↩

  8. Claude Code 文档。”MCP 文档。”2025年12月从 docs.anthropic.com 重定向；2026年2月更新规范 URL。 ↩

  9. Anthropic。”Claude Code 最佳实践。”2025年4月。注：原始 URL 现已重定向至 code.claude.com/docs（内容已合并至主文档）。另见 Claude Code 文档。 ↩

  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 文档。”交互式 MCP 设置。”2025年12月从 docs.anthropic.com 重定向；2026年2月更新规范 URL。 ↩↩

  16. Northflank。”Claude Code 隐藏工具费用。”2025年7月。 ↩↩

  17. Anthropic。”后台代理。”2025年12月。 ↩↩

  18. Claude Code 文档。”Memory 规则目录。”2025年12月。 ↩↩

  19. GitHub。”输出样式发布。”2025年12月。 ↩↩

  20. GitHub CHANGELOG。”Pro 用户现可在其订阅中使用 Opus 4.5。”2025年12月。 ↩↩↩

  21. Northflank。”2025年8月速率限制变更。”2025年7月。 ↩↩

  22. Claude 博客。”Claude Code 网页版和 iOS 应用。”2025年11月。 ↩↩

  23. Claude 博客。”面向 Team 和 Enterprise 用户的 Claude Code 网页版。”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 环境变量、iTerm2/WezTerm/Ghostty/Kitty 中 Shift+Enter 开箱即用。”2026年1月。 ↩↩↩

  38. Datadog Security Labs。”CVE-2025-52882：Claude Code IDE 扩展中 WebSocket 身份验证绕过漏洞，已在 v1.0.24+ 修复。”2026年1月。 ↩↩

  39. GitHub Releases。”v2.1.2：可点击文件路径（OSC 8）、winget 支持、计划模式下 Shift+Tab 自动接受、FORCE_AUTOUPDATE_PLUGINS、SessionStart hook 中的 agent_type、安全修复（命令注入、内存泄漏）、思考切换改为 Alt+T、MCP 通配符权限、PreToolUse updatedInput 含 ask。”2026年1月。 ↩↩↩

  40. Anthropic 定价。”每个组织每月可免费使用1,550小时的代码执行工具。”2026年1月。 ↩↩

  41. VentureBeat。”Claude Code 2.1.0 引入基础设施级功能。面向代理的 Hooks、skills 和斜杠命令，支持作用域化的 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：合并斜杠命令和 skills、/config 中的发布渠道切换、/doctor 不可达权限检测、hook 超时增加至10分钟。”2026年1月。 ↩

  45. Anthropic。”沙箱安全地减少了84%的权限提示。”2026年1月。Anthropic。”Claude Opus 4.5 在 SWE-bench Verified 上达到80.9%，同时将令牌用量减少一半。” ↩↩

  46. GitHub Releases。”v2.1.4：新增 CLAUDE_CODE_DISABLE_BACKGROUND_TASKS 环境变量，修复’帮助改进 Claude’设置的 OAuth 令牌刷新问题。”2026年1月。 ↩

  47. VentureBeat。”Claude Code 2.1.0：通过 skill frontmatter 中的 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 日期范围过滤、嵌套 skills 发现、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 文档。”通过 Claude Code Analytics Admin API 以编程方式访问组织的 Claude Code 使用分析和生产力指标。”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次提交、新增40k行代码、删除38k行。”2026年1月。 ↩↩

  57. Anthropic 定价。”API 令牌定价：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 使用政策。多账户政策。Anthropic 支持。”同一手机号最多可验证三个账户。同一网络支持多个付费订阅。”2026年1月。 ↩↩

  60. GitHub Releases。”v2.1.10：新增 Setup hook 事件，通过 –init、–init-only 或 –maintenance CLI 标志触发；登录时按’c’复制 OAuth URL；改进启动按键捕获；文件建议作为可移除附件；VSCode 插件安装数量和信任警告。”2026年1月17日。 ↩↩

  61. @adocomplete。”Claude 降临节第15天：–dangerously-skip-permissions 标志（YOLO 模式）实现完全自主运行。”2026年1月。 ↩

  62. @adocomplete。”Claude Max 订阅用户可获得3张访客通行证，通过 /passes 命令与他人分享 Claude Code Pro 试用。”2026年1月。 ↩

  63. @mattpocockuk。”Docker 沙箱模式用于安全探索不受信任的代码库。”2026年1月。 ↩

  64. Daisy Hollman。”过夜 hooks 策略：使用代码检查和测试 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 令牌计数、斜杠命令自动补全。”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个令牌。’think’、’think hard’、’ultrathink’等关键词不再分配思考令牌——请改用 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 文档。”v2.1.20：–add-dir 标志用于从额外目录加载 CLAUDE.md、PR 审查状态指示器、通过 TaskUpdate 删除任务、vim 方向键历史导航、/copy 命令对所有用户开放、带时间戳的配置备份。修复：会话压缩问题、代理忽略用户消息、宽字符渲染、JSON Unicode 解析。”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/search 进度指示器、Claude 优先使用文件工具而非 bash。修复：shell 补全缓存、会话恢复 API 错误、自动压缩时机、任务 ID 复用、Windows 文件搜索。”2026年1月27日。 ↩

  75. GitHub Releases。”v2.1.22：修复非交互式（-p）模式的结构化输出。”2026年1月27日。 ↩

  76. GitHub Releases。”v2.1.23：spinnerVerbs 设置、mTLS/代理连接修复、按用户隔离临时目录、ripgrep 超时报告、已合并 PR 紫色指示器、bash 超时显示。修复：提示缓存竞态条件、无头模式下的异步 hooks、tab 补全、Bedrock 区域字符串。”2026年1月28日。 ↩

  77. Claude Code 文档。”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。”代码执行工具 v2 公测版：在代码执行中支持 Bash 命令执行、文件操作和编程式工具调用。”2026年1月。 ↩↩

  80. GitHub Releases。”v2.1.25：修复 Bedrock 和 Vertex 网关用户的 beta header 验证错误。临时方案：CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1。”2026年1月29日。 ↩

  81. GitHub Releases。”v2.1.27：–from-pr 标志用于 PR 关联会话、通过 gh pr create 自动关联会话到 PR、调试日志中的工具调用失败信息、VSCode Claude in Chrome 集成。修复：上下文管理验证、/context 彩色输出、状态栏重复、权限优先级、Windows bash/.bashrc、Windows 控制台闪烁、VSCode OAuth 401 错误。”2026年1月30日。 ↩↩

  82. GitHub Releases。”v2.1.31：会话恢复提示、日语 IME 全角空格输入、PDF 过大错误永久锁定会话修复、沙箱中 bash 只读文件系统错误修复、temperatureOverride 静默忽略修复、LSP 关闭兼容性、改进系统提示优先使用专用工具而非 bash。”2026年2月。 ↩

  83. GitHub Releases。”v2.1.30：Read 工具的 PDF pages 参数、大型 PDF 返回轻量引用、为 MCP（Slack）预配置 OAuth、/debug 命令、–resume 内存减少68%、虚假’(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日。100万令牌上下文（beta）、128K 最大输出、自适应思考、工作量控制、代理团队、Terminal-Bench 2.0 最高分、GDPval-AA 比 GPT-5.2 高 +144 Elo、发现500+零日漏洞。$5/$25 每百万令牌。另见 TechCrunch、CNBC、Anthropic 定价。 ↩↩↩↩↩↩↩↩↩

  87. GitHub Releases。”v2.1.32：Opus 4.6 支持、代理团队研究预览、自动记忆录制、从此处开始摘要、–add-dir 中的 skills 自动加载、skill 字符预算随上下文窗口缩放、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 博客。”Claude 和 Codex 现已在 GitHub 公开预览中可用。”2026年2月4日。另见：GitHub 博客。”Claude Opus 4.6 现已在 GitHub Copilot 中正式可用。”2026年2月5日。 ↩↩

  91. Claude Code 文档。”编排 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 frontmatter、插件名称显示在 skill 描述中。修复：tmux 代理队友会话、代理团队计划警告、扩展思考中断、API 代理 404 回退、WebFetch 代理设置、/resume XML 标记。VSCode：OAuth 远程会话、会话选择器中的 git 分支。”2026年2月。 ↩↩

  93. GitHub Releases。”v2.1.36：Opus 4.6 现已支持快速模式。”2026年2月7日。Simon Willison。”Claude：使用快速模式加速响应。”快速模式定价：标准费率的6倍（Opus 4.6 ≤200K 输入 $30/$150 每百万令牌；>200K 输入 $60/$225）。上线促销（五折优惠）截至2026年2月16日。v2.1.37：修复启用 /extra-usage 后 /fast 未立即生效的问题。Anthropic 定价。 ↩↩↩↩

  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 文档。”Hooks 参考：基于提示的 hooks、基于代理的 hooks、hook 环境变量（$CLAUDE_PROJECT_DIR、$CLAUDE_ENV_FILE）、PreToolUse 的 hookSpecificOutput 格式。”2026年2月。Claude Code 文档。”创建自定义子代理：–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令牌输入上下文。Opus 4.6 在 beta 中扩展至100万令牌。 ↩

  99. Claude Code 文档。”Claude Code 入门指南。”系统要求：macOS 10.15+、Ubuntu 20.04+/Debian 10+、Windows 10+（WSL 或 Git Bash）、最低4 GB 内存、活跃的互联网连接。 ↩

  100. Anthropic。”Claude Sonnet 4.6。”2026年2月17日。Claude Developer Platform 发布说明。”Sonnet 4.6：改进的代理搜索、更少的令牌消耗、扩展思考、100万上下文（beta）。claude.ai 默认模型。Sonnet 4.5 移至旧版。”模型 ID：claude-sonnet-4-6。Anthropic 模型概览。”64K 最大输出，知识截止：可靠至2025年8月/训练至2026年1月。” ↩↩↩↩

  101. Claude Code GitHub Releases。v2.1.43：AWS 认证刷新3分钟超时修复、虚假 .claude/agents/ markdown 警告修复、Vertex/Bedrock 结构化输出 beta header 修复。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个会话、启动速度提升约500ms、内存改进、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 快速模式完整100万上下文、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 文档。”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 文档。”团队配置：~/.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 令牌刷新竞态条件修复。并发写入时配置文件损坏修复。”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 统计。”4%的公开 GitHub 提交（约每天135,000次）由 Claude Code 编写。13个月内增长42,896倍。Anthropic 自身90%的代码由 AI 编写（Dario Amodei，2026年2月）。”2026年2月5日。 ↩↩

  111. GitHub Releases。”v2.1.63（2月28日）：/simplify 和 /batch 内置斜杠命令、工作树共享项目配置和自动记忆、ENABLE_CLAUDEAI_MCP_SERVERS=false 退出选项、HTTP hooks type: http 处理器、/copy ‘始终复制完整响应’选项、VSCode 会话重命名/移除、/clear 重置 skill 缓存、多项内存泄漏修复、REPL 桥接竞态条件修复。”2026年2月28日。 ↩↩↩↩↩↩↩

  112. GitHub 博客。”Claude 和 Codex 现已面向 Copilot Business 和 Pro 用户开放。”2026年2月26日。将 Claude 的可用范围从 Copilot Pro+ 和 Enterprise 扩展至所有付费 Copilot 层级。 ↩↩

  113. Claude Code 文档。”在 v2.1.63 版本中，Task 工具已重命名为 Agent。设置和代理定义中现有的 Task(...) 引用仍作为别名生效。”2026年2月28日。 ↩↩

  114. GitHub Releases。”v2.1.51：托管设置——支持 macOS plist 和 Windows 注册表的企业部署。”2026年2月24日。 ↩↩

  115. CNBC。”Figma 与 Anthropic 合作推出集成 Claude Code 的 AI 功能。”2026年2月17日。 ↩↩

  116. GitHub Releases。”v2.1.68：Opus 4.6 对 Max/Team 默认使用中等工作量，重新引入 ultrathink 用于高工作量，移除 Opus 4/4.1。v2.1.70：修复使用 ANTHROPIC_BASE_URL 时的 API 400 错误、工作量参数错误、ToolSearch 后空响应、改进压缩时图片保留、VS Code spark 图标和 MCP 管理。”2026年3月。 ↩↩↩↩↩↩↩↩↩

  117. GitHub Releases。”v2.1.69：/claude-api skill、InstructionsLoaded hook 事件、hook 事件中的 agent_id/agent_type/worktree、${CLAUDE_SKILL_DIR}、/reload-plugins、sandbox.enableWeakerNetworkIsolation、includeGitInstructions 设置、remote-control 自定义名称、Voice STT 新增10种语言（共20种）、工作量级别显示、Ctrl+U 退出 bash、数字键盘支持、Sonnet 4.5→4.6 自动迁移。70+项错误修复。”2026年3月5日。 ↩↩↩↩↩↩↩

  118. TechCrunch。”Claude Code 推出语音模式功能。/voice 激活按键说话模式。逐步推出（初始约5%）。”2026年3月3日。9to5Mac。”Anthropic 逐步为 Claude Code 添加语音模式。” ↩↩↩↩↩

  119. GitHub Releases。”v2.1.71：/loop 命令用于循环提示、语音按键绑定自定义、bash 自动批准允许列表扩展、stdin 冻结修复、CoreAudio 启动优化。”2026年3月7日。Threads/@boris_cherny。”Claude Code 2.1.0 已发布：/loop、shift+enter 换行、agent/skill frontmatter 中的 hooks。” ↩↩↩

  120. Anthropic 博客。”Claude Code 代码审查：多代理 PR 审查系统。调度并行代理、交叉验证发现、按严重性排序。每次审查 $15-25，约20分钟。54%的 PR 收到实质性评论（此前为16%），错误率不到1%。面向 Team/Enterprise 的研究预览。”2026年3月9日。TechCrunch。”Anthropic 推出代码审查工具。” ↩↩↩↩↩

  121. GitHub Releases。”v2.1.72：使用 ANTHROPIC_BASE_URL 的工具搜索、/copy 中按 w 键写入文件、/plan 描述参数、ExitWorktree 工具、CLAUDE_CODE_DISABLE_CRON、扩展 bash 允许列表（lsof/pgrep/tput/ss/fd/fdfind）、Agent 工具恢复 model 参数、简化工作量符号（○/◐/●）、/config 导航改进、包体积 −510KB、VSCode URI 处理器。”2026年3月10日。 ↩↩↩↩↩

  122. GitHub Releases。”v2.1.73：modelOverrides 设置用于自定义提供商模型 ID（Bedrock/Vertex/Foundry）。弃用 /output-style（改用 /config）。Bedrock/Vertex/Foundry 上默认 Opus 改为4.6。中断后按上箭头恢复提示并回退。响应中 /effort 可用。SSL 证书错误指引。修复：CPU 冻结、死锁、SessionStart hooks 触发两次。”2026年3月11日。 ↩↩↩

  123. GitHub Releases。”v2.1.74：/context 可操作建议。autoMemoryDirectory 设置。--plugin-dir 覆盖行为变更。CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS 可配置超时。托管策略强制修复（ask 规则被用户 allow 绕过）。内存泄漏修复（流缓冲区）。RTL 文本渲染修复。MCP OAuth 修复。”2026年3月12日。 ↩↩

  124. GitHub Releases。”v2.1.75：Max/Team/Enterprise 默认为 Opus 4.6 启用100万上下文窗口。/color 命令对所有用户开放。提示栏显示会话名称。内存文件最后修改时间戳。权限提示中显示 hook 来源。语音模式激活修复。bash 管道命令中 ! 修复。令牌估算过度计数修复。macOS 启动性能改进。破坏性变更：移除已弃用的 Windows 托管设置回退。”2026年3月13日。 ↩↩↩↩↩↩

  125. GitHub Releases。”v2.1.76：MCP elicitation 支持——MCP 服务器可在任务执行中通过交互式对话框（表单字段或浏览器 URL）请求结构化输入。新增 Elicitation 和 ElicitationResult hooks。-n/--name CLI 标志用于会话显示名称。worktree.sparsePaths 用于 monorepo 中的 git sparse-checkout。PostCompact hook。/effort 斜杠命令。会话质量调查（feedbackSurveyRate）。修复：压缩后延迟工具丢失输入模式、计划模式重新审批、语音模式按键、自动压缩断路器（最多3次尝试）、tmux 通过 SSH 的剪贴板复制、Remote Control 会话稳定性。”2026年3月14日。 ↩↩↩↩↩↩↩

  126. GitHub CHANGELOG。”v2.1.77：Opus 4.6 默认最大输出令牌增至64K，Opus 4.6 和 Sonnet 4.6 上限增至128K。allowRead 沙箱文件系统设置。/copy N 复制第 N 条最新响应。/fork 重命名为 /branch。Agent 工具移除 resume 参数（改用 SendMessage）。SendMessage 自动恢复已停止的代理。会话根据计划自动命名。后台 bash 任务达到5GB 时终止。claude plugin validate 检查 frontmatter 和 hooks。macOS 启动加速约60ms，--resume 速度提升45%并减少约100-150MB 内存。安全：PreToolUse allow 不再绕过 deny 规则。25+项错误修复。”2026年3月17日。 ↩↩↩↩↩↩

  127. GitHub Releases v2.1.78。”v2.1.78：StopFailure hook 事件、${CLAUDE_PLUGIN_DATA} 持久化插件状态、代理 frontmatter（effort/maxTurns/disallowedTools）、ANTHROPIC_CUSTOM_MODEL_OPTION、tmux 通知透传、逐行响应流式传输。安全：缺少沙箱依赖时显示可见警告。修复：>5MB 大会话截断、无限 stop hook 循环、沙箱绝对路径、WSL2 语音、VS Code 中 Homebrew PATH。”2026年3月17日。 ↩↩↩

  128. GitHub Releases v2.1.79。”v2.1.79：--console 标志用于 API 计费认证、/remote-control VS Code 命令、VS Code 中 AI 生成的会话标题、CLAUDE_CODE_PLUGIN_SEED_DIR 多目录支持、启动内存减少约18MB、非流式 API 2分钟超时、/resume 切换时触发 SessionEnd hooks。修复：作为子进程时 -p 挂起、print 模式下 Ctrl+C、/btw 错误输出、语音模式启动、企业 429 重试。”2026年3月18日。 ↩↩

$ echo "Maintained by Blake Crosley"
Maintained by Blake Crosley | Last updated 2026-03-21
NORMAL claude-code.md EOF
实验室

开发中

ResumeGeni

resumegeni.com

AI驱动的简历优化

开发中

Return

941return.com

健康追踪与洞察

开发中

Banana List

941getbananas.com

智能购物清单

开发中

H3arted

h3arted.com

社交连接平台

开发中