前言最近AI代码工具更新太快很多教程刚出来就过时尤其是Claude Code这类工具环境配置和API对接总让新手头疼——不是Node.js版本不对就是海外接口连不上折腾半天还是报错。其实核心问题就两个一是国内环境下的API调用麻烦二是缺乏一篇能从头到尾跑通的完整步骤。我花了一下午整理出这套Windows版本流程从Node.js安装到API配置全细节尤其解决了国内直连的问题希望能帮你少踩坑。正文一、准备工作安装Node.js环境Claude Code运行依赖Node.js最低要求Node.js ≥18建议LTS版本稳定性更好。方法一官网下载推荐访问Node.js官网下载LTS版本通常是首页大按钮的推荐版本双击安装包按向导默认安装即可建议勾选Add to PATH自动配置环境变量方法二包管理器安装适合熟悉命令行的用户如果已安装Chocolatey或Scoop可直接用命令安装# Chocolateychocoinstallnodejs# Scoopscoopinstallnodejs验证安装是否成功打开PowerShell建议管理员模式避免权限问题输入以下命令node--version# 输出v18.x.x或更高版本npm--version# 输出对应的npm版本⚠️ 提示如果命令无效检查是否已重启终端或手动将Node.js安装路径默认C:\\Program Files\\nodejs添加到系统环境变量PATH中。二、安装Claude CodeNode.js环境就绪后用npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code安装完成后验证版本claude--version# 输出类似1.0.0的版本号说明安装成功三、配置API连接核心步骤1. 获取API Key在使用各种大模型比如Claudegpt等都需要API密钥我最近使用的是88api中转站https://api.88api.shop作为接口方案大家用自己的也可以。主要是为了减少国内环境下的网络配置和账号问题它支持国内直连且一个Key可管理多个模型如GPT、Gemini等切换方便。获取Key的步骤这里以我使用的api为例注册以后点击侧边栏的 API 令牌点击添加令牌选择分组a. 根据需要调用的模型选择分组aclaude 模型建议使用 calude code 分组、bgpt 模型建议使用 codex分组b. 可通过平台的模型广场查看不同模型支持的分组c. 若在使用中出现上游分组饱和请切换分组使用点击提交点击复制按钮复制API令牌也就是API KEY2. 配置方式二选一推荐配置文件方法一配置文件永久生效推荐在用户目录下创建配置文件路径和内容如下配置文件路径替换你的用户名为实际系统用户名C:\\Users\\你的用户名\\.claude\\settings.json配置内容替换你的API密钥为实际复制的Key{env:{ANTHROPIC_AUTH_TOKEN:你的API密钥,ANTHROPIC_BASE_URL:https://aicode.cat}}创建步骤打开文件资源管理器进入C:\\Users\\你的用户名\\目录新建文件夹.claude如果已存在则跳过在.claude文件夹中新建settings.json文件粘贴上述配置并保存方法二环境变量临时或永久如果不想用配置文件可通过环境变量设置PowerShell临时设置仅当前会话有效$env:ANTHROPIC_BASE_URLhttps://aicode.cat$env:ANTHROPIC_AUTH_TOKEN你的API密钥PowerShell永久设置用户级重启终端生效[System.Environment]::SetEnvironmentVariable(ANTHROPIC_BASE_URL,https://aicode.cat,[System.EnvironmentVariableTarget]::User)[System.Environment]::SetEnvironmentVariable(ANTHROPIC_AUTH_TOKEN,你的API密钥,[System.EnvironmentVariableTarget]::User)验证环境变量$env:ANTHROPIC_BASE_URL# 输出https://aicode.cat$env:ANTHROPIC_AUTH_TOKEN# 输出你的API密钥⚠️ 重要提示配置完成后必须重启终端如果在VS Code/Cursor等IDE中使用需彻底重启IDE仅重启终端可能不生效。3. VSCode插件配置可选如果使用VSCode的Claude插件需额外创建config.json配置文件路径C:\\Users\\你的用户名\\.claude\\config.json配置内容{primaryApiKey:any}创建步骤进入C:\\Users\\你的用户名\\.claude\\目录新建config.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.json文件注意是用户根目录不是.claude文件夹内粘贴上述内容保存重启Claude Code调试技巧检查网络连接是否正常确认API Key和ANTHROPIC_BASE_URL配置正确重启终端或IDE后重试总结这套流程覆盖了Claude Code在Windows系统从环境准备到API对接的全步骤核心解决了国内直连和配置繁琐的问题。关键在于Node.js版本、API配置文件路径和重启终端这三个细节按步骤操作基本能一次跑通。如果遇到其他报错可先检查配置文件路径和内容是否正确或参考常见问题部分。有问题欢迎在评论区交流一起完善这套方案~