Claude Code安装+88api中转配置一篇搞定(Windows)
前言
最近整理了这份Windows下的Claude Code安装配置实操指南,从Node.js环境搭建到API直连配置,每一步都亲测过,尤其解决了国内访问的麻烦,希望能帮你少走弯路。
正文
一、安装Node.js环境
Claude Code运行依赖Node.js,最低要求Node.js ≥18(建议安装LTS版本,稳定性更好)。
方法一:官网下载(推荐新手)
- 访问Node.js官网,下载Windows LTS版本安装包
- 双击安装包,按向导提示完成安装(默认选项即可,会自动配置环境变量)
方法二:包管理器安装(适合有经验用户)
如果已安装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。
有额度大家可以试试;或者大家也可以用自己的。
获取步骤如下:
注册并登录后,点击侧边栏“API令牌”。
点击“添加令牌”
选择分组
- 根据需要调用的模型选择分组
a. claude 模型建议使用 calude code 分组、
b. gpt 模型建议使用 codex分组 - 可通过平台的模型广场查看不同模型支持的分组
- 若在使用中出现上游分组饱和,请切换分组使用
- 根据需要调用的模型选择分组
点击提交
点击复制按钮复制API令牌,也就是API KEY
2. 配置方式(二选一)
方法一:配置文件(推荐,持久生效)
在用户目录下创建配置文件,步骤如下:
配置文件路径(需替换<你的用户名>为实际系统用户名):
C:\Users\<你的用户名>\.claude\settings.json配置内容(替换"你的API密钥"为实际复制的Key):
{"env":{"ANTHROPIC_AUTH_TOKEN":"你的API密钥","ANTHROPIC_BASE_URL":"https://api.88api.shop"}}创建步骤:
- 打开文件资源管理器,进入
C:\Users\<你的用户名>\目录 - 新建文件夹
.claude(若已存在则跳过) - 在
.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"}创建步骤:
- 进入
C:\Users\<你的用户名>\.claude\目录 - 新建
config.json文件,粘贴上述内容并保存
四、启动并使用Claude Code
配置完成后,在PowerShell中输入以下命令启动:
claude首次启动可能需要简单交互,按提示操作即可。如需查看支持的命令,输入:
claude--help五、常见问题排查
问题:启动后提示“Unable to connect to Anthropic services”
原因:首次启动引导流程未完成。
解决方案:在用户根目录创建.claude.json文件跳过引导:
文件路径:
C:\Users\<你的用户名>\.claude.json配置内容:
{"hasCompletedOnboarding":true}创建步骤:
- 进入
C:\Users\<你的用户名>\目录 - 新建
.claude.json文件(注意在用户根目录,非.claude文件夹内) - 粘贴上述内容保存,重启Claude Code
调试技巧:若仍无法连接,检查网络、重启终端/IDE,或确认API Key和Base URL配置是否正确。
总结
这份教程从Node.js环境搭建到API配置,再到常见问题解决,覆盖了Windows下使用Claude Code的完整流程。核心在于正确配置API Key和中转地址,以及解决首次启动的引导问题。国内用户通过中转接口可省去不少环境麻烦,亲测能稳定运行。如果遇到其他问题,欢迎在评论区交流,一起完善这份实操指南。
