【Mac 上命令行安装 Claude Code】（Claude 的终端版 AI 编程助手）完整指南
文章目录
前言
若对您有帮助的话，请点赞收藏加关注哦，您的关注是我持续创作的动力！有问题请私信或联系邮箱：[email protected]
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 即可），直接运行：
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）npminstall -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 # 再安装npminstall -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 里输入）：
| 命令 | 作用 |
|---|---|
| /help | 显示所有斜杠命令 |
| /model | 切换模型（sonnet / opus） |
| /clear | 清屏 |
| /exit | 退出回到普通终端 |
| /terminal-setup | 优化终端（支持 Shift+Enter 换行等） |
| /install-github-app | 安装 GitHub App，让 Claude 自动 review PR |
推荐使用技巧
- 进入项目后直接 claude：它会自动加载项目上下文（文件树、CLAUDE.md 等）
- 创建 CLAUDE.md：在项目根目录放一个 Markdown 文件，写项目规范、编码风格、架构说明，Claude 会优先参考
- 并行代理：
claude --multi-agent可以同时跑多个 Claude 实例（Max 订阅更爽） - 调试神器：直接说“帮我 debug 这个错误” + 贴日志，Claude 会读文件、跑命令、改代码
卸载方式（以防万一）：
- curl 安装：
claude uninstall - Homebrew：
brew uninstall --cask claude-code - npm：
npm uninstall -g @anthropic-ai/claude-code
