国内环境如何跑通Claude Code？保姆级Windows安装教程，API配置+常见错误修复一篇讲清

前言想体验Claude Code却被环境配置劝退不少开发者反馈要么教程太碎片化要么默认海外环境国内用户跟着做总遇到连接失败。这篇文章从Node.js安装到API对接一步步带你在Windows系统跑通亲测有效尽量帮你少走弯路。正文一、准备工作安装Node.jsClaude Code运行依赖Node.js环境最低要求Node.js ≥18建议LTS版本。方法一官网下载推荐访问Node.js官网下载LTS版本双击安装包按向导完成安装默认选项即可方法二包管理器安装如果习惯命令行可通过包管理器安装# Chocolateychocoinstallnodejs# Scoopscoopinstallnodejs验证安装打开终端建议PowerShell输入以下命令出现版本号即安装成功node--version# 输出示例v20.11.0npm--version# 输出示例10.2.4⚠️ 提示若遇权限问题尝试以管理员身份运行终端。二、安装Claude Code通过npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code安装完成后验证claude--version# 输出版本号即成功三、配置API连接获取API Key本人最近用的是 88api 中转服务网址https://api.88api.shop相比较官方更划算推荐大家可以试试。以下是具体步骤注册登录以后点击侧边栏的 “API 令牌”点击添加令牌创建令牌名称随意直接提交获取 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文件粘贴上述配置内容替换你的API密钥为实际Key并保存方法二环境变量配置若不想使用配置文件可通过环境变量临时或永久设置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# 应输出API地址$env:ANTHROPIC_AUTH_TOKEN# 应输出你的API密钥⚠️ 注意配置完成后需重启终端若在VS Code/Cursor等IDE中使用需彻底重启IDE才能生效。VSCode插件配置可选如果使用VSCode的Claude插件需额外创建插件配置文件配置文件路径C:\Users\你的用户名\.claude\config.json配置内容{primaryApiKey:any}创建步骤进入C:\Users\你的用户名\.claude\目录新建config.json文件粘贴上述内容并保存四、开始使用Claude Code在终端输入以下命令启动claude可通过claude --help查看支持的命令例如代码解释、生成等功能。五、常见问题排查问题Unable to connect to Anthropic services症状启动后提示无法连接服务。解决方案创建.claude.json文件跳过引导流程配置文件路径C:\Users\你的用户名\.claude.json配置内容{hasCompletedOnboarding:true}创建步骤进入用户根目录C:\Users\你的用户名\新建.claude.json文件粘贴上述内容并保存重启Claude Code调试技巧检查网络连接确认API Key和地址配置正确重启终端或IDE后重试总结通过本文教程你已完成Claude Code在Windows系统的安装与API配置解决了国内环境下的连接问题。核心在于正确配置API地址和密钥遇到连接失败时记得检查.claude目录下的配置文件或创建.claude.json。如果还有其他问题欢迎在评论区交流一起完善这个配置方案。