macOS下Claude Code从0到1配置教程（附API密钥获取+常见报错修复）

前言最近整理了这篇Claude Code从安装到调用的完整流程连最容易卡壳的API配置都做了详细说明。这次用88api作为中转接口主要是它支持国内直连省去了海外账号注册和网络配置的麻烦一个Key还能管理多个模型切换起来也方便。跟着步骤走基本能少踩80%的坑。正文一、准备工作安装Node.jsClaude Code要求Node.js版本≥18建议LTS版先确保环境满足。方法一官网下载适合不熟悉命令行的用户访问Node.js官网下载macOS的LTS版本双击安装包后按向导完成安装即可。方法二Homebrew安装推荐命令行更快捷如果已安装Homebrew直接在终端执行brewinstallnode验证安装是否成功安装完成后在终端输入以下命令检查版本node--version# 输出v18.x.x或更高npm--version# 输出对应的npm版本二、安装Claude CodeNode.js准备好后通过npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code验证安装是否成功安装完成后检查版本确认安装成功claude--version# 输出类似1.0.0的版本号三、配置API连接核心步骤1. 获取API密钥使用Claude Code需要API密钥这里以我使用的88api为例你也可以用其他平台的密钥主要是省去海外账户注册和翻墙步骤国内直连更方便有额度大家可以试试。注册并登录后点击侧边栏“API令牌”。点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用点击提交点击复制按钮复制API令牌也就是API KEY2. 配置方式推荐用配置文件一劳永逸配置文件路径需要在用户目录下创建.claude文件夹和settings.json配置文件路径为~/.claude/settings.json配置内容文件中需要填入API密钥和中转地址{env:{ANTHROPIC_AUTH_TOKEN:你的API密钥,// 替换为刚复制的密钥ANTHROPIC_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密钥永久生效将上述两行写入~/.zshrc或你的shell配置文件如.bashrcechoexport ANTHROPIC_BASE_URLhttps://api.88api.shop~/.zshrcechoexport ANTHROPIC_AUTH_TOKEN你的API密钥~/.zshrc保存后执行source ~/.zshrc使其生效。4. 注意事项替换密钥务必将配置中的“你的API密钥”替换为实际获取的密钥否则无法连接。重启终端/IDE配置完成后需要重启终端如果在VS Code/Cursor等IDE的集成终端使用需彻底重启IDE仅重启终端可能不生效。5. VSCode插件配置可选如果使用VSCode的Claude插件需额外创建config.json文件路径~/.claude/config.json内容{primaryApiKey:any}创建步骤nano~/.claude/config.json# 粘贴内容后保存退出注意这是插件专用配置与命令行工具的settings.json是两个文件。四、开始使用Claude Code配置完成后在终端输入以下命令启动claude首次启动可能需要简单交互按提示操作即可。想了解更多命令可执行claude--help五、常见问题排查问题1启动后提示“Unable to connect to Anthropic services”原因首次启动引导未完成。解决在用户根目录创建.claude.json文件跳过引导路径~/.claude.json内容{hasCompletedOnboarding:true}创建命令cat~/.claude.jsonEOF { hasCompletedOnboarding: true } EOF验证执行cat ~/.claude.json确认文件已创建重启Claude Code即可。调试小技巧如果配置后仍无法连接可按以下步骤排查检查网络是否正常国内用户需确保中转接口可访问确认API密钥和ANTHROPIC_BASE_URL配置正确重启终端或IDE后重试总结这篇教程从Node.js安装到API配置再到常见问题修复覆盖了macOS下Claude Code的完整上手流程。核心是解决国内环境下的连接难题通过中转接口省去了海外账号和翻墙的麻烦。按步骤操作基本能避免“安装成功但无法调用”的常见问题。如果遇到其他报错欢迎在评论区交流我会尽量帮忙解答。