前言

最近想试试 Claude Code 提升开发效率，但一看要海外账号、配置网络就头大——相信很多朋友和我一样。所以最近我把自己从安装到成功调用的全过程整理出来，尽量让每个步骤都清晰可操作，小白也能跟着走通。

正文

一、准备工作：安装 Node.js

Claude Code 依赖 Node.js 环境，最低要求 Node.js ≥18（建议选 LTS 版本，稳定性更好）。

方法一：官网下载（推荐）

直接访问 Node.js 官网，下载 macOS 的 LTS 版本，双击安装包按向导完成即可。

方法二：Homebrew 安装

如果习惯命令行，也可以用 Homebrew 安装：

brew install node

验证安装

安装完成后，打开终端输入以下命令，能显示版本号即成功：

node --version
# 输出示例：v20.11.0（版本号可能因安装版本不同略有差异）

npm --version
# 输出示例：10.2.4

二、安装 Claude Code

Node.js 就绪后，用 npm 全局安装 Claude Code：

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

验证安装

安装完成后，输入以下命令检查是否成功：

claude --version

如果终端显示版本信息，说明安装没问题。

三、配置 API 连接

Claude Code 需要 API 接口才能调用，我这次用了 88api 中转服务(https://api.88api.shop)，个人觉得较划算稳定，大家也可以用自己熟悉的。

获取 API Key 步骤：

1.注册登录后，点击 “API 令牌”

2.点击添加令牌

3. 创建令牌

名称随便写，没有含义，直接点击提交即可。

4. 获取 API KEY

获得 API Key 后请妥善保管，API Key 是你的身份凭证，等同于账号密码，切勿公开或分享给他人。

5. 点击“知道了”，可以看到我们刚才创建的，在这里也同样可以点击 复制 按钮去获取 API Key。

四、用 CC Switch 解决登录问题并配置模型

Claude Code 默认需要登录官方账号，对国内用户不太友好。用开源工具 CC Switch 可以快速切换和管理 AI 服务，无需手动改配置文件。

不明白没关系，直接跟着操作就行。

具体下载版本链接：https://github.com/farion1231/cc-switch/releases

1. 一直往下拉，拉到下面这个位置下载
   
2. 根据你的操作系统，下载对应的安装包。Linux、MacOS、Windows看文件名能区分。或点击 “show all 18 assets” 往下拉找更多的版本。

3. 在CC Switch主界面，点击「Claude code」图标，再点击「+」号添加配置

4. 选择「自定义配置」，填写：

• 供应商名称：随意填写
• API KEY：粘贴前面复制的 api密钥
• API请求地址：https://api.88api.shop/v1

5. 继续点击「高级选项」，配置模型，支持多模型切换。

在「模型」栏填写具体模型名称（比如我最近在用claude-sonnet-4-6），最后点击添加就可以了。

这里也是之后你切换模型的地方，可以选择你想要使用的模型。

💡 如果不知道模型名称，可以进入首页「模型广场」，查看所有模型，点击左下角复制即可。
然后直接在 cc Switch 里修改模型名称即可切换模型。

6. 最后点击启用，重启 claude code

保存好以后，点击启用。启用完毕之后，需要 重启claude code，使得配置生效。

⚠️ ⚠️ 注意：若启动后因为连接问题无法使用，尝试修改API请求地址为https://api.88api.shop（去除/v1），重启后再试。（我实操时遇到过这个问题，改地址后解决）。

五、开始使用Claude Code

启动Claude Code

打开终端，输入命令：

claude

测试是否正常工作

输入“你好”，若能收到回复，说明配置成功：

常用命令速查表

命令	功能描述
/model	切换AI模型
/help	显示所有可用命令
/clear	清空当前对话
/exit	退出Claude Code
/resume	恢复之前的会话
/cost	显示当前会话费用和时长

总结

本文从 Node.js 安装到 API 配置，再到 CC Switch 工具使用，完整覆盖了 macOS 下 Claude Code 的部署流程。核心解决了账号和网络配置的麻烦，步骤尽量详细，遇到的坑也做了标注。如果跟着操作还是有问题，欢迎在评论区留言，我们一起排查解决。工具用起来才是真的香，赶紧试试吧！