第 4 章 · 把它跑起来
安装与登录：10 分钟搞定
这一章只做一件事：让你的电脑上出现一个能用的 Codex。
先准备两样东西
1）一个账号。Codex 需要登录才能用，而且要看你所在地区是否开放、你的套餐是否包含。这一步没有捷径，请到官方页面看当前的开放情况。
2）一个专门用来干活的文件夹。建议新建一个空文件夹，比如桌面上的 我的项目。别一上来就让它翻你整个 D 盘——第 8 章会讲为什么。
路线 A：桌面 App（新手强烈推荐）
-
下载安装包
到官方页面找到桌面版下载入口，选你系统的版本（Windows 是
.exe或.msi，macOS 是.dmg）。下载完双击，按提示装完就行，和装普通软件没区别。 -
首次打开并登录
点登录按钮，浏览器会跳出来让你授权，点同意之后回到 App 就算登好了。如果浏览器没自动跳回来，手动点一次"我已经完成登录"。
-
选中你的工作文件夹
界面里会让你选一个文件夹（或叫"打开项目""选择工作区"）。选你刚建的那个空文件夹。这一步很关键：它以后默认只能在这个文件夹里活动。
-
看到输入框，就算成功了
屏幕下方有个能打字的框，恭喜，装好了。接下来跳到第 5 章。
路线 B：命令行（想要更强控制力）
如果"终端""命令行"这些词让你发怵，完全可以跳过这条路，桌面 App 足够用了。如果你愿意试试，它其实就四步：
Windows 上先装 Node.js（去 nodejs.org 下 LTS 版，一路下一步），然后在开始菜单里搜 "PowerShell" 打开，粘贴下面这行回车：
npm install -g @openai/codex装完输入 codex 回车，第一次会让你登录，跟着提示走。
macOS 打开「终端」（Launchpad 里搜 Terminal），用 Homebrew 装最省事：
brew install codex没有 Homebrew 的话，也可以先装 Node.js，再用 npm install -g @openai/codex。装完输入 codex 启动。
Linux 上同样用 Node.js 的方式最通用：
npm install -g @openai/codex装完在你想干活的文件夹里运行 codex 即可。
命令会变，心态要稳
上面这些安装命令是最常见的写法，但这类工具迭代很快。如果哪条命令报错说"找不到"，别怀疑自己——先去官方文档的安装页面抄一遍最新的命令。这属于正常情况，不是你操作错了。
路线 C：编辑器插件
如果你本来就在用 VS Code 之类的编辑器写代码，可以在它的扩展市场里搜 Codex，装上之后登录同一个账号。好处是：Codex 改代码时你能直接在编辑器里看着它改，改完顺手就能自己调。这是写给"已经在写代码的人"的路线，新手不用急。
路线 D：网页 / 云端
有些场景下你可以在网页里派活，让它在云端环境里执行，本机什么都不用装。适合"临时用一下""这台电脑不方便装环境"的情况。注意它看到的是云端那份代码，不是你本地的文件，要先把文件放上去或者连上仓库。
思维导图 · 四条安装路线怎么选
- 我要用 Codex
- 桌面 App（新手首选）
- 下载 → 登录 → 选文件夹
- 最直观，看得见它改了什么
- 命令行 CLI
- 适合习惯终端、要接自动化的人
- 需要先装 Node.js
- 编辑器插件
- 本来就在写代码的人更顺手
- 网页 / 云端
- 临时用、本机不方便装环境
- 看到的是云端那份文件
- 桌面 App（新手首选）
安装常见报错速查
装不上很正常，先看下面这张表，多数问题一两分钟能解决。
| 看到的提示 | 大概是什么原因 | 怎么办 |
|---|---|---|
command not found／不是内部或外部命令 | 装是装上了，但系统找不到它 | 把安装目录加进环境变量 PATH，或者换用桌面 App 那条路线 |
EACCES／permission denied | 没有权限写系统目录 | Windows 上用管理员身份重开终端；macOS/Linux 别加 sudo，改用用户目录安装 |
403／timeout／连不上 | 网络到不了服务端 | 先确认网络能访问对应服务；公司网络可能有代理限制，问一下 IT |
| 登录后页面没反应 | 浏览器授权没跳回来 | 回到客户端点一次"我已完成登录"，或者重启客户端再来一次 |
| 装完了，输入命令没反应 | 它在等你的输入，不是卡住 | 看光标是不是在闪、有没有提示符；不确定就按 Ctrl+C 退出重来 |
| PowerShell 提示禁止运行脚本 | 系统执行策略比较严格 | 改用 CMD 或桌面 App；确实要改策略，请先查清影响再动 |
报错是最有价值的信息
把报错原样贴给它，比自己用中文描述"装不上"有用得多。如果它给的方案你不敢执行，就追问一句：这条命令会改我电脑上的什么？能撤销吗？
装完之后先做这两件事
自检：让它做个自我介绍
在输入框里打：你现在能访问哪个文件夹？帮我列一下里面的文件。如果它能正确列出你选的文件夹内容，说明一切正常。
自检：看清权限提示
它第一次要动手时通常会问你一句"是否允许"。认真读一遍那句话，你会知道自己交出去了哪些权限——这比事后担心有用。
如果你以后要在多个账号 / 多个供应商之间切换
有些人的情况是：既有官方账号，又接了第三方接口；或者几个 AI 工具换着用。手动改配置文件又烦又容易改错，社区有个工具叫 CC Switch 就是干这个的——它的原理、使用步骤和风险写在第 16 章。现在不装也没关系，等真有这个需求了再翻回去看。
提示：用键盘 ← → 可以翻到上一章 / 下一章