Codex 是 OpenAI 推出的 AI 编程智能体,和纯聊天机器人最大的不同是:它能进入你指定的项目文件夹,真实读写文件、执行终端命令、产出可交付成果。
官方入口有桌面 App(ChatGPT 的 Codex 模式)、CLI、IDE 扩展与网页版四种。本文按「入口 → 认知 → 操作 → 模型 → 额度 → 排错」的顺序,带你从第一次对话一路用到自动化工作流。
Codex 四种官方入口怎么选
- 桌面 App(ChatGPT Codex 模式):macOS / Windows 通过 ChatGPT 应用进入,三栏布局(项目 / 对话 / 预览),适合日常可视化管理,新手首选。
- CLI(codex 命令行):开发者在终端直接调用,支持命令模式与交互模式,适合自动化脚本与远程服务器。
- IDE 扩展:VS Code / Cursor / Windsurf 内嵌,边写边用,适合在编辑器里就地改代码。
- 网页版:关联 GitHub 仓库后由云端运行环境执行,手机也能 Code Review,适合出门在外。
注意区分:四者共用同一套配置与登录态;桌面端与 CLI 的能力基本对齐,差异主要在交互界面,而不是"能做什么"。
Codex 是什么:不是聊天机器人,是工作代理人
把 Codex 当成"问答工具"会浪费它。它真正的价值是:你给它一个目标,它会在指定文件夹里真实创建、编辑、整理文件,并把工作成果交付给你。例如你说"研究 Codex 桌面版新功能并整理成 Excel 表格存到本项目",它会真的生成 .xlsx 文件,你还能继续让它删列、补数据、改格式。
据 OpenAI 官方文档,Codex 默认在安全沙盒中运行——AI 的读写范围被严格限制在"当前项目文件夹"内,而不是凭模型"自觉"守规矩。这也是它敢碰你本地文件、却相对可控的根本原因。
新手必学 6 个核心操作
- 绑定项目,再发起对话:在桌面 App 新建项目并关联本地文件夹 / Git 仓库(CLI 则先
cd 进项目目录)。这是 Codex 读写文件的边界,所有改动只作用于当前项目目录。先决定"它在哪工作",再下指令。
- 分清两种模式(CLI):命令模式
codex "修复登录接口的参数校验错误" 是一次性调用,无上下文记忆,适合 CI/CD、快速脚本;直接输入 codex 进入交互模式,带上下文记忆,可连续完成"分析结构 → 加缓存 → 写测试 → 跑测试"的开发流。日常用交互模式。
- 设置权限沙盒:默认权限下,所有关键操作(改文件、跑命令、装依赖)都会弹窗确认;自动审查模式由小模型评估风险、低风险自动放行;完全访问权限会无视沙盒限制,需谨慎。新手从默认权限起步。
- 掌握常用斜杠命令:交互模式里以
/ 开头的才是操作指令(必须放在行首)。核心几条见下表,足以覆盖九成日常开发。
- 用 @ 引用文件,多对话并行:在同一项目内用
@文件名 让 Codex 读取既有文件;一个项目可开多个对话,每个对话独立上下文。例如一个聊天写计划、一个做网页、一个做简报,互不干扰。
- 接插件 / 技能 / MCP,做自动化:装 GitHub、Gmail 等插件打通外部服务;用 Skill 封装可复用工作流;接 MCP 连数据库做全栈;把重复任务设为定时自动化(建议先手动跑通一次再固化)。
常用斜杠命令速查
| | |
|---|
| 生成 AGENTS.md 骨架,让 Codex 快速了解项目结构、依赖与规范 | |
| | |
| | |
| 显示 Git diff(含未跟踪文件),核对 AI 改了什么 | |
| | |
| | |
命令列表会随版本、系统、已装插件而变动;在交互模式输入 / 可查看本地实际支持的命令清单。
模型与推理强度怎么选
Codex 支持切换模型与"推理强度(effort)"。简单任务(整理文字、改小文件)用轻量模型 + 低/中 effort 即可;复杂任务(重构、设计完整 App、做商业简报)才上旗舰模型 + 高 effort。据第三方整理,模型档位对额度消耗影响极大:同一 5 小时窗口下,轻量模型可跑数百条任务,而顶级模型往往只有个位数到几十条,长时间任务务必给清目标与验收标准。