前言最近想试试Claude Code作为编程助手但发现不少教程要么默认海外环境要么步骤零散小白跟着做很容易卡壳。其实国内环境下配置并不复杂关键在于API接口的正确对接。这篇文章整理了从Node.js安装到API配置的完整步骤亲测在macOS上能顺利跑通希望帮你少踩坑。正文一、安装Node.jsClaude Code运行依赖Node.js环境最低要求Node.js ≥18建议LTS版本。方法一官网下载推荐访问Node.js官网下载LTS版本双击安装包并按向导完成安装。方法二Homebrew安装如果已安装Homebrew可直接在终端执行brewinstallnode验证安装安装完成后在终端输入以下命令出现版本号即安装成功node--version# 输出示例v20.11.0npm--version# 输出示例10.2.4二、安装Claude CodeNode.js环境准备好后通过npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code验证安装安装完成后验证是否成功claude--version三、配置API连接获取API Key这里以88api为例官网https://api.88api.shop它能提供API中转服务减少账号和网络配置的麻烦有免费额度可试用。具体步骤如下1.点击 “API 令牌”2.点击添加令牌3. 创建令牌名称随便写没有含义直接点击提交即可。获取 API KEY获得 API Key 后请妥善保管API Key 是你的身份凭证等同于账号密码切勿公开或分享给他人。点击“知道了”可以看到我们刚才创建的在这里也同样可以点击 复制 按钮去获取 API Key。四、用CC Switch解决登录问题并配置模型Claude Code默认需要登录官方账号对国内用户不够友好。可通过开源工具CC Switch快速管理AI服务无需手动配置复杂文件。不明白没关系直接跟着操作就行。具体下载版本链接https://github.com/farion1231/cc-switch/releases一直往下拉拉到下面这个位置下载2. 根据你的操作系统下载对应的安装包。Linux、MacOS、Windows看文件名能区分。或点击 “show all 18 assets” 往下拉找更多的版本。3.安装后打开 CC Switch点击 Hermes 的图标再点击 【】号进行配置模型。4.直接默认选择「自定义配置」“供应商标识” 和 “供应商名称” 自己取API KEY 还是上面的直接复制过来API 请求地址就是刚才复制的 Base URLhttps://api.88api.shop/v1 然后直接点击添加就可以了。最后点击启用重启 Hermes启用完毕之后需要重启Hermes使得配置生效。6.重新打开 Hermes点击右上角的设置按钮。在左侧选择“模型”第一个下拉框里选择刚才创建的供应商这里的“88”是我刚创建的供应商标识名称。在第二个下拉框里面这里可以选择 GPT 模型我最近在用 GPT 5.5然后点击应用快速选项也可以给它打开。⚠️ ⚠️ 注意若启动后因为连接问题无法使用尝试修改API请求地址为https://api.88api.shop去除/v1重启后再试。我实操时遇到过这个问题改地址后解决。五、开始使用输入“你好”能够正常回复。恭喜你已经可以开始使用啦六、创建新的Profile前面我们已经介绍一个 profile 就是一个独立的私人助理。现在展示如何新建一个 profile点击左下角的加号。这里需要填写名称克隆来源然后点击创建配置档案即可。选择克隆 相当于抄作业——你选一个已有的 Profile 作为起点它的所有设置记忆、知识等都会复制过来之后可以在此基础上修改。因为我们这里初次登录所以只有一个默认的 default 可以克隆。选择空白 相当于从头开始从零搭建完全符合自己需求的人设。注意创建完之后一个新的 Profile 之后可以关掉Hermes 重启一下因为可能会出现新的 Profile 没有被加载的情况。总结至此你已经完成了Claude Code在macOS上的安装和配置。核心步骤包括Node.js环境准备、API Key获取以及通过CC Switch管理模型配置。如果过程中遇到问题建议先检查命令是否正确或API地址是否匹配欢迎在评论区交流你的实操经验。
前言最近想试试Claude Code作为编程助手但发现不少教程要么默认海外环境要么步骤零散小白跟着做很容易卡壳。其实国内环境下配置并不复杂关键在于API接口的正确对接。这篇文章整理了从Node.js安装到API配置的完整步骤亲测在macOS上能顺利跑通希望帮你少踩坑。正文一、安装Node.jsClaude Code运行依赖Node.js环境最低要求Node.js ≥18建议LTS版本。方法一官网下载推荐访问Node.js官网下载LTS版本双击安装包并按向导完成安装。方法二Homebrew安装如果已安装Homebrew可直接在终端执行brewinstallnode验证安装安装完成后在终端输入以下命令出现版本号即安装成功node--version# 输出示例v20.11.0npm--version# 输出示例10.2.4二、安装Claude CodeNode.js环境准备好后通过npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code验证安装安装完成后验证是否成功claude--version三、配置API连接获取API Key这里以88api为例官网https://api.88api.shop它能提供API中转服务减少账号和网络配置的麻烦有免费额度可试用。具体步骤如下1.点击 “API 令牌”2.点击添加令牌3. 创建令牌名称随便写没有含义直接点击提交即可。获取 API KEY获得 API Key 后请妥善保管API Key 是你的身份凭证等同于账号密码切勿公开或分享给他人。点击“知道了”可以看到我们刚才创建的在这里也同样可以点击 复制 按钮去获取 API Key。四、用CC Switch解决登录问题并配置模型Claude Code默认需要登录官方账号对国内用户不够友好。可通过开源工具CC Switch快速管理AI服务无需手动配置复杂文件。不明白没关系直接跟着操作就行。具体下载版本链接https://github.com/farion1231/cc-switch/releases一直往下拉拉到下面这个位置下载2. 根据你的操作系统下载对应的安装包。Linux、MacOS、Windows看文件名能区分。或点击 “show all 18 assets” 往下拉找更多的版本。3.安装后打开 CC Switch点击 Hermes 的图标再点击 【】号进行配置模型。4.直接默认选择「自定义配置」“供应商标识” 和 “供应商名称” 自己取API KEY 还是上面的直接复制过来API 请求地址就是刚才复制的 Base URLhttps://api.88api.shop/v1 然后直接点击添加就可以了。最后点击启用重启 Hermes启用完毕之后需要重启Hermes使得配置生效。6.重新打开 Hermes点击右上角的设置按钮。在左侧选择“模型”第一个下拉框里选择刚才创建的供应商这里的“88”是我刚创建的供应商标识名称。在第二个下拉框里面这里可以选择 GPT 模型我最近在用 GPT 5.5然后点击应用快速选项也可以给它打开。⚠️ ⚠️ 注意若启动后因为连接问题无法使用尝试修改API请求地址为https://api.88api.shop去除/v1重启后再试。我实操时遇到过这个问题改地址后解决。五、开始使用输入“你好”能够正常回复。恭喜你已经可以开始使用啦六、创建新的Profile前面我们已经介绍一个 profile 就是一个独立的私人助理。现在展示如何新建一个 profile点击左下角的加号。这里需要填写名称克隆来源然后点击创建配置档案即可。选择克隆 相当于抄作业——你选一个已有的 Profile 作为起点它的所有设置记忆、知识等都会复制过来之后可以在此基础上修改。因为我们这里初次登录所以只有一个默认的 default 可以克隆。选择空白 相当于从头开始从零搭建完全符合自己需求的人设。注意创建完之后一个新的 Profile 之后可以关掉Hermes 重启一下因为可能会出现新的 Profile 没有被加载的情况。总结至此你已经完成了Claude Code在macOS上的安装和配置。核心步骤包括Node.js环境准备、API Key获取以及通过CC Switch管理模型配置。如果过程中遇到问题建议先检查命令是否正确或API地址是否匹配欢迎在评论区交流你的实操经验。
