前言
Claude Code 是 Anthropic 官方推出的终端 AI 编码代理(CLI 工具),它能直接在你的项目目录里读懂代码库、写/改代码、运行 git、调试、执行 bash 命令等,体验非常接近'和 Claude 一起在终端里编程'。
目前最推荐的安装方式(按稳定性和易用性排序):
| 方式 | 优点 | 缺点 | 适用人群 | 推荐指数 |
|---|---|---|---|---|
| 1. 一行 curl 脚本(官方推荐) | 最快、无需 Node.js、原生二进制 | 需要信任官方脚本 | 所有人 | ★★★★★ |
| 2. Homebrew cask | 方便更新、卸载 | 需要先装 Homebrew | Homebrew 用户 | ★★★★☆ |
| 3. npm 全局安装 | 灵活、可指定版本 | 需要 Node.js 18+ | 已有 Node 环境 | ★★★★ |
方式一:最简单一行命令(强烈推荐)
打开 Terminal(Spotlight 搜 Terminal 即可),直接运行:
curl -fsSL https://claude.ai/install.sh | bash
- 脚本会自动下载最新稳定版(native binary,无需 Node.js)
- 安装完成后会自动添加到 PATH
- 可能需要输入密码(sudo)来移动二进制文件到 /usr/local/bin
验证安装:
claude --version # 应该输出类似 2.1.x 或更高版本
常见问题解决:
- 命令不存在?重启 Terminal 或运行
source ~/.zshrc(或source ~/.bash_profile) - 想装最新开发版:
curl -fsSL https://claude.ai/install.sh | bash -s latest - 想装指定版本:
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.2
方式二:Homebrew 安装(如果你已经用 brew 管理软件)
# 如果还没装 Homebrew,先装它(一行命令)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装 Claude Code
brew install --cask claude-code
# 更新
brew upgrade claude-code
验证同上:claude --version
方式三:npm 全局安装(适合已有 Node.js 环境)
# 确保 Node.js >= 18(推荐 20+)
node -v
# 全局安装(推荐避免 sudo)
npm install -g @anthropic-ai/claude-code
# 如果提示权限问题,先设置 npm 全局目录(推荐)
mkdir ~/.npm-global
npm config prefix
>> ~/.zshrc
~/.zshrc
npm install -g @anthropic-ai/claude-code


