本文将从零开始介绍如何在 Windows 系统中安装和配置终端版 Claude Code，内容涵盖环境准备、安装步骤、常见问题排查以及国产大模型接入。通过这一篇教程，带你完成全部配置，让 Claude Code 真正在电脑终端中运行起来。

安装流程:

• 安装Git
• 安装Node
• 安装ClaudeCode
• Failed to fetch version from xxx connect ECONNREFUSED 问题解决方案

配置流程：

• 配置环境变量
• 解决校验问题
• Claude code中接入国产大模型
• Claude code 模型接入时报错：Please run /login · API Error: 403 问题解决方案

一、下载安装Git

1、为什么要装git？

Claude Code 在 Windows 上运行有一个特殊要求，Claude Code 必须依赖 Git Bash 才能正常工作，因为它需要一个类 Unix 的环境来执行某些指令。
参考博主：https://blog.csdn.net/qq_43775680/article/details/156805792

2、具体操作

（1）从官网下载git,下载地址：https://git-scm.com/
进入后点击这里：

(2)双击下载的.exe文件，一直点下一步就行！
(3)验证是否安装成功：

• win+R打开命令行,输入cmd，点击确认：
  
• 输入git回车，展示以下内容，即可证明安装成功。
  

二、下载安装Node

1、为什么要装Node？

以前js脚本需要在浏览器中运行，脱离浏览器无法运行。node.js出现正是为了解决js脚本与浏览器的强依赖关系，提供运行js脚本的运行时环境。

2、具体操作

（1）从官网下载Node,下载地址：[https://nodejs.org/zh-cn)

进入后下拉，点击windows安装：

（2）继续傻瓜式安装，文件不大，不建议更改路径，一路点下一步即可。
（3）安装后验证成功的方式：win+r–cmd输入node -v，回车
出现版本号为安装成功！

三、下载安装Claude Code

1、具体操作

（1）从官网下载Claude Code,下载地址：https://claude.com/product/claude-code

（2）在本地搜索/开始菜单中 右键通过管理员的身份 打开Windows PowerShell

（3）把刚才复制的官网命令，粘贴进去，回车运行，等待下载
（4）如出现以下内容，证明安装成功！如果报错请看第（5）步！

（5）

× Installation failed Failed to fetch version from https://downloads.claude.ai/claude-code-releases/latest after 3 attempt(s):connect ECONNREFUSED35.190.46.17:443Try running with--force to override checks irm https://claude.ai/install.ps1 | iex : Installation failed (exit code 1)所在位置 行:104字符:5+Write-Error"Installation failed (exit code $installExitCode)"+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~+CategoryInfo:NotSpecified:(:)[Write-Error],WriteErrorEx ception+FullyQualifiedErrorId:Microsoft.PowerShell.Commands.WriteErrorExcep tion

截图如下：

解决方案：

• 首先，在powershell里面运行以下命令，其中7897是端口号，可以从v**-设置-端口设置中找到，改成自己的！别的不动

$env:HTTP_PROXY="http://127.0.0.1:7897";$env:HTTPS_PROXY="http://127.0.0.1:7897"

• 如果运行完没输出，就把刚才的下载命令再复制进行运行即可完成安装！
  
  参考链接：Claude Code 安装失败

最后在cmd中输入claude就可以运行啦！如果没有运行成功 也没关系继续往下看 我们一起去配置！

四、Claude code配置

1、配置环境变量

如果在启动claude出现“无法将“claude”项识别为cmdlet、函数、脚本文件或可运行程序的名称。请检査名称的拼写，如果包括路径，请确保路径”的问题，这是因为安装过程没有将 claude 命令所在的目录自动添加到系统的环境变量 PATH 中。系统因此在默认路径下找不到这个程序。

解决方案：

• 首先，打开环境变量，找到用户变量中的Path,双击打开。
  
• 找到claude.exe安装位置，一般在c盘/用户/用户名/.local-bin目录下。

• 复制安装路径，并添加到path路径中，点击确定，环境变量保存确定：
  
• 重新打开cmd，输入claude即可配置完成。
  

2、解决校验问题

claude中出现“Unable to connect to Anthropic services Failed to connect to api.anthropic.com: Status 403”的问题， 这是因为ClaudeCode工具会校验位置信息。（国内是无法使用的）需要通过配置解决这个问题。

解决方案：

• 在c盘/用户/用户名下找到.claude.json文件，通过记事本打开文件，并在文件中添加以下代码(注意加英文逗号！！！)：

英文逗号, "hasCompletedOnboarding" :true
第一步：
第二步：
（3）保存json文件。
（4）再次重启cmd，并执行claude命令，就可以正常启动了。

五、在Claude中接入国产大模型（非必选）

1、为什么接入国产大模型？

Claude付费，国产大模型更有性价比（支持官方 but钱包hold不住）

2、接入大模型具体操作

（1）创建API-Key
（2） 在cmd中修改环境变量，接入模型：

• 设置key:setx ANTHROPIC_API_KEY "换成你的模型API-Key"
  

• 设置调用模型的URL：setx ANTHROPIC_BASE_URL "换成你的api调用路径（一般去api购买平台-密钥设置处查看）"
  

• 设置模型名称：setx ANTHROPIC_MODEL "换成你的模型名称"
  

（3）重启cmd终端，查看参数是否设置成功：

• echo %ANTHROPIC_API_KEY%
• echo %ANTHROPIC_BASE_URL%
• echo %ANTHROPIC_MODEL%
  如果是你刚才设置的那些值，就证明设置成功！
  （4）让claude code跑起来！！
  选择一个存放项目的文件夹，在文件夹中右键选择在终端打开
  
  在终端中输入claude，在弹出的对话中，选择Yes, I trust this folder回车
  
  在进入的页面中输入指令，回车运行：
  运行成功!
  
  如果你再（5）步骤中，
  报错提示：
  
  “Please run /login · API Error: 403 Access from this region requires trusted account access.”
  通常由以下三种情况导致，请逐一排查：
• 模型权限不匹配：当前 API-Key 无权调用你所填写的模型名称，换一个有效模型。（其实就是模型名字填写的不对）
• 接口地址错误：API-URL 填写有误，导致网络无法访问，检查前面填写的ANTHROPIC_BASE_URL地址是否正确。

还有可能再启动中又遇到前面的地理位置校验问题，请手动进入 JSON 配置文件，将 hasCompletedOnboard 的值修改为 true。(前文已介绍)
完成上述修改后，重启应用即可恢复正常。

本文参考了 B 站 UP 主的相关教程，UP讲的非常好！更喜欢视频讲解的读者，可以观看：最新 Claude Code 教程。