Codex 是 OpenAI 开发的本地可运行的 AI 编程助手，它会读取你本地的代码上下文，并根据自然语言指令执行任务。Codex 于 2025 年 10 月 6 日全面上市，它是开源的，主要使用 Rust 编写，并且开源于GitHub中，官方地址是：OpenAI/Codex 。

目前 Codex 处于收费阶段，它有两种收费模式：

1. 购买专门的 API KEY

2. 成为 ChatGPT Plus、Pro、Business、Edu 或 Enterprise 等付费用户可免费有限的使用

我选择第 2 种。

Codex 有三种使用方式：

1. Codex 网页版（最简单）

   从 ChatGPT 官网聊天页面即可进入。

2. IDE 扩展（最高效）

   目前支持三款 IDE 的扩展，分别是 VS CODE 、Cursor、Windsurf。可惜不支持我经常用的 IDEA。

3. Codex CLI 终端（最强大）

这个 Codex CLI 才是我要安装的本地终端版本，支持本地读取项目目录，更适合开发者。。

安装 Codex CLI

下面我列举的安装步骤，都是基于我的 Windows 环境。Codex CLI 在 Windows 上虽然支持，但目前最推荐还是通过 Windows Subsystem for Linux (WSL) 来运行，以兼容性更好。

1. 安装 node.js

   由于 Codex CLI 使用 Node.js 模块发布，因此需要先安装 Node.js（选择 LTS 即可）。贴一个别人的安装 node.js 的博客。

2. 安装 Codex CLI

   npm install -g @openai/codex

   安装完成后，验证是否安装成功：

   codex --version

   截止目前（2025-11-17），最新的 Codex 版本是 0.58。

3. 启动 Codex CLI

   codex

   第一次输入时会弹出网页，在弹出的网页上使用 ChatGPT 进行登录即可，注意免费账号不行。

   如下图所示，就是成功登录之后的终端图。

   
   

4. 测试 Codex

   我在终端中输入：你好，你是？。即会立即收到回复，回复如下图所示：

   
   

5. 切换模型

   输入命令 /model ，即可切换模型。目前共有三个模型：

   1. gpt-5.1-codex

      专门针对 Codex 做出优化的 5.1 版本模型。里面分高、中、低三个版本，默认中。

   2. gpt-5.1-codex-mini

      gpt-5.1-codex 的轻量版，同样专门做出优化，成本更低，速度更快，但功能较弱。里面分高和中两个个版本，默认中。

   3. gpt-5.1 (默认选择)

   据官方说是具有广泛的世界知识和强大的一般推理能力。里面分高、中、低三个版本，默认中。

6. 开始使用

   使用 cd + 路径 的命令，切换到你的项目路径中，然后使用 /init 命令来，codex 会自动看你的项目，然后分析项目结构，最后生成一个 AGENTS.md 文档（会询问你是否生成）。最后给大家看看它生成的我的一个项目的文档，大家觉得如何呢？

   Repository Guidelines

   项目结构

   • common：公共依赖与基础设施（Lombok、MapStruct、通用组件），被各服务复用。

   • gateway：Spring Cloud Gateway 入口，负责路由与服务发现。

   • services：微服务集合，包含 service-admin（后台管理）、service-product（商品/SPU-SKU）、service-third-party（OSS/Redis/Nacos 等第三方接入）。

   • sanguimall-admin-front：Vite + Vue3 管理端前台，静态资源在 public，业务代码在 src。

   • 配置主要放在各服务 src/main/resources/application[-*].yml，不要提交真实密钥。

   构建与启动

   # 后端聚合构建（含公共模块）
   mvn -pl common,gateway,services -am clean install
   # 分别本地启动
   mvn -pl gateway spring-boot:run
   mvn -pl services/service-admin spring-boot:run
   mvn -pl services/service-product spring-boot:run
   mvn -pl services/service-third-party spring-boot:run
   # 前端
   cd sanguimall-admin-front && npm install && npm run dev

   启动前请准备好 MySQL、Redis、Nacos 并配置对应地址。

   代码风格与命名

   • Java 21，4 空格缩进，UTF-8。优先构造器注入，@Slf4j 统一日志，避免字段注入与通配符导入。

   • 包路径 com.sangui.*；MapStruct 映射器命名 *Mapper，请求/响应体放 vo/dto 包。

   • 前端：使用 <script setup>，视图文件用短横线命名，例如 src/views/product-list.vue，可复用逻辑放 src/hooks。

   测试规范

   • 后端依赖 spring-boot-starter-test 与 MyBatis 相关夹具，示例：mvn -pl services/service-product test。

   • 推荐针对 service/mapper 做切片或集成测试，外部调用（OSS、Redis、Nacos）用 Mock/本地替身。

   • 测试类命名 *Test，放在 src/test/java，与主代码包结构对应。

   提交与 PR

   • 当前提交格式：YYYY-MM-DD-HH:MM-简述，如 2025-11-16-19:17-fix relation bug。

   • 每次提交聚焦单一改动并注明涉及模块（如 gateway、service-product）。

   • PR 需包含：变更概要、依赖的启动条件（DB/Redis/Nacos）、测试结果；前端改动附主要界面截图。

   配置与安全

   • 数据库/OSS/令牌等敏感信息务必使用环境变量或本地私有配置，不要提交到仓库。

   • Nacos 服务发现与网关路由需要对齐服务 ID，修改注册名时同步更新网关配置。

   • 变更表结构或缓存策略时，在 PR 描述中注明并提供初始化/迁移脚本。

   最后，我和他说：总结一下我的编程风格和习惯。

   他是这么回答的：

   基于目前仓库能看到的线索，推测你的编码风格和习惯如下（如有偏差可告诉我再补充）：

   • 提交习惯：提交信息简短且时间戳开头，格式类似 YYYY-MM-DD-HH:MM-动作简述（如 2025-11-16-19:17-fix relation bug），一天多次小步提交，常用 “finish today/finish <功能>” 结尾。

   • 模块化：偏好清晰的多模块结构：common 复用基础组件，gateway 做入口，services/* 分业务微服务，前端独立为 sanguimall-admin-front。

   • 技术栈默认：后端 Spring Boot 3 + Spring Cloud Alibaba + MyBatis，Java 21，MapStruct + Lombok；前端 Vue3 + Vite + Element Plus。

   • 配置与依赖管理：使用 Maven 聚合与分模块构建，依赖版本集中在父 POM；各服务的配置放 src/main/resources/application[-*].yml。

   • 启动流程：README 中要求先准备 MySQL / Redis / Nacos，再按顺序启动前端和各服务，说明你关注本地运行前的基础设施准备。

   • 代码偏好（推测）：使用 Lombok 减少样板；MapStruct 处理对象转换；可能偏向接口/层次清晰的微服务拆分；前端遵循 Vite/Vue3 常规脚本与目录约定。

最后，我总结一下我使用 Codex 的感受，区别于之前直接使用 ChatGPT 的聊天的形式，少了发送我的代码的环节，相当方便，我只需要提出我的程序的有什么问题就好，Codex 还可以在经过我同意的情况下，直接修改我的代码（但还是不推荐吧，怕有不可逆的情况出现，还是不太放心），它默认是只读的，不会修改。另外，因为我是 Windows 系统，兼容性并不是很好，特别是存在中文输入可能导致退出 Codex的情况。Codex确实省事，但是，我在想，它是不是依靠大量把我的程序作为上下文传上去，有可能它的 API KEY 的消耗会远高于我们一般聊天式的 KEY 消耗，我感觉会，当然了，我不使用 API token 进行消耗，Business/Pro/Plus 用户因为是额度制，不需要太担心。最后我总结下 Codex 的适合人群：

Codex 适合：

• 常写代码的人

• 想自动生成文档、脚本的人

• 想让 AI 直接读代码目录的人

• 想要本地操作而非上传文件的人

不太适合：

• Windows 用户（目前兼容性一般）

• 不想 AI 接触本地代码的用户

• 只需要问问题、而不想让 AI 修改代码的用户

好了，今天体验 Codex 就先到这里了，谢谢大家，我再慢慢体验下 Codex。