前言这篇文章就针对macOS用户从Node.js安装到Claude Code部署再到国内API直连配置一步步带你走通。我特意用了88api作为中转服务国内直连不用翻墙也省去注册海外账户的麻烦亲测整个流程下来不到10分钟。正文一、安装Node.js最低要求v18Claude Code依赖Node.js环境建议安装LTS版本稳定性更好。方法一官网下载适合不熟悉命令行的用户访问Node.js官网选择macOS的LTS版本下载后双击安装包按向导完成安装即可。方法二Homebrew安装推荐命令行更高效如果你已经安装了Homebrew直接在终端执行brewinstallnode验证安装是否成功安装完成后在终端输入以下命令能显示版本号说明安装成功node--version# 应输出v18.x.x或更高npm--version# 通常会随Node.js一起安装二、安装Claude CodeNode.js环境就绪后通过npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code验证安装是否成功安装完成后输入以下命令检查版本claude--version如果能显示版本号说明Claude Code已成功安装。三、配置API连接核心步骤前提获取API Key使用Claude Code需要API Key这里我用的是88api中转服务官网https://api.88api.shop它支持国内直连不用翻墙还能一个Key接入多个模型比如GPT、Gemini等本地统一管理很方便。获取Key的步骤如下以88api为例1.注册并登录后点击侧边栏“API令牌”。2. 点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用4.点击提交5. 点击复制按钮复制API令牌也就是API KEY方法一配置文件推荐永久生效通过配置文件保存API信息一劳永逸。配置文件路径~/.claude/settings.json配置内容{env:{ANTHROPIC_AUTH_TOKEN:你的API密钥,// 替换为刚复制的KeyANTHROPIC_BASE_URL:https://api.88api.shop// 88api的API地址}}创建步骤在终端依次执行以下命令# 创建.claude目录如果已存在会自动跳过mkdir-p~/.claude# 用nano编辑配置文件nano~/.claude/settings.json粘贴上述配置内容按CtrlO保存CtrlX退出编辑器。方法二环境变量临时或永久如果不想用配置文件也可以通过环境变量设置。临时设置仅当前终端生效exportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥// 替换为实际Key永久设置所有终端生效将环境变量写入shell配置文件比如~/.zshrc或~/.bashrc# 用nano打开配置文件nano~/.zshrc# 在文件末尾添加以下两行exportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥// 替换为实际Key# 保存退出后执行以下命令使配置生效source~/.zshrc⚠️ 注意务必将你的API密钥替换为实际获取的Key否则无法连接。配置后需重启终端若在VS Code等IDE的集成终端使用需彻底重启IDE才能生效。VSCode插件配置可选如果使用VSCode的Claude插件还需要额外创建一个专用配置文件配置文件路径~/.claude/config.json配置内容{primaryApiKey:any}创建步骤# 创建配置文件nano~/.claude/config.json# 粘贴上述内容保存退出⚠️ 注意这是VSCode插件专用的config.json与命令行工具的settings.json是两个不同文件不要混淆。四、开始使用Claude Code配置完成后在终端输入以下命令启动claude首次启动可能需要简单交互按提示操作即可。想了解更多命令可执行claude--help五、常见问题排查问题1启动后提示“Unable to connect to Anthropic services”症状启动Claude Code后提示无法连接服务。原因首次启动引导未完成。解决方案创建~/.claude.json文件跳过引导# 创建文件并写入配置cat~/.claude.jsonEOF { hasCompletedOnboarding: true } EOF# 验证文件是否创建成功cat~/.claude.json重启Claude Code即可。调试小技巧如果配置后仍无法连接可按以下步骤排查检查网络是否正常国内用户无需翻墙直连即可确认API Key是否正确重新复制粘贴注意不要有空格重启终端或IDE确保配置生效。总结到这里macOS下Claude Code的安装和API配置就完成了。核心步骤其实很简单装Node.js→装Claude Code→配API Key关键在于API连接时注意配置文件路径和Key的正确替换。用88api作为中转确实省了不少事国内直连不用折腾网络一个Key还能管理多个模型。如果过程中遇到其他问题欢迎在评论区交流我会尽量帮忙解答。
告别环境卡壳！macOS Claude Code从安装到API对接完整指南（附避坑技巧）
前言这篇文章就针对macOS用户从Node.js安装到Claude Code部署再到国内API直连配置一步步带你走通。我特意用了88api作为中转服务国内直连不用翻墙也省去注册海外账户的麻烦亲测整个流程下来不到10分钟。正文一、安装Node.js最低要求v18Claude Code依赖Node.js环境建议安装LTS版本稳定性更好。方法一官网下载适合不熟悉命令行的用户访问Node.js官网选择macOS的LTS版本下载后双击安装包按向导完成安装即可。方法二Homebrew安装推荐命令行更高效如果你已经安装了Homebrew直接在终端执行brewinstallnode验证安装是否成功安装完成后在终端输入以下命令能显示版本号说明安装成功node--version# 应输出v18.x.x或更高npm--version# 通常会随Node.js一起安装二、安装Claude CodeNode.js环境就绪后通过npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code验证安装是否成功安装完成后输入以下命令检查版本claude--version如果能显示版本号说明Claude Code已成功安装。三、配置API连接核心步骤前提获取API Key使用Claude Code需要API Key这里我用的是88api中转服务官网https://api.88api.shop它支持国内直连不用翻墙还能一个Key接入多个模型比如GPT、Gemini等本地统一管理很方便。获取Key的步骤如下以88api为例1.注册并登录后点击侧边栏“API令牌”。2. 点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用4.点击提交5. 点击复制按钮复制API令牌也就是API KEY方法一配置文件推荐永久生效通过配置文件保存API信息一劳永逸。配置文件路径~/.claude/settings.json配置内容{env:{ANTHROPIC_AUTH_TOKEN:你的API密钥,// 替换为刚复制的KeyANTHROPIC_BASE_URL:https://api.88api.shop// 88api的API地址}}创建步骤在终端依次执行以下命令# 创建.claude目录如果已存在会自动跳过mkdir-p~/.claude# 用nano编辑配置文件nano~/.claude/settings.json粘贴上述配置内容按CtrlO保存CtrlX退出编辑器。方法二环境变量临时或永久如果不想用配置文件也可以通过环境变量设置。临时设置仅当前终端生效exportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥// 替换为实际Key永久设置所有终端生效将环境变量写入shell配置文件比如~/.zshrc或~/.bashrc# 用nano打开配置文件nano~/.zshrc# 在文件末尾添加以下两行exportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥// 替换为实际Key# 保存退出后执行以下命令使配置生效source~/.zshrc⚠️ 注意务必将你的API密钥替换为实际获取的Key否则无法连接。配置后需重启终端若在VS Code等IDE的集成终端使用需彻底重启IDE才能生效。VSCode插件配置可选如果使用VSCode的Claude插件还需要额外创建一个专用配置文件配置文件路径~/.claude/config.json配置内容{primaryApiKey:any}创建步骤# 创建配置文件nano~/.claude/config.json# 粘贴上述内容保存退出⚠️ 注意这是VSCode插件专用的config.json与命令行工具的settings.json是两个不同文件不要混淆。四、开始使用Claude Code配置完成后在终端输入以下命令启动claude首次启动可能需要简单交互按提示操作即可。想了解更多命令可执行claude--help五、常见问题排查问题1启动后提示“Unable to connect to Anthropic services”症状启动Claude Code后提示无法连接服务。原因首次启动引导未完成。解决方案创建~/.claude.json文件跳过引导# 创建文件并写入配置cat~/.claude.jsonEOF { hasCompletedOnboarding: true } EOF# 验证文件是否创建成功cat~/.claude.json重启Claude Code即可。调试小技巧如果配置后仍无法连接可按以下步骤排查检查网络是否正常国内用户无需翻墙直连即可确认API Key是否正确重新复制粘贴注意不要有空格重启终端或IDE确保配置生效。总结到这里macOS下Claude Code的安装和API配置就完成了。核心步骤其实很简单装Node.js→装Claude Code→配API Key关键在于API连接时注意配置文件路径和Key的正确替换。用88api作为中转确实省了不少事国内直连不用折腾网络一个Key还能管理多个模型。如果过程中遇到其他问题欢迎在评论区交流我会尽量帮忙解答。
