v1.2 更新日志

Claude Code 课程 v1.2 更新内容（同步 Claude Code v2.1.85 → v2.1.126，跨 42 个版本）

7 分钟

一、概述

本次更新同步 Claude Code v2.1.85 → v2.1.126（42 个版本，2026-03-26 ~ 2026-05-01），覆盖 Opus 4.7 发布以来的所有重大变更。

维度v1.1v1.2变化
知识点总数147~160+13
模块总数1617+1（自动化与编排）
术语表115133+18
影响文件数~130~140MDX ~130 + 配置 ~10

二、Claude Opus 4.7 + xhigh effort 体系

Opus 4.7 上线（v2.1.111）

新一代旗舰模型 Opus 4.7 取代 Opus 4.6 成为默认模型。原生 1M context window（v2.1.117）。总是 adaptive reasoning——CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING 不再适用。

xhigh effort 等级

新增 xhigh effort 选项，仅 Opus 4.7 支持。Opus 4.7 默认 effort = xhigh。${CLAUDE_EFFORT} 字符串替换变量可在 Skill 中引用。

模型矩阵更新

端点OpusSonnet
Anthropic API4.74.6
Bedrock/Vertex/Foundry4.64.5

新 aliases：default（清除 override）、best（最强可用）。

默认 effort 提升

  • API-key / Bedrock / Vertex / Foundry / Team / Enterprise：medium → high（v2.1.94）
  • Pro / Max on Opus / Sonnet：medium → high（v2.1.117）

受影响知识点：模型配置、Effort 系统

三、自动化与编排体系

v1.2 新建第 17 主题模块「自动��与编排」，建立 Routines（云端）/ Desktop Scheduled Tasks（本机）/ /loop（会话内）三层架构。

Routines（云端编排）

web-scheduled-tasks 概念更名为 Routines。Anthropic 云端运行的 Claude Code 任务容器，三种触发器：Schedule / API / GitHub event。通过 /schedule（alias /routines）CLI 命令创建。

Ultraplan（云端 Plan Mode）

云端 plan mode + 浏览器协作。通过 /ultraplan 命令、关键词触发或 Plan Mode 选项触发。支持 teleport 回本地终端。v2.1.117 起自动创建 cloud environment。

Ultrareview（云端 Code Review）

云端 multi-agent deep code review。Pro/Max 3 次免费 + $5-20/run extra usage。/ultrareview 命令 + claude ultrareview 非交互 subcommand（支持 --json --timeout）。v2.1.113 加速（parallelized checks）。

Computer Use（CLI 内置 MCP）

CLI 内置 computer-use MCP server（macOS only，Pro/Max，v2.1.85+）。通过 /mcp 找到 computer-use 开关启用。安全机制：per-app approval、sentinel warnings、终端从 screenshot 排除、machine-wide lock。

/loop 体系增强

  • 三种模式：interval+prompt / dynamic（Claude 自选间隔）/ loop.md 默认 maintenance
  • loop.md 文件（项目级 .claude/loop.md / 用户级 ~/.claude/loop.md，25,000 byte 上限）
  • expiry 从 3 天延长至 7 天
  • Esc 取消 pending wakeup（v2.1.113）
  • Monitor tool（v2.1.98+）内置流式后台 watcher；CronCreate / CronList / CronDelete 工具家族

新增云端编排命令

/team-onboarding（v2.1.101）、/autofix-pr（v2.1.92+）、/extra-usage（购买额外用量）、/tasks（管理后台任务）

受影响知识点：新模块「自动化与编排」全部 5 篇、/loop 与 Cron

四、Hooks 体系扩展

4 个新 hook 事件

  • Setup — 仅 claude --init-only / -p --init / -p --maintenance 触发
  • UserPromptExpansion — 捕获 /skillname 直接输入路径
  • PostToolBatch — 一批并行 tool calls 全部 resolve 后触发一次
  • PermissionDenied — 仅 Auto mode classifier 拒绝时触发

新 handler 类型 mcp_tool（v2.1.118）

第 5 种 hook handler（v1.1 为 4 种）。调用已连接 MCP server 工具，通过 server / tool / input 三字段配置。

新 permission decision defer（v2.1.89）

PreToolUse 第 4 种决策（之前 allow / deny / ask）。仅 -p 非交互模式生效。返回 stop_reason: "tool_deferred" + deferred_tool_use。

additionalContext 系统化

把 hook 输出注入 Claude 上下文。分事件描述注入位置，10,000 字符上限。resume 时重放保存的文本。

5 个新通用字段

if（compound 支持 v2.1.108）、once（仅 Skill frontmatter 中生效）、statusMessage（自定义 spinner）、updatedToolOutput（v2.1.121 起对所有 tool 生效）、duration_ms（PostToolUse / PostToolUseFailure 输入字段）

其他增强

  • asyncRewake：command hook 后台运行 + exit code 2 时唤醒 Claude
  • HTTP hook：新增 headers + allowedEnvVars
  • PreCompact：可阻断自动 compaction（exit code 2 或 {"decision":"block"}）
  • 弃用：顶级 decision / reason 字段，"approve" / "block" 兼容映射到 "allow" / "deny"

受影响知识点：hooks 模块全部 12 篇

五、Plugin 体系深化

全新组件类型 +2

  • Monitors：monitors/monitors.json 数组，后台持续监控
  • Themes：themes/<name>.json，base 选项（light/dark preset）+ overrides（color token 稀疏 map）

Plugin 组件类型从 5 类扩到 7 类。

全新依赖管理

dependencies 字段（plugin.json）：semver range（~2.1.0 / ^2.0 / >=1.4 / =2.1.0）。marketplace 字段支持跨 marketplace 解析。4 种错误码：dependency-unsatisfied / range-conflict / dependency-version-unsatisfied / no-matching-tag。

3 个新 CLI 命令

  • plugin prune（v2.1.121+）：移除 orphan 自动安装依赖
  • plugin list：列出已安装 plugin 含 version / source marketplace / enable status
  • plugin tag（v2.1.118+）：在当前 plugin 目录创建 release git tag

其他增强

  • plugin uninstall 新增 --keep-data / --prune 选项
  • ${CLAUDE_PLUGIN_DATA} 持久数据目录
  • bin/ PATH（v2.1.91）：plugin 根 bin/ 目录加进 Bash tool PATH
  • 7 种 marketplace 源类型：github / git / url / npm / file / directory / hostPattern

受��响知识点：plugins 模块全部 5 篇

六、Auto Mode 完善体系

Auto mode 整体定义

Classifier-routed permission 模式。可用于 Max / Team / Enterprise / API（Pro 不可用，Bedrock/Vertex/Foundry 不可用）。

autoMode 三字段

  • environment：自然语言描述 trusted 基础设施（最重要）
  • allow：自然语言描述例外
  • soft_deny：自然语言描述阻挡

"$defaults" 字符串 splice in，省略时整个默认列表被替换（v2.1.118 起）。

三个 CLI subcommands

  • claude auto-mode defaults → 查看内置 rules
  • claude auto-mode config → 查看 effective rules
  • claude auto-mode critique → AI 批评自定义 rules

其他

  • --enable-auto-mode flag 移除（v2.1.111），直接用 --permission-mode auto
  • PermissionDenied hook（v2.1.89）：仅 auto mode classifier 拒绝时触发
  • /permissions 新增 Recently denied + r retry 标记

受影响知识点：security 模块新建 Auto mode

七、Remote Control + Mobile + 跨平台增强

Mobile push notifications

Remote Control 激活时 Claude 可向手机推送通知。设置：安装 Claude mobile app → 同 account 登录 → 允许通知 → /config 启用 "Push when Claude decides"。故障排查：iOS Focus mode 抑制、Android battery optimization 延迟。

Remote Control 命令矩阵

命令类型示例
仅本地/mcp、/plugin、/resume
Mobile/web 可用/compact、/clear、/context、/usage、/exit、/recap

Ultraplan disconnects Remote Control

两者同时占用 claude.ai/code 接口，存在互斥限制。

Routines 替代 Cloud Scheduled Tasks

"Cloud scheduled tasks" 全面更名为 "Routines"。

--bare 模式

跳过 hooks/skills/plugins/MCP/auto-memory/CLAUDE.md 的 auto-discovery。仅 Bash/file-read/file-edit 工具生效。

受影响知识点：cross-platform 模块全部 9 篇

八、Memory + CLAUDE.md 演进 + 命令系统重构

CLAUDE.md 推荐长度

v1.1 ~500 行 → v1.2 推荐 200 行。

When to add to CLAUDE.md 新章节

4 个触发场景。多步 procedure / 部分代码相关信息应做成 Skill 或 path-scoped Rule。

claude project purge 子命令

删除项目所有本地 state。Flags：--dry-run / -y/--yes / -i/--interactive / --all。

命令系统重构：47 → 75

净增 28 条命令。首次明确区分内置命令（CLI 写死）和 Bundled Skills（6 条，Skill 机制传 prompt 给 Claude）。

/cost + /stats 合并为 /usage（旧名保留）。新增 /recap、/heapdump、/debug、/focus、/tui、/powerup、/btw 等。

移除：/vim（改用 /config → Editor mode）、/tag、/pr-comments。

5 个新顶层子命令：claude install、claude project purge、claude setup-token、claude ultrareview、claude auto-mode。

受影响知识点：claude-md 模块 7 篇、commands 模块 7 篇、reference 模块 5 篇

九、按级别更新统计

级别含义数量
NEW全新知识点~13
RED大幅重写（50%+）~15
YELLOW显著更新~35
GREEN小幅修正~50
WHITE无需更新~30

十、弃用与移除

已移除

  • /vim 命令（v2.1.92）— 改用 /config → Editor mode
  • /tag 命令（v2.1.92）— 直接移除
  • /pr-comments [PR] 命令（v2.1.91）— 直接向 Claude 提问来查看 PR 评论
  • --enable-auto-mode flag（v2.1.111）— 改用 --permission-mode auto
  • web-scheduled-tasks.md 文档 — 被 routines.md 替代
  • "Cloud scheduled tasks" 概念名 — 更名为 Routines

已弃用（仍兼容但建议迁移）

  • /cost 与 /stats → 合并为 /usage
  • voiceEnabled: true → voice.enabled: true 对象
  • cleanupPeriodDays = 0 → CLAUDE_CODE_SKIP_PROMPT_HISTORY 或 --no-session-persistence
  • npm 安装方式 → Native binary（curl install + apt/dnf/apk + Homebrew + WinGet）
  • hooks 顶级 decision / reason → hookSpecificOutput.permissionDecision / permissionDecisionReason
  • hooks "approve" / "block" → "allow" / "deny"
  • includeCoAuthoredBy → attribution
  • 「Claude Code SDK」 → 「Claude Agent SDK」（产品改名）
更新日志1/2