装一次少走两小时弯路。网上的 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 环境别的什么都不用装。打开 Node.js 官网下载 LTS 版2026 年 6 月当前 LTS 是 22.x闭眼装 LTS 就行别装最新的 Current 版。一路下一步装完记得勾上Add to PATH默认勾着。打开 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 configsetregistry 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-Keyclaude想永久生效写进用户环境变量不用每次设[Environment]::SetEnvironmentVariable(ANTHROPIC_BASE_URL,https://你的兼容服务地址,User)[Environment]::SetEnvironmentVariable(ANTHROPIC_AUTH_TOKEN,你的-API-Key,User)设完重启 PowerShell让变量加载。说人话路径 A 适合想用原汁原味官方模型的人路径 B 适合手里已经有兼容服务、想控制成本的人。两条都是官方支持的正规接入方式全程走正规授权合法合规。五、跑通第一个项目实操光装好没用咱们真跑一个。随便建个空目录当练手项目mkdir D:\ai-demo cd D:\ai-demo claudeClaude Code 启动后直接用大白话给它派活比如帮我写一个 Python 脚本 hello.py读取当前目录所有 .txt 文件 统计每个文件的行数结果打印成一张表格。它会分析需求 → 创建hello.py→ 把代码写进去。改文件前它会先问你确认防止乱改你看一眼没问题就让它继续。让它顺手跑一下验证帮我运行 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 initgit commit存档改坏了一条git checkout .就回来了。这是用任何 AI 编程工具的铁律。七、装好之后下一步往哪走到这你已经能让 Claude Code 在终端里帮你干活了。但能用离用出生产力还差一截——真正拉开差距的是怎么写项目级的CLAUDE.md让它懂你的代码规范、怎么接 MCP 工具扩展它的能力、怎么用它做大规模重构而不翻车、怎么把 token 成本压到最低。这些进阶打法我整理成了系列会持续更新。建议先收藏这篇下次重装环境或者排错直接照着抄省得再满网找。如果你想系统地把 AI 编程从尝鲜变成日常生产力可以关注大鹏AI教育的《AI 编程实战》系列——从 Claude Code、Cursor 到 Agent 工作流每篇都是能复现的实战跟着做就能上手。下一篇我会讲怎么给 Claude Code 配 MCP让它能查数据库、读文档、连你自己的工具关注作者第一时间看更新。有装到一半卡住的把报错原文丢评论区我看到都会回。