版本追踪 Changelog
版本追踪 Changelog
Section titled “版本追踪 Changelog”Claude Code 迭代很快——新功能、修复、调整几乎每周都有。这一篇讲怎么查自己装的版本、怎么更新、怎么追踪上游变化，以及怎么从官方 changelog 里挑出对你有用的信息。
版本号以官方为准：本页提到的具体版本号来自 GitHub 仓库
anthropics/claude-code的提交活动梳理，仅作时间节点参考。你装的版本以claude -v实际显示为准，最新版本以官方CHANGELOG.md为准。
怎么查当前版本
Section titled “怎么查当前版本”claude -v
Section titled “claude -v”claude -v# 或claude --version一行输出当前版本号。最快的方式。
/status
Section titled “/status”交互模式里敲 /status，除了版本还会显示：当前模型、账号、连接状态、上下文用量。
claude# 进入后：/statusclaude doctor
Section titled “claude doctor”claude doctor体检命令。会检查：安装完整性、版本新旧、配置文件、网络连通、依赖项。绿色就绪，红色有修复指引。装完或出问题时第一个跑这个。
claude update
Section titled “claude update”claude update更新到最新版。最常用。
指定版本通道
Section titled “指定版本通道”claude install stable # 稳定通道claude install latest # 最新通道（含预览）claude install 2.1.197 # 指定版本号stable 通道更稳，latest 通道更早拿到新功能。企业部署一般锁 stable 或固定版本号。
升级后出问题怎么回退
Section titled “升级后出问题怎么回退”# 装回上一个已知好版本claude install <旧版本号>
# 或回稳定通道claude install stable/rewind 只回退对话和代码改动，不回退 Claude Code 本体版本——版本回退用 install。
Claude Code 默认会提示有新版（交互模式里看到提示按提示操作）。CI 环境里建议固定版本号，避免「昨天能跑今天突然不行」。
怎么追踪上游变化
Section titled “怎么追踪上游变化”官方 CHANGELOG.md
Section titled “官方 CHANGELOG.md”仓库 github.com/anthropics/claude-code 的 CHANGELOG.md 是权威来源。每次发布的改动都记在这里：
- Added：新功能
- Changed：行为变更
- Deprecated：即将移除
- Removed：已移除
- Fixed：修复
- Security：安全相关
怎么读最省事：搜关键字。你关心的功能名（如 subagents、hooks、mcp）在 changelog 里 grep，只看相关条目。
feed.xml（RSS）
Section titled “feed.xml（RSS）”仓库提供 feed.xml，订阅到 RSS 阅读器，有新版本自动推。适合不想手动刷页面的人。
GitHub Releases / Commits
Section titled “GitHub Releases / Commits”- Releases：
github.com/anthropics/claude-code/releases，按版本看发布说明 - Commits：
github.com/anthropics/claude-code/commits，看每天在改什么
提交信息往往比 release notes 更细——一个大版本背后可能有几十个提交。
社区 changelog 目录
Section titled “社区 changelog 目录”best-practice 仓库（社区整理）有 changelog/ 目录，把官方变更按主题归类摘要，适合快速了解「最近这波更新对实战有什么影响」。来源见 外部资源推荐。
官方文档 diff
Section titled “官方文档 diff”docs.claude.com 的页面更新有时比 CHANGELOG 更直观——直接看某功能页有没有新增章节。重要页面值得收藏定期扫：common-workflows、settings、mcp、hooks、sub-agents、skills。
重要版本节点（按提交活动梳理）
Section titled “重要版本节点（按提交活动梳理）”下面这些节点来自 GitHub 仓库 anthropics/claude-code 的提交活动，按时间梳理。仅作参考——具体版本号、确切日期、改动范围以官方 CHANGELOG.md 为准。
| 时间 | 提交主题 | 实战影响 |
|---|---|---|
| 2026-01 | Day 1 onboarding tutorial | 新人引导更顺，/init 后有教程 |
| 2026-03 | claude-oss banner | 开源相关标识调整 |
| 2026-04 | tighten invalid-label rule | 子代理/Skill 的 label 校验更严，旧配置可能要调整 |
| 2026-06 | subagents report badge（提交活动参考 v2.1.197） | 子代理报告展示徽章，摘要更醒目 |
怎么用这张表：
- 看到熟悉的主题（如你重度用 subagents），就去 changelog 里 grep 关键词，看完整改动
- 「tighten invalid-label rule」这类「收紧规则」的更新要警惕——升级后旧配置可能报错
- 大版本跨越前先看 CHANGELOG 的 Breaking Changes 段
再次提醒：上述版本号与日期基于 GitHub 提交活动整理，可能与正式发布有出入。你装的版本以
claude -v为准，最新发布以官方CHANGELOG.md为准。
升级前的检查清单
Section titled “升级前的检查清单”升级 Claude Code 前，特别是跨大版本时，过一遍：
- 看 CHANGELOG：grep 你在用的功能（hooks、subagents、mcp、skills），看有没有 Breaking Change
- 跑 claude doctor：确认当前安装健康
- 备份配置：
.claude/settings.json、CLAUDE.md、.mcp.json进 git（应该早就在 git 里了） - 挑低峰期升级：升级后第一次会话可能要重新认证，别卡在交付前
- 升级后跑一遍常用会话：确认子代理、Skill、Hook 都正常
- 出问题先 doctor 再回退：
claude install <旧版本>
怎么知道该不该升级
Section titled “怎么知道该不该升级”不是每次更新都要追。判断标准：
| 情况 | 建议 |
|---|---|
| 修了你遇到的 bug | 升 |
| 加了你想要的功能 | 升 |
| 安全相关更新 | 必升 |
| Breaking Change 影响你的配置 | 评估后再升 |
| 与你无关的小修 | 不急，攒一波 |
CI 环境里建议：固定版本号，每月主动升一次，避免被动踩坑。
订阅与追踪习惯
Section titled “订阅与追踪习惯”养成三个习惯，长期省心：
- 关注仓库 Release：在 GitHub 上 Watch
anthropics/claude-code的 Releases - RSS 订阅 feed.xml：进 RSS 阅读器，新版本推送
- 每月扫一次官方文档：
docs.claude.com重要页面看有没有新章节
社区资源（best-practice 仓库的 changelog 目录、中文教程的更新公告）能帮你快速判断「这次更新对实战意味着什么」——见 外部资源推荐。
查版本用
claude -v或/status，体检用claude doctor，更新用claude update或claude install <通道>，追踪变化看官方CHANGELOG.md和feed.xml，具体版本号以官方为准。
版本会变，方法不变——把 claude doctor 和 CHANGELOG.md 当成你的两个锚点。要查外部学习资源看 外部资源推荐，要解升级后的疑看 FAQ 大全。🚀