前言

最近想尝试Claude Code,但海外环境配置和账号问题总是让人头疼?很多教程要么步骤不全,要么默认国外环境,国内用户跟着做容易卡壳。

这篇文章手把手教你在Windows上从安装Node.js到配置Claude Code的完整流程,无需海外账号,国内直连就能用,亲测每一步都能跑通。

正文

一、安装Node.js环境

Claude Code需要Node.js环境运行,最低要求Node.js >=18(建议LTS版本)。

方法一:官网下载(推荐)
  1. 访问Node.js官网下载LTS版本
  2. 双击安装包按向导完成安装
方法二:包管理器安装
# Chocolatey
choco install nodejs

# Scoop
scoop install nodejs
验证安装

出现版本号即成功:

node --version
# 输出示例:v20.11.0

npm --version
# 输出示例:10.2.4

⚠️TIP:建议使用PowerShell;如遇权限问题可尝试以管理员身份运行。

二、安装Claude Code CLI工具

执行以下命令全局安装:

npm install -g @anthropic-ai/claude-code

验证安装:

claude --version

三、配置API连接

获取API Key

本次使用88api中转服务(官网:https://api.88api.shop),推荐大家可以试试,或者大家也可以用自己的。

以88api为例获取Key:

  1. 注册登录以后,点击侧边栏的 “API 令牌”

  1. 点击"添加令牌"

  1. 创建令牌,名称随意,直接提交

  1. 获取 API Key,注意妥善保管,不要公开或分享

  1. 点击"知道了",在令牌列表中可以点击"复制"按钮获取 API Key

方法一:配置文件(推荐)

在用户目录创建.claude文件夹和settings.json
路径C:\Users\<你的用户名>\.claude\settings.json
内容

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "https://api.88api.shop"
  }
}

创建步骤

  1. 进入C:\Users\<你的用户名>\目录
  2. 新建.claude文件夹(如已存在跳过)
  3. 在文件夹内新建settings.json并粘贴配置内容
方法二:环境变量
PowerShell临时设置(当前会话)
$env:ANTHROPIC_BASE_URL = "https://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
$env:ANTHROPIC_AUTH_TOKEN

⚠️WARNING:替换“你的API密钥”为实际Key;配置后需重启终端/IDE生效。

VSCode插件配置(可选)

若使用VSCode Claude插件,需创建config.json
路径C:\Users\<你的用户名>\.claude\config.json
内容

{
  "primaryApiKey": "any"
}

创建步骤

  1. 进入.claude目录
  2. 新建config.json并粘贴内容

四、开始使用

运行以下命令启动Claude Code:

claude

查看帮助:claude --help

五、常见问题排查

问题:Unable to connect to Anthropic services

症状:启动后提示无法连接服务
解决方案:创建.claude.json跳过引导:
路径C:\Users\<你的用户名>\.claude.json
内容

{
  "hasCompletedOnboarding": true
}

步骤

  1. 进入用户根目录
  2. 新建.claude.json并粘贴内容
  3. 重启Claude Code

调试技巧:检查网络、重启终端/IDE、确认API配置正确。

总结

这篇教程从Node.js安装到Claude Code配置,再到API对接,覆盖了国内用户使用的核心步骤。通过88api中转服务,省去了海外账号和翻墙的麻烦,让你快速上手Claude Code。如果遇到连接问题,记得检查配置文件或环境变量,重启终端或IDE。希望这篇教程能帮你少踩坑,顺利使用Claude Code~ 有问题欢迎在评论区交流!

Logo

汇聚全球AI编程工具,助力开发者即刻编程。

更多推荐