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

前言

最近花了点时间整理出一套完整流程，从安装到调用全程在Windows环境下测试通过，特别是用了API中转服务省去了海外账户和网络的麻烦。

如果你也想快速上手Claude Code，这篇文章应该能帮你少走不少弯路。

正文

一、安装Node.js环境

Claude Code运行依赖Node.js，官方要求最低版本18（建议用LTS稳定版），先把这个基础环境搭好。

方法一：官网下载（推荐新手）

1. 访问Node.js官网，下载LTS版本安装包（通常是首页大按钮那个）
2. 双击安装包，按向导提示完成安装（一路下一步即可，建议勾选"Add to PATH"）

方法二：包管理器安装（适合有经验用户）

如果习惯用包管理器，可以直接在PowerShell中执行：

# Chocolatey用户chocoinstallnodejs# Scoop用户scoopinstallnodejs

验证安装是否成功

安装完成后，打开PowerShell输入以下命令，能显示版本号说明安装成功：

node--version# 输出v18.x.x或更高npm--version# 输出对应的npm版本

⚠️ 小贴士：如果提示"命令不存在"，检查安装时是否勾选了"Add to PATH"，或重启终端再试。权限问题可右键PowerShell选择"以管理员身份运行"。

二、安装Claude Code

Node.js环境就绪后，用npm全局安装Claude Code：

npminstall-g@anthropic-ai/claude-code

安装完成后验证一下：

claude--version# 输出类似1.0.0的版本号

三、配置API连接（关键步骤）

这一步是核心，需要获取API Key并配置连接信息。我这次用了88api（https://api.88api.shop）作为中转，主要是省去了海外账户注册和网络配置的麻烦，国内直连也稳定，一个Key还能管理多个模型，比较方便。

1. 获取API Key

以88api为例，获取Key的步骤如下：

1. 注册并登录后，点击侧边栏“API令牌”。
   

2. 点击“添加令牌”
   

3. 选择分组

   1. 根据需要调用的模型选择分组
      a. claude 模型建议使用 calude code 分组、
      b. gpt 模型建议使用 codex分组
   2. 可通过平台的模型广场查看不同模型支持的分组
   3. 若在使用中出现上游分组饱和，请切换分组使用
      

4. 点击提交
   

5. 点击复制按钮复制API令牌，也就是API KEY
   

2. 配置方式（二选一）

方法一：配置文件（推荐，永久生效）

在用户目录下创建配置文件，步骤如下：

• 配置文件路径：C:\Users\<你的用户名>\.claude\settings.json（注意替换<你的用户名>为实际系统用户名）
• 配置内容：

{"env":{"ANTHROPIC_AUTH_TOKEN":"你的API密钥",// 替换为刚才复制的API Key"ANTHROPIC_BASE_URL":"https://api.88api.shop"// 中转服务地址}}

• 创建步骤：
  1. 打开文件资源管理器，进入C:\Users\<你的用户名>\目录
  2. 新建文件夹.claude（如果已存在则跳过）
  3. 在.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获取和连接配置这三步。国内用户通过中转服务可以避开海外账户和网络的麻烦，按本文步骤操作基本能一次跑通。如果遇到连接问题，优先检查配置文件路径和内容是否正确，或参考常见问题中的解决方案。有其他问题欢迎在评论区交流，一起提升开发效率！