MacBook 安装 Claude Code 完整教程（2026 最新版）

Claude Code 是 Anthropic 官方推出的终端 AI 编程助手，能帮你写代码、调试、重构、生成文档。本文详细介绍在 MacBook 上安装 Claude Code 的三种方法，从零开始，手把手教学。

Claude Code 是什么

简单来说，Claude Code 是一个运行在终端里的 AI 助手。与 ChatGPT 网页版不同，它能直接访问你的文件系统、读写代码文件、执行终端命令，非常适合开发者使用。

能做什么：

读写、修改代码文件
执行终端命令
Git 操作（提交、推送、合并）
搜索代码库
创建项目、调试 bug
生成文档和注释

---

第一步：检查系统要求

安装前确认你的 Mac 满足以下条件：

项目	要求
操作系统	macOS 10.15 (Catalina) 或更高
芯片	Intel 或 Apple Silicon (M1/M2/M3/M4)
内存	至少 4GB，推荐 8GB
Node.js	v18.0.0 或更高

检查方法：

查看 macOS 版本：点击左上角苹果菜单 → 关于此 Mac

查看芯片类型：同一界面会显示「芯片」或「处理器」

检查 Node.js 版本：打开终端，输入

   node --version

如果显示 v18.x.x 或更高，说明已满足要求。

如果没有安装 Node.js：

推荐使用 Homebrew 安装（见下方 Homebrew 安装步骤）。

---

第二步：安装 Node.js（如果需要）

Claude Code 依赖 Node.js 运行。如果上一步检查发现没有安装，按以下步骤安装。

方法一：使用 Homebrew 安装（推荐）

1. 检查是否已安装 Homebrew

打开终端，输入：

brew --version

如果显示版本号（如 Homebrew 4.x.x），说明已安装，跳过此步。

如果没有，安装 Homebrew：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装过程中可能需要输入 Mac 密码，等待完成。

2. 使用 Homebrew 安装 Node.js

brew install node

3. 验证安装

node --version
npm --version

两个命令都有输出版本号即可。

方法二：直接下载安装包

访问 Node.js 官网
下载 macOS 安装包（.pkg 文件）
双击运行，按提示安装

---

第三步：安装 Claude Code

有三种安装方式，推荐第一种。

方法一：官方安装脚本（推荐）

这是官方推荐的安装方式，会自动配置并支持后台自动更新。

1. 打开终端

按 Command + Space 搜索「终端」并打开。

2. 运行安装命令

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

或者：

source <(curl -sSL https://claude.ai/install)

3. 等待安装完成

终端会显示进度，最后显示 Installation complete! 表示安装成功。

方法二：Homebrew 安装

如果你已经安装了 Homebrew，可以用这个方式：

brew install claude-code

优点：可以通过 brew upgrade claude-code 轻松升级

方法三：npm 安装

npm install -g @anthropic-ai/claude-code

---

第四步：验证安装

安装完成后，验证 Claude Code 是否正常工作：

1. 检查版本

claude --version

如果显示版本号（如 claude 1.0.x），说明安装成功。

2. 首次运行

在终端输入：

claude

如果看到欢迎信息或提示输入 API 密钥，说明安装完成。

---

第五步：配置 API 密钥

Claude Code 需要 API 密钥才能使用。有两种方式获取：

方式一：使用 Claude 订阅账号（推荐新手）

订阅 Claude Pro（$20/月）或 Claude Max（$100/月）
订阅账号包含 API 使用额度
运行 claude 后选择登录方式，输入 Anthropic 账号即可

方式二：单独购买 API 额度

访问 Anthropic API 官网
注册账号并充值
获取 API 密钥（格式：sk-ant-api03-xxxxx）
运行 claude 后选择 API 模式，粘贴密钥

首次配置流程：

$ claude
? Select a login method:
  ▸ Use Anthropic account (Pro/Max subscription)
    Use API key
    Continue without logging in (read-only)

选择 Use API key
粘贴你的 API 密钥
按回车确认

---

第六步：开始使用

安装配置完成后，开始你的第一次使用。

基本用法

启动交互模式：

claude

让 Claude 读懂你的项目：

cd ~/Projects/my-app
claude

Claude 会分析当前目录的文件结构，你可以直接问它问题或让它帮忙写代码。

常用命令

命令	说明
`claude`	启动交互模式
`claude -p "指令"`	单次执行指令（不进入交互）
`claude --help`	查看帮助
`claude --version`	查看版本

单次执行示例：

claude -p "创建一个 Python 快速排序函数"

首次使用建议

创建一个测试项目

   mkdir ~/test-claude
   cd ~/test-claude
   claude

让它帮你写第一个文件

   帮我创建一个 hello.py 文件，输出 "Hello, Claude!"

让它解释代码

   解释一下这个项目的结构

---

常见问题

问题一：安装失败，提示「curl: command not found」

原因：macOS 默认没有安装 curl 或路径问题

解决：使用完整路径或先安装命令行工具：

xcode-select --install

问题二：安装成功但运行报错「command not found」

原因：安装路径未添加到 PATH

解决：在 ~/.zshrc 或 ~/.bash_profile 中添加：

export PATH="/usr/local/bin:$PATH"

然后运行 source ~/.zshrc

问题三：API 密钥无效

原因：密钥过期、额度用完或格式错误

解决：

确认密钥格式正确（以 sk-ant- 开头）
登录 Anthropic Console 检查额度
如果是新密钥，确认已激活

问题四：提示「Permission denied」

解决：给 CLI 添加执行权限：

chmod +x /usr/local/bin/claude

问题五：如何升级到最新版本？

方法一（推荐）：重新运行安装脚本

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

方法二：如果用 Homebrew 安装

brew upgrade claude-code

方法三：如果用 npm 安装

npm update -g @anthropic-ai/claude-code

问题六：卸载 Claude Code

Homebrew 安装：

brew uninstall claude-code

npm 安装：

npm uninstall -g @anthropic-ai/claude-code

手动删除：

rm -f /usr/local/bin/claude
rm -rf ~/.config/claude

---

进阶配置

配置默认模型

在 ~/.claude 目录创建配置文件 settings.json：

{
  "model": "claude-opus-4-7",
  "max_tokens": 4096
}

可选模型（按能力排序）：

claude-opus-4-7 — 最强，适合复杂任务
claude-sonnet-4-6 — 平衡之选
claude-haiku-4-5 — 快速响应

设置项目级规则

在项目根目录创建 CLAUDE.md，Claude 会自动读取并遵守其中的规则。

例如：

# 项目规则

- 使用 TypeScript，禁止 JavaScript
- 遵循 ESLint 规范
- 组件放在 src/components 目录

配置 API 端点（可选）

如果你使用第三方 API 代理：

export ANTHROPIC_API_URL="https://your-proxy.com"

---

总结

安装步骤回顾：

1. 检查系统要求（macOS 10.15+、Node.js 18+）
       ↓
2. 安装 Node.js（如需要）
       ↓
3. 运行官方安装脚本
   curl -fsSL https://claude.ai/install.sh | bash
       ↓
4. 验证安装
   claude --version
       ↓
5. 配置 API 密钥
       ↓
6. 开始使用！

推荐安装方式：官方安装脚本，一行命令搞定：

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

---

如果安装过程中遇到问题，欢迎在评论区留言。

{
 "env": {
 "ANTHROPIC_AUTH_TOKEN": "sk-RCMUGlaljEC3khKmV7g7UGml5bgtbXx4jWFwoPY0h7L9dnyc",
 "ANTHROPIC_BASE_URL": "https://llm.aiload.top",
 "ANTHROPIC_MODEL": "MiniMax-M2.7",
 "ANTHROPIC_SMALL_FAST_MODEL": "MiniMax-M2.7-highspeed",
 "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2.7-highspeed",
 "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M2.7-highspeed",
 "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "6000",
 "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
 },
 "permissions": {
 "allow": [],
 "deny": []
 },
 "model": "MiniMax-M2.7-highspeed"
 }