chanlier如果你最近也在折腾 Codex，你多半会经历这么一条路径：先在搜索框里敲“Codex 官网登录入口”，再找下载和安装教程，照着在终端里敲了一堆命令，最后打开 ChatGPT 桌面端或某个编辑器插件时，屏幕上却出现“ChatGPT failed to start. Unable to locate the Codex CLI binary”之类的一大串英文报错。哪怕你已经确认 codex 命令能用了，它还是照样报错。这篇文章就是冲着这些事来的。
我把话放在前面：Codex 不是一个单纯的“代码补全插件”，它是一套会自己读项目、改文件、执行命令的编程智能体。正因为它是智能体，安装链路会比普通命令行工具长一点，涉及的组件也多一层，所以即便你在终端把 Codex CLI 装好了，也不代表每个上层入口都能自动识别它。这篇教程会从形态辨析、安装、登录、日常使用、模型切换、高频报错排查一路讲下来，尽量让你照着做完就能正常开工，而不是在报错堆里反复横跳。
1. 动手之前：先弄清楚你装的 Codex 到底是谁
1.1 Codex 曾经是个模型，现在是一个“会干活的智能体”
如果你是从老资料开始查的，很容易被绕晕。早几年前，Codex 是 OpenAI 那边一个能根据自然语言生成代码的模型名字，功能更像“高级版的自动补全”。到了后面，官方把这名字放到了一个新的产品形态上：一个能理解整个项目、规划多步操作、在本地或云端沙箱里跑命令的编码智能体。
这个区别很重要，因为你遇到的大部分安装问题，都源于对“Codex 到底是什么”的误会。老教程如果让你去装一个“模型权重”或“推理服务”，那是走了弯路。现在我们要装的，是一层负责执行编码任务的 Agent 程序。你给它一个目标，比如“把支付模块的超时重试逻辑补上，并跑通相关测试”，它会自己去翻代码、看报错、改文件、跑命令，而不是只坐在对话窗口里给你吐一段建议代码。
换句话说，以前我们用 AI 写代码，本质是“复制粘贴”：AI 给答案，你手动改，遇到报错再手动粘回去。Codex 这类工具把中间“人肉操作文件、人肉执行命令”的环节也接了过去，所以才能叫智能体。
1.2 四种入口，别把安装方式搞混
我问过不少卡在安装阶段的朋友，十个里有八个是没分清自己到底要从哪个入口用 Codex。目前你接触到的“Codex”大