前言这篇文章专为macOS用户整理从Node.js安装到API对接全程实操用88api中转方案省掉翻墙和海外账户麻烦配置文件和命令直接复制可用尽量让小白也能跟着走通。正文一、安装Node.jsClaude Code要求Node.js版本≥18建议LTS版先确保环境满足。方法一官网下载访问Node.js官网下载LTS版本双击安装包按向导完成即可。方法二Homebrew安装推荐mac用户用Homebrew更方便终端执行brewinstallnode验证安装安装后检查版本确保Node.js和npm都正常node--version# 输出v18.x.x或更高npm--version# 输出对应npm版本二、安装Claude CodeNode.js就绪后用npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code验证安装安装完成后检查版本确认工具可用claude--version# 输出类似1.0.0的版本号三、配置API连接前提获取API Key调用Claude需要API Key我这次用88api中转官网https://api.88api.shop主要是省掉翻墙和海外账户注册国内直连方便。推荐大家试试或者大家也可以用自己的。下面以88API 为例获取Key的步骤注册并登录后点击侧边栏“API令牌”。点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用点击提交5. 点击复制按钮复制API令牌也就是API KEY方法一配置文件推荐通过配置文件永久保存API信息路径固定在用户目录下配置文件路径~/.claude/settings.json配置内容替换你的API密钥为实际Key{env:{ANTHROPIC_AUTH_TOKEN:你的API密钥,ANTHROPIC_BASE_URL:https://api.88api.shop}}创建步骤终端执行以下命令创建目录和文件# 创建.claude目录如已存在则跳过mkdir-p~/.claude# 用nano编辑配置文件nano~/.claude/settings.json粘贴配置内容后按CtrlO保存CtrlX退出编辑器。方法二环境变量如果不想用配置文件可通过环境变量临时或永久配置临时设置当前终端有效exportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥永久设置将环境变量写入shell配置文件如~/.zshrc# 编辑配置文件nano~/.zshrc# 在文件末尾添加以下内容替换你的API密钥exportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥# 保存后生效source~/.zshrc⚠️ 注意配置后需重启终端若在VS Code/Cursor等IDE的集成终端使用需彻底重启IDE仅重启终端可能不生效。VSCode插件配置可选如果用VSCode的Claude插件需额外创建插件专用配置文件配置文件路径~/.claude/config.json配置内容{primaryApiKey:any}创建步骤# 创建目录如已存在则跳过mkdir-p~/.claude# 编辑配置文件nano~/.claude/config.json粘贴内容后保存退出。⚠️ 注意此文件config.json是VSCode插件专用与命令行工具的配置文件settings.json不同不要混淆。四、开始使用配置完成后终端输入以下命令启动Claude Codeclaude首次启动可能需要简单交互按提示操作即可。想了解更多命令执行claude--help五、常见问题排查问题1Unable to connect to Anthropic services症状启动后提示无法连接服务。原因首次启动引导未完成。解决方案创建~/.claude.json文件跳过引导配置文件路径~/.claude.json配置内容{hasCompletedOnboarding:true}创建方法终端执行cat~/.claude.jsonEOF { hasCompletedOnboarding: true } EOF验证文件是否创建cat~/.claude.json# 输出上述配置内容即成功重启Claude Code即可。调试技巧若仍无法连接可按以下步骤排查检查网络是否正常重启终端或IDE后重试确认API Key和ANTHROPIC_BASE_URL配置正确总结这篇教程从Node.js安装到API配置帮macOS用户解决了Claude Code的环境搭建问题尤其是通过88api中转省掉了翻墙和海外账户的麻烦。核心要点是配置文件路径要正确~/.claude/settings.jsonAPI Key替换成自己的重启终端或IDE让配置生效。如果按步骤操作仍有问题欢迎在评论区留言我会尽量回复。技术配置难免踩坑耐心检查每一步基本都能解决
