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

文章目录

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

前言

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

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

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

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

打开 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 set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

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

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

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

# 启动 Claude Code
claude

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

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

推荐使用技巧

卸载方式（以防万一）：

• curl 安装：claude uninstall
• Homebrew：brew uninstall –cask claude-code
• npm：npm uninstall -g @anthropic-ai/claude-code