Claude Code 零基础跟学教程：从环境安装到子智能体配置的完整实操演示

跟着视频学 Claude Code 这件事，最大的难点其实不在于看不懂，而在于视频播得太快、你手又太慢。尤其是第一次碰命令行、第一次装 AI 编码助手的人，很容易出现「视频里一行命令跑过去了，自己这边卡住了」的尴尬。所以我把这套跟学视频按操作节点重新拆了一遍，告诉你每一步该在哪里按暂停、暂停之后该核对什么，照着做就能自己把安装跑通，并完成一次子智能体调用。

开头别急着跟做：先确认视频在讲哪一套环境

视频最前面通常会花几分钟介绍 Claude Code 是什么。这段你可以正常看，不用动手。它的定位是一个运行在终端里的 AI 智能体，你用自然语言描述任务，它能自己读文件、理解项目、执行命令，而不是那种只帮你补下一行代码的插件。理解这一点很重要，因为后面所有操作都是围绕「终端」展开的。

真正要按下第一次暂停的地方，是视频开始提「前置依赖」的那一刻。资料里讲得很清楚，安装 Claude Code 之前，本地要先有 Node.js 和 Git，而且 Node.js 需要 18 及以上的版本。零基础最常栽在这里：以为跟着装主程序就行，结果环境没准备好，后面怎么都跑不起来。

所以暂停之后先核对一件事：你的电脑到底装没装 Node.js，版本够不够。核对方法不复杂，在终端里查一下 Node.js 的版本号，看它是不是 18 或更高。如果版本偏低，或者命令根本没反应，那就说明环境这一关没过，别急着往下看，先把 Node.js 补齐再说。这一步没过就继续，是新手最容易浪费一整晚的坑。

安装环节：跟着视频走 npm 这条路最稳

确认环境没问题后，视频会进入安装阶段。Claude Code 其实有多种安装方式，但对第一次上手的人来说，资料里推荐的 npm 全局安装是最省心的一条路。视频里演示的多半也是这种，你跟着输入那行全局安装命令即可。

这里要提醒一句：安装命令跑起来之后会有一段输出滚动，很多新手一看到满屏文字就慌。其实你不需要看懂每一行，只要盯住最后的结果——是正常结束，还是报了红色的错误。建议在命令跑完的瞬间暂停视频，把你这边的终端和视频里的状态对一下。如果视频里显示安装成功，而你这边卡在某个报错上，先别继续往后播，这说明问题出在当前这一步。

安装完成后的核对动作同样关键。资料里提到，装好之后在任意项目目录输入启动命令 claude 就能唤起它。所以验证是否真的装成功，不是看那串输出，而是看你能不能把它启动起来。这一步建议你亲自试一次：进入一个随便的文件夹，输入启动命令，看它有没有正常响应。能起来，才算这一关真正过了。

最容易卡住的一关：国内网络与密钥配置

视频接下来往往会讲网络和认证，这也是新手卡得最久的地方，务必放慢速度。资料里明确提到，针对国内网络限制有对应的处理方案，比如配置代理网络，或者通过修改配置来绕过 IP 校验；同时还需要配置 API Key 环境变量，让它知道用谁的身份、连哪个服务。

这段我强烈建议你分成两次暂停来跟。第一次暂停在视频讲「网络方案」的时候：先看清楚视频选的是哪条路，是走代理还是改配置，然后照着它的那一条做，不要两种混着来，混着来反而更乱。第二次暂停在「配置密钥」的时候：Key 这类信息既要填对位置，也要填对内容，视频里光标停在哪一行、填进去的是哪个字段，你都要一一对上。

怎么判断这一关过没过？最直接的办法还是回到启动它、给它发一句简单指令的动作上。如果网络和密钥都配好了，它应该能正常回应你的自然语言请求；如果它迟迟没反应，或者提示连接、认证相关的问题，那基本就能定位到是网络或密钥这一步出了岔子，而不是前面的安装问题。把问题圈定在一步之内，排查起来才不至于乱翻。

从基础命令到技能、子智能体：顺序别搞反

把安装和认证跑通之后，视频会带你进入使用环节。这里有个很重要的操作顺序：先熟悉基础的交互方式，再去碰技能插件（Skills），最后才是子智能体的配置。零基础最容易犯的错，就是跳过基础交互，直接奔着「子智能体」这种听起来很高级的功能去，结果连基本的对话都没摸熟，配置时自然处处踩空。

所以跟到这一段，别图快。先按视频演示，用自然语言给它派几个最简单的任务，感受一下它读文件、理解目录、执行命令的过程。等你对「用一句话指挥它干活」这件事有了手感，再去看技能插件的部分。Skills 可以理解为给它扩展的能力模块，视频通常会先讲这块，作为通往子智能体的过渡。这个由易到难的顺序是刻意安排的，照着走就不容易懵。

完成一次子智能体调用：这篇的终点

到了子智能体这一节，先暂停，把概念听明白再动手。按资料的说法，子智能体是主智能体可以在独立上下文里启动的专用智能体，干完活会把结果汇总回主对话。常见的内置类型有通用型和只读探索型两种：通用型适合独立完成一个小任务、整理文件或跑验证命令并回传结果；只读探索型则专门用来查找、梳理、收集信息，不会去改动文件。除了内置的，你还可以在设置里创建属于自己的用户级子智能体。

对第一次跟学的人，我的建议是：不要上来就自己造一个用户级子智能体，先用内置的跑通一次完整调用，体验「主智能体把一段活拆出去、子智能体独立处理再把结果交回来」的全过程。资料里也给了很直白的用法思路——你可以在提示词里直接要求它先用探索型子智能体去调研某个模块，再回来总结。你就照着这个思路，给它一个简单明确的小任务，让它自己决定要不要拉起子智能体。

这一步的核对点在于「结果有没有回到主对话」。只要你看到子智能体被启动、独立跑了一段、最后把结论汇总回来，那就说明你这次调用成功了——这也正是本篇要带你抵达的终点。

跟学视频的好处是有人演示，坏处是它不会等你。真正决定你能不能跑通的，不是你看得多认真，而是你有没有在那几个关键节点停下来，把自己这边和视频对齐：环境依赖够不够、安装能不能启动、网络和密钥通不通、使用顺序对不对。把这几处暂停核对的习惯养出来，哪怕第一次零基础，你也能自己把安装装好，并踏踏实实完成一次子智能体调用。