Codex App使用教程:安装配置到实战技巧完整指南

OpenAI Codex App的完整使用指南,涵盖安装、配置与实战技巧。
本文详细介绍了OpenAI Codex App的使用方法,包括下载安装渠道、MFA安全登录配置(解决国内手机号无法接收验证码的问题)、项目管理方式,以及计划模式、目标模式、引导模式等多种会话工作模式的区别,还深入讲解了本地处理与WorkTree工作树模式的技术原理和适用场景。
OpenAI Codex App 完全使用指南
OpenAI推出的Codex App已经发布三个多月,它早已不只是一个编程Agent——更是一个功能强大的个人助理,在智能程度上远超Claude和Hermes等同类产品。本文将从下载安装、功能配置到实战技巧,带你全面掌握Codex App的使用方法。
下载安装与安全登录
下载渠道
Codex App提供两个官方下载入口:
- ChatGPT官网下载页:访问
chatgpt.com/download,页面下方有"Download Codex"按钮,支持MacOS和Windows版本 - Codex官网:直接访问
chatgpt.com/codex,同样可以下载
登录前的关键设置:配置MFA
这一步非常重要,直接关系到账号安全。 下载安装后,不要急着登录。先打开ChatGPT网页版,进入「设置 → 安全与保障」,添加多因素身份验证(MFA)中的验证器验证。
什么是MFA验证器? 多因素身份验证(MFA,Multi-Factor Authentication)要求用户在登录时提供两种或以上的身份验证因素。验证器App(如Google Authenticator、Authy)基于TOTP协议(Time-based One-Time Password,RFC 6238标准),每30秒生成一个6位动态码——即使密码泄露,攻击者没有你的手机也无法登录。这种「你知道的(密码)+ 你拥有的(手机)」双重验证机制,是目前最普及的账号安全方案之一。
为什么要这样做?因为Codex登录时会要求验证身份,如果没有配置MFA,系统会发送手机验证码。而国内86开头的手机号无法接收验证码,直接导致登录失败甚至触发风控。配置好验证器后,登录时输入验证器生成的一次性验证码即可顺利通过。
登录方式建议选择ChatGPT账号登录,虽然也支持OpenAI API登录,但后者部分功能(如插件)不可用。Codex的额度与ChatGPT订阅挂钩,Plus会员有基础额度,Pro会员额度更多。
项目管理与工作模式
创建和打开项目
首次使用时项目列表为空,建议选择「现有文件夹」来创建项目。比如你有一个正在开发的App,直接选中对应文件夹即可。左上角按钮可以选择用什么工具打开项目(如Xcode、VS Code等)。

会话模式详解
Codex提供多种灵活的工作模式,适用于不同的开发场景:
- 计划模式:发送任务后,Codex会先列出执行计划,对不清晰的地方主动提问,确认后再动手
- 目标模式(Goal):适合长任务,设定明确目标后,Codex会持续迭代直到达成目标。使用时需要有明确的验收标准
- 跟进行为:默认为"跟进"模式;切换为"引导(Steer)"模式后,你可以在Codex思考过程中插入新指令来调整方向,类似于自动驾驶中接管方向盘
本地模式 vs WorkTree模式
新建会话时可以选择工作模式:
- 本地处理:直接在当前项目目录下工作,适合日常开发
- WorkTree(工作树):从指定分支拷贝一份代码到新的工作目录,适合执行高风险操作。即使搞砸了也不影响原始代码。完成后通过创建新分支、再merge回主分支的方式合并代码
WorkTree的技术原理: Git WorkTree是Git 2.5引入的原生功能,允许从同一个仓库检出多个工作目录,每个目录可以处于不同的分支状态,且共享同一个.git对象数据库。与传统的git clone不同——clone会复制整个仓库历史,而WorkTree只是新增一个工作目录指针,磁盘占用更小、切换更快。在AI编程Agent场景下,WorkTree的隔离特性尤为重要:Agent在独立目录中执行高风险操作,即使产生错误代码也不会污染主分支,完成后通过标准的branch+merge流程合并,完整保留了Git的版本控制语义。
值得一提的是,Codex支持多会话并行——你可以同时开多个会话处理不同任务,这也是它之前被称为"线程(Thread)
相关推荐
教程攻略Cursor+Codex双IDE协同:开源项目二开实战方法论
基于实战经验总结的开源项目二次开发完整方法论,详解Cursor+Codex双IDE协同工作流,涵盖二开七环节、MVP验证、AI读源码技巧,帮助开发者三天跑通项目、两周完成业务集成。
教程攻略Cursor多Agent实战:50分钟搭建Next.js全栈博客
使用Cursor IDE多Agent协作模式,50分钟内从零搭建全栈博客。涵盖Next.js、Clerk认证、Supabase数据库集成,详解4个AI Agent分阶段开发流程与关键避坑经验。
教程攻略从零搭建AI软件工厂:Cursor工程师的多Agent协作实战经验
Cursor工程师Eric分享AI软件工厂构建实战:从自动化六层级、护栏设计、并行Agent管理到规模化扩展,详解如何用多Agent协作实现7×24小时高效软件开发。