macOS下Claude Code安装配置保姆级教程：从Node.js到API直连，新手10分钟跑通

📅 2026/6/29 22:00:50 👁️ 次浏览

前言最近想在macOS上体验Claude Code但翻了不少教程要么步骤零散要么默认海外环境配置时总卡在API调用或网络问题上。作为非专业开发者最怕跟着教程做还失败。这篇文章记录我在macOS上从安装依赖到成功启动的全过程用了API中转服务减少环境配置麻烦亲测能跑通希望帮到同样想尝试的朋友。正文一、准备工作安装Node.jsClaude Code要求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使用Claude Code需要API Key我最近用了88api中转服务网址https://api.88api.shop主要是省去海外账户注册和网络配置的麻烦推荐大家可以试试或者大家也可以用自己的。获取步骤如下注册登录以后点击侧边栏的 “API 令牌”点击添加令牌创建令牌名称随意直接提交获取 API Key注意妥善保管不要公开或分享。点击知道了在令牌列表中可以点击复制按钮获取 API Key方法一配置文件推荐通过配置文件永久保存API信息路径为用户目录下的.claude/settings.json配置内容{env:{ANTHROPIC_AUTH_TOKEN:你的API密钥,ANTHROPIC_BASE_URL:https://api.88api.shop}}创建步骤# 创建.claude目录如已存在则跳过mkdir-p~/.claude# 创建并编辑配置文件nano~/.claude/settings.json粘贴上述配置内容按CtrlO保存CtrlX退出编辑器。方法二环境变量临时/永久如果不想用配置文件可通过环境变量设置临时设置当前终端生效exportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥永久设置全局生效将以下内容写入~/.zshrc或你的shell配置文件如.bashrcexportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥保存后执行source ~/.zshrc使配置生效。⚠️注意请将你的API密钥替换为实际生成的Key配置后需重启终端若在VS Code等IDE中使用需彻底重启IDE才能生效。VSCode插件配置可选如果使用VSCode的Claude插件需额外创建~/.claude/config.json配置内容{primaryApiKey:any}创建步骤# 创建配置文件nano~/.claude/config.json粘贴内容保存即可此文件与命令行工具的settings.json是两个独立文件。四、开始使用Claude Code配置完成后终端输入以下命令启动claude如需查看命令说明可运行claude --help。五、常见问题排查问题1Unable to connect to Anthropic services症状启动后提示无法连接服务。解决方案创建~/.claude.json跳过引导流程配置内容{hasCompletedOnboarding:true}创建方法cat~/.claude.jsonEOF { hasCompletedOnboarding: true } EOF验证文件是否创建cat~/.claude.json重启Claude Code即可。调试技巧若仍无法连接检查网络、重启终端/IDE或确认API Key和Base URL配置是否正确。总结这篇教程覆盖了macOS上Claude Code从依赖安装到API配置的完整流程核心是注意Node.js版本≥18、配置文件路径正确以及妥善保管API Key。遇到连接问题时创建.claude.json跳过引导是关键解决办法。整个过程不算复杂跟着步骤走基本能顺利运行有其他问题欢迎留言交流~

相关新闻