Codex 是集成于 ChatGPT 体系下的软件开发智能代理，专门用于代码调试、功能开发、代码审查与测试执行等开发工作。它不再是独立产品，而是作为工作模式内置在 ChatGPT 当中，支持网页端、桌面客户端、命令行工具、IDE插件多种入口，同时支持本地环境与Codex Cloud云端环境两种运行模式。本文依据官方快速入门文档，介绍 Codex 的环境准备、不同客户端安装配置、基础使用流程、环境选择以及最佳实践。
一、前置准备
使用 Codex 需要具备对应订阅权限，免费版 ChatGPT 不支持 Codex 开发智能体能力。
- 账号条件：拥有 ChatGPT Plus、Pro、Business 或者 Enterprise 订阅账号。可以使用账号直接登录，也支持API密钥方式登录，但部分功能在API密钥模式下会受限。
- 客户端选择
- ChatGPT桌面App：支持 macOS、Windows、Linux，适合处理本地项目、本地文件和长时间运行任务，官方推荐使用。
- 网页版 ChatGPT：无需安装，适合云端复杂任务，关闭页面任务依然可以继续执行。
- Codex CLI：面向开发者，在终端中完成编码任务。
- Codex IDE扩展：嵌入代码编辑器内部工作。
- 运行环境区分：本地 vs 云端（Cloud）
- 本地（Local）：读取本机文件夹与文件，在本机权限下执行操作，仅桌面客户端可用。
- Codex Cloud：隔离托管的云端沙箱环境，任务不受本机开关机影响，桌面、网页、移动端都可以继续同一个任务。创建任务时，选择Work in > Cloud，再创建可复用的云环境，环境会保存仓库、依赖与配置信息，后续任务可以直接复用该环境。
二、各客户端安装与配置
1. ChatGPT桌面应用（推荐）
- 前往官方下载对应操作系统的 ChatGPT 桌面安装包，完成安装。
- 打开应用，使用 ChatGPT 账号完成登录授权。
- 在产品选择器中，切换选择 Codex，进入开发智能体视图。Codex视图会展示代码diff、PR面板、终端输出等开发者相关信息，和普通Chat、Work模式界面有明显区别。
- 选择本地文件夹或者项目，授权Codex访问该目录的文件。
- 新建任务，在任务面板底部切换运行模式：Local（本地）或者Cloud（云端环境），之后就可以提交开发任务。
提示：Codex视图内支持“Quick chat”快速对话，用于简单提问；完整开发任务建议新建正式Codex任务会话（Thread）。
2. 网页端（无需安装）
网页端不需要下载任何软件。
- 访问
chatgpt.com，登录账号。 - 网页版没有独立Codex入口，需要新建任务，在任务设置中选择使用已发布的Codex Cloud云环境，所有任务均运行在云端沙箱内。
- 提交开发目标，查看任务进度与代码变更结果，完成代码审核。网页端适合审核云端任务、跟踪长时间运行的开发作业，不支持直接访问本地电脑文件。
3. Codex CLI（命令行工具）
适合习惯终端工作流的开发者，需要预先安装 Node.js环境。
- 通过npm或者官方脚本安装Codex CLI工具。
- 在终端执行
codex login，浏览器弹出授权页面，完成账号登录。 - 进入项目目录，直接运行
codex进入交互会话。 - 输入任务目标，即可在终端驱动Codex完成代码修改、运行测试等工作。
4. Codex IDE扩展
如果你需要直接在代码编辑器内调用Codex，可以安装Codex IDE扩展，将智能体能力嵌入编辑器，直接读取当前打开的项目，完成修改代码、调试Bug等操作，和CLI共用同一套登录配置。
三、Codex基础使用流程
Codex的交互逻辑不同于普通问答，是描述目标，由智能体自主完成任务，人工复核结果，完整流程如下：
- 准备上下文
将项目文件夹、相关报错日志、需求文档作为上下文提供给Codex。可以直接关联项目目录，也可以上传文件附件。Codex会读取项目整体代码库，理解架构、模块关系，而不是只处理零散的代码片段。 - 描述任务目标
直接用自然语言描述想要达成的结果，不需要给出分步操作。
示例：“修复这个接口抛出的空指针异常，补充边界判断，并且为该接口生成单元测试用例”。
编写提示时，尽量写清楚目标、约束条件和任务完成标准。不需要追求完美的提示词，后续可以通过多轮对话继续调整结果。
- 智能体自动执行
Codex在本地或者云端沙箱环境中运行，执行读取文件、修改源码、运行命令、执行测试等一系列操作，全程自动迭代。所有操作日志、终端输出、代码差异（diff）全部保留，方便追溯。 - 审核与确认结果
Codex完成任务后，开发者必须人工检查代码改动、测试输出，校验逻辑正确性、安全性。确认无误之后，再采纳修改，或者生成Pull Request。AI输出只能作为草稿，不能直接无条件投入生产环境。 - 迭代优化
如果结果不符合预期，可以继续下达指令进行修改，例如“简化这段逻辑”、“请检查是否存在性能问题”，在同一个会话内继续迭代，不用新建任务。
四、会话快照共享
Codex支持将Thread会话生成只读快照，用于团队沟通：
- 在Codex任务会话中点击Share，或者使用斜杠命令
/share。 - 工作区账号可以设置访问权限：全体工作区成员，或仅指定邀请对象。个人账户生成的链接，所有拿到链接的人均可查看。
- 上传完成后复制链接，分享快照。快照仅保存当时的内容，后续对话不会自动更新；系统会自动脱敏常见密钥，但仍然需要人工检查是否残留敏感路径、业务数据。
五、Codex、Chat、Work三种模式对比
在ChatGPT中三种模式定位各不相同，需要根据工作场景选用。
| 模式 | 适用场景 | 特点 |
|---|---|---|
| Chat | 问答、头脑风暴、简单文本交互 | 普通对话，偏向一问一答 |
| Work | 文档撰写、数据分析、项目规划 | 输出可审阅完整交付物，面向通用办公任务 |
| Codex | 软件开发、调试Bug、审查PR、编写测试 | 面向开发者，展示diff、shell日志，支持运行命令、操作代码仓库 |
六、使用注意事项
- 安全原则：无论本地还是云端，都需要人工审核全部代码变更，尤其是生产相关代码。Codex不会自动确认高危操作，关键步骤需要人工确认。
- 任务拆分：大型复杂任务建议拆分为多个小任务，执行成功率更高。
- 环境差异：网页端只能使用Codex Cloud云端环境，无法访问本地文件；桌面App可以自由切换本地与云端。云端任务计算机休眠也可以继续运行，本地任务依赖本机运行状态。
- 结果校验：把AI输出当成草稿，需要校验逻辑、假设条件、潜在漏洞，高风险业务不能直接依赖Codex输出。
总结
Codex作为软件开发智能代理，没有独立安装包，依托ChatGPT生态，提供桌面App、网页、CLI、IDE扩展多种入口，支持本地文件工作与Codex Cloud可复用云端沙箱环境。使用Codex的核心思路是提供完整项目上下文，描述任务目标，交由智能体自主执行，最后由开发者完成审核与迭代。合理区分Chat、Work、Codex三种工作模式，结合本地与云端环境，就可以把Codex用于Bug修复、功能开发、代码重构、测试生成等各类开发工作。
0 条笔记