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

本文将从零开始介绍如何在 Windows 系统中安装和配置终端版 Claude Code内容涵盖环境准备、安装步骤、常见问题排查以及国产大模型接入。通过这一篇教程带你完成全部配置让 Claude Code 真正在电脑终端中运行起来。安装流程:安装Git安装Node安装ClaudeCodeFailed to fetch version from xxx connect ECONNREFUSED 问题解决方案配置流程配置环境变量解决校验问题Claude code中接入国产大模型Claude code 模型接入时报错Please run /login · API Error: 403 问题解决方案一、下载安装Git1、为什么要装gitClaude Code 在 Windows 上运行有一个特殊要求Claude Code 必须依赖 Git Bash 才能正常工作因为它需要一个类 Unix 的环境来执行某些指令。参考博主https://blog.csdn.net/qq_43775680/article/details/1568057922、具体操作1从官网下载git,下载地址https://git-scm.com/进入后点击这里(2)双击下载的.exe文件一直点下一步就行(3)验证是否安装成功winR打开命令行,输入cmd点击确认输入git回车展示以下内容即可证明安装成功。二、下载安装Node1、为什么要装Node以前js脚本需要在浏览器中运行脱离浏览器无法运行。node.js出现正是为了解决js脚本与浏览器的强依赖关系提供运行js脚本的运行时环境。2、具体操作1从官网下载Node,下载地址[https://nodejs.org/zh-cn)进入后下拉点击windows安装2继续傻瓜式安装文件不大不建议更改路径一路点下一步即可。3安装后验证成功的方式winr–cmd输入node -v回车出现版本号为安装成功三、下载安装Claude Code1、具体操作1从官网下载Claude Code,下载地址https://claude.com/product/claude-code2在本地搜索/开始菜单中 右键通过管理员的身份 打开Windows PowerShell3把刚才复制的官网命令粘贴进去回车运行等待下载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字符:5Write-ErrorInstallation failed (exit code $installExitCode)~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~CategoryInfo:NotSpecified:(:)[Write-Error],WriteErrorEx ceptionFullyQualifiedErrorId:Microsoft.PowerShell.Commands.WriteErrorExcep tion截图如下解决方案首先在powershell里面运行以下命令其中7897是端口号可以从v**-设置-端口设置中找到改成自己的别的不动$env:HTTP_PROXYhttp://127.0.0.1:7897;$env:HTTPS_PROXYhttp://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-Key2 在cmd中修改环境变量接入模型设置key:setx ANTHROPIC_API_KEY 换成你的模型API-Key设置调用模型的URLsetx 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 教程。