Claude Code 自动更新失败, 命令失效问题处理修复 Claude：重装最新版 npm i -g @anthro

# Claude CLI 修复记录

> 日期：2025-08-15  
> 系统：macOS + zsh  
> 现象：执行 `claude doctor` 报 `zsh: command not found: claude`，随后出现 `Auto-update failed · Try claude doctor or npm i -g` 的提示。

---

## 1 问题复盘

1. **安装过 Claude CLI**，但终端找不到命令。  
2. **首次报错**：`command not found: claude`  
3. **再次执行时**：`Auto-update failed · Try claude doctor or npm i -g`  
   说明可执行文件被升级脚本删除，导致 shell 无法定位。

---

## 2 解决步骤

| 步骤 | 操作 | 说明 |
|---|---|---|
| 2.1 清理残留 | `sudo rm -rf "$(npm root -g)/@anthropic-ai/claude-code"` | 删除可能损坏的旧包 |
| 2.2 重装 | `npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com` | 全局重新安装最新版 |
| 2.3 验证 | `claude --version` | 输出 `1.0.81 (Claude Code)` |
| 2.4 关闭自动更新 | `claude config set autoUpdates false --global` | 避免再次因升级失败丢失可执行文件 |
| 2.5 确认 | `claude config get autoUpdates --global` | 返回 `false` |

---

## 3 结果

- `claude doctor` 正常输出检查报告。  
- 自动更新已全局禁用，后续不会因升级脚本导致命令丢失。

---

## 4 备用方案（以后若再遇到）

- **PATH 问题**：  
  ```bash
  echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

Homebrew 版本冲突：
```
brew upgrade anthropic/tap/claude
```

5 一键脚本（留档）

#!/usr/bin/env bash
set -e
sudo rm -rf "$(npm root -g)/@anthropic-ai/claude-code"
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
claude config set autoUpdates false --global
echo "✅ Claude CLI 已修复并禁用自动更新"

保存为 fix-claude.sh，chmod +x fix-claude.sh 即可一键执行。