Mac 安装教程：五步上手 Claude Code

本教程面向Mac 用户，按顺序完成五步即可使用 Claude Code。

安装流程总览

1. 装 Node.js（运行环境）
2. 装 Claude Code 本体
3. 装 CC Switch，配好 API
4. 装 Warp 终端（推荐）
5. 连接飞书cli

第一步：装 Node.js

Node.js 是 Claude Code 的运行环境，必须先装。

1.1 打开终端

按 Command + 空格，输入「终端」，回车；或从启动台 → 其他 → 终端 打开。

1.2 安装 Node.js

先装 Homebrew（Mac 软件管理器，只需装一次），安装脚本来自 Homebrew 官网：

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

关掉终端重新打开，再输入：

brew install node@22

如果不想用 Homebrew，也可以直接去 Node.js 官网 下载 macOS Installer 手动安装。

1.3 验证安装

node --version

看到 v22.x.x 即成功。

常见问题：

• 提示 command not found: brew → 输入 eval "$(/opt/homebrew/bin/brew shellenv)"
• 提示 command not found: node → 输入 brew link node@22

第二步：装 Claude Code

2.1 安装

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

• 提示 permission denied → 命令前加 sudo，输入电脑密码（输入时不显示字符，属于正常现象）
• 下载慢 → 先换源：npm config set registry https://registry.npmmirror.com

2.2 验证

claude --version

看到版本号即成功。

2.3 升级

Claude Code 更新频繁，建议每周执行一次：

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

第三步：装 CC Switch，配好 API

CC Switch 是桌面工具，用来管理 API 配置，免去手动改配置文件。

3.1 下载安装

推荐命令行安装：

brew tap farion1231/ccswitch
brew install --cask cc-switch

也可以手动安装：去 CC Switch Releases 页面 下载 macOS 版本，解压拖入「应用程序」。首次打开右键 → 打开 → 确认。

3.2 配置 API

打开 CC Switch：

1. 顶部切到 Claude 标签
2. 点右上角 + 添加新配置
3. 按下表填写信息
4. 点保存

3.3 启用配置

1. 在列表中点击刚添加的配置
2. 点「启用」—— 变成绿色高亮即生效
3. 可点「健康检查」验证连通性
4. 关掉终端重新打开即可使用

第四步（推荐）：装 Warp 终端

Warp 界面更清爽、支持智能补全，推荐使用。跳过此步不影响功能。

1. 访问 Warp 官网 下载安装
2. 打开 .dmg，拖入「应用程序」
3. 首次打开需注册账号（支持 GitHub 登录）

安装后打开 Warp（或系统自带终端），输入 claude 即可启动。

基本操作：

• 直接打字对话
• /help 查看帮助
• Ctrl + C 中断当前操作
• Ctrl + D 退出 Claude Code

第五步：连接飞书cli

安装飞书命令行工具（lark-cli），让 Claude Code 能操作飞书。按 飞书 CLI 官方 README 的推荐流程，直接复制下面这条命令执行：

npm install -g @larksuite/cli && npx skills add larksuite/cli -y -g && lark-cli config init && lark-cli auth login --recommend

这一条命令依次完成 4 件事，中间会弹出浏览器授权页，按提示点「授权」即可：

1. 安装 lark-cli（CLI 本体）
2. 安装飞书 AI Agent Skills 技能包（让 Claude Code 能操作飞书）
3. 首次初始化应用配置（没有飞书开放平台应用时按引导创建）
4. 登录并授权常用权限（--recommend 会自动勾选日历、文档、消息等常用 scope）

看到最后出现 Login successful 即全部完成。

如遇「权限错误」→ 命令前加 sudo。

如遇「下载慢」→ 先切国内源：npm config set registry https://registry.npmmirror.com，再重跑。

验证：试两个操作

创建飞书文档

启动 claude，输入：

帮我创建一篇飞书文档，标题叫"测试文档"，内容写一段简单介绍。

等待几秒，返回文档链接即成功。

查飞书日程

输入：

我今天有什么会议？

返回今日日程列表即成功。

常见问题速查

遇到问题？

截图问 AI（GPT / Gemini / 豆包等）或内部群提问，附上报错截图。