Claude Code HOT

Claude Code 是什么？

Claude Code是Anthropic推出的命令行AI编程工具，让开发者直接在终端中使用Claude进行代码编写、调试、重构和项目管理。它能理解整个代码库的上下文，是目前最强大的终端AI编程助手。

与传统的AI编程插件不同，Claude Code直接运行在终端中，拥有完整的文件系统访问权限，可以自主完成从代码编写到Git提交的全流程操作。

核心功能

• 终端AI编程：在命令行中直接与Claude对话编程，无需离开开发环境
• 代码库全局理解：能理解整个项目的文件结构、依赖关系和代码逻辑
• Git操作集成：自动创建分支、提交代码、创建PR
• 文件读写管理：自主创建、修改、删除项目文件
• 多文件编辑：一次性修改多个文件，保持代码一致性
• 错误自动修复：遇到编译或运行错误时自动诊断和修复

版本对比

使用技巧

• 善用上下文：在项目根目录启动Claude Code，它会自动理解整个项目。
• 分步指令：复杂任务拆分成多步，每步确认后再继续。
• Git集成：让Claude Code自动创建分支和提交，避免手动操作。
• 代码审查：完成编码后让Claude Code审查自己的代码。
• /compact 命令：上下文过长时使用压缩命令保持效率。

适合人群

Claude Code适合熟悉终端的全栈开发者和专业程序员。如果你日常在命令行中工作，Claude Code是最强大的AI编程伙伴。

深度评测

Claude Code 最大的优势在于它不是一个简单的代码补全工具，而是一个真正的"AI程序员"。它可以自主理解项目结构、读取多个文件、编写代码、运行测试、甚至创建 Git commit。

在实际使用中，Claude Code 的代码质量非常高。它生成的代码通常比 GitHub Copilot 更完整、更少 bug，因为它能在写代码之前先理解整个项目的上下文。

与其他工具的对比

Claude Code vs GitHub Copilot：

• Copilot 是代码补全插件，Claude Code 是独立终端工具
• Copilot 只看当前文件，Claude Code 理解整个项目
• Claude Code 可以自主执行 Git 操作和文件管理

Claude Code vs Cursor：

• Cursor 是完整 IDE，Claude Code 是轻量级终端工具
• Cursor 适合前端和全栈开发，Claude Code 更适合后端和系统编程
• Claude Code 的推理能力更强，适合复杂架构设计

实际使用场景

• 新项目搭建：告诉 Claude Code 你的需求，它能从零搭建完整的项目结构
• Bug 修复：把报错信息贴给它，它会自动定位问题并修复
• 代码重构：选中一段代码让它优化，它会保持功能不变的情况下提升代码质量
• 学习新框架：问它怎么用某个框架，它会直接在你的项目中写好示例代码
• 代码审查：让它 review 你的 PR，给出改进建议

注意事项

• Claude Code 需要联网访问 Anthropic 的 API
• 大量使用会产生较高的 API 费用（Max 计划 $100/月）
• 对网络质量有要求，国内用户需要稳定的代理连接
• 建议在重要项目上先在小分支上测试 Claude Code 的修改

版本记录

以下按时间倒序收录历次版本更新的完整说明（页面顶部简介只保留最新一版要点）。

最新版 v2.1.318（2026-11-04 发布；GitHub 标记 Latest，npm latest 与 next 均为 2.1.318、stable 仍为 2.1.311）：新增——把你在会话里对「是否启用 Claude Code 写出的 mods」的回答记录下来；Claude apps 网关的 mantle upstream 新增 assume_role，可承担另一个 AWS 账号的角色并按开发者归因 AWS 成本；mod 的 $.model.fork 新增 effort 选项，让顺手派的小活固定用 low 而不跟会话档位，结果里回报实际发出的 effort；claude auth status 增加 loginExpiresAt、claude -p JSON 增加 credential_expires_at，并在存储的 claude.ai 登录到期前 10 天起给 claude -p 文本输出加一行 stderr 警告。修复——--continue 在畸形工具调用重试耗尽后偶发丢掉早先对话（2.1.314 起的回归）；macOS 会话里大量 Bash 命令并行时随内存增长卡住；权限提示被刚发完消息后键入的按键、或慢提示出现前键入的按键误答；共享网络主目录下配置文件写不进去时，/logout、claude auth logout、claude mcp remove 仍报成功且信任/同意/MCP 设置被静默丢弃；claude mcp add/remove 不再绕过配置锁写入；claude plugin 命令不再在慢速 token refresh 保存前退出；stdio MCP 服务器不再每次启动都重新做版本探测；headless 会话里紧跟模型切换发出的消息在 Stop 后仍继续跑；被删除的会话 transcript 在闲置非交互会话退出时被用最后一条提示重建；claude remote-control 主机、后台守护进程与自托管 runner 在更新或版本清理移走仍在运行进程的二进制后不再 spawn ENOENT。

前一版 v2.1.317（2026-11-03 发布；GitHub 标记 Latest，prerelease=false）：新增——/schedule 新建云端定时任务时若被塞入未申请的连接器，给出警告并说明怎么移除；web 或 shell 工具调用要把账号邮箱发到网络前先询问；Agent SDK hook 回调新增 onFailure: "block"，回调失败即拦下动作而不是放行；Claude Desktop 的 Code 标签在组织远程托管设置未加载/已加载时各给一次提示；OTel metrics/events/spans 新增 anthropic.plan、anthropic.seat_type、anthropic.provider、anthropic.custom_base_url；Claude apps 网关管理 API 新增成本报表 GET /v1/organizations/analytics/cost，可按日期区间读总花费、按开发者/按天/按 IdP 组拆分；带 admin: 的网关每天记录每位开发者的 IdP 组，保留 admin.identity_retention_days 天供成本报表分组；新增 CLAUDE_CODE_DISABLE_NESTED_SESSION_ID（自托管 runner 上设为 1 可让会话内的 claude -p 复用该会话 ID 与 transcript）。修复——auto mode 在 LLM 网关对服务端安全检查回 403/422 时不再每回合失败；effortLevel 不再被提前创建再打开的会话忽略；claude --from-pr 不再因目标会话早于第一页而报「No conversations found」；云/SDK 会话里生成标题时被新消息或 Stop 打断不再丢标题；磁盘满或配额耗尽导致 transcript/~/.claude.json 写入失败时 claude -p 不再退出 0；损坏的 ~/.claude.json 不再被非交互启动替换成默认值；PDF 自身元数据不再让 Read 与 @ 提及少算页数；Grep/Glob 命中时间上限时不再把部分结果当完整结果。

前一版 v2.1.316（2026-10-31 发布；GitHub 标记 Latest，npm latest 与 next 均为 2.1.316、stable 仍为 2.1.309；中间的 v2.1.315 只有 npm 包（2026-10-30T21:05Z），GitHub 的 tag 与 release 列表里都没有它，因此没有官方说明）：新增——CLAUDE_CODE_DISABLE_ULTRATHINK 可整体关掉 ultrathink 关键词；Claude apps 网关支持「组共享预算」——一个组成员共享的月度预算，叠加在各成员自身限额之上，通过 spend limits 管理 API 的 pooled_budget 设置；CLAUDE_CODE_DISABLE_LOOPED_CROSS_CERT_DROP 为需要自签 CA 的服务器保留互相认证的系统交叉证书；CLAUDE_CODE_SUBAGENT_EFFORT 指定子代理的推理力度，不再默认继承会话；网关 managed.policy_mode: layered 让所有匹配的开发者策略逐层合并生效，而不是只取第一条；Bedrock upstream 新增 guardrail.input_tagging，把提示包进 Amazon Bedrock 护栏提示攻击过滤器所需的输入标签（all_messages_and_system 同时标注系统提示）。变更——Opus 4.8 的快速模式自 2026-10-30 起弃用、2026-11-30 移除，之后 Opus 4.8 的快速模式请求会报错且不回退标准 Opus 4.8，官方建议迁到 Opus 5.5；Team 与 Enterprise 登录的服务端托管设置从 Anthropic API 取到后直接生效、不再弹审批，本地副本校验不过则拒用；auto mode 下不带 $defaults 的 autoMode.allow 不再移除定时任务提示的内置规则。修复——Claude Code 自行退出（凭据被拒、云会话归档）时 macOS/Linux 上的 shell 命令不再残留运行；Bash 工具里含换行的 bash 别名（Git Bash 除外）与以 - 开头的函数名不再被破坏；导出了 SHELLOPTS 时 Bash 工具启动的脚本不再只跑第一条命令就停；PowerShell hook 以类型转换、param、using 或特性开头时，退出码 2 也能拦下；压缩响应被截断或损坏时网络请求不再挂起；Vertex AI 与 Bedrock 上 sonnet/opus/haiku 在新模型对账号或区域不可用时改回退较旧模型，而不是会话中途报错；网关开始逐个校验请求点名的模型是否命中 availableModels/deniedModels/models，点名被禁模型返回 400 并指明字段；托管设置要求走网关时 claude auth login 不再拒绝运行，终端里改为显示网关登录；--restricted 会话在 Read 允许规则覆盖时不再上传工作目录外的文件；含不可见字符的提示不再需要按两次回车（纯文本提示首次回车即发送，命令仍会等你复核）；继承父级子代理模型的子代理被后台任务或消息唤醒后不再切到主模型；/model 遇到本版本不认识的模型会提示自动压缩将按 200K 上下文处理；Windows 下 Grep 与 Glob 在搜索进程超时未退出时不再永不返回；/clear 或 /resume 期间正在保存的会话恢复时不再丢计划；窄终端里首次运行的安全说明与终端设置说明不再丢字；自托管 runner 在会话进程被替换后，Stop 之后发出的消息不再被回答、MCP 服务器开关不再丢失；Windows 的 Git Bash 在 rc 文件设置 errexit 与 pipefail 且只定义 winpty 别名（或没有别名）时不再丢失别名与函数。[VS Code] 可在聊天面板直接登录 Claude apps 网关（无需终端）、ultrathink 改为以 xhigh 力度运行并在输入框显示彩虹色、修模型设置带 [1m] 标签（如 opus[1m]）时缺少 Effort 滑杆与 Ultracode 开关。改进——大仓库的 /diff 每次刷新通常少跑一条全仓 git 命令，并在 git 慢时拉开刷新间隔；SSL 证书错误会点名可能成因（如服务器漏发中间证书）与对应修法；/code-review 在 Claude Desktop 或 Web 的 Code 标签页启动时显示发现卡片而不是纯文本列表。

前一版 v2.1.314（2026-10-30 发布；GitHub 标记 Latest，npm latest 实测为 2.1.314、next 为 2.1.315，stable 仍为 2.1.308；中间没有 v2.1.313 正式版——GitHub release 列表与 npm 版本表里都没有该版本）：新增——permissions.blockWritesOutsideWorkingDirectories 让 Write、Edit 与 NotebookEdit 在所有权限模式下拒绝工作目录之外的路径；Claude apps 网关的 upstream 可配 groups 列表，只有列在其中的 IdP 组成员会被路由到该 upstream（故障转移时同样生效）；Bedrock upstream 新增 guardrail_trace，记录本次请求触发了哪条 Amazon Bedrock 护栏过滤器、不含匹配文本；VS Code 与 Claude Desktop 的 Code 标签页支持空闲压缩——200K+ token 的会话闲置后会被摘要，提示缓存过期时下一条消息直接使用该摘要。修复——组织管理员给模型设了推理上限后每轮报「Invalid effort level」，现在自动降档重试并说明所用档位；claude -p 启动失败却以 0 退出且无输出，现在打印错误并以 1 退出；Bedrock 多图会话每轮失败、/compact 报「400 Input is too long」，改为先移除较早图片再压缩；Microsoft Foundry 资源缺少默认 Sonnet/Opus/Haiku 部署时回退到同族较旧模型；网关不接受 tool search 的 tool_reference 块时请求被反复拒绝，现在去掉 tool search 重发一次并在本会话记住；系统证书库里的续期根证书带交叉签名时 TLS 连接报 UNABLE_TO_GET_ISSUER_CERT；免登录可用的 MCP 服务器在存储的登录失效后被误判「需要认证」，改为以未登录状态使用；claude mcp logout 在 macOS keychain 被锁（如 SSH 下）时谎报成功；CI 里带终端时 claude ultrareview 与 claude remote-control 仍弹工作区信任问题，设了 CI 就立即拒绝不受信任目录；PreCompact hook 输出过大导致压缩失败或反复，现在每个 hook 的输出截到 10,000 字符；后台 diff 刷新短暂占用仓库 index 锁，导致并发的 git 命令报 index.lock 已存在；流式输出时 markdown 表格在半行状态下于网格与堆叠布局间跳动、长表格退回原始竖线；/resume 选择器把 CLAUDE.md / CLAUDE.local.md 的正文当成会话标题；SSH 到 Linux 粘贴图片静默无反应；vim 模式 dw/dW/yw/yW 越过行尾、w/W 不停在空行。

前一版 v2.1.312（2026-10-27 发布；GitHub 标记 Latest，npm latest 与 next 实测均为 2.1.312，stable 仍为 2.1.308）：新增——Claude apps 网关新增 oidc.user_id_claim，可用 sub 之外的 id_token claim（如 Microsoft Entra ID 的 oid）识别用户；全屏模式下点击排队消息下方的「立即发送」提示即可马上发出，与快捷键等效；在云会话里新建或编辑 routine 时模型选择器可选推理力度；云环境设置里的安装脚本框改为带颜色、行号与复制按钮的 Bash 编辑器。修复——从 VS Code 扩展登录后，托管设置与组织策略在本次会话剩余时间内不再拉取；Claude 只看到超长 CLAUDE.md、rules 文件或子目录 @ 引入文件的开头就整体覆盖，Write 现在要求先读完或就地编辑；Bash cd 进入仓库更深目录后，按目录与 paths: 声明的技能找不到；终端恢复会话后首次回复偶发在下次恢复时丢失；命令名非法会让所有命令加载失败、claude -p 无输出；Read 工具在 PDF 上偶发 pdftoppm failed: Could not write image；选完推理力度后转圈、OpenTelemetry effort 值与转录仍显示旧档位；/model 与 /effort 的缓存提示误称要等下一条消息；/verify 在 /help 与 / 命令菜单里显示给 Claude 看的长描述；vim 模式下 d/c/y 带超出剩余行数的 gj/gk 计数会误删误拷；agent 视图在 Ctrl+C 清空输入后下次启动仍恢复、用 Ctrl+D 从空 ! 退出后重回 shell 模式。变更——Bedrock、Vertex、Foundry 与 Mantle 对 Claude Code 不认识的模型名（自定义部署名、推理配置 ARN 等）改用短系统提示，设 CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT=0 可保留完整提示；被标记消息后的自动模型切换同样覆盖不认识的模型名，CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK=1 可关闭；用量限额提示把 5 小时窗口改称「5-hour limit」而非「session limit」；prompt 与 agent hook 每会话（含子代理）最多同时跑 24 个，另有最多 12 个已超时等待的；子代理的 autoCompactWindow 现在会下调 CLAUDE_CODE_AUTO_COMPACT_WINDOW 设的窗口（此前无效）；OpenTelemetry 的 mcp_server.name 对官方市场插件声明的固定 URL 远程 MCP 报真实名称；停止发送 claude_code.safety_event 事件。

前一版 v2.1.311（2026-10-26 发布；npm latest 与 next 实测均为 2.1.311，stable 仍为 2.1.308）：新增——self-hosted-runner 支持 --hold-idle-file 与 --max-hold-min，宿主机报告仍有残留进程时保留空闲会话；向 Claude 索要解释时提示 Explanatory 输出风格。修复——CLAUDE.md 含超长列表项时启动及读写文件后长时间卡死；MCP 服务器未应答资源读取或技能仍在下载时，中断要等到超时才生效；标准上下文会话请求超 200K token 时报「Usage credits required for 1M context」而中止，现改为自动压缩后续跑；Write/Edit 一次改数千行时卡住最多 5 秒且报 0 行变更；子代理无法使用在其启动后才连上的 MCP 服务器工具；自动压缩后 Claude 读到会话早期编辑过的旧 MEMORY.md/CLAUDE.md 内容；claude -p 与 SDK 会话转录消息乱序或保留已撤回的消息；SubagentStop hook 每个运行中子代理每分钟触发约两次；@ 文件选择器忽略 .ignore/.rgignore 的否定规则；后台子代理仍在工作时其隔离 worktree 被删除；auto 模式后台 agent 每次唤醒都新开主会话回合；Bash 工具描述谎称工作目录跨调用保持；claude mcp add/remove 与 /mcp 在仓库子目录下把当前文件夹当成 ~/.claude.json 里的项目条目；claude mcp list/get 在失败行重复打印错误码；网络代理拦截启动请求时 Remote Control 会话卡在「连接中」约两分钟；Claude 发往云会话或 Remote Control 的消息在手机端显示为自己的消息；附件保存失败时未告知 Claude 原因。

前一版 v2.1.310（2026-10-23 发布；GitHub Latest，npm latest 与 next 均为 2.1.310，stable 仍为 2.1.308）：新增——Monitor 工具与插件监控（plugin monitors），覆盖 Bedrock、Vertex、Foundry 以及禁用遥测或非必要流量的场景，这些场景下长前台 sleep 同样会被拦截。修复——部分网关与兼容服务器拒绝 effort-2025-11-24 beta 值或会话中段 system 消息导致请求失败，现自动去掉后再重试；cleanupPeriodDays 设得非常大时后台清理误删粘贴图片等近期文件；「Prompt is too long」报错后的压缩保留过多稠密文本（如 base64/SVG）致下一轮仍可能失败；符号链接的文件读取权限提示不显示链接指向；长编辑后外部编辑器关闭瞬间问题自动续时立即触发；非交互会话（-p、Agent SDK）转录文件很大时压缩期间的内存占用。变更——auto 模式在工作目录外首次读取前的提示说明拦截读取会让 shell 命令转而请求许可；Windows 修 Git Bash 缺失且 PreToolUse/PermissionRequest hook 命令全为带引号字符串（如带引号路径）时放行工具调用；mods 的 Image 在 kitty/Ghostty/iTerm2 3.5+（allow-passthrough 与 focus-events 开启、全屏渲染）的 tmux 内可绘制。

前一版 v2.1.309（2026-10-22 发布；GitHub Latest、npm latest 与 next 均为 2.1.309，stable 为 2.1.308，2.1.308 官方说明只有一句「Bug fixes and reliability improvements」）：本版为大规模沙箱与权限修复——修复 macOS/Linux 沙箱在每条命令前把 shell 启动文件在沙箱外执行、denyWrite glob 规则经符号链接路径不生效、沙箱命令与自动接受的编辑可以改写 --mcp-config 传入的 MCP 配置文件、print/SDK 会话中被禁用的 MCP 服务器被后续权限提示重连、worktree 隔离会话误接受带区域前缀的命令（zsh 下含算术命令）、worktree 与分支检出忽略 git replace refs、超大嵌套 CLAUDE.md 导致反复压缩（超限的嵌套 CLAUDE.md 现只加载开头）、Linux 沙箱共享 /proc 时 Read 对 PDF 页范围误报「文件不存在」、Windows 上 PowerShell hook 程序退出码 2 不拦截、PreToolUse/PermissionRequest hook 在未装 Git for Windows 时失效放行等 40 余项；变更——claude ultrareview 现要求工作区信任确认（脚本可传 --trust-workspace），sed -i 改走标准 Bash 提示、不再模拟文件编辑预览也不被 /rewind 还原，Desktop/VS Code 中 bypass permissions 模式下的危险 rm/rmdir 直接拒绝；改进——Windows 上 Claude Code 自用的 git 命令提速、磁盘写满时报错指明需清理的目录。

前一版 v2.1.307（2026-10-21 发布；npm @anthropic-ai/claude-code 的 latest 与 next 均为 2.1.307，stable 仍为 2.1.306）：新增——/claude-api api-version 把 Claude API 代码迁到 API 版本 2026-10-21；新增 claude_code.safety_event OpenTelemetry 事件，权限规则、自动模式、安全检查、hook 或沙箱每次阻止、提示或退回工具调用都会上报；修复——设置 CLAUDE_CODE_DISABLE_1M_CONTEXT 且模型是带 [1m] 后缀的别名（如 opus[1m]）时报 model-not-found、prompt-caching-scope beta 头在自定义 ANTHROPIC_BASE_URL 网关与 Foundry 上无效却仍被发送、macOS 登录钥匙串锁定时 MCP 在 claude -p 里误报「需要认证」、MCP 连接过程中机器休眠被记为超时、HTTP MCP 调用连接中断时重复发送（现仅重试只读或幂等工具）、读大量 PDF/图片时「Autocompact is thrashing」、/clear 清掉的会话在云会话重启时复活、子代理 transcript 记录占位 token 与空 stop reason；改进——无法解析的工具调用最多重试两次、同时 fork 的子代理各自知道哪次启动是自己、浏览器登录成功页不再等账号资料加载、云会话里带原因的 403 搜索错误直接显示原因；另新增 @claude review stop（off/pause 同义），可在 PR 上结束 @claude review always 订阅。中间的 v2.1.306 是两行修复（云会话里 claude -p 误报未登录；MCP 工具多时 API 错误被替换成「prompt is too long」并触发多余压缩）。

前一版 v2.1.305（2026-10-20 发布；npm @anthropic-ai/claude-code 的 latest 与 next 均为 2.1.305，stable 仍为 2.1.304）：新增——sandbox.allowNestedUserNamespaces 让 Linux 上被沙箱的命令可以创建用户命名空间（Chromium、rootless podman 因此可用，官方同时注明这会让它们绕过沙箱的文件保护）；CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS 让无人值守重试模式（CLAUDE_CODE_RETRY_WATCHDOG）能察觉在重置时间之前被提前解除的用量上限。修复——网关或 Vertex/Bedrock 拒绝 tool search 时所有请求失败（2.1.304 回归，现改为不带 tool search 重试）；模型名与 modelOverrides 仅大小写或 [1m] 标签不同时 /effort 与 /autocompact 不生效；bare 仓库新建 worktree 从本地 HEAD 而非默认分支起步、未变更的子代理 worktree 未清理；磁盘满时报原始 ENOSPC 路径（现明示磁盘已满且未执行任何操作）；云会话或 SDK setMcpServers 传入的 MCP 服务器被同名本地设置覆盖；子代理切换 fallback 模型后 Claude 报错模型名；云会话与 teammates 未说明压缩摘要省略了最早消息；定时 Cowork 云会话为每个待批 WebFetch 子代理空等 5 分钟；Workflow resume 重跑已完成的 pipeline()/parallel() 代理；Remote Control 切换会话后 /resume 留空「(session)」条目；/usage 在窄终端被截断；启动警告以裸文本打印在 logo 上方（现写入调试日志）；屏幕阅读器模式下搜索框读作符号、加粗提示词词内出现空格；自托管 runner 三处回归（设置 TERM 时启动脚本报 Resource temporarily unavailable、经 GIT_CONFIG 读配置的凭据助手失效、后台 runner 保持输出导致 spawn-runner hook 误判超时）。改进——/usage 每条警告改为一行可修复项并可用 f 应用（VS Code 与 /doctor 同步）；MCP 同意对话框减少把回车误判为接受；mod 的 Image 在 iTerm2 3.5 及以上全屏渲染；Remote Control 按 w 保存 spawn 模式并说明来源。变更——allowedMcpServers 不再过滤 managed-mcp.json 中仅在 env 使用 ${VAR} 的 stdio 服务器（需用 deniedMcpServers 排除）；Claude Desktop 按路径挂载的插件在 allowManagedPermissionRulesOnly 下不再保留 allowed-tools；/artifacts 删除确认改为 1/Enter 保留、2 删除、Esc 取消；mod 停靠面板宽度限制在终端宽度的 45% 以内。另有 VSCode、Cloud sessions、Claude Tag、Code Review 各若干修复。

前一版 v2.1.304（2026-10-19 发布；npm @anthropic-ai/claude-code，latest、next 与 stable 均为 2.1.304）：新增——/auto-mode-setup 引导式设置，读取项目与近期会话教自动模式了解你的环境，现已覆盖 Bedrock、Vertex、Foundry、Claude apps gateway 与关闭遥测的会话；/claude-api managed-agents-secure 对照 Anthropic 公布的安全指南检查 Managed Agents 配置（只读、不改动）；mod 的 tool.check 新增 decider: "person"（只允许权限弹窗或宿主回调批准，无人可问时按 mod 给出的原因拒绝）与 e.isReadOnly 事件字段；插件抢先跳过一个 mod 的 hook 时在会话记录里写明事件与插件名；压缩摘要（Ctrl+O）显示此前调用过的工具名；Pro/Max 恢复不活跃会话前提示将消耗 5 小时用量限额的一部分。修复——sandbox.filesystem.denyRead 含非字符类方括号（如 [user-id] 路由目录）时沙箱命令无法启动；rm -r 挂载盘或其顶层目录（/Volumes、/media、WSL 的 /mnt/c）未触发安全提示；claude --worktree 在 HEAD 分离或位于其他分支时退出会未经询问删除 worktree 与分支（可能丢提交）；插件重载失败会移除仍在使用版本的工具与命令；mod 共享在托管设置与 Team/Enterprise 计划下卡在密钥扫描；Cowork 云会话为等待 WebFetch URL 审批的每个子代理重复等 5 分钟；Claude Desktop 中未沙箱 Bash 命令读不到 shell 启动文件导出的环境变量；/privacy-settings 在网络或服务端错误后给出不适用的选项；压缩中停止回合后报「Context limit reached / Prompt is too long」；子代理刚结束即被消息或恢复时忘记最近工作等。

前一版 v2.1.303（2026-10-18 发布；npm @anthropic-ai/claude-code，latest 与 next 均为 2.1.303、stable 为 2.1.292）：官方 CHANGELOG 只有一句「Bug fixes and reliability improvements」，本版为纯修复与稳定性补丁，无新增功能或配置项。

前一版 v2.1.302（2026-10-16 发布；npm latest 与 next 均为 2.1.302、stable 为 2.1.292）：新增——CLAUDE_CODE_AUTO_MODE_MODEL 可指定客户端自动模式分类器模型；/config 新增「Idle compaction」空闲压缩开关；/design-sync 提示独立版 Claude Design 将于 2026-12-14 关闭。修复——压缩中中断回合不再报「Prompt is too long」、中途切 Vertex/Bedrock 不再报 diagnostics 错误、Read 拒绝加载超 128MB 图片。

前一版 v2.1.301（2026-10-15 发布；npm latest 通道为 2.1.301、stable 通道为 2.1.292）：新增——无人值守重试模式新增 CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS（用量限额重置时间太远时直接结束请求，不再干等）；vim 模式新增 % 动作（跳到匹配括号，可单独使用或配合 d/c/y）；mod 的 Input 新增 rows（终端多行文本框，Enter 提交、Shift+Enter 或行尾反斜杠换行）；OpenTelemetry 的 tool_decision 事件新增 classifier_verdict、permission_mode 与 classifier_category（区分自动模式分类器的拦截决策与权限规则，后者需 OTEL_LOG_TOOL_DETAILS=1）；claude-api 技能补充 OpenTelemetry tracing 指引（含用 ant CLI 配置 trace 目的地）。修复——退出时不再未经询问移除 WorktreeCreate 钩子创建、可能含未推送提交的 worktree；组织无最新 Fable 模型时 fable/best 别名不再报错，改为回退重试上一代 Fable；磁盘满导致登录刷新失败时的报错改为指明磁盘并提示删除文件；Grep 与 Glob 在搜索程序异常失败时返回「搜索失败」而非「无匹配」；workflow agent 跳过步骤却仍报成功；PreToolUse 钩子覆盖 Edit/Write 时 artifact 更新被拒；参数名极多或极长的技能/命令/钩子调用时卡顿与内存暴涨；VTE 0.53 以前终端（如 RHEL 8 的 MATE Terminal）出现 >0q、>4m 等杂字符与 iTerm2 启动时的 GOK 杂字；非 Bedrock 提供方下模型名含 application-inference-profile 时误跑 awsAuthRefresh 并拖延模型切换钩子；短命令（claude auth status、claude plugin list）在令牌刷新中途退出导致登录刷新超时与意外登出；权限检查期间被中途消息打断的工具调用被误报为「用户拒绝」；切换到更小上下文窗口的模型时不再未经询问就花用量做摘要（改由前一个模型先摘要）；网关返回的模型名与请求不一致时反复压缩；慢机器上 vim 模式 Escape 后仍停留在 INSERT；vim 模式下 Esc 丢弃已输入的 AskUserQuestion 答案（自由文本字段支持 NORMAL 模式）；Read 工具把 .xlsm/.parquet/.epub/.heic 等二进制当文本读；只有表头行的 Markdown 表格过宽时不渲染；/rewind 后技能不再列给模型；恢复会话的压缩行提示未加载的历史；中断回复后「new task? /clear」提示立刻回来；插件/技能 hook 的 ask 决策不显示来源；/diff 漏检 reftable 仓库中冲突的 cherry-pick 或 revert；同会话 Bash cd 之后 workflow 脚本读/改/重跑要求权限或被拒；暗色 ANSI 主题与 16 色终端下的 dim 文本渲染；mod 的 $.model.fork 在新进程首个响应完成前返回 nothing-to-fork；全屏模式 /compact 与自动压缩短暂冻结界面；自托管 runner 的 Slack 会话在托管设置限制 MCP 时找不到仓库、误报源分支被删、失败会话重试日志不准确。改进——长跑子代理工作时进度轨迹改为增量更新（渲染更快）；artifacts 页面绘制 sticky 表头上方色带；mods 中问题对话框上方可绘制含 Markdown 的最多 48 行树（终端仍为 12 行纯文本）；mod hook 的 .catch 仅在钩子抛错或超时时运行；mod 的 $.env.set 成功时解析为 {}。另有 [VSCode] 新增 LaTeX 数学渲染、使用限额横幅新增「Get more usage」链接，并修复面板崩溃后每次重载都重开、长思考时聊天面板变慢、诊断显示 [object Object]、未提供听写时仍加载原生听写音频模块等（本段官方 CHANGELOG 约 50 条，以修复与稳定性为主）。

前一版 v2.1.300（2026-10-14）：新增——mod 提示装饰新增 virtualText（画在输入框里但不进入草稿或提交内容）；OpenTelemetry 的 api_request 事件新增 cache_creation_5m_tokens 与 cache_creation_1h_tokens（按缓存寿命拆分缓存写入），trace span 新增 OpenTelemetry GenAI 语义约定属性（gen_ai.provider.name、gen_ai.conversation.id、gen_ai.tool.name、error.type）；mod 新增 $.ui.view({ agentId })（把某代理的转录显示在主视图、$.ui.view({}) 返回）与 prompt.change 钩子；mod 的 Text 新增 dir 属性支持从右到左文本（Windows 与 VS Code 终端）；Claude Platform on AWS 新增 /advisor（未指定前不运行任何 advisor，可用 advisorModel 或 --advisor 指定、CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 关闭）；agent.spawn 钩子支持改写 workflow agent 的 prompt 与 model；修复——云会话把自身网络设置误报为组织策略拦截、/autocompact 在选较小自动压缩窗口时误报高 token 用量、后台命令仍在运行时退出导致 SessionEnd 钩子不执行、claude agents 在某条 PR 数据不完整时不刷新状态、容器被替换后已恢复过的后台代理被误报丢失、发过消息的子代理完成后从 /tasks 消失、查看子代理时父代理从面包屑消失、agents 视图把突发输入的 up/down/escape 误当按键、自动工具搜索（ENABLE_TOOL_SEARCH=auto）在对话中途被关闭、插件 hook 嵌套超 28,000 层被拒、MCP 请求不再跟随重定向等（本段官方 CHANGELOG 约 90 条）。

前一版 v2.1.299（2026-10-14，同日稍早发布）：新增——CLAUDE_CODE_DISABLE_FILE_MENTIONS 环境变量（Claude 只拿到 @ 提及文件的路径而非内容）；终端空闲压缩（idle compaction）：200K+ token 的对话闲置约 54 分钟后、在其一小时提示缓存过期前先行压缩，避免下一条消息重新处理全文，CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS 调整 200K 下限、settings.json 的 "idleCompaction": false 关闭（均需 v2.1.290+）；mod 新增 $.prompt.media 与 $.session.identity()；mod 的 Text 新增 size/weight/mono/tabular、Box 新增命名间距档（xs~xl）；claude self-hosted-runner orchestrator 新增 --shutdown-drain-sec；agent 视图新增 /effort 与 /fast（裸 /model、/effort、/fast 打开选择器）；claude plugin eval 新增 --disallow-tools 与 disallowed_tools；/usage 新增 max effort、workflow、常驻上下文与超大工具结果的告警。修复——2.1.296 的回归（重启后云/无头会话在恢复时可能重复运行已批准的工具调用）、Cowork 与 claude.ai 云会话在钩子运行中停止消息后 Edit/Retry 失败、被拒云会话在 apiKeyHelper 生效时指向错误组织、gateway 专用模型名在自定义 ANTHROPIC_BASE_URL 下约 200K token 处报 "Prompt is too long"、沙箱化命令可写入 --plugin-dir 目录、大量调试日志下内存增长与退出挂起、WSL2 上沙箱因无法在 Windows 盘建目录而失败、Read 读 PDF 页范围在非提权 Linux 远程会话失败、MCP 服务器名为 constructor/prototype 时无法连接等（本段官方 CHANGELOG 约 190 条，以修复与稳定性为主）。中间的 v2.1.297 与 v2.1.298 未发布正式版（npm 版本号从 2.1.296 直接跳到 2.1.299）。

前一版 v2.1.296（2026-10-09）：新增 Claude apps 网关 managed.policies[] 的 code 键（与 cli 同设置、同时作用于 Claude Desktop 的 Code 标签，与 desktop 并列时会打开桌面端网关模式）；子代理 frontmatter 与 --agents 定义新增 autoCompactWindow（子代理可早于主对话窗口自动压缩）；新增 CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL（让全部 workflow agent 跑在同一模型上、其他子代理不受影响）；新增 CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS（放宽 529 过载重试退避的最长等待）；Read 工具新增 allow_large 选项（上下文有余量时一次性读完超常规大小限制的文本文件）；/plugin 会对因与其他已启用插件同名而被略去 hooks 的插件给出提示。修复——managed-settings 的 PreToolUse hook 用 "continue": false 拒绝调用、以及 managed prompt hook 阻断调用时，此前只拒绝却不结束回合；headless 会话在切目录或重载插件后误启该目录已关闭的 .mcp.json 或插件 MCP 服务器；网关在 managed settings 里把 forceLoginMethod 设为 gateway 而无 forceLoginGatewayUrl 时忽略已保存的登录（2.1.295 的回归）；Haiku 5.5 等仅支持自适应思考的模型 token 计数错误；Bash 权限检查自动放行部分「赋值 BASH_ARGV0 后使用」的命令（现改为询问）；Edit/NotebookEdit 会把非 UTF-8 文件（Windows-1252、Shift-JIS、GBK）里的每个非 ASCII 字符替换掉（现改为拒绝编辑）；Windows 上超过约 1KB 的 PowerShell 命令总要求权限（现 allow 规则与只读检测可覆盖到 32KB）、stdio MCP 服务器在关停时被强杀（现先关 stdin）；macOS 启动挂起（插件路径指向 /home）、Workflow 工具拒绝 CRLF 脚本、共享转录与调试日志的密钥脱敏漏值等；另将 /cost、状态行、--max-budget-usd 与 SDK 成本数字里的 Sonnet 5.5 缓存读价格从 $0.20 降为 $0.10 每百万 token。

前一版 v2.1.295（2026-10-08；stable 通道为 2.1.286）：新增 hook 的 onFailure: "block"——命令与 HTTP hook 无法启动、超时或以非预期码退出时阻断动作而非放行；新增 Program Status Protocol（OSC 7501）支持，实现该协议的终端可显示 Claude 正在工作、在等你回答还是已完成；/copy 选择器新增带引号文本，草稿消息复制不再带 > 标记；claude plugin install / enable / disable / marketplace add 在写入的 settings 文件无法加载时给出警告；claude -p 在最后一轮后仍打开时在 stderr 说明它在等什么；Claude apps 网关的 Bedrock/Vertex/Foundry 等云端上游支持 timeouts.upstream_ttfb_ms（限制流启动时长，超时即故障转移或返回 502）；每个网关上游支持可选 models 白名单（故障转移时同样生效，条目内可用一个 * 通配）；支持 forceLoginMethod: "gateway" 与 forceLoginGatewayUrl；mod 新增 $.ui.notify 原生通知与 Button 子元素（字符串与 Text）；新增 CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS 限制无人值守重试模式等待 429/529 的时长。2.1.293 起 Claude Haiku 5.5（claude-haiku-5-5）成为 Anthropic API 默认 Haiku 模型（1M 上下文、$0.10/$0.50 每百万 token，超 10 万 token 提示按 $0.50/$2.50）；2.1.292 起新增 claude plugin install --marketplace、Agent 工具的 effort 参数、mod 的 prompt.autocomplete 事件与 $.model.complete 提示缓存。修复以稳定性与权限为主（官方 CHANGELOG 本段共约 145 条）——远程 MCP 服务器在断线超过 15 秒后按指数退避重连（最多 30 秒）不再紧密循环、MCP 重复分页游标不再每次连接请求同一页 20 次、MCP 工具返回的 CSS/JS/XML 不再被存成 .bin 而 Read 拒读、超长回复（数万行）导致终端冻结并忽略 Ctrl+C、深层嵌套引号回复占用数 GB 内存、glob 模式 for 循环的 Bash 权限检查精度、Windows 盘符大小写导致项目级插件在 VS Code 不加载、CRLF 短输出不再画在单行、vim 模式 ~ / x / 3~ 光标越界、云会话与后台会话的定时任务丢失或重复触发；安全侧修复 UNC 网络路径与沙箱 seed-admin 暂存文件的读边界绕过、以及 tampered 服务端托管设置缓存可关闭内置策略插件等。

前一版 v2.1.289（2026-10-03）新增 agent.spawn（teammates）与 $.agent.list() 的 idle/waiting 状态，并修复沙箱自动放行下的 Bash/Read 权限规则绕过；2.1.288（2026-10-02）为 mod 新增 $.ui.selection()、云会话内置 gh api、Ctrl+C 草稿恢复、/code-review --max-findings、agents 视图 Ctrl+F 查找会话；2.1.287 引入 Claude Mods 插件系统与内置 mod「You should know」（侧代理监督，/plugin enable cc-plugin-you-should-know@builtin）；2.1.284 起 Claude Sonnet 5.5 成为默认 Sonnet 模型（1M 上下文、$2/$10 每百万 token、缓存读 $0.20/百万）。2026-09 的重磅升级为 Projects 功能原生支持多 Agent 并行——一次对话可分裂多个云端并行会话、各自分支工作、共享同一项目记忆，量子位报道其内部每天运行约 3 万个 Agent、26% 研发工作由 AI 主导；在终端里用自然语言完成代码理解、例行任务与 git 工作流，是 agentic coding 的事实标准工具。