前言这篇文章针对Windows用户从Node.js安装到API配置一步步带你走通Claude Code的完整流程。我会用国内可用的API中转方案省去翻墙和海外账号的麻烦尽量把每个步骤讲细连新手常犯的配置文件路径问题也会提到争取让你跟着做就能跑起来。正文一、准备工作安装Node.jsClaude Code运行需要Node.js环境最低要求Node.js ≥18建议选LTS版本更稳定。方法一官网下载推荐访问Node.js官网下载LTS版本安装包一般是首页显眼位置的Recommended For Most Users双击安装包按向导提示完成安装默认选项即可会自动配置环境变量方法二包管理器安装适合熟悉命令行的用户如果你的电脑装了Chocolatey或Scoop可以直接用命令安装# Chocolatey用户chocoinstallnodejs# Scoop用户scoopinstallnodejs验证安装是否成功打开PowerShell建议用管理员模式避免权限问题输入以下命令node--version# 查看Node.js版本应显示v18.x或更高npm--version# 查看npm版本通常会随Node.js一起安装⚠️ 提示如果命令提示不是内部或外部命令可能是环境变量没配置好建议重新运行Node.js安装包勾选Add to PATH选项。二、安装Claude CodeNode.js准备好后用npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code安装完成后验证是否成功claude--version# 应显示当前安装的版本号三、配置API连接核心步骤前提获取API Key调用Claude需要API Key我这次用的是88api作为接口中转官网https://api.88api.shop主要是考虑国内直连方便无需海外账户且一个Key能管理多个模型减少切换配置的麻烦。推荐大家使用大家也可以用自己的。下面以88API 为例获取Key的步骤注册并登录后点击侧边栏“API令牌”。点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用点击提交5. 点击复制按钮复制API令牌也就是API KEY方法一配置文件推荐永久生效通过配置文件保存API信息步骤如下配置文件路径必须准确C:\Users\你的用户名\.claude\settings.json把你的用户名替换成你电脑的实际用户名比如C:\Users\张三\.claude\settings.json配置内容替换为你的API Key{env:{ANTHROPIC_AUTH_TOKEN:你的API密钥,// 粘贴刚才复制的API KeyANTHROPIC_BASE_URL:https://api.88api.shop// 中转接口地址}}创建步骤打开文件资源管理器进入C:\Users\你的用户名\目录新建文件夹.claude如果已存在则跳过在.claude文件夹内新建文件settings.json注意后缀是.json不是.txt粘贴上述配置内容替换你的API密钥为实际Key保存文件方法二环境变量临时或永久如果不想用配置文件也可以通过环境变量配置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# 应显示设置的接口地址$env:ANTHROPIC_AUTH_TOKEN# 应显示你的API Key⚠️ 重要提示配置完成后必须重启终端或彻底重启VS Code/Cursor等IDE否则配置可能不生效VSCode插件配置可选如果你用Claude插件如果在VSCode中使用Claude插件还需要额外创建一个配置文件配置文件路径C:\Users\你的用户名\.claude\config.json配置内容{primaryApiKey:any}创建步骤进入C:\Users\你的用户名\.claude\目录如果.claude文件夹不存在先按方法一创建新建文件config.json粘贴上述内容并保存⚠️ 注意这是VSCode插件专用的config.json和命令行工具的settings.json是两个不同文件不要搞混四、开始使用Claude Code配置完成后在PowerShell中输入以下命令启动claude首次启动会进入交互界面输入问题即可使用。想了解更多命令可输入claude--help五、常见问题排查问题启动后提示Unable to connect to Anthropic services症状启动Claude Code后报错无法连接服务。原因首次启动引导流程未完成。解决方案在用户根目录创建.claude.json文件跳过引导文件路径C:\Users\你的用户名\.claude.json注意是在用户根目录不是.claude文件夹内配置内容{hasCompletedOnboarding:true}创建步骤进入C:\Users\你的用户名\目录新建文件.claude.json粘贴上述内容并保存重启Claude Code调试技巧如果仍无法连接检查网络是否正常国内直连需确保API地址正确API Key是否配置正确对比复制的Key和配置文件中的内容终端/IDE是否已重启配置生效需要重启总结到这里Claude Code的安装和API配置就完成了。核心步骤是Node.js环境准备、Claude Code安装以及通过配置文件或环境变量对接API。国内用户用中转接口能省掉不少麻烦遇到连接问题时检查配置文件路径和.claude.json文件通常能解决。如果跟着做还是遇到问题欢迎在评论区留言我会尽量回复。技术配置难免踩坑关键是耐心检查每一步——路径对不对、Key有没有填错、终端有没有重启这些细节往往决定成败。
国内直连Claude Code：从Node.js安装到API配置的保姆级教程（2026亲测跑通，小白也能跟做）
前言这篇文章针对Windows用户从Node.js安装到API配置一步步带你走通Claude Code的完整流程。我会用国内可用的API中转方案省去翻墙和海外账号的麻烦尽量把每个步骤讲细连新手常犯的配置文件路径问题也会提到争取让你跟着做就能跑起来。正文一、准备工作安装Node.jsClaude Code运行需要Node.js环境最低要求Node.js ≥18建议选LTS版本更稳定。方法一官网下载推荐访问Node.js官网下载LTS版本安装包一般是首页显眼位置的Recommended For Most Users双击安装包按向导提示完成安装默认选项即可会自动配置环境变量方法二包管理器安装适合熟悉命令行的用户如果你的电脑装了Chocolatey或Scoop可以直接用命令安装# Chocolatey用户chocoinstallnodejs# Scoop用户scoopinstallnodejs验证安装是否成功打开PowerShell建议用管理员模式避免权限问题输入以下命令node--version# 查看Node.js版本应显示v18.x或更高npm--version# 查看npm版本通常会随Node.js一起安装⚠️ 提示如果命令提示不是内部或外部命令可能是环境变量没配置好建议重新运行Node.js安装包勾选Add to PATH选项。二、安装Claude CodeNode.js准备好后用npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code安装完成后验证是否成功claude--version# 应显示当前安装的版本号三、配置API连接核心步骤前提获取API Key调用Claude需要API Key我这次用的是88api作为接口中转官网https://api.88api.shop主要是考虑国内直连方便无需海外账户且一个Key能管理多个模型减少切换配置的麻烦。推荐大家使用大家也可以用自己的。下面以88API 为例获取Key的步骤注册并登录后点击侧边栏“API令牌”。点击“添加令牌”选择分组根据需要调用的模型选择分组a. claude 模型建议使用 calude code 分组、b. gpt 模型建议使用 codex分组可通过平台的模型广场查看不同模型支持的分组若在使用中出现上游分组饱和请切换分组使用点击提交5. 点击复制按钮复制API令牌也就是API KEY方法一配置文件推荐永久生效通过配置文件保存API信息步骤如下配置文件路径必须准确C:\Users\你的用户名\.claude\settings.json把你的用户名替换成你电脑的实际用户名比如C:\Users\张三\.claude\settings.json配置内容替换为你的API Key{env:{ANTHROPIC_AUTH_TOKEN:你的API密钥,// 粘贴刚才复制的API KeyANTHROPIC_BASE_URL:https://api.88api.shop// 中转接口地址}}创建步骤打开文件资源管理器进入C:\Users\你的用户名\目录新建文件夹.claude如果已存在则跳过在.claude文件夹内新建文件settings.json注意后缀是.json不是.txt粘贴上述配置内容替换你的API密钥为实际Key保存文件方法二环境变量临时或永久如果不想用配置文件也可以通过环境变量配置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# 应显示设置的接口地址$env:ANTHROPIC_AUTH_TOKEN# 应显示你的API Key⚠️ 重要提示配置完成后必须重启终端或彻底重启VS Code/Cursor等IDE否则配置可能不生效VSCode插件配置可选如果你用Claude插件如果在VSCode中使用Claude插件还需要额外创建一个配置文件配置文件路径C:\Users\你的用户名\.claude\config.json配置内容{primaryApiKey:any}创建步骤进入C:\Users\你的用户名\.claude\目录如果.claude文件夹不存在先按方法一创建新建文件config.json粘贴上述内容并保存⚠️ 注意这是VSCode插件专用的config.json和命令行工具的settings.json是两个不同文件不要搞混四、开始使用Claude Code配置完成后在PowerShell中输入以下命令启动claude首次启动会进入交互界面输入问题即可使用。想了解更多命令可输入claude--help五、常见问题排查问题启动后提示Unable to connect to Anthropic services症状启动Claude Code后报错无法连接服务。原因首次启动引导流程未完成。解决方案在用户根目录创建.claude.json文件跳过引导文件路径C:\Users\你的用户名\.claude.json注意是在用户根目录不是.claude文件夹内配置内容{hasCompletedOnboarding:true}创建步骤进入C:\Users\你的用户名\目录新建文件.claude.json粘贴上述内容并保存重启Claude Code调试技巧如果仍无法连接检查网络是否正常国内直连需确保API地址正确API Key是否配置正确对比复制的Key和配置文件中的内容终端/IDE是否已重启配置生效需要重启总结到这里Claude Code的安装和API配置就完成了。核心步骤是Node.js环境准备、Claude Code安装以及通过配置文件或环境变量对接API。国内用户用中转接口能省掉不少麻烦遇到连接问题时检查配置文件路径和.claude.json文件通常能解决。如果跟着做还是遇到问题欢迎在评论区留言我会尽量回复。技术配置难免踩坑关键是耐心检查每一步——路径对不对、Key有没有填错、终端有没有重启这些细节往往决定成败。
