前言最近AI工具更新太快很多教程没跟上版本变化尤其是Claude Code这类需要特定环境的工具新手很容易卡在安装配置环节。要么Node.js版本不对要么API连接总失败国内用户还得处理网络问题。这篇文章整理了我亲测跑通的完整流程从Node.js环境搭建到API对接连常见报错都附上解决办法尽量让大家少踩坑。正文一、准备工作安装Node.jsClaude Code运行依赖Node.js环境最低要求Node.js ≥18建议用LTS版本更稳定。方法一官网下载推荐访问Node.js官网下载LTS版本安装包双击安装包按向导完成安装默认选项即可会自动配置环境变量方法二包管理器安装适合熟悉命令行的用户如果已安装Chocolatey或Scoop可直接用命令安装# Chocolateychocoinstallnodejs# Scoopscoopinstallnodejs验证安装是否成功打开终端建议用PowerShell输入以下命令出现版本号即安装成功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连接核心步骤获取API KeyClaude Code需要API Key才能调用服务。我最近在用 88api作为中转接口网址https://api.88api.shop。大家也可以根据自己情况选择合适的API服务。以88api为例获取Key的步骤如下1.注册登录后点击 “API 令牌”2.点击添加令牌3. 创建令牌名称随便写没有含义直接点击提交即可。获取 API KEY获得 API Key 后请妥善保管API Key 是你的身份凭证等同于账号密码切勿公开或分享给他人。点击“知道了”可以看到我们刚才创建的在这里也同样可以点击 复制 按钮去获取 API Key。配置方式一配置文件推荐永久生效在用户目录下创建配置文件步骤如下打开文件资源管理器进入路径C:\Users\你的用户名\替换你的用户名为实际系统用户名新建文件夹.claude若已存在则跳过在.claude文件夹中新建文件settings.json内容如下{env:{ANTHROPIC_AUTH_TOKEN:你的API密钥,// 替换为实际复制的API KeyANTHROPIC_BASE_URL:https://api.88api.shop// 中转接口地址}}配置方式二环境变量临时或永久如果不想用配置文件可通过环境变量配置临时设置仅当前终端会话有效$env:ANTHROPIC_BASE_URL https://api.88api.shop$env:ANTHROPIC_AUTH_TOKEN 你的API密钥//替换为实际Key永久设置用户级全局生效[System.Environment]::SetEnvironmentVariable(ANTHROPIC_BASE_URL,https://api.88api.shop,[System.EnvironmentVariableTarget]::User)[System.Environment]::SetEnvironmentVariable(ANTHROPIC_AUTH_TOKEN,你的API密钥,[System.EnvironmentVariableTarget]::User)⚠️ 注意配置后需重启终端若在VS Code等IDE中使用需重启整个IDE才能生效。可通过以下命令验证环境变量是否配置成功$env:ANTHROPIC_BASE_URL# 应输出接口地址$env:ANTHROPIC_AUTH_TOKEN# 应输出API KeyVSCode插件配置可选如果使用VSCode的Claude插件需额外创建config.json进入路径C:\Users\你的用户名\.claude\新建文件config.json内容如下{primaryApiKey:any}⚠️ 注意这是插件专用配置文件与命令行工具的settings.json是两个不同文件不要混淆。四、启动Claude Code配置完成后在终端输入以下命令启动claude首次启动会进入交互界面可直接输入问题使用。若需查看支持的命令输入claude--help五、常见问题排查问题启动后提示Unable to connect to Anthropic services症状启动Claude Code后提示无法连接服务。解决办法这通常是首次启动引导未完成导致需手动创建.claude.json文件跳过引导进入路径C:\Users\你的用户名\用户根目录非.claude文件夹新建文件.claude.json内容如下{hasCompletedOnboarding:true}保存后重启Claude Code即可。调试技巧若仍无法连接检查网络是否正常、API Key是否正确配置或重启终端/IDE后重试。总结这篇教程从Node.js环境搭建到API配置再到常见问题解决覆盖了Claude Code在Windows系统的完整部署流程。核心是通过API中转实现国内直连避免了海外账户和网络问题。如果按步骤操作仍遇到问题欢迎在评论区留言我会尽量帮忙解答。技术配置难免踩坑关键是耐心排查每一步祝大家顺利用上Claude Code