Codex 使用教程:从安装配置到插件、Git 与进阶工作流全指南

最近一直忙着做交付，好久没有写文章了，今天带来一篇CodeX的使用教程为什么选这个主题，原因是最近做项目交付一直用的CodeX，也算是一直在深度体验今天将从零开始，带你全面了解 Codex 的安装配置、核心功能以及在实际项目中的应用。

基础篇：安装、登录与初体验

Codex 是 OpenAI 推出的一款基于 AI 的编程助手，它能够理解自然语言描述并自动生成、修改和优化代码。但是我觉得CodeX也不仅仅是一个编程助手，搭配各种不同的skill插件，变得越来越通用，同时它带有图形化界面，使用上对非程序员群体更加友好，优点是除了有点吃内存其他都很ok

软件下载与安装

下载与常规安装流程

首先，访问 Codex 的官方网站下载页面。根据你的操作系统选择对应的安装包。Codex 目前支持 macOS 和 Windows 两大主流平台。下载完成后，双击安装包启动安装向导。

安装过程中，系统会引导你完成几个简单的步骤：接受用户协议、选择安装位置（建议使用默认位置）、确认安装。整个过程通常只需要几分钟即可完成。

安装过程就不说了，这个很简单

套餐选择

Codex 提供了多种套餐供用户选择，从免费版到专业版的 Pro 套餐，功能和额度各有不同：

推荐订阅 Plus 套餐：综合考虑功能需求和性价比，建议大多数用户订阅 Plus 套餐。它支持 Git 版本管理、自定义 Agent 配置、多会话并行等进阶功能，能够显著提升开发效率。

前提条件

• 使用CodeX对网络要求较高，需要解决网络访问，更多时候还需要TUN模式才能稳定使用
• GPT账号肯定不必说需要准备的
• 如果需要真实开发，尽量需要Plus以上的套餐，但是自行充值比较麻烦，通常的充值方法有：

当然，你也可以找我充值，我这边也有直充渠道，非常稳定

初次使用与界面配置

工作类型选择与配置导入

首次登录成功后，Codex 会引导你进行初始配置。首先，你需要选择主要的工作类型，例如 Web 开发、移动应用开发、数据分析等。这个选择会影响 Codex 在代码生成时的默认偏好和建议。

如果你之前使用过 Codex 并导出过配置，可以在此步骤选择导入配置文件，快速恢复之前的个性化设置，包括快捷键绑定、主题偏好、常用插件等。

手机版试用提示与跳过

配置过程中，Codex 可能会推荐你下载手机版应用进行协同使用。如果你暂时不需要这个功能，可以点击跳过按钮，之后随时可以在设置中重新启用。

进入操作界面并验证可用性

完成初始配置后，你将进入 Codex 的主操作界面。界面主要由几个区域组成：左侧的文件浏览器、中间的对话输入框、右侧的代码编辑区和底部的状态栏。当你只想和Codex进行简单对话时，可以直接在CodeX顶部选择“新对话”，此时会弹出一个聊天框，只要不选择输入框的“进入项目工作”，此时Codex会自动创建一个目录来存储对话信息

如果你想进入到某个目录中进行对话修改，那么有两种方式，一种是“新对话“后在对话框下面选择”进入项目工作“，另一种方式是在菜单栏直接打开文件夹

此时我们简单测试下，新建一个对话，可以在输入框中输入指令："写一个 Python 的 Hello World 程序，并运行"。如果能够正常生成代码，说明 Codex 已经安装配置成功。

进阶功能

掌握了基础操作后，接下来介绍一些我常用的、更进阶的功能，包括核心配置调节、Git 版本管理、消息迭代编辑等

内置浏览器

Codex内置了浏览器，打开侧边栏选择“浏览器”就可以打开

这意味着你可以直接对web中的元素进行操作，而不用再用自然语言去描述在浏览器中选择“注释”

然后选择想要修改的元素，例如在时间戳这里我想增加时区，那么直接选择区域后，输入“增加时区”

点击确认，它会直接往聊天框中输入内容：

这样操作web上的元素就非常方便

输入框旁核心配置

模型调节

在 Codex 输入框的旁边，你会看到一个配置面板，这里可以调节模型的思考深度。默认使用的是 GPT-5.5 Medium 模型，它在速度和代码质量之间取得了良好的平衡。

思考深度调节选项允许你控制 Codex 在生成代码前的推理程度。较高的思考深度会让 Codex 进行更详细的分析和规划，生成的代码质量通常更高，但响应时间也会相应增加。

• 复杂编程任务：建议将思考深度调高
• 简单代码补全：使用默认设置即可

Codex 提供了多种模型选择，包括标准版、快速版（ST 模式）。ST 模式（Speed Turbo） 专注于响应速度，适合需要快速迭代的场景，如代码补全、格式调整等简单任务。但是快速版消耗得更快，是否使用就看任务紧急程度吧

使用 Git 进行版本管理

调用终端初始化 Git 仓库

通过快捷键 Cmd+J（macOS）或 Ctrl+J（Windows）打开内置终端，然后在项目目录中执行：

gitinit

此时创建一个git仓库后，右侧就会弹出git的图形化界面，你可以直接在右侧直接操作git，也挺方便的

执行 git add 与 git commit 备份代码

当你完成了一批代码修改后，建议及时提交到 Git 仓库进行备份：

gitadd.gitcommit-m"描述本次修改的内容"

养成定期提交的习惯非常重要，建议在完成一个功能点或修复一个 bug 后就进行一次提交。在文件上点击“+”号，即可暂存文件：

如果想取消暂存，切换tab页到“已暂存”，取消暂存即可

在界面的 Environment（环境）区域，你可以看到当前项目的文件状态：

• 红色：未暂存的改动
• 绿色：已暂存但未提交的改动

点击具体的文件，可以查看该文件的详细改动对比（diff）。

在查看代码差异时，如果发现某行代码需要调整，你可以直接在该行上添加注释。

点击行号旁边的区域，输入你的修改要求，Codex 会根据注释针对性地修改该行代码。

当你确认所有改动都正确无误后，可以直接点击界面上的 提交或推送 按钮来提交代码。这种方式比在终端中输入命令更加直观便捷。

迭代需求与消息管理

编辑上一条消息以避免无效上下文干扰

Codex 支持编辑上一条发送的消息。将鼠标悬停在你发送的最后一条消息上，会出现编辑按钮，点击后即可修改内容并重新发送。

注意：目前仅支持编辑会话中的最后一条消息。如果想修改更早之前的消息，需要使用 Fork 功能。

代码回滚与 Fork 功能

Fork 功能详解：复制会话而非回滚代码

Fork 会基于你选择的某条消息创建一个新的会话分支，你可以在新分支中继续对话，相当于间接实现了对历史消息的编辑。

例如在对话中点击消息卡片上的 "分叉"（Fork）图标

需要选择派生方式

核心区别

Fork 创建新分支后，你可以配合 Git 命令实现实际的代码回滚。例如，在 Fork 后的分支中执行 git reset 命令，然后将主分支重置到该提交点。

技能与自动化

Skill（技能）是 Codex 的另一项强大功能，它让你可以自定义 Codex 的行为模式和工作流。

Skill 管理界面

Skill 通常随插件一起安装。在 Skill 管理界面，你可以查看所有已安装的 Skill，以及它们指导 Codex 使用工具的详细说明文档。

创建自定义 Skill

你可以创建自定义 Skill 来指导 Codex 按照你的特定需求工作。在 Skill 管理界面点击新建按钮，输入 Skill 名称，然后在内容区域编写指导说明。

示例 Skill：代码审核

你在进行代码审核时，请遵循以下规范：-检查变量命名是否使用驼峰命名法-检查函数长度是否超过50行-检查是否有未处理的异常-检查注释是否清晰完整-检查是否存在硬编码的魔法数字

Skill 创建完成后，在对话中 / 引用这个 Skill 即可使用：

设置定时任务

Codex 的 Automation 功能允许你设置定时执行的任务。

这个就很简单了，直接使用模板或者使用对话创建都可以

在任务正式运行前，建议先点击"试运行"按钮进行验证，确认配置是否正确。试运行不会影响定时 schedule。

Agent.md

Agent.md 是定义 Codex 助手“人格”与“行为准则”的核心文件。它是一个遵循 Markdown 格式的配置文档，描述了助手的身份、知识边界、回复风格、记忆策略以及道德约束。在你的工作区根目录下创建 Agent.md，Codex 会自动加载。一个典型结构如下：

#身份你是一位精通前后端开发的资深软件工程师，代号“Codex”。#沟通风格使用专业但不晦涩的中文，适当加入代码示例。语气友善，像同事一样交流。#知识范围你擅长React、Node.js、Python，了解AWS基础服务。对不了解的内容，请明确告知，绝不编造。#行为规则-优先给出可运行的代码片段。-当用户提出需求时，先复述需求再给出方案。-涉及修改代码时，必须提醒备份。-每天首次对话需打招呼并介绍今天的重点任务。#记忆记住用户的姓名、技术栈偏好和当前项目名称，存储于长期记忆。

通过编写不同的 Agent.md 文件并放置在不同文件夹，例如前端有前端的Agent.md，后端开发有后端的

插件

插件系统是 Codex 的核心扩展机制，通过安装不同的插件，你可以让 Codex 获得操作第三方应用、控制浏览器、生成多媒体内容等强大能力。

插件组成：App 与 Skill

每个插件由两个核心部分组成：

• App（工具/Action）：定义了插件可以执行的具体操作，相当于插件的"手脚"
• Skill（说明文档）：告诉 Codex 如何以及何时使用这些操作，相当于插件的"大脑"

以 Gmail 插件为例

Gmail 插件的 App 部分包含 send_email、read_inbox、search_emails 等操作；

Skill 部分描述了这些操作的用途和使用场景。

使用 Presentations 插件制作 PPT

在对话中，你可以通过 @ 符号来显式指定使用某个插件：

@Presentations帮我创建一个介绍Codex的ppt

使用 @ 符号的好处：避免 Codex 误解意图，确保使用正确的工具；让 Codex 优先加载该插件的 Skill 上下文，提升执行准确度。

养宠物

之前Claude code源码泄漏的时候，就有人看源码说要上线一个陪伴宠物，不知道OpenAI是不是抄的....在Codex中，宠物一个虚拟伙伴，以动态形象出现在界面侧边栏或独立窗口它不只是装饰，更是交互入口和效率工具宠物会根据你的使用习惯、任务完成情况做出反应，甚至能主动提醒事项

宠物的设置路径在：设置-Pets

在其中可以选择不同的宠物，还能创建自己的设计同时在聊天中，也可以通过斜杠命令来唤醒宠物

唤醒之后，可以弹出做其他事，宠物会实时返回进度

当任务完成后也会提醒

至此，已经完整介绍了我自己使用 Codex上的一些经验，希望这些经验能够帮助你充分发挥 Codex 的潜力，提高自己的效率

✨我是小珩，前BAT大厂架构师✨

点右下角在看，下次可以优先收到我的文章 ↓