4.5 命令版本管理

约 975 字大约 3 分钟

Claude Code 会定期更新，添加新功能、改进现有功能、修复 bug。了解命令版本管理可以帮助您保持 Claude Code 的最新状态，并了解版本之间的差异。

版本信息

查看当前版本

您可以通过以下方式查看当前安装的 Claude Code 版本：

CLI 命令

claude --version

交互式命令

/version

这会显示当前安装的 Claude Code 版本号。

版本号格式

Claude Code 使用语义化版本号格式：MAJOR.MINOR.PATCH

MAJOR（主版本号）：重大更新，可能包含不兼容的 API 变更
MINOR（次版本号）：新功能添加，向后兼容
PATCH（修订号）：bug 修复和小改进，向后兼容

例如：2.1.3 表示主版本 2，次版本 1，修订号 3。

更新 Claude Code

使用 claude update 命令

Claude Code 提供了方便的更新命令，可以自动检查并安装最新版本。

基本用法

claude update

这会执行以下操作：

检查是否有新版本可用
下载最新版本的安装包
安装新版本
清理旧版本的文件

更新过程

更新过程通常包括以下步骤：

检查更新：连接到更新服务器，检查最新版本
下载更新：下载更新包（可能需要几分钟）
验证更新：验证下载的更新包的完整性
安装更新：安装新版本（可能需要管理员权限）
清理：删除临时文件和旧版本
确认：显示更新完成信息和新版本号

更新选项

检查更新但不安装

某些情况下，您可能只想检查是否有更新，而不立即安装：

claude update --check-only

这会显示是否有新版本可用，但不会执行安装。

指定版本

在某些情况下，您可能需要安装特定版本：

claude update --version 2.1.0

这会安装指定的版本，而不是最新版本。

预览版本

如果您想尝试预览版本（可能包含新功能，但可能有 bug）：

claude update --preview

这会安装最新的预览版本。

版本兼容性

命令兼容性

不同版本的 Claude Code 可能支持不同的命令和标志：

新增命令：新版本可能添加新的命令
废弃命令：旧命令在新版本中可能被废弃
删除命令：某些命令在新版本中可能被删除

命令变更：命令的语法或行为可能发生变化

标志兼容性

不同版本的 Claude Code 可能支持不同的标志：

新增标志：新版本可能添加新的标志
废弃标志：旧标志在新版本中可能被废弃
删除标志：某些标志在新版本中可能被删除
标志变更：标志的语法或行为可能发生变化

配置兼容性

不同版本的 Claude Code 可能使用不同的配置格式：

配置结构：配置文件的结构可能发生变化
配置选项：配置选项可能被添加、删除或重命名
默认值：配置选项的默认值可能发生变化
验证规则：配置验证规则可能变得更加严格

版本迁移

升级到新版本

当您升级到新版本时，可能需要进行一些迁移工作：

阅读发布说明：了解新版本的变化和改进
检查废弃警告：注意废弃的功能，准备迁移
更新配置：根据新的配置格式更新配置文件
测试功能：测试常用的功能，确保正常工作
报告问题：如果发现问题，及时报告

降级到旧版本

如果新版本有问题，您可能需要降级到旧版本：

claude update --version 2.0.14