📅 2026 年 9 月亲测有效。文中所有标注【实测】的数据,来自 2026-09-02 在 Windows + Node v24.12.0 环境的真实运行;截图摄自两套真实 Windows 环境,版本号略有差异(功能与流程一致)。工具迭代很快,安装命令以官方文档为准。
🧭按需跳读,不用从头读到尾:只想尽快装上能用 → 直接去第三节从第 1 步开始跟,装完做第 6 步验证;已经装过、卡在报错 → 直接翻第七节避坑指南对号入座;想知道这东西是什么、值不值得装 → 读第一节和第六节就够了;撞上"连不上/要订阅" → 看第 5 步的三条出路。
这篇教程解决一个问题:让一个从没打开过"终端"的人,在今天之内,在自己的 Windows 电脑上用上 Claude Code,并完成第一个任务。
- 适合:完全零基础的小白(不知道终端是什么、没装过 Node.js、没有 Claude 会员)
- 不适合:已经天天用 Claude Code 的人(可以跳到避坑指南看报错实录)
- 读完你会做成:本机跑通 Claude Code,并让它替你完成一个真实的小任务
一、Claude Code 是什么(一句话)
Claude Code 是住在终端里的 AI 干活搭档:你用打字的方式告诉它要什么,它直接在你电脑上读文件、写文件、跑命令,交付成果物。
和网页版聊天窗口的区别,一句话说清:聊天窗口只能"说",Claude Code 能"做"。你说"帮我把这个文件夹里的图片全部改名为日期格式",聊天窗口回你一段教程,Claude Code 直接把文件改好。
它由 Anthropic(做出 Claude 的公司)出品,是目前编程圈最主流的 AI 终端工具之一。你不需要会编程才能用它——把它理解成"一个能动手的助理"就行。
二、界面导览:先认认门,别迷路
Claude Code 跑在"终端"里。终端就是一个黑底白字、只靠打字和回车操作的窗口——别怕,保姆级教程会带你一步步打开它。
打开 Claude Code 后,你会看到这样的界面:
三个区域,记住一句话就够:底部的❯是你的话筒,中间滚动的是它的回答,它的提问和确认会插在中间等你按键。
三、跑通第一个任务(手把手,从零开始)
任务选择:问它一句话,拿到回答。10 分钟内可完成,只用到一个功能,但走通了"打开终端 → 命令 → 得到结果"的完整链路。
第 1 步:打开终端
同时按键盘上的Win 键 + R,屏幕左下角弹出一个小窗口(叫"运行"):
在输入框里打三个字母cmd,按回车。黑窗口出现——这就是终端。
这步在干什么:终端是 Windows 上通过打字执行命令的地方。"cmd"是最基础的终端程序。后面所有步骤都在这个黑窗口里完成。
第 2 步:(走 npm 安装路的人才需要)检查 Node.js
在终端里输入下面这行,按回车:
node -v这行在干什么:查看 Node.js 的版本。
-v是 version(版本)的缩写。Claude Code 的 npm 安装包需要 Node.js 22 以上(官方 npm 包 v2.1.198 起的要求)。
- 显示
v22.x.x或更高(比如我实测的【实测】v24.12.0)→ 继续 - 显示"不是内部或外部命令" → 你没装 Node.js,两个选择:(a)去nodejs.org下载 LTS 版安装(一路下一步);(b)直接走下面第 3 步的"原生安装"路,它完全不需要 Node.js
第 3 步:安装 Claude Code(两条路,选一条)
路线 A:官方原生安装(推荐,不需要 Node.js)
在终端里粘贴这行,回车:
irm https://claude.ai/install.ps1 | iex这行在干什么:这是 PowerShell 命令(注意:如果你用的是 cmd 黑窗口,
irm会报"不是内部或外部命令"——遇到这个提示,说明你在 cmd 里,改用下面 cmd 版命令,或先输入powershell回车再执行)。irm从官方地址下载安装脚本,| iex表示"下载完立刻执行"。它会自动下载对应你电脑的安装包、装好、配好环境变量。
cmd 窗口用的版本:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd路线 B:npm 安装(老方法,同样官方支持)
npm install -g @anthropic-ai/claude-code这行在干什么:
npm是 Node.js 的软件安装器,install -g表示"全局安装"(装到整个电脑而不是某个项目),@anthropic-ai/claude-code是软件包的官方全名。官方说明:npm 包现在装的也是同一个原生程序。
国内用户注意(重要):上面两条路都需要能访问 Anthropic 的服务器。如果你在网络受限环境,可能下载或登录会失败——这不是你操作错了,解法见第七节坑 2。
第 4 步:验证安装成功
claude --version这行在干什么:让 Claude Code 报出自己的版本号。能打印出版本(比如【实测】
2.1.72 (Claude Code))就说明装好了。
如果卡住:显示"'claude' 不是内部或外部命令" → 环境变量还没生效,关掉终端窗口,重新打开一个再试(详见坑 4)。
第 5 步:启动并登录
直接输入:
claude这行在干什么:启动 Claude Code 的交互界面,首次启动它会尝试连接官方服务器并引导你登录。
你会先看到一个欢迎画面("Welcome to Claude Code" + 一只像素小浣熊)。接下来分两种情况:
- 网络通畅:出现登录引导,给你一个链接在浏览器里登录 Anthropic 账号;
- 国内直连(大概率):欢迎画面刚过,直接甩出红色报错
Unable to connect to Anthropic services(Failed to connect to api.anthropic.com: Status 403),末尾还补一句 "Claude Code might not be available in your country"——登录页根本没机会出现。
下面这张就是本站在国内网络直连时的真实首启画面(2026-09 实拍,未修图):
先说结论:这不是你操作错了,更不是装坏了——第五节"给它做体检"的claude doctor自检能证明程序本身是完好的,卡住的是它连 Anthropic 服务器这一步。
登录的现实(必须提前说清,免得你卡在这暴怒):
- Claude Code不包含在免费 Claude 账号里,需要 Pro / Max 等付费订阅,或按量付费的 API 账户
- 官方文档写明服务"位于 Anthropic 支持的国家/地区"——中国大陆不在其中,登录和日常使用还会叠加网络问题
这两条加起来,就是国内小白最大的劝退点。三条出路:①你有合规的国际网络 + 海外支付,走官方订阅;②你懂一点配置,手动把它接到国内的 Anthropic 兼容 API(如 DeepSeek 的兼容端点,按量花钱,不需要订阅——本站实测:轻量问答分钱级,Agent 级任务约 0.2~0.5 元/次,见《WorkBuddy vs 开源方案》实测明细);③什么都不想折腾:用本站的 Windows 一键安装包,下载双击,装完即用(它自动帮你配好国内可直连的模型通道,文末有入口)。
第 6 步:完成第一个任务
走到这一步的前提:第 5 步你登录成功了,或者已经按"三条出路"之一配好了可用通道(一键包用户天然满足)。还停在 403 画面的,先回第 5 步把出路选了,再往下走。
看到❯提示符(部分终端显示为>)后,打字(任何中文问题都行):
用一句话解释什么是终端回车,等它回答。看到一段中文回答出现,就是跑通了。
四、心智模型:怎么"使唤"它(比学命令更重要)
新手的困惑从来不是"命令记不住",是"我不知道该让它干什么、怎么说它才懂"。记住三种用法,覆盖 90% 场景:
用法一:直接干(小任务用)
"把 D:\资料 这个文件夹里的所有文件列出来,按修改时间排序"
适合:看一眼就能验收的小事。它干完你看结果。
用法二:先出计划,我确认再动手(大事用)
"我想把 D:\照片 里 500 张照片按拍摄月份整理进子文件夹。先告诉我你打算怎么做,我确认后你再动"
适合:动文件、删东西、改重要内容。养成习惯:凡是"写"和"删"的操作,都让它先说计划。
用法三:只咨询,别碰我电脑(咨询用)
"不要运行任何命令、不要改任何文件,只回答我:……"
适合:你只想问知识、拿方案,不想让它动手的时候。
另外两个习惯:
- 它每次要动你电脑前都会停下来问你允许/拒绝(终端里按数字键选择)。不确定就拒绝,让它解释清楚再说允许
- 重要文件夹,先备份再让它动。它是助理不是神仙,让它"先列出将要做的事"永远是安全牌
五、进阶能力(每个 3 步,用得上才学)
1. 接着上次聊(claude -c)
关掉终端后想继续上午的任务?在新终端输入claude -c,它会接上当前目录下最近一次对话的上下文。
小实操:①上午问过它一个问题并关闭窗口;②重新打开终端;③输入
claude -c,问"我们刚才说到哪了"。
2. 给它装"技能"(Skills),让它更专业
技能(Skill)是给 Claude Code 的"岗位说明书",装了什么技能,它就在对应领域更专业。
小实操:①在对话里输入
/会弹出命令面板;②技能通常从 GitHub 安装(一条npx skills add 作者名/项目名命令);③装完直接提需求即可。想深入看这篇:Claude Code Skill 安装教程(手把手)
3. 给它做体检(claude doctor)
出问题时,先跑这个,它会自检安装状态、版本、配置,常能直接告诉你哪不对。第 5 步撞了 403 墙的人,跑一遍就能确认"程序本身没坏"。
小实操:①退出对话(按两次
Ctrl+C);②输入claude doctor;③按它给出的建议处理。
4. 挑模型(新手:不用管)
Claude Code 支持指定模型,但新手保持默认就是最优解。等你用出感觉了,再去研究--model参数(想看它支持什么,claude --help【实测】可以列出全部选项)。
六、选择建议(敢说结论,不和稀泥)
Q:订阅官方还是走国内 API?
- 完全新手 + 有国际网络和海外支付 → 官方订阅,省心,月费固定
- 想按量花小钱、只想尝鲜 → 国内兼容 API(如 DeepSeek 端点),花几块钱能玩很久,但需要动手配一次
- 两个都不想折腾 → 本站一键安装包,装好就用(通道已预配)
Q:装原生版还是 npm 版?
新手选原生版(第 3 步路线 A)。npm 版是给已经装了 Node.js 的开发者顺手用的,两者装的程序如今是同一个。别两个都装——会出坑 3 说的"幽灵问题"。
Q:要不要怕它删我文件?
不用怕,但要有规矩:它的每个写/删动作都会先请求你批准;你只要守住"没看懂的操作就拒绝"这一条,它就伤不到你。
七、避坑指南(真实报错实录)
以下坑 1 的报错原文,来自我 2026-09-02 的真机实录——不是编的,是踩的。
坑 1:API Key 失效 →401 Invalid API Key
现象:输入问题后卡很久,最后报:
Failed to authenticate. API Error: 401 {"error":{"message":"Invalid API Key","param":"Please provide valid API Key","code":"401","type":"invalid_key"}}我实测时它重试了约 198.8 秒才报错【实测】——所以"卡住很久"别急着关窗口,可能是 key 的问题。
原因:你的 Claude Code 配的是第三方兼容 API(国内常见做法),key 过期或填错了。
解法:①跑claude doctor自检;②找到配置里的 key 重新填/续费;③配官方账号的人检查登录状态(重新claude登录一次)。
预防:把 key 的来源和到期时间记在备忘录;换 key 后用claude doctor验一次。
坑 2:国内直连的"三堵墙"(网络、支付、订阅)
现象:安装慢/失败、登录打不开验证页、或登录后无可用计划。本站实测(2026-09):某些国内网络直连时,路线 A 的官方安装命令拿回来的根本不是安装脚本而是一个网页,iex执行后报出一大串语法错误;就算装成功了,首次启动也常停在 403 连接失败(就是第 5 步截图 07 那个画面)——遇到这些,不是你操作错了,是网络墙。
原因:官方要求付费订阅 + 支持地区 + 国际网络,三件事对国内小白同时不成立。
解法(按省事程度排序):①本站一键安装包(预配国内通道,免订阅);②手动配国内兼容 API;③有条件的走官方订阅。走 npm 路线的人,可给 npm 换国内镜像源(registry.npmmirror.com,本站实测 81 秒装完)。
坑 3:装了两份,版本打架
现象:明明刚升级过,claude --version却显示旧版本;或行为忽对忽错。
原因:原生版和 npm 版装了双份。我本机实测就中招【实测】:where claude同时列出两个路径,长这样:
解法:认准.local\bin这份(原生版),把 npm 那份卸掉:npm uninstall -g @anthropic-ai/claude-code。
预防:只走一条安装路线。
坑 4:'claude' 不是内部或外部命令
现象:第 4 步验证时报这个错。
原因:安装刚完成时,环境变量对"已经开着的旧终端"不生效。
解法:关掉终端窗口,重新开一个再试。还不行就重启电脑。
坑 5:npm 装到一半报 Node 版本错误
现象:npm 安装时报 Node.js 版本不满足。
原因:官方 npm 包 v2.1.198 起要求 Node 22+,你的 Node 太老。
解法:node -v确认版本;去 nodejs.org 装 LTS 版;或干脆改走不需要 Node 的原生安装(路线 A)。
八、真实实战:让它替我整理一个乱糟糟的文件夹
以下是 2026 年 9 月在本站实测机上的完整记录(Windows + Claude Code 2.1.72 + DeepSeek 模型通道)。
任务:一个塞了 20 个杂七杂八文件的文件夹——照片、合同、发票、表格、安装包、压缩包、视频、杂项全混在一起,要求按类型整理进子文件夹。
我的指令(就这一句):
把这个文件夹里的所有文件按类型整理进子文件夹:图片、文档、表格、安装包、压缩包、视频、其他。直接动手完成,最后用一段话报告结果结果(50 秒后):它自动创建 7 个子文件夹,20 个文件全部归位、零遗漏——图片 4、文档 7、表格 2、安装包 2、压缩包 2、视频 2、其他 1,最后还把归位清单打印出来给我核对。
翻车点:无,一次通过。一个提醒:上面用的是"直接动手"模式;整理重要文件夹时,建议加一句"先列出计划,我确认后再动"(就是第四节的用法二)。
花费:按量计费,这类文件整理任务一次估算在几毛钱以内(取决于你的模型通道牌价;轻量问答则是分钱级)。
收尾:你的下一步
**嫌上面任何一步麻烦?**本站的 Windows 一键安装包把第 2~5 步全部打包:下载 → 双击 → 装完即用,内置国内可直连的模型通道,不需要 Claude 订阅,附自检和修复脚本:
继续读(站内相关):
- Claude Code Skill 安装教程:手把手,每行命令都有解释
- 小白也能用 Claude Code Skill:从安装到创建自己的工作流
- 2026 年最值得装的 Claude Code Skill 推荐
下一篇预告:《WorkBuddy vs 开源方案:同一个玩法,不花钱能不能玩》——腾讯的免折腾版和自己动手的免费版,到底怎么选。每周更新,不见不散。
