前言最近想试试Claude Code结果找了一圈教程不是缺步骤就是环境不匹配光配置API就折腾了大半天。其实很多人跟我一样不是技术出身就想找篇能直接照着做的完整指南。这篇文章把从Node.js安装到API对接的每一步都写清楚了用了中转接口解决直连问题亲测能跑通希望能帮你少踩点坑。正文一、准备工作安装Node.js环境Claude Code需要Node.js支持最低要求是Node.js 18以上建议用LTS版本更稳定。方法一官网下载安装推荐访问Node.js官网下载LTS版本安装包双击安装包按向导提示完成安装一路默认下一步即可方法二通过包管理器安装如果你习惯用命令行可以通过Chocolatey或Scoop安装# Chocolatey用户chocoinstallnodejs# Scoop用户scoopinstallnodejs验证安装是否成功打开终端建议用PowerShell输入以下命令能显示版本号就说明安装成功了node--version# 示例输出v20.11.0npm--version# 示例输出10.2.4⚠️ 小提示如果遇到权限问题试试以管理员身份运行终端。二、安装Claude Code环境准备好后用npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code安装完成后验证一下claude--version如果能显示版本信息就说明安装成功了。三、配置API连接核心步骤获取API Key要让Claude Code正常工作需要配置API连接配置大模型。我最近在用88api中转接口网址https://api.88api.shop相较于官方更划算推荐大家可以试试。具体获取步骤1.注册登录后点击 “API 令牌”2.点击添加令牌3. 创建令牌名称随便写没有含义直接点击提交即可。获取 API KEY获得 API Key 后请妥善保管API Key 是你的身份凭证等同于账号密码切勿公开或分享给他人。点击“知道了”可以看到我们刚才创建的在这里也同样可以点击 复制 按钮去获取 API Key。方法一通过配置文件设置推荐在用户目录下创建配置文件一劳永逸配置文件路径注意替换你的用户名为实际用户名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$env:ANTHROPIC_AUTH_TOKEN能显示出设置的值就说明配置对了。⚠️ 重要提示配置完一定要重启终端如果用VS Code或Cursor的集成终端需要彻底重启整个IDE否则配置可能不生效。VSCode插件配置可选如果你用VSCode的Claude插件还需要额外配置一个文件配置文件路径C:\Users\你的用户名\.claude\config.json配置内容{primaryApiKey:any}创建步骤和前面类似在.claude文件夹里新建config.json粘贴内容保存即可。注意这是插件专用配置和命令行工具的settings.json是两个文件。四、开始使用Claude Code配置完成后在终端输入claude就能启动Claude Code了。想了解更多命令可以输入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配置是否正确。总结其实Claude Code配置不算复杂关键是环境和API这两步别出错。这篇教程从Node.js安装到API对接再到常见问题解决都是我实际操作过的步骤国内环境下用中转接口确实能省不少事。如果按步骤走还是遇到问题欢迎在评论区交流咱们一起看看怎么解决。
Claude Code本地部署总失败？Windows完整安装+API直连配置教程（亲测2026可用）
前言最近想试试Claude Code结果找了一圈教程不是缺步骤就是环境不匹配光配置API就折腾了大半天。其实很多人跟我一样不是技术出身就想找篇能直接照着做的完整指南。这篇文章把从Node.js安装到API对接的每一步都写清楚了用了中转接口解决直连问题亲测能跑通希望能帮你少踩点坑。正文一、准备工作安装Node.js环境Claude Code需要Node.js支持最低要求是Node.js 18以上建议用LTS版本更稳定。方法一官网下载安装推荐访问Node.js官网下载LTS版本安装包双击安装包按向导提示完成安装一路默认下一步即可方法二通过包管理器安装如果你习惯用命令行可以通过Chocolatey或Scoop安装# Chocolatey用户chocoinstallnodejs# Scoop用户scoopinstallnodejs验证安装是否成功打开终端建议用PowerShell输入以下命令能显示版本号就说明安装成功了node--version# 示例输出v20.11.0npm--version# 示例输出10.2.4⚠️ 小提示如果遇到权限问题试试以管理员身份运行终端。二、安装Claude Code环境准备好后用npm全局安装Claude Codenpminstall-ganthropic-ai/claude-code安装完成后验证一下claude--version如果能显示版本信息就说明安装成功了。三、配置API连接核心步骤获取API Key要让Claude Code正常工作需要配置API连接配置大模型。我最近在用88api中转接口网址https://api.88api.shop相较于官方更划算推荐大家可以试试。具体获取步骤1.注册登录后点击 “API 令牌”2.点击添加令牌3. 创建令牌名称随便写没有含义直接点击提交即可。获取 API KEY获得 API Key 后请妥善保管API Key 是你的身份凭证等同于账号密码切勿公开或分享给他人。点击“知道了”可以看到我们刚才创建的在这里也同样可以点击 复制 按钮去获取 API Key。方法一通过配置文件设置推荐在用户目录下创建配置文件一劳永逸配置文件路径注意替换你的用户名为实际用户名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$env:ANTHROPIC_AUTH_TOKEN能显示出设置的值就说明配置对了。⚠️ 重要提示配置完一定要重启终端如果用VS Code或Cursor的集成终端需要彻底重启整个IDE否则配置可能不生效。VSCode插件配置可选如果你用VSCode的Claude插件还需要额外配置一个文件配置文件路径C:\Users\你的用户名\.claude\config.json配置内容{primaryApiKey:any}创建步骤和前面类似在.claude文件夹里新建config.json粘贴内容保存即可。注意这是插件专用配置和命令行工具的settings.json是两个文件。四、开始使用Claude Code配置完成后在终端输入claude就能启动Claude Code了。想了解更多命令可以输入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配置是否正确。总结其实Claude Code配置不算复杂关键是环境和API这两步别出错。这篇教程从Node.js安装到API对接再到常见问题解决都是我实际操作过的步骤国内环境下用中转接口确实能省不少事。如果按步骤走还是遇到问题欢迎在评论区交流咱们一起看看怎么解决。
