当前位置：首页 > news >正文

Claude Code 安装、配置与国产大模型接入保姆级教程-适合新手小白（包含个人各种踩坑记录）

news 2026/8/6 20:48:16

本文将从零开始介绍如何在 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地址是否正确。