前言AI工具越来越强大但环境配置总能劝退不少想尝试的朋友——尤其在macOS上从Node.js版本到API连接稍有差池就可能卡壳。国内用户还常遇到海外账户注册、网络连接等麻烦。这篇文章整理了我在macOS上从零安装Claude Code并配置API的全过程亲测每个步骤都能跑通无需复杂环境跟着做就能上手。正文一、准备工作安装Node.jsClaude Code要求Node.js版本≥18建议LTS版先确保环境满足。方法一官网下载推荐访问Node.js官网下载macOS的LTS版本双击安装包按向导完成安装。方法二Homebrew安装如果习惯命令行可通过Homebrew安装brewinstallnode验证安装安装完成后打开终端输入以下命令出现版本号即成功node--version# 输出示例v20.11.0版本号可能因LTS更新变化npm--version# 输出示例10.2.4二、安装Claude CodeNode.js准备好后通过npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code验证安装安装完成后输入以下命令检查版本claude--version若输出版本信息说明安装成功。三、配置API连接核心步骤Claude Code需要API密钥才能使用。我最近在用88api中转网址https://api.88api.shop相比较官方比较划算。或者大家也可以用自己的 。1. 获取API Key注册登录以后点击侧边栏的 “API 令牌”点击添加令牌创建令牌名称随意直接提交获取 API Key注意妥善保管不要公开或分享。点击知道了在令牌列表中可以点击复制按钮获取 API Key2. 配置API推荐配置文件方式通过配置文件永久保存API信息避免每次终端都需重新设置。配置文件路径~/.claude/settings.json配置内容{env:{ANTHROPIC_AUTH_TOKEN:你的API密钥,// 替换为实际获取的KeyANTHROPIC_BASE_URL:https://api.88api.shop// 中转接口地址}}创建步骤打开终端依次输入以下命令# 创建.claude目录若已存在可跳过mkdir-p~/.claude# 用nano编辑配置文件nano~/.claude/settings.json粘贴上述配置内容按CtrlO保存CtrlX退出编辑器。3. 环境变量配置备选方案若不想用配置文件可通过环境变量临时或永久设置临时设置当前终端生效exportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥// 替换为实际Key永久设置所有终端生效将以下内容写入shell配置文件如~/.zshrc或~/.bash_profileexportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥// 替换为实际Key保存后执行source ~/.zshrc或对应配置文件使生效。⚠️ 重要提示配置后需重启终端若在VS Code/Cursor等IDE的集成终端使用需彻底重启IDE仅重启终端可能不生效。若使用VSCode的Claude插件需额外创建~/.claude/config.json文件内容为{primaryApiKey:any}此为插件专用配置与命令行工具的settings.json是两个文件。四、开始使用Claude Code配置完成后在终端输入以下命令启动claude首次启动可能需要简单交互按提示操作即可。若需查看命令说明可输入claude--help五、常见问题排查问题启动后提示“Unable to connect to Anthropic services”原因首次启动引导未完成。解决方案在用户根目录创建.claude.json文件跳过引导文件路径~/.claude.json文件内容{hasCompletedOnboarding:true}创建命令cat~/.claude.jsonEOF { hasCompletedOnboarding: true } EOF创建后验证文件是否存在cat~/.claude.json重启Claude Code即可。总结这篇教程覆盖了macOS下Claude Code从Node.js安装到API配置的完整流程避免了海外账户和复杂网络配置。关键步骤确保Node.js版本≥18配置文件路径正确~/.claude/settings.jsonAPI Key替换为实际值重启终端或IDE使配置生效。遇到连接问题时检查.claude.json文件是否创建。如果按步骤操作仍有问题欢迎在评论区交流我会尽量解答。希望这篇教程能帮你少踩坑快速用上Claude Code