命令字典
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
立即应用 Claude Code 的待装更新,等价于命令行 claude update,无需等待后台自动检查。
/updateclaude update/update 是 Claude Code 的更新命令,在当前会话内立即拉取并应用最新版本,不必等待后台自动更新的下一次检查。它对应命令行入口 claude update——官方文档对后者的说明是一句话:"Update to latest version"。原生安装(native install)的 Claude Code 默认在后台自动更新,/update / claude update 用来手动提前触发这一过程。
版本要求: 任意现代版本均可用(claude --version 可确认)。无需额外订阅。注意更新行为取决于安装方式:原生安装支持自动更新与 claude update;Homebrew / WinGet / Linux 包管理器安装默认不走 Claude Code 的自动更新(见运行约束)。
会话内直接键入:
/update
等价的命令行形式(会话外、脚本、CI 都可用):
claude update
官方说明:"To apply an update immediately without waiting for the next background check, run claude update。" 更新在后台下载安装,下次启动 Claude Code 时生效。
如果只是想确认"最近一次更新尝试的结果",用:
claude doctor
claude doctor 会显示最近一次更新的结果以及可用的修复建议。
更新行为由若干 settings.json 字段与环境变量控制,/update 与后台自动更新都遵守这些配置。
autoUpdatesChannel{ "autoUpdatesChannel": "stable" }
| 取值 | 含义 |
|---|---|
"latest"(默认) | 新版本一发布即收到 |
"stable" | 使用约一周前的版本,跳过含重大回归的发布 |
可通过 /config → Auto-update channel 切换。claude update 会按当前通道拉取版本。企业可用 managed settings 强制统一通道。
minimumVersion{ "autoUpdatesChannel": "stable", "minimumVersion": "2.1.100" }
后台自动更新与 claude update 都不会安装低于此值的版本。从 latest 切到 stable 时,若当前版本更新,系统会提示你"留在当前版本"(此举把 minimumVersion 钉到该版本)还是允许降级;切回 latest 会清除该钉子。
DISABLE_AUTOUPDATER{ "env": { "DISABLE_AUTOUPDATER": "1" } }
DISABLE_AUTOUPDATER 只停掉后台检查,claude update 和 claude install 仍然可用。若要连手动更新一并封死(自建分发场景),改设 DISABLE_UPDATES。
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATEHomebrew / WinGet 安装默认不自动更新。设 CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE 为 1 后,Claude Code 会在有新版本时后台替你跑对应的升级命令,成功后提示重启。
| 约束 | 说明 |
|---|---|
| 更新延迟生效 | 后台下载安装后,下次启动才切换到新版本,不会热替换当前进程 |
仅原生安装走 claude update | Homebrew / WinGet / apt / dnf / apk 安装默认不通过 Claude Code 自更新,需各自的升级命令 |
npm 安装用 @latest | npm 全局安装升级用 npm install -g @anthropic-ai/claude-code@latest;避免 npm update -g(受原始 semver 范围约束,可能不升到最新) |
受 minimumVersion 约束 | 不会安装低于下限的版本 |
受 requiredMaximumVersion 约束 | managed settings 设了上限时,更新不会越过该上限 |
| npm 全局目录不可写则失败 | npm 全局安装若目录不可写无法自更新,启动时一次性提示,claude doctor 列出修复方式 |
各安装方式的手动升级命令:
| 安装方式 | 手动升级 |
|---|---|
| 原生 / native | claude update |
| Homebrew | brew upgrade claude-code(或 claude-code@latest) |
| WinGet | winget upgrade Anthropic.ClaudeCode |
| apt | sudo apt update && sudo apt upgrade claude-code |
| dnf | sudo dnf upgrade claude-code |
| apk | apk update && apk upgrade claude-code |
| npm | npm install -g @anthropic-ai/claude-code@latest |
/update(claude update) | claude install [version] | 后台自动更新 | |
|---|---|---|---|
| 作用 | 立即升到当前通道最新版 | 安装/重装指定版本或通道 | 启动时及运行中定期检查 |
| 可指定版本 | 否(跟随通道) | 是(2.1.118 / stable / latest) | 否 |
| 何时生效 | 下次启动 | 安装完成后 | 下次启动 |
| 是否需手动触发 | 是 | 是 | 否 |
受 DISABLE_AUTOUPDATER 影响 | 否(仍可用) | 否 | 是(被停掉) |
安装某个具体版本号或在通道间切换,用
claude install 2.1.89/claude install stable,而不是claude update——后者只会拉当前通道的最新版。
/update 不等后台轮询claude update 保证用最新版跑/config 设 autoUpdatesChannel: "stable" 后跑一次 claude update 对齐到稳定版claude doctor 看最近一次更新尝试的结果与修复建议claude install 2.1.89 装指定版本,配合 minimumVersion 防止被自动降级更新不是即时热替换:/update 后当前会话仍跑旧版,必须重启 Claude Code 新版本才生效。
包管理器安装不走 claude update:Homebrew / WinGet / apt / dnf / apk 装的,默认不通过 Claude Code 自更新,要用各自的升级命令(或设 CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 让它代跑)。
DISABLE_AUTOUPDATER 不等于禁掉一切更新:它只停后台检查,claude update / claude install 仍能手动升级;要全封死得用 DISABLE_UPDATES。
npm 别用 npm update -g:它受原始 semver 范围约束,可能不会升到最新发布;改用 npm install -g @anthropic-ai/claude-code@latest。
minimumVersion 会拦更新:钉了下限后,低于它的版本无论自动还是 claude update 都装不上;切通道时若选"留在当前版本"会悄悄把下限钉到当前版。
| 操作 | 效果 |
|---|---|
DISABLE_AUTOUPDATER=1 | 停掉后台自动检查,手动更新仍可用 |
DISABLE_UPDATES(env-vars) | 封死所有更新路径,含手动 |
minimumVersion / requiredMaximumVersion | 限定可安装的版本范围 |