Codex快速入门了解指南

一、Codex 是什么为什么说它是 AgentOpenAI 的 Codex 是一款面向软件开发的 AI Agent。它与 ChatGPT 共用同一套账号与订阅体系并针对编程任务使用专门优化的 Codex 模型产品形态与目标则不同ChatGPT 以对话为主Codex 以在项目里完成任务为主。称 Codex 为 Agent是因为它不仅能生成文字还能在授权范围内读取代码、修改文件、执行命令、根据结果继续调整直到任务推进到可验收的状态。使用 Codex 通常需要 ChatGPT 订阅如 Plus、Pro、Business 等具体以 OpenAI 当前政策为准。1.1 ChatGPT 负责告诉你怎么做Codex 可以直接帮你做用 ChatGPT 写程序常见流程是你提问 → 模型给出思路或代码片段 → 你自己复制到编辑器、保存、安装依赖、运行、看报错再回来继续问。模型停留在「建议层」不会直接改动你本机项目目录里的文件。Codex 则把「建议」和「执行」连在一起。你描述目标后Agent 可以打开并编辑项目中的多个文件在终端运行构建、测试、安装等命令根据命令输出或报错信息继续修改在需要时向你确认是否执行敏感操作因此两者的分工可以这样理解以下对比主要指在本机项目里写代码的典型场景ChatGPTCodex核心角色顾问、讲解员执行者、协作者输出形式主要是文字与代码块项目内的实际变更与运行结果是否改本机项目文件否是Local / Worktree 等本地模式是否在项目终端替你跑命令否是本地模式下ChatGPT 告诉你怎么做Codex 在你指定的范围内直接帮你做。补充说明Codex 也有Cloud云端模式——任务在 OpenAI 配置的远程环境中运行变更以 diff 形式交给你审阅后再应用到本机这与「ChatGPT 只给建议」仍不同但也不是立刻改本地文件。网页版 CodexCodex Web同样属于云端工作流。1.2 Codex 的工作对象不是单条消息而是一个项目普通聊天产品的上下文往往围绕「当前这一轮对话」。你换话题或开新会话之前的细节容易丢失模型也很难对「整个仓库」形成稳定认知。Codex 的设计单位是项目——通常是你选定的一个文件夹、Git 仓库或云端绑定的代码环境。Agent 在这个边界内工作搜索文件、理解目录结构、对照现有代码风格再动手。一次任务往往对应一条线程Thread可以在多轮对话里逐步完成而不必每轮都重述背景。这意味着上下文更完整Agent 能同时参考多个文件而不是只看你粘贴的一小段代码。任务可拆分、可延续可以先搭框架再补测试再改文档在同一线程里推进。结果可核对改动落在真实文件或可应用的 diff 上你可以用 diff、测试、运行程序来验收而不是只读一段生成的文字。用 Codex 时更有效的说法不是「写一段 Python」而是「在这个项目里给登录模块加上单元测试并跑通」——把项目当作协作对象而不是把模型当作一次性问答工具。1.3 Codex 适合做什么Codex 适合有明确交付物、能在项目里验证的开发工作。比较适合从零或从模板搭建小项目、脚本、网页、API 服务根据报错或现象定位并修复 bug重构拆文件、重命名、统一风格、补类型或注释编写或更新 README、配置文件、CI 脚本批量、重复性的代码调整在人工审查前提下分步骤实现中等规模需求先规划再执行不太适合或需谨慎纯聊天、泛知识问答、与代码无关的写作——ChatGPT 往往更合适没有可运行环境、无法验证结果的任务未经审查就大规模改动生产环境或敏感数据期望「一句话完美上线」且零人工检查的高风险变更简单判断能在文件夹里看到改动、在终端或浏览器里看到结果的就适合交给 Codex。二、Codex 的几种使用方式Codex 提供多种入口底层是同一类 Agent 能力CLI、桌面 App 与 IDE 扩展还共享配置文件如~/.codex/config.toml和 MCP 设置。差别主要在于你在哪里操作、代码改在本机还是云端、是否图形化。2.1 Codex CLICodex CLI 是 OpenAI 提供的开源命令行 AgentRust 实现在终端里运行。进入项目目录后执行codex会进入交互式终端界面TUI用自然语言描述任务后Agent 可在当前目录读写文件、执行 shell 命令。支持 macOS、Windows 与 Linux。特点轻量不依赖图形界面适合习惯命令行、远程 SSH、WSL、无桌面环境的服务器便于与 Git、现有脚本配合可通过exec等能力接入自动化流程支持 MCP、子 Agent 并行、本地代码审查等扩展能力典型用法在仓库根目录让 Agent 修 bug、补测试、跑测试套件快速生成小型工具或脚手架在 feature 分支上改代码再用git diff人工审查后提交从 CLI 发起 Codex Cloud 任务在终端审阅并应用远程 diff使用 CLI 时同样要注意命令执行与审批模式重要项目建议先纳入版本控制再让 Agent 动手。2.2 Codex 桌面客户端Codex桌面端是安装在Windows 或 macOS上的独立应用官方称 Codex app。用户选择一个本地文件夹作为项目在图形界面里与 Agent 对话并可查看代码变更、使用集成终端、并行管理多条线程等。会话与配置可与 CLI、IDE 扩展互通。特点可视化界面适合不熟悉纯终端工作流的用户支持多种运行模式Local直接改当前目录、Worktree在 Git worktree 中隔离修改、Cloud在远程环境运行支持查看 diff、Skills技能、Automations自动化等能力可同时处理多个线程分别推进不同任务典型用法初学者选一个空文件夹用 Local 模式从零做出可运行的小程序日常开发绑定现有项目一条线程完成一个功能或一次修复需要对照界面审查改动、边看 diff 边继续提需求时桌面端强调「选文件夹 → 提需求 → 看改动 → 验收」是上手 Codex Agent 的常见方式之一。2.3 Codex 网页版和 IDE 插件除 CLI 和桌面 App 外Codex 还可通过浏览器和编辑器扩展使用。网页版Codex Web在浏览器访问 chatgpt.com/codex需 ChatGPT 账号登录即可使用Codex Web。任务在云端环境中运行适合临时换设备、不想安装客户端更习惯在浏览器里管理 Agent 任务本地机器资源有限希望把构建与测试放在远程环境云端完成后你需要审阅并应用 diff变更才会进入本机仓库——这与 Local 模式「直接改文件夹」的体验不同。IDE 插件OpenAI 提供Codex IDE Extension支持 VS Code 及其衍生编辑器如Cursor、Windsurf以及JetBrains系列IntelliJ、PyCharm、WebStorm 等。Agent 出现在编辑器侧边栏能利用当前工作区作为项目上下文读文件、改代码、解释诊断信息。扩展同样支持将任务委托给 Codex Cloud并在 IDE 内与桌面 App 同步线程同一项目下。典型用法写代码时顺手让 Agent 补测试、解释报错、做小范围重构在 IDE 内直接应用或审查 diff与调试、Git 插件一起使用在编辑器与桌面 App 之间切换延续同一线程如何选择方式更适合CLI终端用户、远程机、脚本化、Linux 服务器桌面客户端需要完整 UI、本地项目管理、多线程并行、可视化 diff网页版Codex Web少安装、跨设备、云端构建与长任务IDE 插件已在编辑器里开发、希望不离 IDE多种入口可以并存日常小改用 IDE 插件较大任务用桌面端或 CLI云端环境用 Codex Web。核心 Agent 能力一致区别主要在交互界面以及代码改在本机还是云端。小结Codex 被称为 Agent是因为它面向的是项目级任务而不仅是单条消息能读、能改、能跑、能根据反馈迭代。ChatGPT 擅长回答「怎么做」Codex 擅长在授权范围内「帮你做到能验收」。CLI、桌面端、Codex Web 与 IDE 插件是同一能力的不同入口——按你的习惯、操作系统与是否需要云端环境选择即可。感兴趣想要尝试的小伙伴可以参考 Codex配置使用教程