Claude Code安装+88api中转配置一篇搞定(Windows)

Claude Code安装+88api中转配置一篇搞定(Windows)

前言

最近整理了这份Windows下的Claude Code安装配置实操指南,从Node.js环境搭建到API直连配置,每一步都亲测过,尤其解决了国内访问的麻烦,希望能帮你少走弯路。

正文

一、安装Node.js环境

Claude Code运行依赖Node.js,最低要求Node.js ≥18(建议安装LTS版本,稳定性更好)。

方法一:官网下载(推荐新手)
  1. 访问Node.js官网,下载Windows LTS版本安装包
  2. 双击安装包,按向导提示完成安装(默认选项即可,会自动配置环境变量)
方法二:包管理器安装(适合有经验用户)

如果已安装Chocolatey或Scoop包管理器,可直接用命令安装:

# Chocolatey用户chocoinstallnodejs# Scoop用户scoopinstallnodejs
验证安装是否成功

打开PowerShell(建议管理员模式,避免权限问题),输入以下命令检查版本:

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

二、安装Claude Code

Node.js环境就绪后,通过npm全局安装Claude Code:

npminstall-g@anthropic-ai/claude-code

安装完成后验证:

claude--version# 显示版本号即安装成功

三、配置API连接(核心步骤)

1. 获取API Key

使用Claude Code需要API Key,我这次用的是88api中转接口(官网:https://api.88api.shop),主要是为了省去海外账户注册和翻墙的麻烦,国内环境可直接调用,还能统一管理多个模型的API 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

配置内容(替换"你的API密钥"为实际复制的Key):

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

创建步骤

  1. 打开文件资源管理器,进入C:\Users\<你的用户名>\目录
  2. 新建文件夹.claude(若已存在则跳过)
  3. .claude文件夹内新建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# 应显示设置的URL$env:ANTHROPIC_AUTH_TOKEN# 应显示设置的Key

⚠️ 注意:配置完成后需重启终端,若在VS Code等IDE中使用,需彻底重启IDE(仅重启终端可能不生效)。

3. VSCode插件配置(可选)

如果使用VSCode的Claude插件,需额外创建插件配置文件:
配置文件路径

C:\Users\<你的用户名>\.claude\config.json

配置内容

{"primaryApiKey":"any"}

创建步骤

  1. 进入C:\Users\<你的用户名>\.claude\目录
  2. 新建config.json文件,粘贴上述内容并保存

四、启动并使用Claude Code

配置完成后,在PowerShell中输入以下命令启动:

claude

首次启动可能需要简单交互,按提示操作即可。如需查看支持的命令,输入:

claude--help

五、常见问题排查

问题:启动后提示“Unable to connect to Anthropic services”

原因:首次启动引导流程未完成。
解决方案:在用户根目录创建.claude.json文件跳过引导:

文件路径

C:\Users\<你的用户名>\.claude.json

配置内容

{"hasCompletedOnboarding":true}

创建步骤

  1. 进入C:\Users\<你的用户名>\目录
  2. 新建.claude.json文件(注意在用户根目录,非.claude文件夹内)
  3. 粘贴上述内容保存,重启Claude Code

调试技巧:若仍无法连接,检查网络、重启终端/IDE,或确认API Key和Base URL配置是否正确。

总结

这份教程从Node.js环境搭建到API配置,再到常见问题解决,覆盖了Windows下使用Claude Code的完整流程。核心在于正确配置API Key和中转地址,以及解决首次启动的引导问题。国内用户通过中转接口可省去不少环境麻烦,亲测能稳定运行。如果遇到其他问题,欢迎在评论区交流,一起完善这份实操指南。