前言最近想试试Claude Code作为非专业开发最怕的就是环境配置这关——Node版本不对、API密钥放错位置、终端配置不生效每个小问题都能让人劝退。所以整理了这篇实操文从Node.js安装到API接口对接再到常见报错解决全程在macOS下亲测跑通。如果你也想在国内环境下用上Claude Code跟着步骤走应该能少踩不少坑。正文一、准备工作安装Node.jsClaude Code依赖Node.js环境最低要求Node.js ≥18建议LTS版本稳定性更好。方法一官网下载推荐访问Node.js官网下载LTS版本安装包双击后按向导完成安装即可。方法二Homebrew安装如果习惯命令行也可以用Homebrew安装brewinstallnode验证安装安装完成后打开终端输入以下命令出现版本号即成功node--version# 输出示例v20.11.0版本号可能因安装版本不同略有差异npm--version# 输出示例10.2.4二、安装Claude CodeNode.js准备好后通过npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code验证安装安装完成后输入以下命令检查是否安装成功claude--version# 输出示例1.0.0版本号以实际安装为准三、核心配置API连接Claude Code需要API密钥才能调用模型服务。我这里使用88api作为中转接口主要是为了省去海外账号注册和网络配置的麻烦。 推荐大家可以试试或者大家可以用自己的。1. 获取API Key首先访问 88api (https://api.88api.shop)注册登录点击侧边栏的 “API 令牌”点击添加令牌创建令牌名称随意直接提交获取 API Key注意妥善保管不要公开或分享。点击知道了在令牌列表中可以点击复制按钮获取 API Key2. 配置API连接两种方式选一种即可方法一配置文件推荐永久生效在用户目录下创建.claude文件夹和settings.json配置文件路径为~/.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仅重启终端可能不生效。3. VSCode插件配置可选如果使用VSCode的Claude插件需额外创建config.json文件路径~/.claude/config.json{primaryApiKey:any}创建步骤# 创建配置文件nano~/.claude/config.json粘贴上述内容保存即可。⚠️ 注意此文件config.json与Claude Code命令行工具的配置文件settings.json是两个独立文件不要混淆。四、开始使用Claude Code配置完成后终端输入以下命令启动claude首次启动可能需要简单交互按提示操作即可。如需查看命令说明可执行claude--help五、常见问题排查问题1启动后提示“Unable 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是否配置正确。总结Claude Code的配置核心其实就三步装Node.js、装工具本身、配API接口。国内环境下用中转接口能省不少事关键是配置文件路径和API Key别填错。如果按步骤操作还是遇到问题建议优先检查终端是否重启、配置文件路径是否正确尤其是隐藏文件夹.claude是否创建。有其他问题欢迎在评论区交流一起避坑