通用环境基础设施
AI 编程工具都需要你使用终端输入命令。如果你以前只点鼠标操作电脑,这篇文章帮你补齐基础知识。读完你会知道终端是什么、怎么打开、以及安装软件时经常出现的“PATH”“环境变量”是什么意思。
不需要任何预备知识。这正是零基础起点。
你的电脑像一个厨房。GUI(鼠标点来点去)就是在厨房台面上手动切菜、炒菜。终端(Terminal)就是你对厨师长用对讲机下命令——更快、更精确,但你得知道正确的口令。PATH 就是厨师长的菜单——他只听上面列的那些厨师的指令。
1. 打开终端
Section titled “1. 打开终端”- macOS:按
Cmd + Space,输入Terminal,回车。或 Launchpad → 其他 → 终端 - Windows:按
Win + R,输入cmd或powershell,回车 - Linux:取决于桌面环境,通常是
Ctrl + Alt + T
2. 输入你的第一条命令
Section titled “2. 输入你的第一条命令”echo "Hello"输出:Hello
echo 就是“复读机”——你说什么它就重复什么。
3. 你在哪?
Section titled “3. 你在哪?”pwd输出:类似 /Users/jason 的路径。pwd = “print working directory”(打印当前目录)。
4. 这里有什么?
Section titled “4. 这里有什么?”ls输出:当前目录下的文件列表。ls = “list”(列出)。
5. 包管理器是什么?
Section titled “5. 包管理器是什么?”包管理器就是一个“应用商店”,只是工作在终端里:
- macOS:
brew install <包名>(需要先装 Homebrew)
如果你的 Mac 还没装 Homebrew(输入 brew --version 看是否提示 command not found),先用这条命令安装:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"安装过程中它会告诉你它在做什么、是否需要输入密码。按提示操作即可。装完后验证:brew --version。
- Windows:
winget install <包名>(Windows 11 自带) - Linux:
sudo apt install <包名>(Debian/Ubuntu)或sudo dnf install <包名>(Fedora)
6. PATH 是什么?
Section titled “6. PATH 是什么?”echo $PATH输出:一串用 : 分隔的目录路径。
当你输入 npm 时,系统按照 PATH 里列出的目录顺序去找 npm 这个可执行文件。如果找不到,就报 command not found。
7. 环境变量是什么?
Section titled “7. 环境变量是什么?”echo $HOME输出:你的用户主目录路径(如 /Users/jason)。
环境变量是系统和程序之间共享的“便签”。HOME 告诉所有程序你的主目录在哪。AI 工具的 API Key 通常也通过环境变量传入(如 ANTHROPIC_API_KEY)。
command not found:这个命令没有安装,或者它的路径不在 PATH 里。先确认已安装:which <命令名>。若安装了仍提示 command not found,大概率 PATH 未包含该安装路径。Permission denied:没有权限。加sudo尝试(macOS/Linux),或检查文件权限:chmod +x <文件名>。- 安装完软件后终端不识别:关掉终端重新打开。新装的软件注册到 PATH 需要重启 shell 才能生效。
Checkpoint
Section titled “Checkpoint”确认你的环境已就绪:
- 打开终端,输入
echo "Hello"能看到输出 - 输入
node --version能看到版本号(没有?macOS 运行brew install node,Windows 运行winget install OpenJS.NodeJS.LTS) - 输入
npm --version能看到版本号 - 你知道
pwd是干什么的(打印当前目录)
全部通过?环境就绪,可以继续了。
- 从 开始之前 跳过来的?环境就绪了,回去继续自评估
- 继续 Claude Code 快速开始
- 环境就绪后,了解 CLAUDE.md 编写哲学 来定制 Claude 的行为
- 回 学习方法论
- 查看 术语对照表