OpenAI Codex 是本地运行的 AI 编程 Agent，分为早期初代 Web 版、CLI 命令行版、VSCode 插件版、独立桌面 App 版、云端 Codex Cloud 多个版本，不同历史分支能力、权限、计费规则差别很大，这份指南覆盖历史包获取、多平台安装、三种登录方式、项目实操、版本回退与常见报错，同时区分原版和社区复刻版本；Codex 可以读取本地仓库、自动写代码、跑测试、提交 Git，支持多轮长任务，很多开发者踩坑都是因为装错版本、登录方式选错，或者新旧版本参数不兼容。
一、Codex 各历史版本清单与差异对比
| 版本类型 | 发布时间 | 获取渠道 | 核心特点 | 局限 |
|---|---|---|---|---|
| 初代网页版 Codex（老版） | 2021 早期 | openai.com/codex（现已下线） | 最早代码补纯补全模型，无 Agent 能力 | 仅 API 调用入口，独立交互页面关闭，只能通过 API 接入 |
| Codex CLI v1（早期终端版） | 2025 上半年 | npm、GitHub Releases | 基础文件读写、代码修改，轻量 | 不支持图片输入，审批模式简单，无 MCP 工具 |
| Codex CLI v2（主流稳定版） | 2025 下半年至今 | npm、brew、官方一键脚本 | 支持截图识图、任务待办、MCP 扩展、三级权限审批 | 需要 Node.js18+，服务器部署优先选它 |
| Codex 桌面独立 App | 2026 年初 | 微软商店、dmg 包、GitHub | 图形界面、多项目并行、任务看板 | 占用资源更高，仅 Windows、macOS |
| VSCode Codex 插件版 | 持续迭代 | VSCode 扩展市场 | 编辑器内直接调用，跟随代码上下文 | 功能子集，复杂长任务能力弱于 CLI |
| Codex Cloud 云端版 | 2026 | ChatGPT 网页 / APP 内入口 | 云端沙箱运行，本地电脑关机也能跑任务 | 消耗 ChatGPT 订阅额度，不能自由访问本地全盘文件 |
二、全平台下载与安装操作
1. CLI 版本（推荐，跨平台，支持历史版本指定安装）
前置依赖：Node.js ≥18，Git
- macOS / Linux 一键脚本：
- Windows PowerShell 脚本：
- npm 安装，指定历史版本：
- macOS Homebrew：brew install --cask codex
- 验证：终端输入 codex --version，输出版本号即成功
curl -fsSL https://chatgpt.com/codex/install.sh | sh
irm https://chatgpt.com/codex/install.ps1 | iex
npm install -g @openai/codex@0.12.5（把后面版本号替换为需要的历史版本）
2. 桌面 App
Windows：微软商店搜索 Codex，或者去 GitHub Releases 下载 msix/zip 免安装包；macOS 下载 dmg，拖拽到应用程序文件夹。
历史旧包：GitHub Releases 页面，找到 tags 归档，下载对应日期的安装包，官方不提供旧版在线回滚按钮，需要手动下载二进制文件。
3. VSCode 插件
打开扩展商店搜索 OpenAI Codex，直接安装；旧版本插件可以在插件详情页选择安装特定历史版本。
三、三种登录对接方式
| 登录方式 | 命令 | 适用场景 | 计费规则 |
|---|---|---|---|
| ChatGPT OAuth 登录（首选） | codex login | 日常开发、桌面 App、VSCode | 消耗 ChatGPT 订阅额度（Plus/Pro/Business/Enterprise） |
| 设备码登录 | codex login --device-auth | 服务器、无图形浏览器、远程 CI 环境 | 同样走订阅额度 |
| API Key 登录 | codex login --with-api-key | 自动化脚本、流水线、不想用订阅 | OpenAI 平台按量计费，独立 Token 账单 |
注意：登录凭证保存在 ~/.codex/auth.json，严禁提交到 Git 仓库；查看登录状态 codex login status，退出登录 codex logout。
四、首次实操完整流程
- 新建项目文件夹，路径不能包含中文、空格，进入这个目录；
- 终端输入 codex 启动交互会话；
- 先确认权限等级：read-only（只读，必须人工确认每一步）、auto、full-access；新手建议 auto；
- 下发自然语言任务，例如：梳理这个仓库 README、修复报错、写单元测试、新增接口；
- Codex 读取文件、生成改动计划，等待你审批；
- 同意后自动修改代码、执行命令、跑测试；
- 任务结束后，可以 diff 查看改动，一键 git 提交；不满意输入 revert 回滚本次全部变更。
五、版本管理、回退与升级要点
- 升级：codex --upgrade，自动拉取最新稳定版；
- 回退旧版：npm 指定版本号重装，或者手动下载历史 Release 二进制包覆盖；
- 跨版本注意：v1 配置文件和 v2 不完全兼容，回退旧版本建议删除 ~/.codex 配置目录；
- 不建议多版本同时共存，容易出现命令冲突、凭据错乱。
六、适用场景与风险边界
✅ 适合使用 Codex
- 大型代码仓库重构、陌生项目读代码、调试 bug
- 批量生成接口、测试用例、脚本、Dockerfile
- 需要长期连续任务，跨多天迭代开发
- 想在本地沙箱执行命令，AI 自主搭建环境
❌ 不适合
- 纯离线需求：官方原版 Codex 必须联网调用云端模型，离线只能选社区复刻版本
- 简单单行代码补全：普通 VSCode AI 插件更轻量
- 敏感涉密源码：Codex 会上传代码片段给 OpenAI 模型服务
七、高频故障排查清单
- codex 命令找不到：npm 路径未加入环境变量，Windows 重启终端；
- 登录授权失败：网络环境问题，或者订阅类型不包含 Codex 权限；
- 旧版 CLI 无法识图：0.13 之后版本才支持图片输入，回退到更早版本就丢失该功能；
- 权限报错：不要在系统根目录、用户主目录直接运行，限制在项目文件夹内；
- 版本安装不生效：先 npm uninstall -g @openai/codex 卸载干净再重装。
【相关 FAQ】
问题 1：Codex 保姆级教程里，安装历史版本 Codex CLI 要怎么操作？
回答 1：Codex CLI 可以用 npm 指定版本号安装历史版本，命令 npm install -g @openai/codex@版本号，也可以在 GitHub Releases 归档页下载对应历史二进制包手动部署。
问题 2：Codex 保姆级教程里面，ChatGPT 订阅登录和 API Key 登录的 Codex 有什么区别？
回答 2：ChatGPT OAuth 登录的 Codex 消耗 ChatGPT 套餐内额度；API Key 登录不走订阅，直接在 OpenAI 平台按量计费，适合 CI 自动化场景，两种登录的能力大体一致。
问题 3：按照 Codex 保姆级教程，安装老版本 Codex 之后配置文件会兼容新版本吗？
回答 3：Codex v1 和 v2 版本的配置结构存在差异，高版本配置不能直接给早期历史版本使用，版本回退时建议删除 ~/.codex 目录清空旧缓存。
【参考资料】
[2026-10-29]（Codex 安装 + 登录 + 使用教程 (含所有版本)）稀土掘金
[2026-07-21]（Codex 全网最全指南：安装、登录、历史版本回滚）稀土掘金
[2026-11-02]（Codex CLI Quickstart | OpenAI 官方帮助文档）OpenAI Help Center
[2026-06-09]（Codex CLI 和 Codex 桌面端完整教程）稀土掘金
【免责声明】
本文基于 OpenAI 官方文档、社区公开实践文档整理；Codex 各历史版本能力、权限、套餐权益会持续调整，部分早期版本官方不再维护；Codex 拥有本地文件读写、执行命令权限，运行任务前务必仔细审阅执行计划；所有版本下载、计费、功能权限以 OpenAI GitHub 仓库、官方帮助中心为准，本文不构成订阅与付费购买建议。
本文来自作者[幻波解析]投稿，不代表乌兰科技网立场，如若转载，请注明出处：https://www.wlcbnews.com/rgzn/202611/1257.html
评论列表（4条）
我是乌兰科技网的签约作者“幻波解析”！
希望本篇文章《Codex 保姆级教程全历史版本下载安装、登录对接、实操使用完整指南》能对你有所帮助！
本站[乌兰科技网]内容主要涵盖：互联网行业的追踪与探索
本文概览：OpenAI Codex 是本地运行的 AI 编程 Agent，分为早期初代 Web 版、CLI 命令行版、VSCode 插件版、独立桌面 App 版、云端 Codex Cloud 多个版本，不同历史分支能力、权限、计费规则差别很大，这份指南覆盖历史包获取、多平台安装、三种登录方式、项目实操、版本回退与常见报错，同时区分原版和社区复刻版本；Codex 可以读取本地仓库、自动写代码、跑测试、提交 Git，支持多轮长任务，很多开发者踩坑都是因为装错版本、登录方式选错，或者新旧版本参数不兼容。