Claude Code 安装教程：Windows、macOS、Linux 先用官方原生安装，再处理 PowerShell 和代理

如果你只想先看结论

• 现在安装 Claude Code，优先走官方 native install。
• 如果你是 Windows 用户，先决定自己长期使用的是 WSL、Git Bash，还是原生 PowerShell 路线。
• 安装完成后最值得立刻执行的两条命令是：

claude --version
claude doctor

• 如果命令还不存在、PATH 不通、终端路线没定清楚，就先别急着排代理和网络。

这篇文章最核心的一句话其实是：

先把安装层做干净，再去处理 PowerShell 和代理层。

为什么这篇安装教程要单独写

很多人第一次接触 Claude Code 时，会把这些问题混成一件事：

• 安装
• PATH
• 登录
• Windows 终端选择
• 代理
• 网络

结果就是：

• 命令都还没装通，就开始怀疑网络
• WSL、Git Bash、PowerShell 混着试，最后不知道哪一步真的起作用
• 明明是安装层问题，却被误判成代理问题

这篇教程的目标，就是把“安装层”和“网络层”先切开。

截至 2026-04-06，官方推荐的安装起点是什么

按照 Anthropic 官方文档当前的 Getting Started 和 Quickstart，更推荐的起点已经是：

先用 native install。

对于大多数用户，这意味着你不需要先把旧的 npm 全局安装路线当成默认起点。只有在一些兼容性、环境限制或特定工作流下，才再回头看 npm 安装方案。

这点很重要，因为不少旧教程还默认从下面这条命令讲起：

npm install -g @anthropic-ai/claude-code

这条路线并不是完全不能用，但它已经不该是大多数新用户的第一选择。

安装前先做的第一件事：决定你的终端路线

如果你是 macOS 或 Linux 用户，通常简单很多，按官方原生安装走就行。

如果你是 Windows 用户，真正该先决定的不是安装命令，而是：

你准备长期在哪种终端环境里用 Claude Code。

路线 1：Windows + WSL

更适合：

• 想要更稳定的类 Linux 终端环境
• 后续会长期做 CLI、脚本、仓库级任务的人
• 不想长期被原生 Windows 终端差异反复绊住的人

路线 2：Windows + Git Bash

更适合：

• 已经长期使用 Git for Windows / Git Bash
• 主要是个人项目或日常仓库开发
• 希望保留现有工作习惯的人

路线 3：Windows + 原生 PowerShell

可以用，但更适合：

• 已经明确习惯 PowerShell
• 对环境变量、代理变量和命令差异比较熟悉
• 能接受后续可能需要更多排障的人

对大多数第一次认真安装 Claude Code 的 Windows 用户来说，更省事的顺序通常是：

1. 优先考虑 WSL
2. 如果你本来就长期用 Git Bash，继续走 Git Bash
3. 最后再把 PowerShell 当成长期主路线

安装前的最小准备清单

开始前，建议先确认这几件事：

• 你有一个可用的终端环境
• 你已经决定了自己的 Windows 路线
• 你的网络可以访问 Claude Code 所需的官方服务
• 你手头有一个真实项目目录，后面可以直接进入测试

如果你在 Windows 上还没决定终端路线，就不要先急着跑命令。那样通常只会让后面的排障更混乱。

Claude Code 怎么安装

macOS / Linux

最简单的思路就是：

1. 打开官方文档
2. 按 native install 走
3. 安装完成后立刻做自检

Windows

Windows 也是一样的原则，但顺序更严格一些：

1. 先决定 WSL、Git Bash 还是 PowerShell
2. 在你准备长期使用的那个终端里执行官方安装流程
3. 不要在多个终端里混着试第一轮安装
4. 安装成功后先验证命令和环境，再排网络

很多人最浪费时间的点，不是安装本身，而是今天在 PowerShell 里试、明天在 Git Bash 里试、后天又切到 WSL，最后根本不知道问题属于哪个环境。

安装完成后，先做这 4 步自检

第一步：确认命令存在

claude --version

如果这一步失败，说明问题还在安装层，通常和命令本身、PATH、终端环境有关，而不是代理问题。

第二步：做环境自检

claude doctor

这一步非常重要。它能比盲目搜索报错信息更快地告诉你：

• 命令是否安装成功
• 当前环境是否合理
• 基础配置是否已经具备运行条件

第三步：进入真实项目目录

cd your-project
claude

不要只在一个空目录里试完就结束。Claude Code 的真实价值，本来就是在项目目录、仓库上下文和多步骤任务里体现出来的。

第四步：确认你能进入登录流程

如果命令、版本和 doctor 都正常，下一步再去确认登录是否顺利。

这时如果卡住，问题通常已经不再是“装没装上”，而更可能是：

• 网络
• 代理
• 终端环境差异
• PowerShell 路线问题

什么情况属于安装问题，而不是网络问题

只要你遇到的是下面这些情况，优先按安装层处理：

• claude 命令不存在
• 不同终端里命令表现不一致
• PATH 没生效
• 你自己也还没定清楚长期终端路线
• claude doctor 明显提示安装或环境异常

这时候最容易犯的错误，就是直接跳去研究代理。

什么情况才该转去看 PowerShell / 代理排障

如果下面这些都已经成立：

• claude --version 正常
• claude doctor 能跑
• 你已经选定长期终端路线
• 安装命令和 PATH 没问题

但你仍然遇到：

• 浏览器能联网，Claude Code 不行
• PowerShell 里失败，别的环境里正常
• Windows 下登录、连接或请求经常超时

这时问题才更像是终端网络层或代理层，而不是安装层。

建议继续看：

• Claude Code 在 PowerShell 连不上网怎么办
• Claude Code 在 Windows 和 PowerShell 连不上怎么办

Windows 用户最容易浪费时间的 5 个安装误区

1. 一上来就先搜第三方旧教程

很多旧内容还默认用 npm 全局安装做主线，容易把你带到过时路径。

2. 没先决定终端路线

WSL、Git Bash、PowerShell 混着试，后面几乎一定会混乱。

3. 命令还没跑通，就先查代理

如果命令本身都不存在，先排代理通常是在错误层级上用力。

4. 不跑 claude doctor

官方已经给了环境自检入口，跳过它基本等于主动增加试错成本。

5. 不在真实项目里验证

不进入真实仓库，就很难知道这套安装是否真的能进入你的日常工作流。

我建议的新手安装顺序

如果你今天是第一次装 Claude Code，我更建议按这个顺序来：

1. 先看官方 Getting Started
2. 决定自己的长期终端路线
3. 按官方 native install 走
4. 跑 claude --version
5. 跑 claude doctor
6. 进入真实项目目录执行 claude
7. 如果命令和 doctor 都正常，但联网仍失败，再去看 PowerShell / 代理排障

这篇安装页看完后，下一步该看什么

如果你的目标是继续往下走，建议按下面顺序读：

• 想先判断自己到底该不该走终端路线： AI 编程工具推荐：Claude Code、Cursor、Codex CLI、Windsurf 2026 到底该先用哪个
• 你是 Windows 用户，想先少踩坑： Windows 用户更适合哪种 AI 编程工具
• 安装已经通了，但 PowerShell 网络不通： Claude Code 在 PowerShell 连不上网怎么办
• 安装已通，但 Windows 代理和连接问题还没解决： Claude Code 在 Windows 和 PowerShell 连不上怎么办
• 想继续对比终端路线和 IDE 路线： Claude Code vs Cursor Claude Code vs Codex CLI

FAQ

Claude Code 现在推荐怎么安装

优先按官方文档走 native install。对于大多数新用户，这应该是默认起点，而不是先从 npm 全局安装开始。

Windows 用户更推荐 WSL 还是 Git Bash

如果你追求更稳定、更接近 Linux 的长期环境，通常优先考虑 WSL；如果你已经长期使用 Git Bash，也可以继续走 Git Bash 路线。

安装完成后第一步该做什么

先执行 claude --version 和 claude doctor，确认命令、版本和基础环境都正常，再进入登录和联网层排查。

浏览器能上网，但 Claude Code 还是连不上，说明什么

这通常说明问题已经不在安装层，而更像是终端网络层、代理层或者 PowerShell 环境层问题。

参考与延伸阅读

• Claude Code Getting Started
• Claude Code Quickstart
• Claude Code 在 PowerShell 连不上网怎么办
• Claude Code 在 Windows 和 PowerShell 连不上怎么办
• AI 编程工具推荐：Claude Code、Cursor、Codex CLI、Windsurf 2026 到底该先用哪个
• Windows 用户更适合哪种 AI 编程工具