命令行入门

本站大部分工具（Claude Code、Codex、SillyTavern 等）都需要在终端里执行一两条命令。 如果你从没碰过命令行，看完这一页就够用了：只需要学会三个动作 —— 打开终端 → 复制命令 → 粘贴并回车。之后回到你要装的那个工具页面照着做。

本页内容

1. 第一步：打开一个「终端」窗口
2. 第二步：复制教程里的命令
3. 第三步：粘贴进终端并回车
4. 怎么算成功、怎么算失败
5. Windows 用户必看的两个坑
6. 停止、重开、进目录、复制路径
7. 最常用的几条命令（够用了）
8. 出错时怎么求助

第一步：打开一个「终端」窗口

终端就是一个可以用文字下命令的黑框框，你电脑里本来就有，不用另外安装。 按你的系统照做：

你的系统	怎么打开（任选一种）
Windows 10 / 11	方法一：按 Win 键 → 直接输入 powershell → 点出来的「Windows PowerShell」。 方法二：按 Win + X → 在菜单里点「终端」或「Windows PowerShell」。 （黑色窗口的「命令提示符 cmd」也能用，遇到报错时它反而更省事，见下文。）
macOS	方法一：按 Command + 空格 → 输入 终端（或 Terminal）→ 回车。 方法二：访达 → 应用程序 → 实用工具 → 终端。
Linux	多数桌面环境按 Ctrl + Alt + T；或在应用菜单里搜「终端 / Terminal」。

打开后你会看到一个窗口，里面有一行类似 PS C:\Users\你的名字> 或 你的名字@MacBook ~ % 的字样。最后那个符号（> 或 % 或 $） 表示它在等你的命令 —— 这就是我们要的状态。

第二步：复制教程里的命令

教程里所有灰色代码框的右上角都有一个「复制」按钮，点一下整条命令就复制好了， 不用手动拖鼠标选中。

如果你想手动选：从命令开头一直拖到结尾，然后按 Ctrl + C（macOS 为 Command + C）。

第三步：粘贴进终端并回车

在终端窗口里粘贴，粘贴完必须按一下回车键（Enter），命令才会开始执行。粘贴快捷键：

系统	在终端里粘贴	补充说明
Windows	Ctrl + V，或在窗口里点鼠标右键	老版本控制台里 Ctrl+V 可能无效，用右键即可。
macOS	Command + V	—
Linux	Ctrl + Shift + V	Linux 终端里 Ctrl+V 不是粘贴。

粘贴成功后你会看到命令文字出现在窗口里、光标停在末尾 —— 这时按回车，它才开始跑。

怎么算成功、怎么算失败

你看到的	说明
窗口滚出一些文字后停住，出现了新的提示符（或一个网址、一句成功提示）	成功。具体成功标志每个工具不同，对应教程页都会写清「看到什么就是装好了」。
出现 npm warn 开头的黄字	多数只是警告，不影响使用，继续等它跑完。
'node' 不是内部或外部命令 / command not found: node	电脑还没装 Node.js。去对应教程页的「安装 Node.js」小节。
npm.ps1 ... 禁止运行脚本（Windows）	PowerShell 安全策略拦住了 npm，见下面「Windows 两个坑」。
几分钟没有任何新文字，像卡死了	多半在联网下载。先等够 5 分钟；仍不动就按 Ctrl+C 停掉，按下面换成国内镜像再重试。
command not found（刚装完就提示找不到）	安装成功了但当前窗口还没刷新。关掉终端，重新开一个再试。
其它看不懂的红色报错	不用慌，按最后一节把内容发给客服。

Windows 用户必看的两个坑

坑一：提示「禁止运行脚本」（无法加载文件 npm.ps1）。这是 PowerShell 的默认安全策略，不是命令写错了。两种解法任选：

• 解法 A（一次解决）：把下面这条粘进 PowerShell 并回车，它会问一句，输入 Y 再回车：

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

• 解法 B：不用 PowerShell，改用「命令提示符」：按 Win 键 → 输入 cmd → 打开后执行同一条命令。

坑二：下载卡住不动（npm / npx 拉取慢）。换成国内镜像再试，只影响本机下载来源：

npm config set registry https://registry.npmmirror.com

想改回官方源：把地址换成 https://registry.npmjs.org 再执行一次即可。

停止、重开、进目录、复制路径

想做的事	怎么做
停止正在运行的程序	在那个终端窗口里按 Ctrl + C（macOS 也是 Ctrl+C）。直接关掉窗口也可以。
下次再启动	重新打开终端，再执行一次启动命令即可。配置会被记住，不用重新填。
进入某个文件夹	用 cd：例如 cd "D:\我的项目"（macOS/Linux：cd ~/Projects/demo）。路径里有空格必须加英文双引号。
看当前在哪个文件夹	Windows：dir；macOS/Linux：ls。看清当前路径可以看提示符，或 Windows 用 cd（不带参数）显示。
复制某个文件夹的完整路径	Windows：资源管理器里进入该文件夹，点一下顶部地址栏，路径会变成可复制文本。macOS：右键文件夹 → 按住 Option → 选「拷贝…为路径名称」。

最常用的几条命令（够用了）

命令	作用
cd 文件夹路径	进入某个文件夹
dir / ls	列出当前文件夹里的内容（Windows 用 dir，macOS/Linux 用 ls）
node -v	看 Node.js 版本（装了才有输出）
npm -v	看 npm 版本（随 Node.js 一起装）
git --version	看 Git 版本（部分工具需要 Git）
↑ 方向键	调出上一条执行过的命令，改一改再回车，不用重打
Ctrl + C	中断当前正在跑的命令

不需要记住它们 —— 用到的时候回来查一眼就行。

出错时怎么求助

把下面三样一起发给客服，基本一眼就能定位问题：

1. 终端里最后 5～10 行文字（直接截图也可以，注意别把密钥那行拍进去）。
2. 你在哪个教程页、做到第几步。
3. 如果有网页界面报错，把界面上的提示原文也发来。

学会这一页之后，回到你要装的工具页面继续： Claude Code CLI、 Codex CLI、 CC Switch、 酒馆 SillyTavern、 DeepSeek Harness 等。