如果你最近在关注 AI 编程工具大概率会频繁看到 Codex 这个名字。但真正动手去装的人又会发现它并不是“装完就能用”这么简单有人卡在 npm 装完提示 command not found有人登录时浏览器怎么也跳转不出来有人第一次跑任务就碰到模型不支持的报错还有人被一段 local proxy failed 的报错折腾了整整一天。这篇文章不绕弯子直接给你整理一份 Codex CLI 从零到一的完整链路它到底是什么、安装前需要准备哪些环境、怎么登录和配置、怎么在终端里让它写代码以及如何接入 DeepSeek 这类 OpenAI 兼容模型。文末还会集中梳理高频报错和排查思路。全文不要求你有任何 AI 工具使用经验只要终端能敲命令跟着每一步做就能跑起来。1. Codex CLI 是什么解决什么问题1.1 先分清三个 Codex在开始安装之前我建议先解决一个最容易让新手懵掉的问题Codex 到底指什么。因为网上搜“Codex”你会看到三种完全不同的东西同时出现。Codex 模型 / APIOpenAI 早期发布的代码生成模型后来逐渐演进成 OpenAI 在多个产品中使用的编程智能能力。现在很多第三方服务所说的“Codex 接口”其实是指 OpenAI 兼容的代码处理接口并不一定是原版模型。ChatGPT 里的 CodexChatGPT 产品中集成的代码执行和 Agent 能力。用户在网页对话框里让它改代码、跑测试、读日志这套交互能力在 OpenAI 的生态里也被称为 Codex。Codex CLI也就是本文的主角。它是 OpenAI 开源的一个命令行工具npm 包名为openai/codex。安装后你可以在终端里输入codex命令用自然语言描述需求它会直接读取本地文件、修改代码、执行命令并根据执行结果自我修正直到任务完成。简单来说Codex CLI 是把“AI 编程助手”搬进了终端。你不需要打开网页也不需要频繁切换 IDE 和浏览器只要在终端里把需求说清楚它就能完成一个从读代码、写代码到跑命令验证的完整闭环。1.2 Codex CLI 解决什么问题传统的 AI 编程工具通常以网页对话或 IDE 插件形式存在当任务涉及多文件改动、命令执行、环境验证时流程往往是断裂的。Codex CLI 的核心优势在于它能直接操作本地文件系统并执行命令读取项目结构和文件内容理解当前代码上下文。生成新代码或修改已有代码支持多文件操作。运行测试、构建命令、脚本并读取输出结果。根据执行结果自动修正多轮迭代直到任务完成。在实际开发中它比较适合这几类场景写一次性脚本比如批量重命名文件、统计代码量、转换数据格式。快速补测试给已有函数补充单元测试用例。重构小模块把一段重复代码抽取成公共函数或者调整函数结构。解释老项目把一段读不懂的代码丢给它让它逐行解释逻辑。排查报错把终端里的异常堆栈贴给它让它分析可能原因并给出修复方案。当然它也有不适合的场景。对于需要强业务理解、涉及核心架构决策、或者对安全审计要求极高的任务AI 工具只能作为辅助不能完全替代人工评审。2. 环境准备安装前先过一遍清单Codex CLI 虽然只是一个命令行工具但它的运行依赖并不少。为了避免装到一半才发现环境不对建议按下面的顺序逐项确认。2.1 Node.js 环境Codex CLI 通过 npm 分发所以 Node.js 是必备环境。它依赖比较新的 Node 特性官方推荐使用较新的 LTS 版本。如果你之前没装过 Node.js建议直接安装 Node.js 22 及以上版本。先打开终端确认当前环境node -v npm -v如果提示node或npm找不到说明 Node.js 没有安装或者安装目录没有加入 PATH。可以到 Node.js 官网下载对应系统的安装包选择 LTS 版本安装完成后重新打开终端再验证一次。需要注意如果你本机已经有多个 Node 版本建议用