在 Windows 上配置 Claude Code从安装到解决网络问题Claude Code 是 Anthropic 推

一、安装前先确认环境是否满足要求

很多人上来就直接复制命令，其实这一步特别容易忽略。在安装之前，先确认你的环境满足基本要求，否则后面很容易一边装一边报错。

1. 操作系统

建议使用以下系统：

Windows 10
Windows 11

如果系统版本过旧，PowerShell、证书链、脚本兼容性这些地方都有可能出问题。

2. 内存

Claude Code 本身不是特别吃资源，但你在实际使用时，往往不会只开一个终端。你大概率还会同时打开：

VS Code / IntelliJ IDEA
浏览器
Git Bash
PowerShell
本地项目

所以建议内存至少满足：

4GB：可运行
8GB 及以上：体验更稳

3. 账号权限

Claude Code 并不是所有账号类型都默认支持。最稳妥的做法是：先确认你的账号具备对应的使用权限，再开始安装。

很多人不是装不上，而是装完之后发现权限不够，这就很浪费时间。

4. 网络环境

这一点非常关键，而且往往才是真正的“隐藏大坑”。

Claude Code 在运行过程中，需要访问它依赖的官方服务域名，例如：

api.anthropic.com

如果你的网络环境无法正常访问相关服务，即使你已经把命令装好了，后面运行时也可能直接报连接错误。

尤其如果你当前使用的是：

企业办公网络
校园网
受控网络
有防火墙或出口策略的内网

那你还需要额外确认：

DNS 是否正常
是否允许访问目标服务域名
是否需要通过单位统一代理访问外网
是否有安全软件拦截终端请求

很多人以为自己是“安装失败”，其实本质上是“网络不通”。

二、Windows 安装 Claude Code，其实核心就三步

别被网上各种教程绕晕了。真正有效的流程，其实就是下面这三步：

安装 Git for Windows
运行官方安装脚本
登录账号并验证环境

把这三步做对，后面就顺很多。

三、第一步：先安装 Git for Windows

为什么 Claude Code 之前，最好先装 Git？

因为在 Windows 环境里，Claude Code 往往会依赖 Git 提供的一些基础命令能力，尤其是 Git Bash 这类终端环境。如果你连 Git 都没装，后面很多命令行为都可能异常。

安装方式

去 Git for Windows 官方网站 下载最新版安装包，安装时一般保持默认选项即可。

通常来说：

不需要改安装路径
不需要自定义复杂配置
默认安装项已经足够大多数开发场景

安装完成后先验证

打开 PowerShell 或 Git Bash，执行下面这条命令：

git --version

如果能看到类似下面的输出：

git version x.x.x.windows.x

那就说明 Git 已经安装成功。

如果这一步都不正常，建议先别急着继续安装 Claude Code，先把 Git 环境处理好。

四、第二步：运行官方安装脚本

在 Git 环境没问题之后，就可以进入正式安装。

打开 PowerShell，执行：

irm https://claude.ai/install.ps1 | iex

这条命令可以简单理解成两件事：

从官方地址拉取安装脚本
在本地直接执行安装流程

如果你的终端环境比较严格，也可能会遇到脚本执行权限问题。这时候你要先检查：

PowerShell 是否被策略限制
企业终端是否禁用了远程脚本执行
本地安全软件是否拦截了下载或运行

安装后一定要做验证

很多人执行完安装命令就觉得“应该好了”，然后直接开始用。这是非常容易踩坑的做法。

安装完成后，请立刻执行这两个命令：

claude --version
claude doctor

这两步非常关键。

`claude --version` 的作用

它主要用于确认：

claude 命令是否已经安装成功
当前终端是否能识别这个命令
PATH 环境变量是否已经生效

如果它提示“找不到命令”，通常说明：

安装没有完成
当前终端没有刷新
PATH 没正确加载

`claude doctor` 的作用

这个命令可以理解成 Claude Code 自带的“体检工具”。

它通常会帮助你检查：

安装是否完整
当前环境是否缺少依赖
配置是否存在明显异常
某些基础网络问题是否可识别

很多人一遇到报错就重装，其实没必要。 先跑一遍 claude doctor，往往比你反复重装更有效。

五、第三步：登录账号并完成首次启动

安装和验证都正常之后，就可以尝试真正启动 Claude Code 了。

在终端里执行：

claude

正常情况下，程序会：

自动打开浏览器
引导你完成登录或授权
授权成功后返回终端
进入可用状态

如果浏览器没有自动打开怎么办？

这也是比较常见的情况。

可能的原因包括：

系统默认浏览器配置异常
浏览器被安全策略限制调用
终端没有足够权限拉起外部程序
本地安全软件拦截了弹出行为

这时候先不要慌，重点看终端里的提示信息：

是否提供了手动打开的授权地址
是否已经出现网络错误
是否仍停留在等待授权状态

因为“浏览器没弹出来”和“网络连接失败”是两类完全不同的问题，排查方式也不一样。

六、最常见的报错：安装成功了，但就是连不上服务

这类问题，几乎是很多 Windows 用户最容易遇到的。

典型提示大概类似这样：

Unable to connect to Anthropic services
Failed to connect to api.anthropic.com
Please check your internet connection and network settings.

很多人一看到这类报错，第一反应是：

是不是安装失败了？
是不是脚本有问题？
是不是版本有 bug？

其实大多数情况下，这不是安装失败，而是网络可达性问题。

也就是说：

claude 命令很可能已经装好了
账号登录流程也可能没问题
真正的问题是：当前终端访问不到它依赖的服务

这才是重点。

七、遇到连接失败时，正确的排查顺序是什么？

这里强烈建议你记住一个原则：

不要一上来就重装。

更有效的顺序应该是：

先看网络是否可达
再看配置是否正确
最后用工具做自检

这个顺序对了，排查效率会高很多。

八、先确认你的网络环境是否允许访问目标服务

如果你在家庭宽带环境下使用，问题可能相对简单。但如果你当前处于以下环境：

公司内网
校园网
受控网络
有统一出口管理的办公网络

那么首先要排查的，不是命令本身，而是网络策略。

你需要确认这些事情：

是否允许访问 api.anthropic.com
是否需要通过单位统一出口访问外部服务
是否存在防火墙、安全网关或白名单限制
是否对终端工具和浏览器采用了不同规则
是否有 DNS 解析失败或证书异常问题

很多时候，浏览器能访问外网，并不代表命令行工具也能正常访问目标服务。

这一点非常容易被忽略。

九、如果单位提供了合规代理，可以按规范配置环境变量

如果你的公司或组织本身就提供了合规的网络代理服务，并允许开发工具通过代理访问外部服务，那么你可以在 PowerShell 中配置环境变量。

例如：

$env:HTTPS_PROXY = "http://127.0.0.1:端口"
$env:HTTP_PROXY  = "http://127.0.0.1:端口"

这里最重要的不是照抄命令，而是注意下面几点：

代理地址要以你当前实际可用配置为准
端口号要以你本机真实监听值为准
不要直接复制别人的端口
不要使用来源不明、未经授权的网络服务

很多人最大的问题就是：教程里写了一个端口号，他就原封不动复制过去，结果自己的环境根本不是那个端口，最后当然不生效。

配置完之后怎么验证？

重新执行：

claude

如果之前的问题确实是网络不可达，而现在可以正常连接，那就说明你的配置方向是正确的。

十、为了避免每次重复设置，可以写入配置文件

临时设置环境变量虽然方便，但有一个很明显的问题： 终端一关，配置就丢了。

如果你已经验证某套配置是有效的，可以考虑把它写入 Claude Code 的配置文件中，让后续自动生效。

编辑下面这个文件：

~/.claude/settings.json

写入类似内容：

{
  "env": {
    "HTTPS_PROXY": "http://127.0.0.1:端口",
    "HTTP_PROXY": "http://127.0.0.1:端口"
  }
}

这样做的好处很明显：

不用每次手动设置
新开终端也能自动读取
更适合长期使用

当然，仍然要强调一句： 这里的网络配置应建立在合法、合规、已授权的基础上。

十一、如果企业有统一网关，优先使用官方或单位授权方案

在团队或企业环境中，更常见的做法是通过统一网关、统一出口或者内部密钥管理来访问服务，而不是每个人各自单独配置。

如果你的单位已经提供了这类方案，可以按要求在配置文件中写入：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://你的企业网关地址",
    "ANTHROPIC_API_KEY": "你的授权密钥"
  }
}

这里有几个非常重要的注意点。

1. 优先使用官方支持或单位授权地址

不要为了图省事，随便接入来源不明的地址。开发工具一旦接错入口，后续问题会非常多，安全性也没保障。

2. API Key 一定要保管好

这是很多新手最容易忽视的问题。

真实的 API Key 千万不要：

写进公开仓库
直接贴到技术社区文章里
发到公共聊天群
放进容易泄露的脚本文件里

正确做法是：

用环境变量管理
用企业密钥系统管理
示例中全部用占位符代替

十二、配置了还是不行？继续按这 4 步查

如果你已经做了配置，但仍然报错，那就别急，继续往下排查。

1. 先确认网络本身就是通的

先不要只盯着 Claude Code，先排查更基础的问题：

当前网络是否稳定
DNS 是否正常
能否正常访问普通 HTTPS 网站
本地安全软件是否拦截了终端工具

如果你的基础网络本身就不稳定，那么后面的配置再完美也没有意义。

2. 检查端口、地址和协议是否写错

这是高频错误区。

常见问题包括：

端口号写错
地址写错
协议类型写错
终端代理和系统代理不一致

建议你回到自己的网络配置界面、单位 IT 文档或实际使用的代理配置中，重新核对：

监听地址
端口号
协议类型

一句话总结就是：

端口错一位，前面全白费。

3. 用命令行先测试目标服务连通性

与其凭感觉猜，不如直接测一下。

你可以在 PowerShell 中执行：

curl https://api.anthropic.com

这一步的重点，不是一定要拿到业务成功结果，而是看这些基础现象：

请求能不能发出去
会不会立刻被拦截
是连接超时、拒绝连接，还是 DNS 失败
是否有证书相关异常

通过这一条命令，你往往就能快速判断问题更可能出在哪一层。

4. 最后一定再跑一次 `claude doctor`

如果前面都查过了，还是不确定问题在哪，那最值得做的一步还是：

claude doctor

它最大的价值在于：能帮你把很多“看不见的问题”直接暴露出来。

比如：

安装是否完整
命令是否被正确识别
环境变量有没有生效
配置文件有没有被正常读取
是否有明显依赖缺失

你可以把它理解成 Claude Code 的故障自检入口。真的非常实用。

十三、环境都正常后，就可以开始使用了

当你确认安装成功、登录正常、网络也没问题之后，就可以进入项目目录开始使用。

例如：

cd C:\your-project
claude

如果你是第一次用，建议先在一个测试项目里熟悉一下，不要一上来就直接接入重要项目。

常用命令速查

下面这几个命令建议先记住：

命令	说明
`/help`	查看可用命令
`/status`	查看当前状态查看当前状态
`claude doctor`	检查安装与配置
`/bug`	提交问题反馈

如果你刚开始使用，建议先做这几件事：

先确认命令能稳定启动
先确认登录状态是否正常
先确认项目目录下运行是否正常
先做一些简单操作熟悉交互方式

这样后面真的遇到问题时，你会更容易判断是环境问题，还是使用方式问题。

十四、总结：安装本身不难，真正难的是排查思路

说实话，Claude Code 在 Windows 上安装，真正难的并不是那几条命令。难的是很多人遇到问题时，排查顺序是乱的。

你只要记住下面这几件事，基本就不会跑偏：

1. 先装 Git，再装 Claude Code

别跳步骤。 Git 环境不完整，后面很多问题都会跟着来。

2. 安装完先验证，不要凭感觉判断

请务必执行：

claude --version
claude doctor

这两步可以帮你快速确认安装是否真的成功。

3. 报连接错误时，优先查网络，不要先怀疑安装

这几乎是最常见的误区。

“装不上”和“连不上”是两回事。很多时候，命令已经装好了，真正的问题只是网络不可达。

4. 配置一定要以自己的环境为准

尤其是：

地址
端口
协议
企业出口策略

技术文章的示例只能帮你理解思路，不能替你决定实际参数。

5. `claude doctor` 是最值得优先使用的诊断命令

如果你已经试了很多方法还不行，那就别瞎猜了，直接让工具帮你看。

十五、最后一句

如果你现在正卡在 Claude Code 的 Windows 安装上，最实用的建议其实就一句话：

装完先跑 claude doctor，报错先查网络，不要上来就重装。

很多坑，真的不是靠多装几次就能解决的。把排查顺序理顺了，问题往往就没那么复杂。

在 Windows 上配置 Claude Code从安装到解决网络问题