乐于分享
好东西不私藏

被 Claude Code 官网的复杂文档劝退?其实你只缺一个“最小第一步”

被 Claude Code 官网的复杂文档劝退?其实你只缺一个“最小第一步”

你打开 Claude Code 的官网,看了一圈。鼠标在屏幕上悬停了一会儿。不知道该点哪里。

你在想:我是不是应该先读点什么?先看懂一些东西?然后再开始?

这很正常。


首先,这不是你的问题

我们去一个新产品官网,通常期待看到这样的东西:一个下载按钮,一个”三分钟上手”视频,几张截图,告诉我们”点这里,开始用”。

Claude Code 的官网不是这样的。

它给你的是文档。一层套一层的文档。安装指南、快速开始、命令参考、配置说明。你往下滑,以为快要到底了——结果下面还有更多。

然后你注意到它提到”terminal”(终端)。你不太确定那是什么。它还提到”command line”。你模糊地记得这个东西,但很久没用过了。

于是你的脑子里开始出现一种声音:”这个东西好像不是给我准备的。”

这个声音出现的时候,你不是一个人。包括那些已经在写代码的人,第一次面对这个界面,也会有同样的反应。

官网的设计假设和你的实际状态之间,存在错位。

王富贵在县城一所中学教信息技术。他想买一套在线课程学 Python,付了钱,登录了平台,满屏的目录和章节——”环境配置”、”变量基础”、”循环结构”——他不知道该从哪一章开始。卡了两周,最后把课程退掉了。

他后来意识到:不是学不会,是从哪开始这个问题,课程没有回答。

你现在面对 Claude Code 的感觉,和王富贵当时一模一样。

官网假设你知道命令行是什么。假设你已经有了编程环境。(而这些都是开始编程前需要知道的前置知识,一般只会在高级部分讲到。)假设你能读英文文档。这些假设,对于一个刚被”生产力工具升级”这篇文章说服、想来试试的普通用户来说,每一条都可能不成立。

你感到不知所措,不是因为你不够格。那个”最小第一步”,还藏在文档的第三层之后。


你看到的是什么

我们来重新看一下你刚才看到的那个页面。

第一眼,你可能以为这是一个 App——就像 Notion、Figma 或者那些你用惯了的在线工具一样,点进去,登录,然后开始用。

它不是。

Claude Code 是一个命令行工具。它在你电脑的终端(terminal)里运行。终端是 macOS 自带的应用——在”启动台”里搜索”终端”或者”Terminal”,就能找到它。

你打开了那个黑色的窗口,里面有一行光标在闪。在那个窗口里输入文字指令,它会执行。那个窗口,就是你和 Claude Code 沟通的地方。

当你第一次打开 Claude Code 官网,你看到的那个页面,不是它的”界面”——那是它的使用手册。而使用手册,是写给已经知道怎么用它的人看的。

这听起来有点反直觉。但想想看,我们不会在学会开车之前去读汽车说明书。我们先坐到驾驶座上,踩一脚油门,感受一下车动了,然后再去看手册里那些术语——那时候,它们才有了意义。

使用 Claude Code 也是一样的道理。


最小可行路径

所以,不需要把文档全部读完才能开始。你需要的只是最小可行的第一步。

以下这五步,是最简路径。

第一步:安装

打开终端(macOS 或 Linux 系统):

curl -fsSL https://claude.ai/install.sh | bash

如果你用的是 Windows,打开 PowerShell(开始菜单搜索”PowerShell”):

irm https://claude.ai/install.ps1 | iex

安装完成之后,输入 claude --version,如果看到版本号,说明安装成功了。

这一行命令,可能已经是整篇文章里最吓人的一句话了。我完全理解。如果你从来没有用过终端,这个界面看起来确实像某种黑客电影。

但它只是一个窗口。你在那个窗口里输入文字,它给你结果。就这么多。

第二步:认证

安装之后,你需要登录你的账号。运行 claude,它会引导你完成认证流程。

你需要有一个 Claude 账号。这个账号需要开通 Pro 订阅(截至 2026 年 6 月,约每月 20 美元)。不是 Claude Code 单独收费,而是你需要有一个 Claude Pro 的账号才能使用 Claude Code。

如果你已经有 Claude Pro 账号,直接 claude login,按提示操作就好。

如果你在注册账号的过程中遇到障碍——比如境外手机号、支付环节、或者访问受限——市面上有一些帮助用户获取 API 访问权限的中转服务。它们的价格和服务方式差异较大,选择的时候多看评价,找一个评价真实、响应及时的服务商,能省不少麻烦(隐晦说一下,比如我这里。可以给你看看我这几天的 Token 用量)。

第三步:进入一个文件夹,运行它

这是最神奇的一步。

找任何一个你电脑上的文件夹——一个放代码的文件夹,或者随便新建一个空文件夹也行。打开终端,用 cd 命令进入那个文件夹:

cd ~/Desktop/my-project

然后输入:

claude

回车。

你看到了什么?你应该看到一个对话界面在终端里打开了。Claude 在等你说话。

从安装到第一次对话,最快只需要三分钟。

第四步:写一个 CLAUDE.md

在你的项目文件夹里,新建一个文件,命名为 CLAUDE.md

这个文件就是 Claude Code 的”记忆卡”。每次进入这个文件夹,它都会先读一遍这个文件,了解你在做什么项目、用什么语言、你的目标是什么。

第一版可以极其简单:

# 我的项目这是一个用来练习 Claude Code 的测试项目。我主要用 Python。

就这些。三句话。Claude 读完之后,就知道你在做什么了。

它可以在你使用的过程中慢慢完善。每次你发现 Claude 遗漏了什么,就在 CLAUDE.md 里补上。这是一个你和 Claude Code 之间越来越默契的过程。

下图是我一个 GitHub 仓库的 CLAUDE.MD 文件内容

第五步:下第一个指令

现在你已经坐在驾驶座上了。系好安全带了吗?踩油门吧。

试试这个:

帮我写一个 README.md,介绍这个项目的基本信息。

Claude 会问几个问题确认你的需求,然后生成文件。你同意就让它写入,不同意就说”不太对,改一下”,它会继续调整。

就这么简单。这就是你的第一个指令。


你不需要”准备好”

到这里,你可能还有一个心理障碍:我的指令够不够清楚?会不会说错了?

我们来看一个事实:Claude Code 不是一个会读心术的工具,但它是一个会追问的工具

如果你给的指令很模糊——”帮我弄一下这个项目”——它不会凭空发挥。它会问:”你希望我具体做什么?”然后你们就开始对话,一点一点把任务说清楚。

这个对话能力,是 Claude Code 和那些一次性补全工具最大的区别。你不需要在第一次对话前就准备好完美的指令。你需要的只是一个真实存在的任务——哪怕很模糊,哪怕只有一个模糊的想法。

比如:

  • “我有一个文件夹,里面有一些 Python 文件,但很乱,帮我看看”
  • “我上周写的这段代码,现在跑不起来了,帮我调试”
  • “我想给我的项目加一个用户登录功能,不知道从哪里开始”

如果你不是程序员,试试这个:把一个放文档的文件夹变成你的”写作工作室”。在 CLAUDE.md 里写上:

# 写作工作室我在这个文件夹里写公众号文章。我主要用 Markdown 格式。每次帮我生成一个草稿开头,风格要口语化。

然后对 Claude 说:”帮我写一个关于时间管理的文章开头。”它会问你几个问题——目标读者是谁、想表达什么核心观点——你回答,它就帮你生成。然后你们可以继续改。这就是非程序员也可以用它的方式。

这些都是有效指令。它们不需要完整,不需要准确。它们只是开始。

真正的问题是:你有没有先下一个指令。


不知所措?你只是缺一个最小第一步

回过头来看,我们为什么会不知所措?

表面上,是因为看到的信息太多、太陌生。但深层的原因是:我们没有看到一个清晰的、足够小的第一步。

我们期待有一个”准备好了”的感觉——等我们把文档读完了,等我们对它足够了解了,等我们确定自己会用对了(等鸡啄完米,等狗舔完面,等火把铁锁烧断)——然后再开始。

但这个感觉不会来。只有开始做了,才会来。

不知所措,与其说是”我学不会“””的信号,其实是”我还没找到最小第一步”的信号。

当你下次看到任何一个让你心动的工具,却不知道从哪里开始的时候——记住这个模式。那不是你的问题。是那个工具的官网没有给你一个足够小的第一步。

而这篇文章,就是你的那个第一步。

今天可以做的最小一件事:

打开终端,输入 curl -fsSL https://claude.ai/install.sh | bash ——先完成安装。其他的事情,明天再说。


你上一次因为”不知道从哪开始”而放弃的东西,后来找到那个最小第一步了吗?它是什么?