告别海外账号！Claude Code Windows完整部署指南：从Node.js到api对接（附避坑）

前言这篇文章针对小白会从Node.js环境搭建开始到Claude Code安装、API配置再到常见问题处理全程基于Windows系统用国内可直接访问的接口方案尽量帮你少走弯路快速上手。正文一、准备工作安装Node.jsClaude Code运行依赖Node.js环境最低要求Node.js ≥18建议选LTS稳定版。方法一官网下载推荐访问Node.js官网下载Windows LTS版本安装包双击安装包按向导完成安装默认选项即可会自动配置环境变量方法二包管理器安装适合熟悉命令行的用户如果已安装Chocolatey或Scoop可直接用命令安装# Chocolateychocoinstallnodejs# Scoopscoopinstallnodejs验证安装打开PowerShell建议管理员模式输入以下命令检查版本node--version# 输出v18.x.x或更高npm--version# 输出对应npm版本⚠️ 提示若遇权限报错右键PowerShell选择“以管理员身份运行”即可。二、安装Claude CodeNode.js环境就绪后用npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code安装完成后验证claude--version# 输出类似 0.1.0 的版本号说明安装成功三、配置API连接核心步骤前提获取API Key调用Claude模型需要API Key我最近用的是88api(官网https://api.88api.shop)作为接口中转省去海外账号和翻墙麻烦国内直连。大家有自己的也可以。这里以88api为例获取Key的步骤注册并登录后点击侧边栏“API令牌”。点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用点击提交5. 点击复制按钮复制API令牌也就是API KEY方法一配置文件推荐永久生效在用户目录下创建配置文件步骤如下配置文件路径替换你的用户名为实际系统用户名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仅重启终端可能不生效。VSCode插件配置可选如果使用VSCode的Claude插件需额外创建config.json配置文件路径C:\Users\你的用户名\.claude\config.json配置内容{primaryApiKey:any}创建步骤同方法一在.claude文件夹中新建config.json并粘贴上述内容。四、开始使用Claude Code配置完成后在PowerShell中输入以下命令启动claude首次启动会进入交互界面可直接输入问题或代码需求。如需查看命令帮助claude--help五、常见问题排查问题Unable to connect to Anthropic services无法连接服务症状启动后提示无法连接到Anthropic服务。解决方案创建.claude.json文件跳过引导流程文件路径C:\Users\你的用户名\.claude.json配置内容{hasCompletedOnboarding:true}创建步骤在用户根目录非.claude文件夹新建.claude.json粘贴上述内容保存重启Claude Code即可。调试技巧若仍无法连接检查网络、重启IDE或重新核对API Key是否配置正确。总结本文从Node.js环境搭建到Claude Code安装再到API配置和常见问题处理提供了一套完整的Windows本地部署方案尤其适合国内用户无需海外账号和翻墙。核心在于API配置的准确性以及环境变量/配置文件的正确生效。如果按步骤操作仍遇到问题欢迎在评论区留言我会尽量回复。技术工具配置虽繁琐但一步步跟着做总能跑通——这也是我写这篇教程的初衷。