【Mac 上命令行安装 Claude Code】（Claude 的终端版 AI 编程助手）完整指南

文章目录

- 前言
- - 方式一：最简单一行命令（强烈推荐）
  - [方式二：Homebrew 安装（如果你已经用 brew 管理软件）](#方式二：Homebrew 安装（如果你已经用 brew 管理软件）)
  - [方式三：npm 全局安装（适合已有 Node.js 环境）](#方式三：npm 全局安装（适合已有 Node.js 环境）)
  - [首次运行 & 认证（所有方式通用）](#首次运行 & 认证（所有方式通用）)
  - 推荐使用技巧

前言

若对您有帮助的话，请点赞收藏加关注哦，您的关注是我持续创作的动力！有问题请私信或联系邮箱：funian.gm@gmail.com

Claude Code 是 Anthropic 官方推出的终端 AI 编码代理 （CLI 工具），它能直接在你的项目目录里读懂代码库、写/改代码、运行 git、调试、执行 bash 命令等，体验非常接近"和 Claude 一起在终端里编程"。

目前（2026年1月）最推荐的安装方式（按稳定性和易用性排序）：

方式	优点	缺点	适用人群	推荐指数
1. 一行 curl 脚本（官方推荐）	最快、无需 Node.js、原生二进制	需要信任官方脚本	所有人	★★★★★
2. Homebrew cask	方便更新、卸载	需要先装 Homebrew	Homebrew 用户	★★★★☆
3. npm 全局安装	灵活、可指定版本	需要 Node.js 18+	已有 Node 环境	★★★★

方式一：最简单一行命令（强烈推荐）

打开 Terminal（Spotlight 搜 Terminal 即可），直接运行：

bash 复制代码

curl -fsSL https://claude.ai/install.sh | bash

脚本会自动下载最新稳定版（native binary，无需 Node.js）
安装完成后会自动添加到 PATH
可能需要输入密码（sudo）来移动二进制文件到 /usr/local/bin

验证安装：

bash 复制代码

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 管理软件）

bash 复制代码

# 如果还没装 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 环境）

bash 复制代码

# 确保 Node.js >= 18（推荐 20+）
node -v

# 全局安装（推荐避免 sudo）
npm install -g @anthropic-ai/claude-code

# 如果提示权限问题，先设置 npm 全局目录（推荐）
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

# 再安装
npm install -g @anthropic-ai/claude-code

首次运行 & 认证（所有方式通用）

bash 复制代码

# 进入你的项目目录
cd ~/Projects/my-repo

# 启动 Claude Code
claude

第一次会打开浏览器让你登录 Anthropic 账号（Claude Pro/Max 订阅或 API Key 均可）
推荐用 Claude Pro（ $20/月）或 Max（$ 100/月），有更高的 token 限额和 Opus 模型
登录后会自动创建 ~/.claude/ 目录存放配置

常用命令速查（启动后在 claude 里输入）：

命令	作用
/help	显示所有斜杠命令
/model	切换模型（sonnet / opus）
/clear	清屏
/exit	退出回到普通终端
/terminal-setup	优化终端（支持 Shift+Enter 换行等）
/install-github-app	安装 GitHub App，让 Claude 自动 review PR

【Mac 上命令行安装 Claude Code】（Claude 的终端版 AI 编程助手）完整指南

文章目录

前言

方式一：最简单一行命令（强烈推荐）

方式二：Homebrew 安装（如果你已经用 brew 管理软件）

方式三：npm 全局安装（适合已有 Node.js 环境）

首次运行 & 认证（所有方式通用）

推荐使用技巧