首页 Claude Code 更新日志 更新日志
Claude Code 更新日志(中文) Claude Code 的每个稳定版本:发布时间(北京时间)、官方说明中各类改动的数量和要点。要点保留英文原文,每个版本都链接到 GitHub 上的完整官方说明。
快速回答: Claude Code 最新稳定版是 2.1.302,于北京时间 2026年10月17日 04:53 发布。截至最新版本的近 30 天内共发布 26 个稳定版,中位间隔 1 天。
如何安装和更新 Claude Code、查看版本 安装(macOS、Linux、WSL) 推荐使用官方原生安装程序,安装后会自动更新,不需要管理员权限:
curl -fsSL https://claude.ai/install.sh | bash安装(Windows PowerShell) irm https://claude.ai/install.ps1 | iex安装(Windows CMD) 提示符显示 PS C:\ 的是 PowerShell,只显示 C:\ 的是 CMD:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd用 Homebrew 安装 claude-code 对应 stable 渠道,claude-code@latest 对应 latest 渠道:
brew install --cask claude-code用 WinGet 安装(Windows) winget install Anthropic.ClaudeCode用 npm 安装 需要 Node.js 22 或更高版本,不要使用 sudo npm install -g:
npm install -g @anthropic-ai/claude-code登录 运行 claude,按浏览器中的提示登录。Claude Code 需要 Pro、Max、Team、Enterprise 或 Console 账户,免费版 claude.ai 不包含 Claude Code,并且只能在 Anthropic 支持的国家和地区使用。
查看已安装的版本 输出类似 2.1.302 (Claude Code):
claude --version立即更新 原生安装会在启动时和运行期间检查更新,在后台下载,下次启动时生效。想马上更新:
claude updateHomebrew 更新 Homebrew、WinGet、apt、dnf、apk 和 npm 安装不会自动更新:
brew upgrade claude-codeWinGet 更新 winget upgrade Anthropic.ClaudeCodenpm 更新 请用 install @latest,不要用 npm update -g:
npm install -g @anthropic-ai/claude-code@latest安装指定版本(macOS、Linux、WSL) 例如安装 2.1.302:
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.302发布渠道 Claude Code 有两个发布渠道:latest(默认)每个版本一发布就更新;stable 通常晚大约一周,并会跳过有严重回归问题的版本。可在 /config → Auto-update channel 中切换,或在 ~/.claude/settings.json 中设置 autoUpdatesChannel。
{
"autoUpdatesChannel": "stable"
}关闭自动更新 在 settings.json 中加入以下内容,claude update 仍可手动使用:
{
"env": {
"DISABLE_AUTOUPDATER": "1"
}
}找不到 claude 命令 先打开一个新的终端窗口。仍然不行,就把安装目录加入 PATH(以 zsh 为例),并用 claude doctor 检查安装:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
claude doctor命令来自官方文档:Claude Code 安装文档(官方中文) 、Claude Code: Advanced setup (2026 年 10 月核对)。
最近 20 个版本 北京时间 2026年10月17日 04:53
Claude Code 2.1.302 共 63 项改动:3 项新功能,21 项修复,1 项性能,38 项其他。
新功能 Added CLAUDE_CODE_AUTO_MODE_MODEL to choose the model the client-side auto mode classifier uses; it does not change the model for server-side… 新功能 Added an Idle compaction row to /config for turning idle compaction off or back on; the notices shown after an… 新功能 Added a notice to /design-sync and /design-login that standalone Claude Design (claude.ai/design) closes by December 14, 2026 GitHub 官方说明 · 英文摘要
北京时间 2026年10月16日 03:22
Claude Code 2.1.301 共 51 项改动:6 项新功能,29 项修复,1 项性能,15 项其他。
新功能 Added CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS so unattended retry mode (CLAUDE_CODE_RETRY_WATCHDOG) ends a request at a usage limit that resets too far away instead… 新功能 Added OpenTelemetry tracing guidance to the claude-api skill, including setting up trace destinations with the ant CLI 新功能 Added the % motion to vim mode: jump to the matching bracket, alone or with d/c/y GitHub 官方说明 · 英文摘要
北京时间 2026年10月15日 02:24
Claude Code 2.1.300 共 88 项改动:8 项新功能,43 项修复,37 项其他。
新功能 Added virtualText to a mod's prompt decorations: text drawn in the prompt box that never enters the draft or the… 新功能 Added cache_creation_5m_tokens and cache_creation_1h_tokens to the OpenTelemetry api_request event, splitting cache writes by lifetime 新功能 Added $.ui.view({ agentId }) for mods: shows an agent's transcript in the main view when you ask, and $.ui.view({}) goes… GitHub 官方说明 · 英文摘要
北京时间 2026年10月14日 10:49
Claude Code 2.1.299 共 190 项改动:17 项新功能,115 项修复,1 项性能,2 项安全,55 项其他。
安全 Fixed an agent teammate started without a description keeping part of a credential from its prompt in the task description… 安全 Self-hosted runner: Improved what setup and doctor say when the runner's machine has no git credentials 新功能 Added CLAUDE_CODE_DISABLE_FILE_MENTIONS environment variable: Claude gets the paths of @ file mentions to read with its file tools, not the… GitHub 官方说明 · 英文摘要
北京时间 2026年10月10日 03:28
Claude Code 2.1.296 共 79 项改动:6 项新功能,39 项修复,2 项性能,1 项安全,31 项其他。
安全 Fixed secret redaction in shared transcripts and debug logs missing some values that follow a key with no value, including… 新功能 Added a code key to the Claude apps gateway's managed.policies[]: the same settings as cli, also applied in Claude Desktop's… 新功能 Added autoCompactWindow to subagent frontmatter and --agents definitions, so a subagent can auto-compact earlier than the main conversation's window GitHub 官方说明 · 英文摘要
北京时间 2026年10月9日 03:48
Claude Code 2.1.295 共 143 项改动:15 项新功能,85 项修复,43 项其他。
新功能 Added onFailure: "block" for command and HTTP hooks: a hook that can't start, times out, or exits with an unexpected… 新功能 Added Program Status Protocol (OSC 7501) support: terminals that implement it can show whether Claude Code is working, waiting on… 新功能 Added quoted text to the /copy picker, so a drafted message copies without its > markers GitHub 官方说明 · 英文摘要
北京时间 2026年10月8日 13:03
Claude Code 2.1.294 共 2 项改动:1 项修复,1 项其他。
修复 Fixed prompt and agent hooks written as instructions (such as "Block commands that...") allowing what they should block 其他 Improved how prompt hooks on Stop and SubagentStop written as instructions (such as "Carry on if the build is broken")… GitHub 官方说明 · 英文摘要
北京时间 2026年10月8日 02:10
Claude Code 2.1.293 共 56 项改动:3 项新功能,31 项修复,2 项安全,20 项其他。
安全 Fixed Remote Control uploading a session's starting history again after every credential recovery 安全 Fixed claude plugin eval refusing every Bash-granting run on Macs with Docker Desktop (links under ~/.docker/bin); the refusal now names… 新功能 Added Claude Haiku 5.5 (claude-haiku-5-5), now the default Haiku model on the Anthropic API — 1M context, $0.10/$0.50 per Mtok… GitHub 官方说明 · 英文摘要
北京时间 2026年10月7日 02:59
Claude Code 2.1.292 共 92 项改动:6 项新功能,51 项修复,1 项性能,2 项安全,32 项其他。
安全 Fixed a managed sandbox read-deny path (and user ones beside it) that appears or re-points mid-session not dropping project grants… 安全 Security: Fixed PreToolUse hook approvals and auto mode bypassing the permission prompt for file reads from network (UNC) paths 新功能 Added --marketplace <source> to claude plugin install: adds the marketplace if needed, under the same policy checks as claude plugin… GitHub 官方说明 · 英文摘要
北京时间 2026年10月6日 11:55
Claude Code 2.1.291 共 2 项改动:2 项修复。
修复 Fixed a regression in 2.1.290 where cloud sessions could drop answers to permission prompts 修复 Fixed a regression in 2.1.288 where the last messages of a session could be lost when quitting GitHub 官方说明 · 英文摘要
北京时间 2026年10月6日 07:33
Claude Code 2.1.290 共 190 项改动:11 项新功能,111 项修复,1 项性能,2 项安全,65 项其他。
安全 Fixed first launch asking to pick a login method again after claude auth login or with a credentials file already… 安全 Improved the Claude apps gateway's log when an upstream's cloud credentials or connection fail: the warning now ends with the… 新功能 Added serverToolUses to the result of a mod's turn.step hook: the tool calls the API ran itself (the advisor), each… GitHub 官方说明 · 英文摘要
北京时间 2026年10月4日 07:07
Claude Code 2.1.289 共 2 项改动:2 项修复。
修复 Fixed a deny or ask rule on a nested part of a compound shell command not holding over a user-installed… 修复 Fixed the terminal freezing on short code blocks with many unclosed ` GitHub 官方说明 · 英文摘要
北京时间 2026年10月3日 04:19
Claude Code 2.1.288 共 89 项改动:7 项新功能,54 项修复,6 项安全,22 项其他。
安全 Fixed /login reporting "Login successful" when credentials could not be saved to secure storage; it now shows the failure, and… 安全 Fixed a Stop during Bedrock credential lookup sometimes moving the session to a fallback model instead of ending the request 安全 Fixed sandbox.credentials.files entries on git config files not taking effect while permissions.blockReadsOutsideWorkingDirectories is on GitHub 官方说明 · 英文摘要
北京时间 2026年10月2日 02:00
Claude Code 2.1.287 共 106 项改动:5 项新功能,50 项修复,1 项安全,50 项其他。
安全 Changed whole-tool Bash allow rules and allowing hooks to prompt for, not run, shell writes to files Claude Code's file… 新功能 Added Claude Mods: plugins may now modify deeper behavior 新功能 Added You should know, a built-in mod where a side agent watches your back and flags things you or Claude… GitHub 官方说明 · 英文摘要
北京时间 2026年10月1日 03:10
Claude Code 2.1.286 共 88 项改动:2 项新功能,32 项修复,2 项性能,4 项安全,48 项其他。
安全 Fixed several Claude Code processes and IDE extensions each opening a login browser when gcpAuthRefresh or awsAuthRefresh credentials expire 安全 Fixed macOS sessions still showing "Not logged in" or "Login expired" after /login succeeds in another Claude Code window when… 安全 Fixed MCP error messages showing a credential's value when "Bearer" or "Basic" came before its key name GitHub 官方说明 · 英文摘要
北京时间 2026年9月30日 03:27
Claude Code 2.1.285 共 136 项改动:6 项新功能,58 项修复,2 项性能,2 项安全,68 项其他。
安全 Fixed /ultrareview uploads including uncommitted changes to credential files whose name has a colon before the extension, such as server:8443.key 安全 Fixed /ultrareview uploads on macOS and Linux running slowly on some unusual file names, and their credential-file check missing file… 新功能 Added CLAUDE_CODE_DISABLE_WEB_FETCH environment variable to turn off the WebFetch tool GitHub 官方说明 · 英文摘要
北京时间 2026年9月29日 02:02
Claude Code 2.1.284 共 100 项改动:6 项新功能,39 项修复,2 项性能,3 项安全,50 项其他。
安全 Added auth: { google: {} } for Claude apps gateway telemetry.forward_to destinations, so telemetry can be exported straight to Google… 安全 Added certificate client authentication (private_key_jwt) between the Claude apps gateway and its identity provider, for identity providers that issue certificate… 安全 Improved the startup refusal when managed settings require a sign-in (forceLoginMethod or forceLoginOrgUUID) and an API key, token or apiKeyHelper… GitHub 官方说明 · 英文摘要
北京时间 2026年9月26日 05:50
Claude Code 2.1.283 共 94 项改动:9 项新功能,36 项修复,2 项性能,1 项安全,46 项其他。
安全 Fixed sandboxed git asking credential helpers to store the sandbox proxy's login, which printed "failed to store" 新功能 Added x-claude-code-prompt-id to the gateway hint headers so LLM gateways can group the requests that serve one user prompt; opt… 新功能 Added availableModelsMatch managed setting: with "exact", an availableModels entry allows only the model version it names, so new releases stay… GitHub 官方说明 · 英文摘要
北京时间 2026年9月25日 02:38
Claude Code 2.1.282 共 86 项改动:5 项新功能,44 项修复,37 项其他。
新功能 Added a maxProseWidth setting that caps the width of Claude's prose in wide terminals while tables and code blocks keep… 新功能 Added a startup notice, and /status and claude doctor entries, listing telemetry variables in a project's settings files that were… 新功能 Added the allowClaudeInChromeWithManagedMcp managed setting to let claude --chrome run alongside an exclusive managed-mcp.json; the error shown when Chrome is… GitHub 官方说明 · 英文摘要
北京时间 2026年9月24日 03:19
Claude Code 2.1.281 共 176 项改动:10 项新功能,90 项修复,1 项性能,1 项安全,74 项其他。
安全 Fixed macOS credential writes dropping stored MCP OAuth tokens or deleting the keychain entry when the login keychain was locked… 新功能 Added Claude apps gateway support for newer Claude Desktop keys in desktop policy blocks, including blockReadsOutsideWorkingDirectories and disableBypassPermissionsMode 新功能 Added assume_role on Claude apps gateway Bedrock upstreams: the gateway calls Bedrock as an IAM role it assumes through STS… GitHub 官方说明 · 英文摘要
要点保留英文原文,按官方说明缩写,优先列出安全和新功能。
常见问题 如何更新 Claude Code? 原生安装的 Claude Code 会在后台自动更新;想立即更新,在终端运行 claude update。用 Homebrew 安装的运行 brew upgrade claude-code,用 WinGet 安装的运行 winget upgrade Anthropic.ClaudeCode,用 npm 安装的运行 npm install -g @anthropic-ai/claude-code@latest。 来源:Claude Code 安装文档(官方中文) 。 如何查看 Claude Code 版本? 在终端运行 claude --version(或 claude -v),会显示当前安装的版本号;在会话中输入 /status 也能看到。 来源:Claude Code 安装文档(官方中文) 。 如何在 Windows 上安装 Claude Code? 在 PowerShell 中运行 irm https://claude.ai/install.ps1 | iex;在 CMD 中运行 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd。也可以用 WinGet(winget install Anthropic.ClaudeCode)或在 WSL 中安装。 来源:Claude Code 安装文档(官方中文) 。 latest 和 stable 渠道有什么区别? latest(默认)每个版本一发布就更新;stable 通常晚大约一周,并会跳过有严重回归问题的版本。可在 /config 中或用 autoUpdatesChannel 设置切换。 来源:Claude Code 安装文档(官方中文) 。 Codex CLI 更新日志 · Claude 额度重置 · English version · RSS