第 02 模块 · 1 节

终端导航与文件操作入门

《Claude Code 基础入门》02 终端与命令行基础 · 本节时长 28 分钟

为什么还要学终端

你可能觉得「都要让 AI 干活了,还学终端干嘛」。其实理由很简单:

  • Claude Code 就住在终端里,你得会在终端里启动它、看它的输出
  • 很多时候你要告诉它「在哪个目录干活」,得会看自己在哪
  • 你偶尔要自己跑一下命令验证结果

不用学很深,掌握「看目录、进目录」就够 80% 的日常。

贯穿项目这几节的终端命令,我们马上就会真实用上:第 4 模块建 todo 项目、进项目目录、检查文件,全靠 pwd / ls / cd / mkdir。现在就打好底子。

我在哪:pwd

pwd(print working directory)显示你当前所在目录:

pwd
# /Users/you/my-project
习惯开 Claude Code 前先 pwd 确认自己在项目根目录,否则它可能在错误的地方干活。

这里有什么:ls

ls 列出当前目录内容:

ls              # 列出文件和目录
ls -la          # 显示隐藏文件 + 详细信息(更常用)

看到带 . 开头的(如 .git.env)就是隐藏文件,ls -la 才看得到。


进目录:cd

cd 进入目录:

cd src          # 进入 src 目录
cd ..           # 回到上一级
cd ~            # 回到用户主目录
cd              # 回到主目录(等价 cd ~)
cd /Users/you/my-project   # 绝对路径直接跳

你不需要记复杂路径,多用 cd .. 一步步回,或让 Claude 帮你找。


建目录:mkdir

mkdir my-project        # 新建目录
mkdir -p a/b/c          # 递归创建多级目录

常用组合:Tab 补全

打命令时按 Tab 键会自动补全文件名或目录名,打几个字母再 Tab,能省很多打字,也能避免拼错路径。这是终端最提升手速的功能之一。


一张速查表

命令 作用
pwd 当前目录
ls -la 列出文件(含隐藏)
cd <目录> 进入目录
cd .. 上一级
mkdir <名字> 新建目录
Tab 自动补全

落地练习:建出 todo 的「家」

现在就把我们贯穿项目的目录建出来,真实走一遍这节的全部命令:

  1. 回到你的工作区(cd ~cd
  2. 建一个项目目录:mkdir todo-app
  3. 进去:cd todo-app
  4. 确认位置:pwd,应该显示以 todo-app 结尾
  5. 再看里面有什么:ls -la(新建的空目录,通常只有 ...

怎么判断做对了?——pwd 的输出以 todo-app 结尾,ls -la 正常列出了内容没有报错。这个目录就是接下来几节的「练功房」。

卡住了怎么办? cd 进不去?看看是不是目录名拼错了,或先 ls 看它在不在。mkdir 提示已存在?说明之前建过了,用 cd 进去就行。


常见坑:不知道该在哪个目录干活

新手最常见的困惑是「我到底在哪个目录、该去哪建项目」。

三个提醒:开工前先 pwd 知道自己位置;cd ~ 回主目录当起点,别随便乱进系统目录;每个项目一个独立目录,别把东西散落在一堆文件夹里。养成这几个习惯,终端就不会「迷路」。


小结

这一节补齐了最基础的终端底子:看自己在哪(pwd)、看有什么(ls)、进目录(cd)、建目录(mkdir)、Tab 补全,并建好了我们的 todo-app 项目目录。下一节学命令管道,然后就能正式和 Claude 对话了。