前言最近整理了这份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 CodeNode.js环境就绪后通过npm全局安装Claude Codenpminstall-ganthropic-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 KEY2. 配置方式二选一方法一配置文件推荐持久生效在用户目录下创建配置文件步骤如下配置文件路径需替换你的用户名为实际系统用户名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_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)验证环境变量$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和中转地址以及解决首次启动的引导问题。国内用户通过中转接口可省去不少环境麻烦亲测能稳定运行。如果遇到其他问题欢迎在评论区交流一起完善这份实操指南。
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 CodeNode.js环境就绪后通过npm全局安装Claude Codenpminstall-ganthropic-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 KEY2. 配置方式二选一方法一配置文件推荐持久生效在用户目录下创建配置文件步骤如下配置文件路径需替换你的用户名为实际系统用户名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_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)验证环境变量$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和中转地址以及解决首次启动的引导问题。国内用户通过中转接口可省去不少环境麻烦亲测能稳定运行。如果遇到其他问题欢迎在评论区交流一起完善这份实操指南。
