Claude Code入门指南：安装前的3个决策与30分钟内跑通第一个命令

“能从头教我怎么用Claude Code吗？”

上个月收到的咨询，一半以上都是这个问题。但仔细听下去，大多数人卡住的地方其实在”怎么用”之前。踏不出安装的第一步，搞不清楚费用，不知道最开始该试什么——就是这三点。

处于这种状态时，读”使用方法”的文章也进不了脑子。阅读之前，需要先解决3个判断。今天我按顺序把这3个判断列出来——安装”前”需要决定的事、30分钟内让它跑起来的最短路径、以及通过最初3个命令真正理解Claude Code的地方。全部内容都从我在实际工作中走过的步骤反推而来。

参考资料：Anthropic官方《Claude Code overview》、Anthropic官方《Set up Claude Code》、Anthropic官方《Claude Code quickstart》

“Claude Code入门”搜索量上升的原因

在搜索引擎里输入”Claude Code入门”或”如何开始使用Claude Code”的人，今年明显增多了。我平时使用的SEO工具里，相关关键词群的前列已稳定出现”入门”类词汇。具体月搜索量因工具而异，在此不作引用。但”入门”已成为与”使用方法”并列的高流量关键词，这是可以观察到的事实。

这种增长有其原因。

原因之一是Claude Code的定位发生了变化。最初主要以面向工程师的CLI工具形式介绍。但2026年5月，RUNTEQ针对非工程师开设了Claude Code课程（RUNTEQ官方）。6月，KDDI敏捷开发中心全公司推行了Claude Enterprise（PR TIMES）。“以非工程师也会使用为前提”的趋势，已同时在教育和企业两个层面发生。

另一个原因是搜索者的焦虑性质变了。这是我的体感，但来咨询的人大多说同样的话：“费用大概看懂了，功能也差不多了解了，但就是迈不出第一个命令那一步。“读了”使用方法”类文章，才发现自己卡在更前面的地方。

一个容易混淆的地方是”入门”和”使用方法”的边界。我是这样区分的：

• 入门：安装前的判断、环境搭建、到第一个命令为止（本文）
• 使用方法：第一天用3步做什么、如何应用于实际工作（claude code使用方法）
• 费用：5个套餐的区别与个人试用、企业PoC、正式上线的月费估算（claude code费用）

本文的范围是：下决心安装，以及30分钟后屏幕上出现什么。之后的”工作中如何使用”交给其他文章。刚开始的人，只需要读今天这篇。

安装前需要做的3个判断

首先花时间的，不是设置电脑，而是解决3个判断。跳过这一步，安装后会遇到”和预想的不一样”而卡住的情况。

判断1：从哪个套餐开始

截至2026年6月，个人版价格分为3档：Pro版20美元/月、Max 5x版100美元/月、Max 20x版200美元/月。企业版方面，Claude Code在Team/Enterprise套餐下的使用条件另有规定，请通过Help Center《Claude Code和Team・Enterprise套餐》确认最新条件。个人版定价来源：Anthropic官方定价页面。

第一个判断在Pro和Max之间。我的建议是：从Pro开始。理由有两点：

• Pro版20美元/月，在使用上限范围内运行（Anthropic官方《Manage costs》）。根据我的观察，非工程师用户在第一周内触达上限的情况很少
• 切换到Max版随时可以在月度边界进行。从一开始就选Max的合理时机，是明确预计每天会使用Claude Code 2至3小时以上时

多人使用的企业场景，请先在上述Help Center确认Team/Enterprise套餐条件再行动。详细的套餐比较整理在claude code费用中。

判断2：在哪台设备上运行

Claude Code官方支持macOS、Linux和Windows（Anthropic官方《Set up Claude Code》）。Windows除了通过WSL（Windows Subsystem for Linux，Windows Linux子系统）的方式外，也提供了使用PowerShell和WinGet的原生安装导引。核心判断是”直接用自己的主力设备，还是另外开一台”。

在我咨询的非工程师用户中，最常见的是以Windows为主力机的情况。通过WSL的方式需要多一个步骤——在Windows内部安装Linux运行环境。按照微软官方文档操作，30分钟内可以完成。但如果目标是在30分钟内跑通整个流程，需要注意：光是WSL安装就可能用掉这30分钟。

我的实际做法是，建议以Windows为主力机的用户”前一周借用macOS或Linux设备”。公司有Mac借用名额的话就用那个，没有的话家人的MacBook也行。降低第一次体验中遇到挫折的概率，正是能坚持下去和坚持不下去的分水岭。

判断3：最开始用什么业务来试

这是安装前最容易被省略的判断。“装好之后再想用什么试”，会导致30分钟后呆坐在屏幕前。

我给非工程师咨询者的初始尝试业务，有3类：

• 文件整理：把一个乱糟糟的文件夹交给Claude Code，指示”看看里面的内容，帮我整理”
• 会议纪要摘要：把录音转写稿交给它，指示”只提取决定事项和待办任务”
• 业务操作手册化：把自己的口头说明交给它，指示”把这个整理成新员工能看懂的操作手册”

这些都不是编程。但在最初的30分钟内，可以切身体会到Claude Code能读取文件、能写入文件这一核心特性。在安装前就决定好”把自己的哪项业务交给Claude Code来处理”——这决定了最初30分钟的体验质量。

30分钟内的最短路径

3个判断解决后，接下来就是30分钟。按时间轴排列。

0至5分钟：确认Node.js

Claude Code的安装方式有两种：通过npm进行全局安装，以及通过Anthropic官方原生安装程序安装（Anthropic官方《Set up Claude Code》）。今天以npm方式为前提进行说明。选择npm方式的原因是，之后安装其他基于JS的工具时，这套环境可以复用。

首先确认Node.js是否已安装。打开终端，输入node -v。如果返回v18以上的版本号，没有问题。如果返回”找不到命令”，则从Node.js官方网站安装推荐版本。5分钟以内可以完成。

5至15分钟：通过npm安装claude code

在终端中输入：npm install -g @anthropic-ai/claude-code

中途可能出现权限错误，这在后面的”常见卡点”部分会讲到。安装完成后，用claude --version确认是否返回版本号。返回版本号即安装成功。

到这一步大约需要10分钟左右。很多人到这里会有一种”啊，装进去了”的感觉。

15至20分钟：在项目文件夹中启动claude

接下来，确定让Claude Code工作的文件夹。在桌面新建一个名为”claude-test”的空文件夹，在终端中导航到该文件夹，然后只输入claude。

Claude Code的设计是将”当前所在文件夹的内容”作为工作对象。如果不小心在Documents文件夹直接启动，业务文件也会进入工作范围。第一次启动，务必在空文件夹中进行。

20至30分钟：浏览器认证

第一次启动claude时，浏览器会弹出Anthropic账号的登录界面。用手头的Pro账号登录即可。认证完成后，终端提示符会返回，出现类似”>“的输入等待符号。

到这里大约30分钟。屏幕上只有一行等待输入的提示符。看上去什么都没发生，但这就是起点。

通过最初的3个命令切身体验变化

跑通30分钟的流程后，第一步输入什么会改变体验感。以下是我给非工程师咨询者的最初3个命令：

命令1：整理这个文件夹里的文件

事先在空的claude-test文件夹里放入5至10个各类文件。图片、PDF、Excel、文本文件都行。然后在Claude Code的提示符中输入：

“请在这个文件夹里按文件类型创建子文件夹，把文件分类整理好。”

Claude Code会读取文件夹内容，提出整理方案，并请求确认。确认后，文件按类型分别归入各个子文件夹。大约1至2分钟完成。

这个命令让非工程师体验到的是：**“用自然语言的指示就能操控自己电脑里的内容”**这一事实。不需要记终端命令，也不需要编程知识。用中文写一句指示，文件操作就开始执行。大多数咨询者在这里第一次意识到”这和其他工具不一样”。

命令2：从这份会议纪要里只提取决定事项和待办任务

接下来是文本处理。在文件夹内放入从录音转写的会议纪要文本文件，1000字左右即可。然后输入：

“读取会议纪要.txt，把决定事项和待办任务以条目形式提取出来。有负责人和截止日期的请一并标注。”

Claude Code读取文本，将内容结构化，以条目形式返回。大约30秒完成。

这个命令能体验到的是：**“我旁边多了一个会帮我读文件、整理内容的存在”**这种感觉。会议纪要的整理，以前只能自己做，或者粘贴到其他工具里处理。在Claude Code运行的这段时间里，这项工作在文件夹内就能完成。

命令3：把这份操作说明改写成适合新员工阅读的格式

第三个是文档生成。把自己用手机备忘录记下来的口头说明文字（500字左右即可）放入文件夹。然后输入：

“读取操作说明.txt，改写成新员工也能看懂的格式，加上标题和步骤。专业术语请加简单说明。”

返回的是带有标题和编号步骤的结构化操作手册。大约1分钟完成。

这里体验到的是：**“以前只存在于自己脑子里的工作知识，现在可以文档化了”**这种感觉。对很多非工程师来说，“把自己的做法用语言表达出来”本身就是一道坎，甚至先于自动化就已经挡在前面了。Claude Code承担了这种语言化工作的一部分。

在30分钟完成启动后，输入这3个命令。达到这里，Claude Code就不再是”方便的AI”，而是”坐在旁边的另一个人”。

容易卡住的3个关口与应对方法

读到这里觉得”要去试试了”的人，恰恰最可能在最初30分钟遇到麻烦。以下是在我的咨询案例中出现频率最高的3个关口，附对应方法：

关口1：Node.js版本不匹配

输入npm安装命令后，很多人遇到报错停下来。大多数情况是Node.js版本问题。如果装的是较旧的v14或v16，会返回兼容性错误。

应对方法有两种：将Node.js升级到最新推荐版本（LTS），或者使用Node.js版本管理器（nvm）指定v20。在最初30分钟内，选前者更简单。升级到LTS，重新打开终端，用node -v再次确认。

关口2：权限错误（macOS/Linux）

在macOS或Linux上执行npm install -g时，可能返回”permission denied”（权限被拒绝）。这是因为全局安装目标文件夹没有写入权限。

可以用sudo npm install -g强行通过，但我不建议这样做——这样做之后npm的权限问题往往会越来越复杂。推荐的方法是将npm的prefix重定向到自己的home目录下（npm官方文档里有操作说明）。虽然需要10分钟，但做好之后，之后所有基于JS的工具安装都会顺畅很多。

关口3：用量额度用尽

第三个容易卡住的点是用量额度。Pro套餐有使用上限（Anthropic官方《Manage costs》）。最初几天因为体验感好、连续投入大量文件，有可能触碰上限。

应对方法是在第一周采用”短指令多次执行”的运营方式。长文档处理留到明确知道要问什么的时候再投入。这样既能稳定结果，也能合理使用额度。费用设计的详细内容在claude code费用中有整理。

开始后第一周要做什么

30分钟跑通，最初3个命令的体感改变了，常见卡点也克服了。接下来的一周，决定Claude Code是否能坚持下去。

我给咨询者的第一周安排如下：

• 第1至2天：用不同的文件、不同的业务再跑一遍最初的3个命令。观察同样的指示，结果会有什么变化
• 第3至4天：从自己的实际工作中列出3件”想交给Claude Code处理”的事。只是列出来，还不需要实际运行
• 第5至7天：从列出的3件事里选最简单的一件，实际交给Claude Code处理。就算结果不理想，也要用修正指示最多坚持3次

关键是”不要试图把整个工作都交给Claude Code”。第一周只处理业务的一部分——具体说是自己能用语言表达步骤的那部分。这是能坚持下去和消失的人之间的分水岭。

3步实用指南在claude code使用方法中有整理。完成30分钟启动后，请前往那里继续阅读。如果同时想考虑无代码AI代理工具，可以在无代码7款工具比较中确认。

总结：只需记住3个判断和第一个命令

给所有搜索”Claude Code入门”却卡住的人，把今天想传达的内容重新整理如下：

• 安装前的3个判断：套餐（从Pro开始）、设备（优先macOS/Linux，Windows选PowerShell/WinGet原生或WSL）、第一件尝试的业务（文件整理・会议纪要摘要・业务操作手册化三选一）
• 30分钟最短路径分4个环节：确认Node.js、npm安装、在空文件夹启动、浏览器认证
• 最初3个命令固定好：文件整理、会议纪要提取、新员工操作手册化
• 容易卡住的3个关口：Node.js版本、权限错误、用量额度用尽
• 能坚持下去的诀窍：第一周只限于业务的一部分，每次修正指示最多3次

达到这里，Claude Code就不再是”需要学会用法的工具”，而是”坐在旁边的另一个人”。

明天早上留出30分钟。Pro版20美元的订阅、一个空文件夹、还有一张”第一件要交给它处理的事是什么”的便条准备好，当天晚上你对这个工具的理解就会改变。