前言最近想上手Claude Code但翻了不少教程要么默认海外环境要么步骤零散配置时总卡在API连接或环境依赖上。作为非专业开发者最缺的就是一篇能直接跟着做的完整实操文。今天就分享下在macOS上从0到1安装Claude Code并通过API中转实现国内直连的全过程每个步骤都亲测过希望帮你少走弯路快速用上这个工具。正文一、安装Node.jsClaude Code运行需要Node.js环境最低要求Node.js ≥18建议安装LTS版本稳定性更好。方法一官网下载访问Node.js官网选择LTS版本下载双击安装包后按向导提示完成安装即可。方法二Homebrew安装推荐如果已安装Homebrew直接在终端执行brewinstallnode验证安装安装完成后打开终端输入以下命令检查版本确保Node.js和npm都已正确安装node--version# 应显示v18.x.x或更高npm--version# 通常随Node.js一起安装二、安装Claude CodeNode.js环境准备好后通过npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code验证安装安装完成后输入以下命令检查版本确认安装成功claude--version三、配置API连接要使用Claude Code需要配置API密钥和连接地址。这里以API中转方案为例国内可直连无需海外账户。前提获取API Key我这次选择88api作为中转接口官网https://api.88api.shop主要是它支持国内直连无需翻墙和海外账户还能统一管理多个模型的API 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密钥,// 替换为实际复制的API KeyANTHROPIC_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密钥// 替换为实际API Key永久设置将以下内容写入~/.zshrc或你的shell配置文件如.bashrcexportANTHROPIC_BASE_URLhttps://api.88api.shopexportANTHROPIC_AUTH_TOKEN你的API密钥// 替换为实际API Key保存后执行以下命令使配置生效source~/.zshrc⚠️注意请务必将你的API密钥替换为实际获取的API Key。配置完成后需重启终端若在VS Code/Cursor等IDE的集成终端使用需彻底重启IDE仅重启终端可能不生效。VSCode插件配置可选如果使用VSCode的Claude插件需额外创建插件专用配置文件配置文件路径~/.claude/config.json配置内容{primaryApiKey:any}创建步骤# 创建.claude目录如已存在则跳过mkdir-p~/.claude# 创建并编辑配置文件nano~/.claude/config.json粘贴上述内容保存即可注意此文件与命令行工具的settings.json是两个不同文件。四、开始使用配置完成后在终端输入以下命令启动Claude Codeclaude若需查看命令说明可执行claude--help五、常见问题排查问题1Unable to connect to Anthropic services症状启动Claude Code后提示无法连接服务。解决方案通常是首次启动引导未完成需创建.claude.json文件跳过引导配置文件路径~/.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密钥和中转地址遇到连接问题时用.claude.json跳过引导。整个过程不算复杂跟着步骤走基本能一次成功。如果操作中遇到其他问题欢迎在评论区留言一起交流解决~