前言这篇文章整理了我亲测跑通的完整流程从Node.js环境搭建到Claude Code安装再到用API中转解决国内直连问题每个步骤都标了详细路径和命令。如果你也想省心用上Claude Code跟着一步步操作基本10分钟就能搞定。正文一、准备工作安装Node.js环境Claude Code运行依赖Node.js官方要求最低版本≥18建议用LTS稳定版。方法一官网下载安装推荐访问Node.js官网下载LTS版本安装包双击安装包按向导提示完成安装默认选项即可会自动配置环境变量方法二包管理器安装适合熟悉命令行的用户如果电脑装了Chocolatey或Scoop可以直接用命令安装# Chocolatey用户chocoinstallnodejs# Scoop用户scoopinstallnodejs验证安装是否成功打开PowerShell建议管理员模式输入以下命令检查版本node--version# 应显示v18.x.x或更高npm--version# 应显示对应的npm版本⚠️ 注意如果提示命令不存在可能是环境变量未生效建议重启终端或检查安装路径是否添加到系统环境变量。二、安装Claude CodeNode.js环境就绪后用npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code安装完成后验证是否成功claude--version# 应显示当前安装的版本号三、配置API连接核心步骤1. 获取API KeyClaude Code需要API Key才能调用服务。我这里用的是88api中转接口网址https://api.88api.shop主要图它国内直连不用翻墙而且一个Key能对接多个模型省了注册多个海外账号的麻烦。推荐大家试试或者大家也可以用自己的。下面以88API 为例:获取Key的步骤1.注册并登录后点击侧边栏“API令牌”。2. 点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用4.点击提交5. 点击复制按钮复制API令牌也就是API KEY2. 配置连接推荐用配置文件创建配置文件是最稳定的方式步骤如下配置文件路径C:\Users\你的用户名\.claude\settings.json将你的用户名替换为实际系统用户名配置内容{env:{ANTHROPIC_AUTH_TOKEN:你的API密钥,// 替换为刚复制的KeyANTHROPIC_BASE_URL:https://api.88api.shop// API中转地址}}创建步骤打开文件资源管理器进入C:\Users\你的用户名\目录新建文件夹.claude如果已存在则跳过在.claude文件夹中新建settings.json文件粘贴上述配置并保存3. 备选方案环境变量配置如果不想用配置文件也可以通过环境变量设置仅当前用户生效PowerShell临时设置仅当前会话$env:ANTHROPIC_BASE_URLhttps://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)⚠️ 重要配置完成后必须重启终端如果在VS Code等IDE中使用需要重启整个IDE否则配置可能不生效。4. VSCode插件配置可选如果用VSCode的Claude插件还需要额外创建config.json配置文件路径C:\Users\你的用户名\.claude\config.json配置内容{primaryApiKey:any}创建步骤进入.claude文件夹之前创建的新建config.json文件粘贴上述内容保存注意这是插件专用配置和命令行工具的settings.json是两个文件不要弄混。四、开始使用Claude Code配置完成后在终端输入以下命令启动claude首次启动可能会提示协议确认按提示操作即可。想了解更多命令可输入claude--help五、常见问题排查问题启动后提示Unable to connect to Anthropic services原因首次启动引导流程未完成。解决在用户根目录创建.claude.json文件跳过引导文件路径C:\Users\你的用户名\.claude.json注意是用户根目录不是.claude文件夹内配置内容{hasCompletedOnboarding:true}创建步骤进入C:\Users\你的用户名\目录新建.claude.json文件粘贴上述内容保存重启Claude Code如果仍无法连接检查API Key是否正确复制时是否多了空格确认网络能访问https://api.88api.shop重启终端或IDE后重试总结其实Claude Code配置不复杂核心就是环境搭建API对接两步。这篇教程从Node.js安装到API中转配置再到常见报错解决基本覆盖了国内用户会遇到的所有问题。按步骤操作10分钟就能从不会配到能用起来。如果遇到其他报错欢迎在评论区留言我会尽量回复。技术工具的价值在于解决问题希望这篇教程能帮你少踩坑把时间花在更有价值的开发上。
告别海外账号！Claude Code Windows完整安装+API对接指南，小白也能照着做
发布时间：2026/5/21 7:31:32
前言这篇文章整理了我亲测跑通的完整流程从Node.js环境搭建到Claude Code安装再到用API中转解决国内直连问题每个步骤都标了详细路径和命令。如果你也想省心用上Claude Code跟着一步步操作基本10分钟就能搞定。正文一、准备工作安装Node.js环境Claude Code运行依赖Node.js官方要求最低版本≥18建议用LTS稳定版。方法一官网下载安装推荐访问Node.js官网下载LTS版本安装包双击安装包按向导提示完成安装默认选项即可会自动配置环境变量方法二包管理器安装适合熟悉命令行的用户如果电脑装了Chocolatey或Scoop可以直接用命令安装# Chocolatey用户chocoinstallnodejs# Scoop用户scoopinstallnodejs验证安装是否成功打开PowerShell建议管理员模式输入以下命令检查版本node--version# 应显示v18.x.x或更高npm--version# 应显示对应的npm版本⚠️ 注意如果提示命令不存在可能是环境变量未生效建议重启终端或检查安装路径是否添加到系统环境变量。二、安装Claude CodeNode.js环境就绪后用npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code安装完成后验证是否成功claude--version# 应显示当前安装的版本号三、配置API连接核心步骤1. 获取API KeyClaude Code需要API Key才能调用服务。我这里用的是88api中转接口网址https://api.88api.shop主要图它国内直连不用翻墙而且一个Key能对接多个模型省了注册多个海外账号的麻烦。推荐大家试试或者大家也可以用自己的。下面以88API 为例:获取Key的步骤1.注册并登录后点击侧边栏“API令牌”。2. 点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用4.点击提交5. 点击复制按钮复制API令牌也就是API KEY2. 配置连接推荐用配置文件创建配置文件是最稳定的方式步骤如下配置文件路径C:\Users\你的用户名\.claude\settings.json将你的用户名替换为实际系统用户名配置内容{env:{ANTHROPIC_AUTH_TOKEN:你的API密钥,// 替换为刚复制的KeyANTHROPIC_BASE_URL:https://api.88api.shop// API中转地址}}创建步骤打开文件资源管理器进入C:\Users\你的用户名\目录新建文件夹.claude如果已存在则跳过在.claude文件夹中新建settings.json文件粘贴上述配置并保存3. 备选方案环境变量配置如果不想用配置文件也可以通过环境变量设置仅当前用户生效PowerShell临时设置仅当前会话$env:ANTHROPIC_BASE_URLhttps://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)⚠️ 重要配置完成后必须重启终端如果在VS Code等IDE中使用需要重启整个IDE否则配置可能不生效。4. VSCode插件配置可选如果用VSCode的Claude插件还需要额外创建config.json配置文件路径C:\Users\你的用户名\.claude\config.json配置内容{primaryApiKey:any}创建步骤进入.claude文件夹之前创建的新建config.json文件粘贴上述内容保存注意这是插件专用配置和命令行工具的settings.json是两个文件不要弄混。四、开始使用Claude Code配置完成后在终端输入以下命令启动claude首次启动可能会提示协议确认按提示操作即可。想了解更多命令可输入claude--help五、常见问题排查问题启动后提示Unable to connect to Anthropic services原因首次启动引导流程未完成。解决在用户根目录创建.claude.json文件跳过引导文件路径C:\Users\你的用户名\.claude.json注意是用户根目录不是.claude文件夹内配置内容{hasCompletedOnboarding:true}创建步骤进入C:\Users\你的用户名\目录新建.claude.json文件粘贴上述内容保存重启Claude Code如果仍无法连接检查API Key是否正确复制时是否多了空格确认网络能访问https://api.88api.shop重启终端或IDE后重试总结其实Claude Code配置不复杂核心就是环境搭建API对接两步。这篇教程从Node.js安装到API中转配置再到常见报错解决基本覆盖了国内用户会遇到的所有问题。按步骤操作10分钟就能从不会配到能用起来。如果遇到其他报错欢迎在评论区留言我会尽量回复。技术工具的价值在于解决问题希望这篇教程能帮你少踩坑把时间花在更有价值的开发上。
