国内环境轻松跑Claude Code：Windows安装+API配置完整教程（亲测有效，少踩坑）

前言最近花了点时间整理出一套完整流程从安装到调用全程在Windows环境下测试通过特别是用了API中转服务省去了海外账户和网络的麻烦。如果你也想快速上手Claude Code这篇文章应该能帮你少走不少弯路。正文一、安装Node.js环境Claude Code运行依赖Node.js官方要求最低版本18建议用LTS稳定版先把这个基础环境搭好。方法一官网下载推荐新手访问Node.js官网下载LTS版本安装包通常是首页大按钮那个双击安装包按向导提示完成安装一路下一步即可建议勾选Add to PATH方法二包管理器安装适合有经验用户如果习惯用包管理器可以直接在PowerShell中执行# Chocolatey用户chocoinstallnodejs# Scoop用户scoopinstallnodejs验证安装是否成功安装完成后打开PowerShell输入以下命令能显示版本号说明安装成功node--version# 输出v18.x.x或更高npm--version# 输出对应的npm版本⚠️ 小贴士如果提示命令不存在检查安装时是否勾选了Add to PATH或重启终端再试。权限问题可右键PowerShell选择以管理员身份运行。二、安装Claude CodeNode.js环境就绪后用npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code安装完成后验证一下claude--version# 输出类似1.0.0的版本号三、配置API连接关键步骤这一步是核心需要获取API Key并配置连接信息。我这次用了88apihttps://api.88api.shop作为中转主要是省去了海外账户注册和网络配置的麻烦国内直连也稳定一个Key还能管理多个模型比较方便。1. 获取API Key以88api为例获取Key的步骤如下注册并登录后点击侧边栏“API令牌”。点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用点击提交点击复制按钮复制API令牌也就是API KEY2. 配置方式二选一方法一配置文件推荐永久生效在用户目录下创建配置文件步骤如下配置文件路径C:\Users\你的用户名\.claude\settings.json注意替换你的用户名为实际系统用户名配置内容{env:{ANTHROPIC_AUTH_TOKEN:你的API密钥,// 替换为刚才复制的API KeyANTHROPIC_BASE_URL:https://api.88api.shop// 中转服务地址}}创建步骤打开文件资源管理器进入C:\Users\你的用户名\目录新建文件夹.claude如果已存在则跳过在.claude文件夹内新建settings.json文件粘贴上述配置并保存方法二环境变量临时或永久如果不想用配置文件也可以通过环境变量配置临时设置当前会话有效$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)验证环境变量是否配置成功$env:ANTHROPIC_BASE_URL# 应输出设置的URL$env:ANTHROPIC_AUTH_TOKEN# 应输出设置的Key⚠️ 重要提示配置完成后必须重启终端如果在VS Code/Cursor等IDE的集成终端中使用需要彻底重启整个IDE不只是重启终端窗口否则配置可能不生效。3. VSCode插件配置可选如果使用VSCode的Claude插件还需要额外创建一个配置文件配置文件路径C:\Users\你的用户名\.claude\config.json配置内容{primaryApiKey:any}创建步骤在.claude文件夹内新建config.json粘贴上述内容保存即可。⚠️ 注意这是VSCode插件专用的config.json和命令行工具的settings.json是两个不同文件不要混淆。四、开始使用Claude Code配置完成后在PowerShell中输入以下命令启动claude首次启动会进入交互界面输入claude --help可以查看支持的命令比如代码解释、生成、优化等功能。五、常见问题排查问题启动后提示Unable to connect to Anthropic services症状启动Claude Code后显示无法连接服务。解决方案这通常是首次启动引导未完成导致的需要手动创建跳过引导的配置文件文件路径C:\Users\你的用户名\.claude.json注意是用户根目录不是.claude文件夹内配置内容{hasCompletedOnboarding:true}创建步骤在用户根目录新建.claude.json文件粘贴上述内容保存重启Claude Code即可。调试小技巧如果仍无法连接检查网络是否正常API Key是否正确配置或重启终端/IDE后重试。总结其实Claude Code的安装配置并不复杂核心就是Node.js环境、API Key获取和连接配置这三步。国内用户通过中转服务可以避开海外账户和网络的麻烦按本文步骤操作基本能一次跑通。如果遇到连接问题优先检查配置文件路径和内容是否正确或参考常见问题中的解决方案。有其他问题欢迎在评论区交流一起提升开发效率