小白也能搞定！Claude Code完整安装配置指南：从Node.js到API连接，少踩90%的坑

前言这篇文章整理了我自己实操通过的完整流程从Node.js安装到API配置甚至包括常见报错的解决办法尽量让每个步骤都清晰可查。我用了88api作为接口中转省去了海外账户和网络的麻烦国内环境下也能稳定调用大家可以参考着一步步来。正文一、安装Node.jsClaude Code运行依赖Node.js环境最低要求Node.js ≥18建议安装LTS版本稳定性更好。方法一官网下载推荐访问Node.js官网下载LTS版本安装包根据系统选择32位/64位。双击安装包按向导提示完成安装默认选项即可建议勾选“Add to PATH”自动配置环境变量。方法二包管理器安装如果习惯用包管理器如Chocolatey或Scoop可直接执行命令# Chocolatey安装chocoinstallnodejs# Scoop安装scoopinstallnodejs验证安装安装完成后打开PowerShell建议管理员身份运行避免权限问题执行以下命令检查版本node--version# 输出Node.js版本如v20.10.0npm--version# 输出npm版本如10.2.3⚠️ 提示若提示“命令不存在”检查是否已将Node.js添加到系统PATH或重启终端重试。二、安装Claude CodeNode.js环境就绪后通过npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code安装完成后验证是否成功claude--version# 输出版本号如1.0.0三、配置API连接这是最关键的一步需要先获取API Key再通过配置文件或环境变量让Claude Code连接接口。前提获取API Key我这次使用88api作为接口中转主要是为了省去海外账户注册和网络配置的麻烦国内可直连且一个Key能管理多个模型切换方便。推荐大家可以试试或者大家也可以用自己的。获取步骤如下获取Key的步骤注册并登录后点击侧边栏“API令牌”。点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用点击提交5. 点击复制按钮复制API令牌也就是API KEY方法一配置文件推荐通过配置文件永久保存API信息步骤如下配置文件路径C:\Users\你的用户名\.claude\settings.json将你的用户名替换为实际系统用户名。创建步骤打开文件资源管理器进入C:\Users\你的用户名\目录。新建文件夹.claude若已存在则跳过。在.claude文件夹中新建settings.json文件。配置内容{env:{ANTHROPIC_AUTH_TOKEN:你的API密钥,// 替换为刚复制的API KeyANTHROPIC_BASE_URL:https://api.88api.shop// 88api接口地址}}方法二环境变量临时/永久若不想用配置文件可通过环境变量配置适合临时测试PowerShell临时设置当前会话生效$env:ANTHROPIC_BASE_URLhttps://api.88api.shop$env:ANTHROPIC_AUTH_TOKEN你的API密钥// 替换为实际KeyPowerShell永久设置用户级重启后生效[System.Environment]::SetEnvironmentVariable(ANTHROPIC_BASE_URL,https://api.88api.shop,[System.EnvironmentVariableTarget]::User)[System.Environment]::SetEnvironmentVariable(ANTHROPIC_AUTH_TOKEN,你的API密钥,[System.EnvironmentVariableTarget]::User)验证环境变量执行以下命令确认配置是否生效$env:ANTHROPIC_BASE_URL# 输出https://api.88api.shop$env:ANTHROPIC_AUTH_TOKEN# 输出你的API Key⚠️ 注意配置完成后需重启终端若在VS Code/Cursor等IDE中使用需重启整个IDE仅重启终端可能不生效。VSCode插件配置可选如果使用VSCode的Claude插件需额外创建config.json文件配置文件路径C:\Users\你的用户名\.claude\config.json。配置内容{primaryApiKey:any}⚠️ 注意此文件与命令行工具的settings.json是两个独立文件不要混淆。四、开始使用配置完成后在终端执行以下命令启动Claude Codeclaude首次启动会进入交互界面可直接输入问题或代码需求。若需查看支持的命令执行claude--help五、常见问题排查问题启动后提示“Unable to connect to Anthropic services”症状启动Claude Code后提示无法连接到服务。原因首次启动引导流程未完成。解决方案在用户根目录创建.claude.json文件跳过引导文件路径C:\Users\你的用户名\.claude.json注意是用户根目录非.claude文件夹内。文件内容{hasCompletedOnboarding:true}保存后重启Claude Code即可。额外排查若仍无法连接检查网络是否正常、API Key是否正确配置或重启终端/IDE后重试。总结国内环境下使用Claude Code核心就是解决“Node.js环境”和“API连接”两个问题。本文从安装Node.js到配置88api接口再到常见报错处理提供了完整的实操步骤亲测在Windows系统下可以稳定运行。如果按步骤操作仍遇到问题建议重点检查Node.js版本需≥18和API配置路径注意.claude文件夹和根目录的区别。欢迎在评论区交流你的实操经验一起少踩坑