终端入门：iTerm2 + Homebrew + Node.js

从零开始学会使用 Mac 终端——掌握基础操作之后，安装 Claude Code 就是一行命令的事。

iTerm2

安装更好用的终端

基础命令

快速上手常用操作

Homebrew + Node

安装开发工具链

什么是终端

终端（Terminal）是一个文字界面，让你通过输入命令来操作电脑。Mac 自带的「终端」app 已经够用，但 iTerm2 功能更强、体验更好，是 Mac 开发者的首选。

为什么要用终端

Claude Code 是一个命令行工具，必须在终端里运行。在学会用终端之后，安装和使用 Claude Code 只需要几分钟。

安装 iTerm2

前往 iTerm2 官网 下载最新版，拖入「应用程序」文件夹即可。

安装完打开 iTerm2，你会看到一个黑色（或白色）的窗口，光标在等待输入——这就是终端。

导入推荐配置

作者整理了一套开箱即用的 iTerm2 配置，主要针对以下使用习惯做了调整：

• Option 键按字跳词：Option+← / Option+→ 按单词前后跳，编辑命令时非常高效
• Option 键作为 Meta 键：让 bash/zsh 的快捷键（如 Option+D 删除后一个词）正常工作
• Hotkey Window 配置：一个专用的下拉式终端窗口，随时弹出、随时隐藏

下载配置文件

在终端执行以下命令，把配置文件下载到桌面：

curl -o ~/Desktop/iTerm2-Profiles.json \
  "https://raw.githubusercontent.com/vectorsss/my-dot-file/refs/heads/main/iterm2/iTerm2-Profiles.json"

导入到 iTerm2

打开 iTerm2 → 菜单栏 iTerm2 → Settings → Profiles，点击左下角 Other Actions → Import JSON Profiles…，选择刚才下载到桌面的 iTerm2-Profiles.json。

设为默认（可选）

导入后你会看到 Default 和 Hotkey Window 两个 Profile。选中 Default，点击左下角星号将其设为默认，新窗口会自动使用此配置。

配置了什么

功能	快捷键	说明
向前跳一个词	Option+→	光标跳到下一个单词的开头
向后跳一个词	Option+←	光标跳到上一个单词的开头
删除后一个词	Option+D	删除光标后面的一个单词
删除前一个词	Option+Backspace	删除光标前面的一个单词

基础命令速查

打开 iTerm2，试试输入这些命令（每行输完按 Enter）：

目录导航

pwd          # 显示当前所在目录（Print Working Directory）
ls           # 列出当前目录的文件
ls -la       # 列出所有文件，含隐藏文件和权限信息
cd ~/Desktop # 进入桌面目录
cd ..        # 返回上一级目录
cd ~         # 回到家目录（即 /Users/你的用户名）

文件操作

mkdir my-project      # 创建文件夹
touch hello.txt       # 创建空文件
cp hello.txt copy.txt # 复制文件
mv hello.txt new.txt  # 重命名 / 移动文件
rm new.txt            # 删除文件（不可恢复！）
rm -rf my-folder      # 删除文件夹（不可恢复！）

查看与编辑

cat hello.txt         # 打印文件内容
open .                # 在 Finder 里打开当前目录
open hello.txt        # 用默认程序打开文件

其他常用

clear                 # 清空屏幕（或按 Control+L）
history               # 查看历史命令
which node            # 查找命令的实际路径
echo $PATH            # 查看 PATH 环境变量

键盘快捷键

这些快捷键在终端里每天都用得到，熟练之后效率翻倍：

光标移动

快捷键	功能
Control+A	跳到行首
Control+E	跳到行尾
Option+←	向前跳一个词（iTerm2 配置生效后）
Option+→	向后跳一个词（iTerm2 配置生效后）

编辑

快捷键	功能
Control+U	删除光标前的所有内容
Control+K	删除光标后的所有内容
Control+W	删除前一个单词
Option+Backspace	删除前一个单词（iTerm2 配置生效后）

进程控制

快捷键	功能
Control+C	中断当前程序（强制停止）
Control+D	发送 EOF，通常等同于退出当前 shell
Control+Z	暂停当前程序，放入后台

历史记录

快捷键	功能
↑ / ↓	在历史命令中前后翻
Control+R	搜索历史命令（输入关键词实时匹配）

iTerm2 窗口

快捷键	功能
Command+T	新建标签页
Command+W	关闭当前标签页
Command+D	垂直分屏
Command+Shift+D	水平分屏
Command+[ / Command+]	切换分屏

安装 Homebrew

Homebrew 是 Mac 上最常用的包管理器，用来安装各种开发工具——类似手机上的应用商店，但面向命令行工具。

在 iTerm2 里执行：

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

安装过程中会提示输入系统密码（不显示字符，正常输入按 Enter），以及安装 Xcode Command Line Tools——全部按提示确认即可，整个过程约 5-15 分钟。

验证安装

brew --version
# 输出类似：Homebrew 4.x.x

Apple Silicon（M 系列芯片）用户

安装完 Homebrew 后，M1/M2/M3/M4 Mac 需要额外执行一步，将 Homebrew 加入 PATH：

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

安装脚本结束时会有提示，按照提示执行即可。

常用 brew 命令

brew install git          # 安装软件
brew upgrade git          # 升级软件
brew uninstall git        # 卸载软件
brew search node          # 搜索软件包
brew list                 # 列出已安装的包
brew update               # 更新 Homebrew 自身
brew doctor               # 检查环境问题

安装 Node.js

Node.js 是运行 Claude Code 的必要环境。推荐用 nvm（Node Version Manager）来管理 Node.js 版本，方便将来切换。

方式一：nvm（推荐）

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

# 让 nvm 在当前终端生效（或重启 iTerm2）
source ~/.zshrc

# 安装最新 LTS 版本的 Node.js
nvm install --lts

# 验证安装
node --version   # 应输出 v20.x.x 或更高
npm --version    # npm 随 Node.js 一起安装

方式二：Homebrew

如果只需要一个版本，Homebrew 安装更简单：

brew install node

# 验证
node --version
npm --version

Claude Code 要求 Node.js 18+

Claude Code 要求 Node.js 18 或 20 LTS 及以上版本。用 node --version 确认版本满足要求。

配置 npm 镜像（国内用户）

如果 npm 安装速度较慢，可以切换到国内镜像：

npm config set registry https://registry.npmmirror.com

验证镜像是否生效：

npm config get registry
# 应输出：https://registry.npmmirror.com

下一步：安装 Claude Code

环境准备好了——有了终端、Homebrew 和 Node.js，安装 Claude Code 只需一行命令。

Claude Code 接入指南

安装 Claude Code 并配置 TokenPilot，开始 AI 辅助编程

常见问题

Q: 终端显示 command not found: brew

说明 Homebrew 没有加入 PATH。Apple Silicon Mac 执行：

eval "$(/opt/homebrew/bin/brew shellenv)"

Intel Mac 执行：

eval "$(/usr/local/bin/brew shellenv)"

然后把这行写入 ~/.zshrc 或 ~/.zprofile 使其持久生效。

---

Q: nvm: command not found

nvm 安装后需要重启终端，或手动 source 配置文件：

source ~/.zshrc
# 如果还不行，试试：
source ~/.nvm/nvm.sh

---

Q: npm install 很慢或超时

切换到国内镜像：

npm config set registry https://registry.npmmirror.com

---

Q: Option 键跳词没有生效

确认已导入 Profile 并且 Default Profile 处于激活状态。在 iTerm2 Settings → Profiles → Keys → General 里，检查 Left/Right Option key 是否设置为 Esc+。