小白 AI Hub

Codex 小白入门课｜第二章

从零开始安装 Codex：小白第一次打开终端机也能跟着做

第一章我们先讲要准备什么工具，第二章就要真的开始安装 Codex。这一章会把你当成真正的小白：不知道终端机是什么、不知道要打在哪里、不知道看到什么算成功，这些都没关系。

你只要照着做，一步一步来。这章不是要你变成工程师，而是让你知道怎么把 Codex 安装好，之后才可以叫它帮你改文件、做网站、整理文章。

先看短视频版：1 分钟看懂安装流程

如果你还没打开过终端机，可以先看这支短视频。它会用最白话的方式，把 Node.js、PowerShell、Terminal、npm 和 Codex 登录流程先串起来。

也可以直接到 YouTube 观看

先讲白话：安装 Codex 不是像一般 App 一样一直按下一步。它比较像先帮电脑装一个「可以听指令的入口」，然后你在黑色或白色的小窗口里输入 codex，Codex 才会开始跟你工作。

这一章要完成什么？

  1. 知道什么是终端机。
  2. 安装 Node.js，让电脑可以使用 npm。
  3. 用 npm 安装 Codex CLI。
  4. 输入 codex 启动 Codex。
  5. 登录 ChatGPT 账号。
  6. 确认看到 Codex 画面，代表安装成功。

先懂三个名词，不用背

终端机是什么？

终端机就是一个可以用文字命令控制电脑的小窗口。Windows 常见的是 PowerShell，Mac 常见的是 Terminal。你可以把它想成「跟电脑下指令的对话框」。

Node.js 是什么？

你可以先把 Node.js 想成一个让电脑可以安装某些工具的底座。Codex CLI 可以通过 npm 安装，而 npm 通常会跟 Node.js 一起来。

Codex CLI 是什么？

CLI 的意思是命令行工具。小白不用记英文，只要知道：这是可以在终端机里启动 Codex 的版本。官方文件也说 Codex CLI 是在你电脑本机执行的 coding agent。

安装前先确认你有什么

第一步：先安装 Node.js

如果你不知道自己有没有 Node.js，就照这一段做。装过也没关系，后面会教你怎么检查。

Windows 和 Mac 都可以这样开始

  1. 打开浏览器。
  2. 到 Node.js 官方网站：https://nodejs.org/en/download
  3. 下载适合你系统的版本。
  4. 打开下载好的安装文件。
  5. 小白先用默认选项，一路照着安装。
  6. 安装完以后，先把终端机关掉再重新打开。

第二步：打开终端机

Windows 小白打开方式

  1. 按键盘左下角的 Windows 键。
  2. 输入 PowerShell。
  3. 点开「Windows PowerShell」。
  4. 你会看到一个可以输入文字的窗口。

Mac 小白打开方式

  1. 按 Command + 空白键。
  2. 输入 Terminal 或「终端机」。
  3. 按 Enter 打开。
  4. 你会看到一个可以输入文字的窗口。

第三步：确认 Node.js 和 npm 有没有成功

打开终端机后，先输入下面这一句，再按 Enter：

node -v

如果画面出现像 v20.0.0、v22.0.0 这种版本号，代表 Node.js 有装好。数字不一定跟这里一样，重点是要有出现版本号。

接着输入：

npm -v

如果也出现一串数字，代表 npm 可以用。

如果看不懂错误：不要慌。把整段错误复制起来，问 Codex 或 ChatGPT：「我是电脑小白，这段错误是什么意思？请一步一步教我修。」

第四步：安装 Codex CLI

确认 npm 可以用以后，在终端机输入下面这一句，然后按 Enter：

npm install -g @openai/codex

这句话的意思是：请 npm 帮你把 OpenAI 的 Codex 工具安装到这台电脑，之后你可以直接输入 codex 叫它出来。

安装时画面会跑一些英文，这很正常。小白先不要急着关掉，等它跑完，回到可以输入下一行命令的状态。

第五步：启动 Codex

安装完以后，输入：

codex

正常情况下，你会看到 Codex 开始启动，可能会要求你登录。官方建议可以选择用 ChatGPT 账号登录，这样就能用你的 ChatGPT 方案使用 Codex。

第六步：登录 ChatGPT

  1. 看到登录提示时，选择用 ChatGPT 登录。
  2. 浏览器可能会自动打开登录页。
  3. 输入你的 ChatGPT 账号。
  4. 登录成功后，回到终端机。
  5. 如果 Codex 画面可以输入任务，代表你已经进去了。

Windows 和 Mac 哪里不一样？

Windows

Windows 通常用 PowerShell。小白最常卡在权限、路径、安装后没有重新开终端机。如果输入 codex 找不到，先关掉 PowerShell 再重新打开。

Mac

Mac 通常用 Terminal。有些人会用 Homebrew 安装，官方文件也提供 brew install --cask codex 这种方式。但小白先用 npm 方式即可，因为 Windows 和 Mac 都能用同一套逻辑。

小白最常遇到的 5 个问题

1. 输入 node -v 没反应或找不到

通常是 Node.js 没装好，或安装后终端机没有重开。先重新开 PowerShell / Terminal，再试一次。

2. 输入 npm -v 找不到

通常也是 Node.js 安装问题。回到 Node.js 官网重新安装一次。

3. npm install 跑很久

先等一下。有时候网络慢。如果真的卡很久，把画面错误复制下来再问 Codex。

4. 输入 codex 显示找不到命令

先关掉终端机重新打开。如果还是不行，可能是安装没有成功，重新跑一次安装命令。

5. 登录时不知道选哪个

小白优先选 ChatGPT 登录，不要一开始就碰 API Key。API Key 需要另外设置，对新手比较容易搞混。

安装成功后，第一句不要乱下大任务

你刚装好 Codex，不要马上叫它「帮我做一个完整网站」。先用很小的任务测试。

你好，我是电脑小白。
请先不要修改任何文件。
请告诉我你现在能帮我做哪些事情，
并用小白能懂的方式列出 5 个例子。

如果它能正常回复，代表你已经可以开始学第三章：怎么跟 Codex 说话。

第二章检查表

工具推荐版位：未来可放 MacBook、Windows 笔电、屏幕、键盘、云端备份、Node.js / Codex 安装陪跑服务。

下一章预告

第三章就要进入真正使用：安装好了以后，你第一句要怎么跟 Codex 说？我们会用「小白老板与 Codex 员工」的方式，教你怎么交代任务、限制范围、验收成果。

参考来源