MacBook Pro Intel 芯片版：Node.js + Claude Code + OpenCode 完全安装指南

适配 MacBook Pro A2141 (Intel Core i7/i9)，从零到上手，一条龙教程

大家好！这篇文章专门为使用 MacBook Pro A2141（Intel 芯片） 的开发者准备。无论你是前端、后端还是全栈，跟着这份教程，30分钟内搞定全套 AI 编程环境！

---

📋 目录

1. 环境检查
2. [安装 Node.js](#安装 Node.js)
3. [安装 Claude Code](#安装 Claude Code)
4. [安装 OpenCode](#安装 OpenCode)
5. [配置 API 密钥](#配置 API 密钥)
6. 验证与测试
7. 常见问题解决

---

一、环境检查

1.1 确认你的 Mac 型号

点击左上角苹果图标 → 「关于本机」，确认显示：

• 型号：MacBook Pro (16-inch, 2019) 或类似
• 芯片 ：Intel Core i7 或 i9（不是 Apple M 系列）
• 系统版本：推荐 macOS 12 Monterey 或更高版本

1.2 打开终端

• 按 Command + 空格，输入「终端」或「Terminal」，回车打开
• 建议将终端固定在程序坞，后续操作都在这里进行

1.3 检查是否已安装 Node.js

node -v
npm -v

如果显示版本号（如 v18.x.x 和 9.x.x），说明已安装，可以跳过 Node.js 安装步骤。

如果显示 command not found，请继续往下看。

---

二、安装 Node.js

⚠️ 重要提醒 ：OpenCode 必须依赖 Node.js 18.0 或更高版本。Claude Code 虽然可以用原生脚本绕过，但为了两个工具都能用，强烈建议安装 Node.js。

方法一：官方安装包（新手首选）⭐

1. 访问官网：https://nodejs.org/

2. 选择版本 ：点击左侧 LTS 版本 （目前是 v20.x 或 v22.x），不要点 Current，LTS 更稳定

3. 下载文件 ：网站会自动识别你的 Mac，提供 .pkg 安装包（Intel 芯片会下载 x64 版本）

4. 双击安装 ：

   • 打开下载的 node-vXX.X.X.pkg
   • 点击「继续」→「同意」→「安装」
   • 输入电脑密码
   • 点击「关闭」完成

5. 验证安装 （重启终端后执行）：

   node -v   # 应显示 v20.12.1 或类似
   npm -v    # 应显示 10.x.x 或类似

方法二：Homebrew 安装（推荐熟悉命令行的用户）

如果你还没安装 Homebrew，先执行：

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

安装完成后，执行：

brew update
brew install node

验证：

node -v
npm -v

方法三：nvm 安装（多版本管理，进阶推荐）

nvm 可以在不同项目间切换 Node.js 版本，非常实用。

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 重启终端，或执行以下命令使 nvm 生效
source ~/.zshrc   # 如果你用的是 zsh（macOS 默认）
source ~/.bash_profile  # 如果你用的是 bash

# 安装最新 LTS 版本
nvm install --lts

# 设置为默认版本
nvm alias default 'lts/*'

# 验证
node -v
nvm current

---

三、安装 Claude Code

Claude Code 是 Anthropic 官方出品的终端 AI 编程助手，支持 Mac、Linux、Windows。

方法一：原生脚本安装（推荐，无需 Node.js）⭐

这是官方推荐的方式，最简单直接，不需要依赖 Node.js 环境：

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

安装脚本会自动：

• 检测你的 Mac 芯片（Intel 或 Apple Silicon）
• 将 claude 命令添加到 PATH
• 配置自动更新

安装完成后，重启终端，然后验证：

claude --version

方法二：Homebrew 安装

如果你已经是 Homebrew 用户，可以用这个方式：

brew install --cask claude-code

验证：

claude --version

方法三：npm 安装（需要 Node.js）

如果前面已经装了 Node.js，也可以用 npm：

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

---

四、安装 OpenCode

OpenCode 是一个开源的 AI 编程 Agent，功能与 Claude Code 类似，但完全开源，支持多种大模型。

⚠️ 注意 ：OpenCode 必须依赖 Node.js，请确保已按第二章完成 Node.js 安装。

方法一：原生脚本安装（推荐）⭐

curl -fsSL https://opencode.ai/install | bash

安装脚本会自动：

• 检测你的系统架构（Intel Mac 会自动选择 x64 版本）
• 安装到 $HOME/bin 或 $HOME/.opencode/bin
• 将 opencode 命令添加到 PATH

安装后重启终端，验证：

opencode --version

方法二：Homebrew 安装

brew install opencode

或者使用第三方 tap（更新更及时）：

brew install anomalyco/tap/opencode

方法三：npm 安装

npm install -g opencode-ai@latest

验证：

opencode --version

方法四：桌面版（Beta 测试版）

OpenCode 还提供了桌面版应用，适合不喜欢命令行的用户：

• Intel Mac 下载 ：https://opencode.ai/download → 选择 opencode-desktop-darwin-x64.dmg

下载后双击安装即可。

---

五、配置 API 密钥

两个工具都需要配置 AI 模型的 API 密钥才能工作。

5.1 Claude Code 配置

Claude Code 默认使用 Anthropic 的 Claude 模型，需要配置 API Key。

方式一：临时设置（每次终端会话）

export ANTHROPIC_AUTH_TOKEN="sk-你的API密钥"

方式二：永久配置（推荐）

将以下内容添加到你的 shell 配置文件（~/.zshrc 或 ~/.bash_profile）：

echo 'export ANTHROPIC_AUTH_TOKEN="sk-你的API密钥"' >> ~/.zshrc
source ~/.zshrc

获取 API Key 的途径

1. Anthropic 官方：https://console.anthropic.com/（需要国外信用卡）
2. OpenRouter：聚合平台，支持支付宝充值，可用 Claude 模型
3. 阿里云百炼：国内可用，按量付费

5.2 OpenCode 配置

OpenCode 支持多种模型提供商，非常灵活。

方式一：临时设置

export OPENCODE_API_KEY="你的API密钥"
export OPENCODE_DEFAULT_MODEL="gpt-4"  # 或 claude-3-sonnet 等

方式二：配置文件

在项目根目录或用户目录创建 .opencode/config.json：

{
  "provider": "openai",
  "apiKey": "sk-你的密钥",
  "model": "gpt-4",
  "baseUrl": "https://api.openai.com/v1"
}

支持的模型提供商

提供商	配置示例
OpenAI	provider: "openai", model: gpt-4
Anthropic	provider: "anthropic", model: claude-3-sonnet
本地模型 (Ollama)	provider: "ollama", model: codellama
阿里云百炼	provider: "bailian", apiKey: sk-xxx
OpenRouter	provider: "openrouter", baseUrl: https://openrouter.ai/api

---

六、验证与测试

6.1 测试 Node.js 环境

node -e "console.log('Node.js 工作正常！')"
# 应输出：Node.js 工作正常！

6.2 测试 Claude Code

# 创建一个测试目录
mkdir ~/claude-test && cd ~/claude-test

# 启动 Claude Code
claude

首次启动会提示：

• 选择主题（直接回车选默认）
• 确认安全须知（回车）
• 信任工作目录（回车）

进入交互界面后，输入：

帮我写一个 Python 函数，计算斐波那契数列

如果能生成代码，说明配置成功。输入 exit 退出。

6.3 测试 OpenCode

# 创建测试目录
mkdir ~/opencode-test && cd ~/opencode-test

# 启动 OpenCode
opencode

进入交互界面后，输入：

用 JavaScript 写一个 Hello World 程序

如果能生成代码，说明配置成功。按 Ctrl+C 退出。

---

七、常见问题解决

7.1 命令找不到：command not found

原因：PATH 环境变量未包含工具安装路径。

解决方法：

# 检查 Claude Code 安装位置
which claude

# 如果没找到，重新加载 shell 配置
source ~/.zshrc
# 或
source ~/.bash_profile

# 如果还是不行，手动添加 PATH（以 OpenCode 为例）
echo 'export PATH="$HOME/.opencode/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

7.2 Node.js 版本过低

错误 ：Node.js 18.0 or higher is required

解决方法：使用 nvm 升级

nvm install 20
nvm use 20
nvm alias default 20

7.3 权限错误：Permission denied

解决方法：

# 修复 npm 全局目录权限
sudo chown -R $(whoami) /usr/local/lib/node_modules
sudo chown -R $(whoami) /usr/local/bin

# 或者用 nvm 避免权限问题

7.4 OpenCode 安装脚本卡住

解决方法：使用 npm 安装代替

npm install -g opencode-ai@latest

7.5 API 连接失败

检查：

1. API Key 是否正确
2. 网络是否正常（某些国外 API 需要代理）
3. 如果是国内模型，检查 baseUrl 配置

测试连接：

# Claude Code
claude --version
claude -p "测试连接"

# OpenCode
opencode --version
opencode run "测试连接"

---

八、快速参考卡片

工具	安装命令	验证命令	启动命令
Node.js	brew install node	node -v	-
Claude Code	`curl -fsSL https://claude.ai/install.sh	bash`	claude --version
OpenCode	`curl -fsSL https://opencode.ai/install	bash`	opencode --version

---

写在最后

恭喜！你已经成功在 MacBook Pro Intel 芯片上配置了 Node.js、Claude Code 和 OpenCode 全套 AI 编程环境。

后续建议：

• 多尝试两个工具，找到最适合你工作流
• Claude Code 适合复杂项目开发，OpenCode 适合开源定制和本地模型
• 可以配合 Cursor、VS Code 等 IDE 一起使用