最近 Claude Code 火得不行。

但我翻了全网教程，发现两个问题：要么是 Mac 的，Windows 用户跟着做全程报错；要么讲到安装就戛然而止，剩下的坑一个没提。

我用 Windows 电脑从下载一路装到跑通第一个项目，中间踩了6 个坑。

这篇文章把它们一次说清。照着做，30 分钟内搞定。

先说 Claude Code 是什么：Anthropic 出的命令行 AI 编程工具。你用大白话说需求，它直接在你的项目里写代码、改文件、跑命令。适合程序员，也适合不会写代码、但想让 AI 帮自己干活的人。

一、安装：一条命令的事

打开PowerShell（开始菜单搜 PowerShell，回车），粘贴这一行：

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

回车，等进度条跑完就行。

不需要管理员权限，它只装在你自己的用户目录下，不会动系统。

装完后，关掉这个窗口，重新开一个新的 PowerShell。这一步不做，你马上就会踩坑 1。

【插图位置：插入 PowerShell 运行安装命令的截图，插完删掉这个框】

验证装没装上，新窗口输入：

claude --version

能显示出版本号（比如2.1.283 (Claude Code)），安装就完成了。

二、登录：必须有账号

第一次使用，进任意文件夹后输入claude，浏览器会自动弹出 Anthropic 的登录页。

两种账号都能用：

▸Claude 订阅账号（Pro / Max，就是网页版 claude.ai）

▸Anthropic Console 账号（API 按量付费）

登录成功后浏览器显示一串确认码，终端自动继续，就完事了。

三、跑通第一个项目

随便建个文件夹：

mkdir my-first-app

cd my-first-app

claude

进入界面后直接打字说人话，比如：

"帮我写一个能记录每天开销的小工具，数据存在本地文件里，给我完整代码和运行说明"

它干活时会请求权限（读文件、写文件、执行命令），第一次遇到每种操作都会问你。

看清楚再按回车。新手期建议每个都手动确认。

看到它把文件写好、告诉你怎么运行，第一个项目就算跑通了。

【插图位置：插入 Claude Code 生成项目的界面截图，插完删掉这个框】

四、我踩过的 6 个坑（重点）

坑 1：装完了却提示"claude 不是内部或外部命令"

不是装错了，是你还在用装之前就开着的旧终端窗口，PATH 没刷新。关掉所有终端窗口重新开，大概率就好。

坑 2：irm 不是内部或外部命令

说明你用的是 CMD，不是 PowerShell。看窗口提示符：有 PS 开头的是 PowerShell，没有的是 CMD。换 PowerShell 再执行，或用 CMD 专用安装命令（官方文档里有）。

坑 3：安装命令卡住 / 登录页打不开

国内网络直连 Anthropic 不稳定，这是最多人卡住的地方。需要全程稳定的代理网络，终端也要能走代理。终端代理没配好，登录那步会一直转圈——这个坑我卡了快半小时。

坑 4：终端中文乱码

执行这句再启动，切到 UTF-8 编码：chcp 65001

坑 5：旧教程让你先装 Node.js

早期的 Claude Code 靠 npm 安装，现在官方原生安装器已经不需要 Node 了。直接跑第一步那条命令，跟着老教程装 Node 是绕远路。

坑 6：项目文件夹用中文名，各种诡异报错

路径带中文或空格容易出玄学问题。建文件夹用纯英文加数字，比如 my-app、demo-01。

五、装完先做这 3 件事

1. 跑 claude doctor：一条命令体检安装和登录状态，有问题它会告诉你哪不对
2. 设预算上限：Console 按量付费的账号，去后台设月度消费上限，防止烧钱没数
3. 每天用它干一件小事：整理文件、写周报、改 Excel 公式。工具是练出来的，不是收藏出来的

我把安装命令、登录配置和这 6 个坑的解决方案整理成了一份文档，另外很多朋友问的"怎么低成本稳定使用"的问题，也单独写了一份说明。

在公众号后台回复【教程】自取

觉得有用的话，点个关注，接下来会持续更新 Claude Code 的实战玩法和 AI 工具的省钱门道。