Claude Code 新手先看什么：下载、文档、Windows 安装与常见问题入口

如果你只想先看结论

如果你今天就想把 Claude Code 真正装起来、用起来，建议按这个顺序做：

1. 先看官方安装页
2. 再看官方 Quickstart
3. Windows 用户先决定终端路线
4. 跑 claude --version 和 claude doctor
5. 在真实项目目录里执行 claude
6. 如果这一步之后还联网失败，再去排 PowerShell / 代理

你最不该做的事，是把这些问题同时搅在一起：

• 安装
• PATH
• 登录
• Windows 路线
• 代理
• PowerShell 会话问题

第一步：先固定官方下载与官方入口

如果你的目标是“真正开始用上 Claude Code”，先固定下面 3 个官方入口：

• Claude Code Advanced setup
• Claude Code Quickstart
• Claude Code settings

为什么不是只给一个链接？

因为新手最容易把三件不同的事混在一起：

• 能不能装
• 怎么开始第一次会话
• 以后配置写到哪

官方现在已经把它们拆开了。你只要按这三页走，起步成本会比翻十几篇二手帖子低很多。

第二步：先决定你是不是 Windows 特殊路线

如果你是 macOS 或常规 Linux 用户，流程通常比较简单：跟着官方安装页走就行。

真正容易出问题的是 Windows 用户。

根据当前官方文档，Windows 新手至少要先知道这几件事：

• 原生 Windows 路线需要 Git for Windows
• WSL 路线不需要 Git for Windows
• PowerShell、CMD、Git Bash、WSL 不是一个环境
• 你在哪个环境里安装，就尽量在哪个环境里完成第一轮验证

也就是说，Windows 用户最该先做的事情，不是复制命令，而是先回答：

我准备长期在哪条终端路线里用 Claude Code？

更适合优先考虑 WSL 的情况

• 你长期做 CLI、脚本、仓库级任务
• 你希望工作流更接近 Linux
• 你不想长期和原生 Windows 终端差异缠斗

更适合继续用 Git Bash 的情况

• 你已经长期使用 Git for Windows
• 你主要处理常规仓库任务
• 你不想在今天顺手把终端生态也一起换掉

什么时候才建议把 PowerShell 当主路线

• 你已经熟悉 PowerShell 的环境变量和会话差异
• 你接受它和 Git Bash / WSL 在行为上不完全一致
• 你后续愿意处理一些更偏 Windows 原生的终端问题

第三步：按官方方式完成安装，不要一开始就自己发明流程

截至 2026-04-24，官方文档明确列出了几种安装方式，其中新手最值得优先看的还是 Native install。

官方文档当前给出的典型入口包括：

macOS、Linux、WSL

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell

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

Windows CMD

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

这里最容易出错的不是命令本身，而是你在错误的终端里执行了对的命令。

官方文档甚至直接提醒了：

• 如果你在 PowerShell 里看到 && 分隔符报错，你其实跑了 CMD 命令
• 如果你在 CMD 里看到 irm 不存在，你其实跑了 PowerShell 命令

对新手来说，这种错误一点都不丢人，它反而说明你应该先把终端环境认清楚，再往下走。

第四步：安装完成后，不要跳过这两个自检命令

安装完成后，先做两步最值钱的验证：

claude --version

claude doctor

为什么这两步这么关键？

因为它们能帮你快速确认：

• 命令是否已经存在
• 当前终端是否真的拿到了 CLI
• 版本是否正常
• 基础环境与配置有没有明显异常

很多人最大的问题不是“安装没做”，而是“装完没验证”，于是后面把所有报错都误判成代理或网络问题。

第五步：真正的起点不是安装完成，而是第一次进入项目目录

对新手来说，“Claude Code 真正能用”至少要满足下面这几个条件：

1. 你能运行 claude --version
2. 你能运行 claude doctor
3. 你能完成第一次登录
4. 你能在真实项目目录里执行 claude

这一步很重要，因为 Claude Code 的核心价值不在于它存在于系统里，而在于它能进入项目上下文中工作。

一个更实际的最小验证流程是：

cd /path/to/your/project
claude

然后确认你能进入首次会话，看到欢迎界面或开始提问。

如果你连这个阶段都还没走到，就不算“真正用上了 Claude Code”。

第六步：什么问题属于安装层，什么问题才该转去看代理

下面这些通常还属于安装层或终端层问题：

• claude 命令不存在
• 同一台机器里，某个终端能跑、某个终端不能跑
• PATH 没生效
• 你自己也还没决定长期终端路线
• claude doctor 就已经暴露基础环境异常

只有在下面这些都成立时，你才更应该转去看网络 / 代理排障：

• 命令可用
• claude doctor 可跑
• 你能明确自己在哪条终端路线里排障
• 安装层和 PATH 层已经基本排除

这时如果仍然失败，问题才更可能是：

• PowerShell 当前会话没拿到代理变量
• 浏览器代理和 CLI 代理不一致
• v2rayN / Clash 端口选择不对
• 原生 PowerShell 路线本身就不适合你当前工作方式

Windows 用户最容易踩的 5 个坑

1. 一上来就搜旧教程

Claude Code 的安装方式、文档入口、账户说明和配置结构都在变化。旧教程里最容易让你浪费时间的，是它仍然把过期路径当成默认起点。

2. 终端路线没定清楚

WSL、Git Bash、PowerShell 混着试，最后几乎一定会把问题层级搞乱。

3. 命令还没跑通，就开始换节点

如果 claude 命令都还不可用，换节点通常不会帮你解决核心问题。

4. 安装后不做 claude doctor

你已经有官方自检入口了，跳过它只会增加试错成本。

5. 不在真实项目里做首次验证

很多问题不是在空目录里暴露，而是在真实项目目录里才暴露。越早进项目验证，越早知道这个工具能不能进入你的日常工作流。

一条更适合中文用户的新手起步路径

如果你今天就想用起来，建议按这个顺序读和做：

1. Claude Code Advanced setup
2. Claude Code Quickstart
3. Claude Code 新手入门资料导航：中文用户先看这几个官方入口和实战指南
4. Claude Code 安装教程
5. 在自己的项目目录里完成第一次 claude 启动
6. 如果失败，再看：
   • Claude Code 在 Windows 和 PowerShell 连不上怎么办
   • Claude Code 在 PowerShell 连不上网怎么办

我的判断

Claude Code 的新手门槛，不在于“资料少”，而在于“顺序错”。
很多人不是不会安装，而是把官方入口、Windows 环境、终端路线、PATH、代理和首次登录混成了一步。

如果你能把它拆成下面这条顺序：

• 官方安装入口
• 官方 Quickstart
• Windows 路线判断
• 安装验证
• 真实项目首次启动
• 再排网络与代理

那你真正用上 Claude Code 的概率会高很多。

继续阅读

• Claude Code 新手入门资料导航：中文用户先看这几个官方入口和实战指南
• Claude Code 安装教程：Windows、macOS、Linux 先用官方原生安装，再处理 PowerShell 和代理
• Claude Code 在 Windows 和 PowerShell 连不上怎么办：代理、PATH、v2rayN 排障顺序
• Claude Code 在 PowerShell 连不上网怎么办：Windows 用户先查这 6 步
• Claude Code 适合什么人，不适合什么人？别先装再后悔

参考与延伸阅读

• Claude Code Advanced setup
• Claude Code Quickstart
• Claude Code settings