别再东拼西凑了！Claude Code Windows安装+API配置一条龙，国内环境手把手教你跑通

前言最近想体验Claude Code却发现网上教程要么步骤不全要么环境配置讲得模糊。AI工具更新快旧教程很容易失效折腾半天还是跑不起来。这篇文章整理了我亲测可行的完整流程从基础环境搭建到API配置一步步带你解决安装和连接难题尽量帮你少踩坑。正文一、安装Node.js环境Claude Code运行依赖Node.js最低要求Node.js ≥18建议使用LTS版本。方法一官网下载安装推荐访问Node.js官网下载LTS版本安装包双击安装包按向导提示完成安装默认选项即可无需额外配置方法二通过包管理器安装如果习惯命令行操作可使用Chocolatey或Scoop安装# Chocolatey安装命令chocoinstallnodejs# Scoop安装命令scoopinstallnodejs验证安装是否成功打开终端建议用PowerShell输入以下命令出现版本号即表示安装成功node--version# 输出示例v20.11.0npm--version# 输出示例10.2.4⚠️ 注意若遇权限问题可尝试以管理员身份运行终端。二、安装Claude CodeNode.js环境就绪后通过npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code安装完成后验证版本claude--version若终端显示版本号说明安装成功。三、配置API连接获取API KeyAPI连接需要有效的密钥这次实操中我用了88api中转服务官网https://api.88api.shop主要是为了省去海外账户注册和复杂网络配置推荐大家可以试试或者大家可以用自己的。以下是具体步骤1.注册登录后点击 “API 令牌”2.点击添加令牌3. 创建令牌名称随便写没有含义直接点击提交即可。获取 API KEY获得 API Key 后请妥善保管API Key 是你的身份凭证等同于账号密码切勿公开或分享给他人。点击“知道了”可以看到我们刚才创建的在这里也同样可以点击 复制 按钮去获取 API Key。方法一通过配置文件设置推荐在用户目录下创建配置文件永久保存API信息配置文件路径C:\Users\你的用户名\.claude\settings.json配置内容{env:{ANTHROPIC_AUTH_TOKEN:你的API密钥,ANTHROPIC_BASE_URL:https://api.88api.shop}}创建步骤打开文件资源管理器进入C:\Users\你的用户名\目录新建文件夹.claude若已存在则跳过在.claude文件夹中新建settings.json文件粘贴上述配置并保存方法二通过环境变量设置若不想使用配置文件可通过环境变量临时或永久配置PowerShell临时设置仅当前会话有效$env:ANTHROPIC_BASE_URLhttps://api.88api.shop$env:ANTHROPIC_AUTH_TOKEN你的API密钥PowerShell永久设置用户级重启终端生效[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$env:ANTHROPIC_AUTH_TOKEN⚠️ 重要提示请将你的API密钥替换为实际获取的密钥配置完成后需重启终端若使用VS Code/Cursor等IDE的集成终端需彻底重启IDE才能生效VSCode插件配置可选如果使用VSCode的Claude插件需额外创建插件专用配置文件配置文件路径C:\Users\你的用户名\.claude\config.json配置内容{primaryApiKey:any}创建步骤进入C:\Users\你的用户名\.claude\目录若.claude文件夹不存在先按方法一创建新建config.json文件粘贴上述内容并保存⚠️ 注意此文件config.json与Claude Code命令行工具的配置文件settings.json是两个独立文件不要混淆。四、开始使用Claude Code完成配置后在终端输入以下命令启动claude若需要查看支持的命令可运行claude--help五、常见问题排查问题启动后提示“Unable to connect to Anthropic services”症状启动Claude Code后无法连接服务提示连接失败。解决方案通常是首次启动引导未完成导致需在用户根目录创建.claude.json文件跳过引导配置文件路径C:\Users\你的用户名\.claude.json配置内容{hasCompletedOnboarding:true}创建步骤进入C:\Users\你的用户名\目录注意是用户根目录不是.claude文件夹内新建.claude.json文件粘贴上述内容并保存重启Claude Code调试技巧若仍无法连接可检查网络连接是否正常API Key和Base URL配置是否正确重启终端或IDE后重试总结这篇教程从Node.js环境搭建到Claude Code安装再到API连接配置提供了完整的操作流程解决了国内环境下常见的安装和连接问题。核心在于通过配置文件或环境变量正确设置API信息遇到连接失败时通过创建.claude.json文件跳过引导即可。按照步骤操作基本能顺利跑通。如果还有其他问题欢迎在评论区交流~