1. 为什么我要写一份连下一步点哪里都写清楚的教程我最早看到 Claude Code 这玩意儿是在一个深夜的技术社群里。几个开发者轮流贴出录屏AI 在终端里自己读代码、改文件、跑命令全程人只负责在旁边看戏。当时大家普遍觉得这离普通人太远了根本不是给非程序员用的东西。到了 2026 年再回头看我发现身边越来越多并非程序员出身的人——做运营的、写数据分析脚本的、想给家人做个小工具的全职妈妈——都开始尝试它。这本来是件好事但我在几个新手群里潜水观察了大半年发现真正劝退大多数人的根本不是AI 能不能干活而是我连装都装不上它。1.1 装不上到底卡在哪把几百条新手提问归类之后九成的人死在了三个节点上。第一个节点是环境准备。Claude Code 不是那种下载一个双击就能用的软件它要跑在一套运行环境之上。很多人跳过前置准备直接执行安装命令结果系统甩出一句 node 不是内部或外部命令当场就懵了。第二个节点是安装权限。执行全局安装时被系统拒绝报出所谓的 EACCES 权限错误完全没接触过权限概念的人只能原地放弃。第三个节点是登录认证。历尽千辛万苦总算装完了结果一启动卡在授权登录上浏览器弹了又关、关了又弹授权完成了终端还是没反应。这三个节点单独拎出来都不算难但叠在一起再加上网上的教程默认你多少该会点基础操作就成了一座悬崖。1.2 这份教程想做成什么我后来专门找了一台几乎全新的电脑假装自己是什么都不懂的新手把每一步都完整跑了一遍。这篇教程就是那次过程的记录。你只需要跟着往下做每个阶段我都会给你一个验证命令如果结果和预期不一致那大概率是前面哪一步没完成往回翻就能找到原因。严格来说这篇文章没有太多高深原理更像一份照着敲就能通的操作手册。原理部分我会用正常人类能理解的方式简单带过剩下的全是可复现步骤。2. 先把灶台搭好Node.js 环境安装与验证2.1 为什么 Claude Code 需要 Node.jsClaude Code 是用 JavaScript 写的命令行工具通过 npm——也就是 Node.js 自带的包管理器——分发给用户。也就是说你的电脑上必须先有一个 Node.js 运行时环境这个工具才跑得起来。我常拿灶台和锅来类比Node.js 是灶台Claude Code 是锅。灶台都没有锅买回来也不知道往哪放、火从哪来。很多新手恰恰是跳过了这一步直接去煮饭失败自然是必然的。2.2 下载并安装 Node.jsLTS 版本打开 Node.js 官方网站页面上会同时展示两个版本一个标着 LTS也就是长期维护版另一个标着 Current也就是尝鲜版。选 LTS别碰 Current。LTS 意味着已经经过长时间验证、稳定性优先作为工具依赖再合适不过。Current 版本虽然新但没有必要陪它踩坑。Windows 用户的操作路径下载 Windows Installer 安装包也就是 .msi 后缀的那个双击运行安装向导里会询问安装路径和组件保持默认即可。最关键的一点一定要确保 Add to PATH 选项处于勾选状态一路 Next直到 Finish点确定完成安装完成后重开一次终端。这一步太容易被忽略导致明明装好了系统却不认识macOS 用户的操作路径下载 macOS Installer 安装包也就是 .pkg 后缀的那个双击运行一路继续中途可能需要输入电脑登录密码装完同样建议重开终端Linux 用户的话如果用的是 Debian 系或者 Ubuntu 系比较省事的方式是用系统自带的包管理器直接安装 Node.js。用 nvm 管理 Node 版本也可以但新手期不必引入额外工具。2.3 安装完成的验货方式重开终端后依次输入这两条命令并回车node -v npm -v正常情况下你会看到类似下面的输出v20.19.0 10.8.2只要不是提示不是内部或外部命令也没有冒出 command not found就说明这套运行环境已经能用了。2026 年的 LTS 版本大概率已经到了 Node.js 20 甚至更高这些都无所谓不低于 18 都可以放心往下走。2.4 如果 node 命令找不到怎么办两个最常见的修复方法确认安装时 Add to PATH 确实勾上了把终端窗口整个关掉重新打开一个新的让环境变量生效。在旧窗口里反复敲命令是没用的记住验证环境这件事只认node -v和npm -v的真实输出别靠猜测。3. 安装 Claude Code 的三条路径我只推荐你走最快那条环境准备好之后主角终于可以出场了。3.1 路径一npm 全局安装推荐打开终端Windows 上建议用 PowerShell 或命令提示符执行下面这行命令npm install -g anthropic-ai/claude-code这是 Claude Code 在 npm 上的官方包名。执行之后你会看到大量滚动日志耐心等它跑完就行。如果受网络状况影响npm 下载速度不太理想可以考虑临时切换镜像源但镜像源可能存在更新延迟一旦失败就切回官方源再试一次。macOS 或 Linux 如果遇到权限报错可以先尝试在前面加 sudosudo npm install -g anthropic-ai/claude-codeWindows 用户如果提示权限不足就用管理员身份打开 PowerShell 再执行一次。权限问题的具体原因第 7 章会专门展开讲。3.2 路径二原生安装器到了 2026 年官方已经把原生安装流程做得相当省心。如果你希望电脑里尽量少装依赖完全可以选择原生安装器方式。安装完成后它同样会以claude命令的形式出现在终端里使用体验没有差别。但我的建议是新手老老实实选 npm 这条路。原因只有一个npm 全局安装的升级命令最统一以后想升级就是一条命令的事不容易出岔子。顺手把升级命令也给你npm update -g anthropic-ai/claude-code3.3 路径三IDE 插件间接安装如果你以后打算在主流代码编辑器里写代码也可以在编辑器扩展市场搜索 Claude Code 相关插件。插件会在后台帮您完成核心组件的安装然后用编辑器面板和 AI 交互。这种方式的优点是图形化对完全不适应用终端的人友好很多缺点是如果你换到别的环境还是得重新走一遍终端流程。所以我的态度很明确先用终端把核心概念跑通之后想用插件就用插件体验会顺手很多。3.4 安装成功与否怎么验证执行claude --version如果看到一串版本号恭喜安装这一步已经通关。再执行claude --help会刷出一大片说明文字扫一眼就好。能看到说明说明命令已经被系统正常识别。如果提示 command not found别慌原因和解决办法在第 7 章的避坑清单里。这里你只需要记住一个判断思路装没装上要用claude --version来确认而不是自己猜。4. 登录认证90% 的新手在这里无限循环安装只完成了三分之一。真正进入对话之前你得先完成身份认证让 Claude Code 知道你是谁、用的哪个账号、额度从哪扣。4.1 两种认证方式怎么选Claude Code 目前的认证主要有两条路。方式 A使用 Claude 账号授权登录。在终端里启动 claude它会生成一个授权链接你打开浏览器完成登录和授权就行。这种模式适合绝大多数普通用户因为额度直接绑定你的账号个人日常使用最合适。方式 B使用 API Key。这是给开发者在代码里、自动化脚本里调用的密钥。你需要去自己的开发者后台创建一个密钥然后把它交给 Claude Code。API Key 通常按 token 用量计费更适合自动化任务和批量场景。新手我强烈建议用方式 A一个浏览器操作搞定后面不容易把自己绕晕。4.2 完整登录流程第一步进入你的练习目录执行claude第二步如果是第一次运行终端会提示你进行授权登录。这时系统可能会自动弹出浏览器打开授权页面如果迟迟没弹终端里通常会直接给出一个授权链接复制到浏览器打开就行。第三步在浏览器里登录你的 Claude 账号并确认授权。这一步务必把所有确认按钮都点完。只登录不点授权是新手最容易犯的遗漏。第四步回到终端。如果屏幕上出现了 Claude Code 的欢迎信息说明认证成功你已经进入对话环境了。4.3 登录卡住的三类高频问题问题一浏览器死活不弹。大多数情况下终端里都会给出一条长长的链接手动复制、粘贴到浏览器反而比反复重试更高效。问题二授权完成回到终端还是没反应。大概率是本地回调环节出了问题也可能是本机安全软件或其它网络工具拦截了回环请求。试着重开一个终端窗口重新执行 claude很多时候它其实已经记住了你刚完成的登录状态。问题三API Key 不识别。如果你选了方式 B设置环境变量时要注意密钥前后不要有多余空格不要带着引号进去设置完一定要重开终端让环境变量生效。以 Windows PowerShell 为例正确写法是$env:ANTHROPIC_API_KEY你的密钥macOS 或 Linux 的 bash/zsh 则是export ANTHROPIC_API_KEY你的密钥需要提醒的是这种方式只对当前终端窗口有效。想永久生效得写进 shell 的配置文件。新手期先临时试试跑通了再研究持久化配置避免一次引入太多概念。4.4 登录成功的标志登录成功后终端会出现一个交互式的对话界面。你可以试着输入一句你好帮我看看当前目录下有哪些文件。能正常得到回复就说明一切都通了。5. 第一次实操让 Claude Code 从零帮你做出一个待办清单网页环境问题全部解决后终于可以上手干活。这一章我会带你做完一个真实的小项目——一个能增删待办事项的网页。全程你不需要亲自写代码。5.1 先创建一个干净的练习目录mkdir -p ~/practice-claude cd ~/practice-claude为什么强调空目录因为 Claude Code 工作时会读取当前目录里的已有文件作为上下文参考。如果你在一个塞满旧项目的目录里喊它给我做个待办清单它很容易被无关文件干扰。空目录等于一张白纸新手期最不容易出意外。5.2 启动并输入你的第一个需求在这个目录里运行claude进入对话界面后输入这样一段话在这个目录里创建一个 todo-app 文件夹里面放一个 index.html 和一个 style.css做一个支持新增、勾选完成、删除的待办清单网页。界面要简洁现代适合在手机浏览器上查看。做完后告诉我怎么在浏览器里预览。这已经是一个相当完整的请求。拆解一下目标待办清单网页、交付物两个文件、功能要求增删和勾选、界面倾向简洁现代、后续动作告诉预览方式。新手最常见的失误是需求太模糊比如只丢一句写个网页给我效果自然不理想。5.3 观察它的执行过程Claude Code 收到请求后通常会先给出一个执行计划然后开始逐文件创建。你会实时看到它新增了哪些文件、往文件里写了什么代码。整个过程像看一个远程同事在共享屏幕上工作完全透明随时可以叫停。如果你不满意某个细节可以随时打断这一步停一下我不要 checkbox 放在最左边改成放右边。下一次操作里它就会调整。这种终端对话式开发比传统写完一版再改需求要直观得多。5.4 追加第二个需求增加清除已完成第一次生成的内容不一定完美没关系继续追加帮我再加一个按钮点击后把所有已勾选完成的事项一次性清空。样式和现在的配色统一。它会直接修改相关文件。注意此刻它已经知道项目里有什么了不需要你重新介绍目录结构。这也是为什么在同一个目录、同一个会话里连续干活效率会特别高。5.5 让 AI 主动帮忙跑命令预览想让网页在浏览器里显示直接对它说帮我在本地起一个静态服务器来预览这个页面并告诉我访问地址。启动前先确认当前目录下没有占用端口的程序。如果工具的策略允许执行终端命令它会直接跑类似下面的命令python3 -m http.server 8000如果权限没有默认放开它会弹出一个确认请求。你根据命令内容判断是否允许。新手这时候很容易慌——别怕这是工具在你确认后才执行命令的机制不是坏了。之后你打开它给出的地址就能看到实际效果。第一次在浏览器里看到 AI 帮你写完的网页时那种成就感是很上头的。5.6 一个重要的思维转变整个过程中你写的唯一代码就是聊天内容。但请记住Claude Code 不是魔法它仍然需要你给方向、给反馈、做验收。你可以把它的产出想象成一位非常勤快、但偶尔自作主张的实习程序员。你需要像带新人一样告诉它边界在哪、预期在哪。下一章讲到的配置本质就是在做这件事——把边界写下来。6. 斜杠命令、项目记忆和权限配置会这三样就能认真干活从零做成一个小网页之后你应该对终端对话式开发有了体感。这一章讲的是能让体验长期保持稳定的三样东西斜杠命令、CLAUDE.md 记忆文件、settings 权限配置。6.1 常用斜杠命令速查这里直接给你一张表平时想不起来就回来查。命令作用什么情况下用/help打开帮助文档迷路、忘命令时随时用/init生成 CLAUDE.md新项目开始时想把项目约定固定下来/clear清空当前对话上下文上下文太长、思路跑偏、想重来时/compact压缩对话上下文对话长但不想全扔想保留关键信息时/status查看会话状态确认当前 token 消耗、当前模型时/cost查看费用消耗想确认这次会话大概花了多少时/model切换模型需要更强推理或想省 token 时这里面新手最常用、也最容易被忽略价值的是/clear和/compact。6.2 /init把项目规矩写进 CLAUDE.mdCLAUDE.md 是放在项目根目录下的一个文本文件用来记录这个项目的工作约定。Claude Code 在每次对话开始时都会读它相当于给 AI 递一份入职手册。运行 /init它会根据当前目录结构自动生成一份初始文档。我更建议你手动打开这份文件再补充以下内容项目是做什么的一句话说清技术栈比如纯 HTML/CSS/JS无构建工具约定比如不要改 style.css改动样式请新建 theme.css常用命令比如测试用 npm test不要用 yarn test实测下来只要写进 CLAUDE.md 的约定后续对话中 AI 会频繁遵守比每次开头重新交代一遍靠谱一个数量级。6.3 settings.json把允许做什么也写成明文Claude Code 的项目配置里有一份 settings.json 文件专门管权限。本质是告诉 AI哪些终端命令可以直接执行、哪些需要每次询问、哪些绝对禁止。新手建议至少做到一件事把不熟悉的命令类型设为需要确认把明显有风险的操作设为禁止。我个人的安全底线是凡是删除文件、批量修改权限、连接远程服务器的操作默认都不允许自动执行。这里我不贴完整的配置模板因为版本差异可能导致字段不兼容。正确做法是先运行/status或/help看当前版本提供的配置说明再对照着填。你只需要理解配置等于给 AI 划边界这件事具体字段查起文档来会非常快。6.4 什么时候该翻篇很多新手会出现两种极端。一种是一个会话从头用到尾越用越笨另一种是几乎每句话都在清空把上下文全洗掉导致 AI 完全失忆。合理的节奏是一个小功能的开发周期内尽量保持会话连续功能验收完毕用 /clear 开一个新会话功能没完成但上下文已经超长用 /compact 压缩而不是硬撑记住一个朴素的比喻AI 的对话窗口就像一个人的工作台面。台面上堆满了旧图纸新图纸自然就摆不下了。7. 新手高频踩坑清单每个问题都附修复路径这一章的内容是从新手群里几百条提问里筛出来的高频问题。每一个我都实际复现过完整排查链路给你写出来。7.1 npm 安装报 EACCES 权限拒绝现象执行npm install -g anthropic-ai/claude-code之后滚动日志里出现EACCES: permission denied。原因npm 默认把全局包写入系统目录普通用户没有写权限。这不是 Claude Code 的问题是所有 npm 全局包的通用现象。排查思路先确认报错里确实有 permission denied 字样macOS/Linux 用户直接在命令最前面加 sudo 重试Windows 用户以管理员身份打开 PowerShell再执行一次修复后再跑一下claude --version验证。顺便说一句长期来看更优雅的方案是修改 npm 全局目录到普通用户目录下彻底绕开系统权限问题但新手期用 sudo 解决问题就够了别给自己增加额外负担。7.2 明明安装成功claude 命令却提示 command not found现象安装日志显示成功claude --version却提示找不到命令。这个问题需要按操作系统分开排查macOS 的 zsh 用户装完后先执行source ~/.zshrc让 shell 重新加载环境变量nvm 用户确认你是在哪个 Node 版本下装的 Claude Code切换版本会导致全局命令丢失。解决办法是切回一致的 Node 版本或者用 nvm 固定默认版本Windows 用户检查 npm 全局 bin 目录是否在系统 PATH 里。在 PowerShell 执行npm prefix -g把输出的目录手动加进 PATH 环境变量即可7.3 对话到后面越来越笨答非所问这不是 AI 变笨了是上下文被撑爆了。工具会把整个对话历史持续送入模型历史太长时早前细节会被吞掉模型直接抓不住你的最新要求。此时别继续硬聊。先执行 /compact它会生成一份压缩后的上下文摘要。如果压缩完还是乱直接 /clear在 CLAUDE.md 存在的前提下开一个新会话让它重新读一遍项目效果立竿见影。7.4 AI自作主张执行了我不想让它干的命令现象你只是让它查一下目前目录大小它却执行了一长串网络命令。原因默认权限策略相对宽松它判断命令似乎是安全的就直接执行了。对策立刻打开 settings.json把这类命令的权限改成需要确认。然后明确告诉它以后执行任何网络相关命令前都要先问我。就算它下次口头忘了权限配置也会强制兜底。配置是硬约束比口头要求可靠得多。7.5 登录后终端一直无响应如果你已经确认浏览器里授权完成但终端还停在登录中绝大多数情况是本地回环回调没有成功。从这三个点检查授权页面上的确认按钮是否全部点完而不只是登录完本机是否有安全软件或网络工具在拦截回环连接重开一个终端窗口再执行 claude它可能已经记住了授权状态7.6 关于免费额度和订阅的常见误解用 Claude 账号登录和用 API Key 是两套完全独立的计费体系不要混着用。账号授权登录计入账号本身的订阅或体验额度API Key按 token 独立计费。新手最容易困惑的场景是我已经登录了账号为什么还要我填 Key。这时候低头看一眼终端提示它让你打开浏览器授权就选方式 A它让你输入密钥就选方式 B。一条提示就能分清不用瞎猜。8. 零基础速查卡从零到跑通只要九步最后这章不写大段原理只给一份你随时翻开就能抄的清单。8.1 九步操作序列安装 Node.js LTS重开终端用node -v和npm -v确认环境执行npm install -g anthropic-ai/claude-code用claude --version确认安装在目标项目目录里执行claude浏览器完成账号授权在对话里输入需求让 AI 创建文件用 /init 生成 CLAUDE.md并补充项目约定功能完成就 /clear新功能再开新会话8.2 命令速查表目的是执行这个检查 Nodenode -v / npm -v安装 Claude Codenpm install -g anthropic-ai/claude-code升级 Claude Codenpm update -g anthropic-ai/claude-code查看版本claude --version启动对话claude查看帮助/help生成项目记忆/init清空上下文/clear压缩上下文/compact查看会话状态/status退出对话输入 exit 或按 CtrlD8.3 一句话记住请求怎么写一个完整的 AI 请求 目标 交付物 约束条件 验收方式。每次写请求之前先拆这四个要素。拆清楚了写出来的指令比随口拼一句好十倍。我想特别提一句这次为了验证教程我重新在一台全新电脑上完整跑了一遍整个过程里感受最深的一条是Claude Code 最大的价值不在于让完全不懂编程的人凭空创造软件而在于把动手验证想法门槛降到了极低。我见过一个做运营的朋友用 Claude Code 每天处理上百条数据清洗工作后来硬生生把自己练成了部门里的自动化能手。他并没有写出多优雅的代码他只学会了一件事——把需求拆清楚然后让 AI 执行。这可能是 2026 年最值得培养的动手习惯。最后送你一个小技巧每次对话第一句尽量先把你的身份背景和最终想要的结果讲清楚比如我是做运营的对代码不熟想用脚本把两个表合并请用最保守、最容易理解的方式实现。这段前置说明能帮你省下大量来回返工的沟通成本。现在就去跑通你的第一个项目吧。