Claude Code macOS 安装与更新指南

一、Native 安装：Run claude install

1. 在终端输入：

claude install

2. 如果安装后显示：Native installation exists but ~/.local/bin is not in your PATH.，则需要修改 PATH，将 ~/.local/bin 添加到优先级最高位置。

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

命令说明：

• echo '...'：输出引号内的文本。
• >> ~/.zshrc：将输出追加到 ~/.zshrc 文件末尾（>> 为追加，> 为覆盖）。
• source ~/.zshrc：在当前 Shell 中重新加载配置文件，使修改立即生效，无需重启终端。
• export PATH="$HOME/.local/bin:$PATH"：设置并导出环境变量 PATH。
  • export PATH=：设置并导出变量，不加 export 则仅在当前 Shell 生效。
  • $HOME/.local/bin：将用户主目录下的 .local/bin 目录加入搜索路径。
  • :$PATH：保留原有 PATH 内容，用冒号分隔。

二、npm 安装

1. 安装 Node.js

# 更新 Homebrew
brew update
# 升级所有已安装的软件包
brew upgrade
# 安装 Node.js（会同时安装最新稳定版 + npm）
brew install node

2. 安装/更新 Claude Code

# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

注意： 更新命令与安装命令相同，npm install -g 会自动检测已安装版本，如有新版本则覆盖更新。

2.1. 检查当前版本和最新版本

# 查看当前安装的版本
claude --version
# 查看 npm 上的最新版本
npm show @anthropic-ai/claude-code version

3. Claude Code 自带更新命令：claude update

Claude Code 支持独立于 npm 的更新命令，直接输入即可更新。

claude update