装一次，少走两小时弯路。

网上的 Claude Code 教程要么是 Mac/Linux 的，要么版本过时、跟着做总在某一步报错。这篇基于 2026 年 6 月最新版，纯 Windows、不装 WSL，从 0 到跑通你的第一个 AI 编程项目，每一步都给完整命令，我自己踩过的坑全标了出来。照着做一遍，20 分钟内你就能让 AI 在终端里帮你写代码、改 bug、跑测试。

先说结论：Claude Code 是 Anthropic 官方出的命令行 AI 编程工具，跟 Cursor 那种"插件式"不一样——它直接在终端里读你的整个项目、自己改文件、自己跑命令，更适合"把一个完整需求丢给它让它干完"。

---

一、先搞清楚：Claude Code 到底是什么，值不值得装

一句话：它是一个住在你终端里的 AI 工程师。

• 你在项目目录里敲一句 claude，它就启动了，能看到你这个项目的所有文件。
• 你用大白话说"帮我把这个登录接口加上图形验证码"，它会自己找到相关文件、改代码、必要时跑命令验证。
• 跟 Cursor/Copilot 最大的区别：Cursor 是"你写它补"，Claude Code 是"你说它干"——它能跨多个文件改、能自己执行终端命令，更接近"交活给它"。

什么人值得装：经常要改成型项目、做重构、批量改代码、写测试的人。纯写几行小脚本，其实 Cursor 就够了。

---

二、环境准备：装 Node.js（唯一的前置）

Claude Code 是个 npm 包，所以只需要 Node.js 环境，别的什么都不用装。

1. 打开 Node.js 官网，下载 LTS 版（2026 年 6 月当前 LTS 是 22.x，闭眼装 LTS 就行，别装最新的 Current 版）。
2. 一路下一步装完，记得勾上"Add to PATH"（默认勾着）。
3. 打开 PowerShell，验证：

node -v
npm -v

只要分别打印出版本号（比如 v22.14.0 和 10.9.2），就说明环境 OK。

踩坑①：如果 node -v 报 不是内部或外部命令，是 PATH 没刷新。重启一下 PowerShell（或者整个电脑），别在装完的同一个旧窗口里敲。

---

三、安装 Claude Code（一条命令）

PowerShell 里执行：

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

-g 是全局安装，装完任何目录都能用。装完验证：

claude --version

打印出版本号就成功了。

踩坑②：如果卡在下载很慢甚至超时，是 npm 默认源在国外。换成国内镜像再装：

npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code

装完想换回来：npm config set registry https://registry.npmjs.org。

踩坑③：报 EACCES 或权限错误，用管理员身份重开 PowerShell 再装。

---

四、配置：让 Claude Code 连上模型（合规口径）

这是最关键也最容易卡的一步。Claude Code 要调用 Claude 模型，有两条合规路径，按你的情况选一条。

路径 A：用 Anthropic 官方账号（最稳）

直接在项目目录里启动，它会引导你登录：

claude

第一次运行会弹出登录引导，跟着走、用官方账号授权即可。官方对新账号有一定免费额度，先跑通流程足够了。

路径 B：用兼容 Anthropic 协议的第三方/自建服务

Claude Code 支持通过环境变量指定接入地址和密钥——很多服务（包括一些国产大模型的兼容网关）提供了 Anthropic 兼容接口，把地址和 Key 填进去就能用：

# 当前会话临时生效（关掉窗口就没了，适合先测一下）
$env:ANTHROPIC_BASE_URL = "https://你的兼容服务地址"
$env:ANTHROPIC_AUTH_TOKEN = "你的-API-Key"
claude

想永久生效，写进用户环境变量（不用每次设）：

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://你的兼容服务地址", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的-API-Key", "User")

设完重启 PowerShell 让变量加载。

说人话：路径 A 适合想用原汁原味官方模型的人；路径 B 适合手里已经有兼容服务、想控制成本的人。两条都是官方支持的正规接入方式，全程走正规授权，合法合规。

---

五、跑通第一个项目（实操）

光装好没用，咱们真跑一个。

1. 随便建个空目录当练手项目：

mkdir D:\ai-demo
cd D:\ai-demo
claude

2. Claude Code 启动后，直接用大白话给它派活，比如：

帮我写一个 Python 脚本 hello.py，读取当前目录所有 .txt 文件，
统计每个文件的行数，结果打印成一张表格。

3. 它会：分析需求 → 创建 hello.py → 把代码写进去。改文件前它会先问你确认（防止乱改），你看一眼没问题就让它继续。

4. 让它顺手跑一下验证：

帮我运行 hello.py，看看有没有报错，有的话直接修。

这就是 Claude Code 的精髓：它能自己执行命令、看到报错、自己修，而不是只给你一段代码让你自己折腾。

几个一上手就该会的快捷操作

• /clear：清空当前对话上下文（聊久了它会"记太多"变慢，及时清）。
• /init：让它扫描整个项目、生成一份 CLAUDE.md 项目说明，之后它干活更懂你的代码。
• 按两下 Esc：中断它当前的动作。
• 拖一个文件到终端：把文件路径喂给它当上下文。

---

六、常见报错全解（按出现频率排）

1. command not found: claude / 无法将"claude"识别为命令
PATH 没生效。重启 PowerShell；还不行就确认全局安装成功：npm list -g @anthropic-ai/claude-code。

2. 启动后一直转圈、连不上模型
九成是网络到不了模型服务。路径 A 检查网络环境；路径 B 检查 ANTHROPIC_BASE_URL 有没有写错、结尾别多带斜杠，Key 有没有粘全。

3. 401 Unauthorized / 鉴权失败
Key 不对或过期。重新确认 ANTHROPIC_AUTH_TOKEN，注意别把多余的空格/引号粘进去。

4. 改了环境变量不生效
临时设的（$env:xxx）只在当前窗口有效；永久设的要重启终端才加载。用 echo $env:ANTHROPIC_BASE_URL 确认当前窗口读到的值。

5. 它改文件太激进 / 改错了
养成习惯：让它改之前先 git init + git commit 存档，改坏了一条 git checkout . 就回来了。这是用任何 AI 编程工具的铁律。

---

七、装好之后，下一步往哪走

到这你已经能让 Claude Code 在终端里帮你干活了。但"能用"离"用出生产力"还差一截——真正拉开差距的是：怎么写项目级的 CLAUDE.md 让它懂你的代码规范、怎么接 MCP 工具扩展它的能力、怎么用它做大规模重构而不翻车、怎么把 token 成本压到最低。这些进阶打法我整理成了系列，会持续更新。

建议先收藏这篇：下次重装环境或者排错，直接照着抄，省得再满网找。

如果你想系统地把 AI 编程从"尝鲜"变成"日常生产力"，可以关注 大鹏AI教育 的《AI 编程实战》系列——从 Claude Code、Cursor 到 Agent 工作流，每篇都是能复现的实战，跟着做就能上手。下一篇我会讲怎么给 Claude Code 配 MCP，让它能查数据库、读文档、连你自己的工具，关注作者第一时间看更新。

有装到一半卡住的，把报错原文丢评论区，我看到都会回。