跳到正文

更新日志

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 update

Homebrew 更新

Homebrew、WinGet、apt、dnf、apk 和 npm 安装不会自动更新:

brew upgrade claude-code

WinGet 更新

winget upgrade Anthropic.ClaudeCode

npm 更新

请用 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 个版本

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 官方说明 · 英文摘要

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 官方说明 · 英文摘要

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 官方说明 · 英文摘要

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 官方说明 · 英文摘要

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 官方说明 · 英文摘要

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 官方说明 · 英文摘要

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 官方说明 · 英文摘要

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 官方说明 · 英文摘要

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 官方说明 · 英文摘要

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 官方说明 · 英文摘要

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 官方说明 · 英文摘要

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 官方说明 · 英文摘要

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 官方说明 · 英文摘要

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 官方说明 · 英文摘要

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 官方说明 · 英文摘要

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 官方说明 · 英文摘要

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 官方说明 · 英文摘要

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 官方说明 · 英文摘要

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 官方说明 · 英文摘要

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 最新稳定版是 2.1.302,于北京时间 2026年10月17日 04:53 在 GitHub(anthropics/claude-code)发布。 来源:GitHub · anthropics/claude-code。
如何更新 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 安装文档(官方中文)。