Codex 安装与配置完整指南
一、环境准备与安装
下载与安装
步骤 1：获取安装包
访问 OpenAI 官网的 Codex 页面下载
步骤 2：账号登录
Codex 支持两种登录方式：
- ChatGPT 账号登录：使用已有的 OpenAI 账号直接登录
- API Key 登录：使用 OpenAI API Key 进行身份验证
提示：如需使用 API Key 登录，需要先在 OpenAI 平台获取 API 密钥(https://platform.openai.com/api-keys)）
界面概览
安装完成后，首次启动 Codex 的界面如下：
二、基础功能操作
上下文管理
查看上下文状态
压缩上下文
对话上下文不断累积会持续消耗 token 资源，当上下文过长，可以执行 /压缩 指令手动精简上下文内容，减少 token 占用：
额度状态查看
方式一：系统设置查看
在系统设置中查看当前的额度使用情况：
方式二：斜杠命令查看
在对话框输入 /额度 对应指令，即可展示详细资源统计：
模型选择与配置
速度模式说明：
- 标准模式：默认速度，适合常规开发任务
- 快速模式：响应速度提升约 1.5 倍，但会消耗更多额度
模型选择建议：
- 推荐使用最新的5.5 模型，性能最优
- 也可根据具体需求选择其他版本模型
- 智能程度设置：一般任务选择"中"级别即可满足需求
三、本地文件操作
项目创建与管理
新建项目
两种方式创建项目：
- 新建空白项目
- 选择本地已有文件夹作为项目
权限设置
三种文件访问权限级别：
默认权限
- 仅能读写所选项目文件夹内的文件
- 如需访问外部文件，需要单独申请权限
自动审查模式
- AI 会自动检查操作风险
- 高风险操作会请求用户确认
- 低风险操作直接执行
完全访问权限
- 在电脑上执行任意操作
多任务并行处理
在现有项目中，可开启多个并行对话任务：
四、命令行集成使用
开启"自动审查"模式后，直接在命令行中工作。可以通过自然语言指令让 Codex 执行各种命令行操作，如安装工具、运行脚本。
编辑器集成方案
当前限制：
聊天任务框中显示的文件可以在右侧结果框内打开查看，但无法直接编辑。
解决方案：集成 AI 编辑器
推荐安装支持 AI 的代码编辑器（如 Cursor），Codex 会自动识别并集成到界面中。
集成步骤：
部署编辑器
通过自然语言指令让 Codex 检查并安装 Cursor：请检查我是否已安装 Cursor 编辑器； 若未安装，请先为我安装。 若已安装，将 Codex 桌面端右上角"打开编辑器"的默认目标设置为 Cursor，并验证是否生效。使用集成编辑器
部署完成后，Cursor 会常驻在右上角，文件可以直接在 Cursor 中打开编辑：
五、持久记忆
方式 1：全局级长期记忆
「全局生效 Agents.md」不管在哪个项目和 Codex 对话，都会第一时间把已记录的记忆，当作上下文传给大模型。
「全局生效 Agents.md」适合记录所有任务都通用的规则，比如你的使用习惯、工作偏好等。
步骤 1：在「设置」中找到「个性化」
**步骤 2：**直接在「自定义指令」里添加想要的规则和约束，比如个人使用习惯、工作偏好等。
**步骤 3：**可直接在聊天任务中使用日常语言交代自己的规则，并最终要求添加到「全局agents.md」
方式 2：项目级持久记忆
- 「项目级agents.md」只在固定项目持久生效
步骤 1：在具体项目中打开编辑器（如：Cursor）
步骤 2：在编辑器中新建文件，并命名为：AGENTS.md。（注意：AGENTS必须大写）
步骤 3：直接在AGENTS.md里，用自然语言，新增规则。
步骤 4：可直接在聊天任务中使用日常语言交代自己的规则，并最终要求添加到“项目AGENTS.md”
方式 3：自动记忆
- 自动记忆的机制是，codex会在我们结束对话或任务，闲置一段时间之后，帮我们把之前对话总结成记忆，并在之后的对话与项目中复用。
步骤 1：在「设置」下的「个性化」中找到「启用记忆」
步骤 2：自动记忆的文件一般是在/Users/xxxx/.codex/memories文件夹下面的
六、大型项目规划与落地
面对逻辑复杂、需求还没有完全梳理清楚的项目，可以打开计划模式，借助工具梳理思路，再落地执行。下面以个人网页开发作为示例演示完整流程。
步骤 1：新建项目
步骤 2：打开「计划模式」
步骤 3：（以“从0开始做个人网页”为例）根据Codex的引导，通过引导选择，或自主输入提示词，最终完善计划
步骤 4：计划生成后，调整计划
步骤 5：计划开始执行后，如果不满意，可临时提交建议，并在合适的时机点击「引导」进行提交。执行过程不会被中止。
步骤 6：如果执行中有些想法不确定，可以通过「fork（分叉）」开个副本测试，这样不会弄乱主线任务
步骤 7：等待时，可在「设置」下的「外观」选择或定制桌面宠物。唤醒后，宠物会提示你，当前Codex正在做什么。
步骤 8：可以在结果预览界面右上角，选择「注释」对生成内容进行批注，批注好以后，发送给codex进行修改
步骤 9：项目完结后，可让codex帮我们基于刚才的项目，生成一份「项目级AGENT.md」
七、插件
插件位置&情况
插件（中文）大全
| 必装插件 | 板块 | 可以做什么 |
|---|---|---|
| Chrome | Featured / 精选 | 用你的浏览器登录态处理网页任务，适合查资料、测试页面、整理网页信息。 |
| GitHub | Featured / 精选 | 查看仓库、PR、Issue 和 CI 状态，适合代码协作、审查和发布流程。 |
| OpenAI Developers | Featured / 精选 | 查询 OpenAI API、Agents、ChatGPT Apps、Codex 等官方开发资料。 |
| Vercel | Featured / 精选 | 构建和部署 Web 应用、Agent、预览环境。 |
| Netlify | Coding / 编程与工程 | 部署前端项目、管理预览环境、配置站点和函数。 |
| Sentry | Coding / 编程与工程 | 查看线上错误和事件，帮助定位 bug、复现问题和评估影响范围。 |
| Remotion | Design / 设计 | 根据提示创建 动态图像 / 程序化视频。 |
| HyperFrames by HeyGen | Design / 设计 | 编写 HTML 并渲染视频，适合生成动态视觉内容。 |
重点插件介绍
| 插件名称 | 功能作用 | 适用场景 | 场景案例 | 备注 |
|---|---|---|---|---|
| Browser | 让Codex操作内置浏览器 | 一般用于前端的自动化测试 | 1. 自动登录网站 2. 点击按钮 3. 填写表单 4. 翻页截图 5. 确认页面功能和样式是否正常 | 处理公开网页、本地预览、无需登录的页面，则优先使用 Codex 自带 Browser |
| Computer Use | 让codex多一双“眼睛”和“鼠标”，能操控所有电脑软件 | 1. 命令行或插件不够用的场景 2. 完全依靠图形界面交互的场景 | 1. 测试桌面 App 2. 复现界面 Bug 3. 检查导入导出流程 4. 打开音乐软件搜歌 5. 使用微信界面发消息 | 目前仅限mac系统 |
| Chrome | codex控制真实的谷歌浏览器，并在后台执行浏览器操作 | 适合处理“必须登录真实网站才能完成”的浏览器任务 | 1. 打开 Gmail 查邮件 2. 进公司后台改资料 3. 跨多个网页整理资料 | 不会直接接管你正在用的窗口，导致影响你正常使用谷歌浏览器 |
八、Skills&CLI
推荐下载的skill
| skill名称 | 功能 |
|---|---|
| Find-Skill | 根据用户需求，查找和安装来自agent skill开放生态的元技能 |
| Frontend- Design | 创建具有独特风格、生产级品质且设计精良的前端界面 |
| humanizer-zh | Humanizer 的汉化版本，消除文本内容的 AI 生成痕迹。 |
skill合集网站：lobehub
创建自己的skill
以最终创建一项「自动撰写《本周 GitHub 热门项目推荐》文章」的skill为例
步骤 1：要求codex整理出本周热门GitHub项目，并解释项目作用。
本周最新的github流行项目、热门项目有哪些？并清晰解释这些项目的作用步骤 2：筛选5个符合写作目标，且star数量最多的项目，写一篇《本周GitHub热门项目推荐》
从整理名单中，在AI编程、研究、学习三个领域，选出5个star数量最多的项目，写一篇《本周GitHub热门项目推荐》步骤 3：通过斜杠指令调出已下载好的humanizer-zh技能，去掉文章的AI味儿
步骤 4：对文章的内容与形式进行打磨
加一个固定的开头和结尾，用image2生成一些配图，最后以飞书文档的形式写出来步骤 5：让codex将整个过程整合为一个skill
将以上过程的一整套动作、步骤和标准，整合优化为一个skill步骤 6：可通过斜杠命令进行调出并使用这个skill
推荐的CLI
| CLI名称 | 功能 |
|---|---|
| 飞书CLI | 飞书官方CLI工具，覆盖消息、文档、多维表格、电子表格、幻灯片、日历、邮箱、任务、会议等核心业务域，提供200+命令及24个AI Agent Skills |
| OpenCLI | 万能命令行工具箱，通用命令行中心与AI原生运行平台，能将任何网站、桌面应用或本地程序变成统一命令行操作界面 |
| CLI | GitHub 的官方命令行工具。它将拉取请求、问题和其他 GitHub 概念带到终端中，与你已经在使用git和代码的地方并排显示。 |
| gemini-CLI | Gemini CLI 可将 Gemini 的功能直接引入终端。它提供轻量级的 Gemini 访问方式，能够以最直接的方式从终端命令访问 Gemini 模型。 |
九、MCP
MCP位置
MCP安装
把开源 MCP 项目地址给到工具，由工具执行下载部署，跟随页面提示授权即可。
- 以notebooklm mcp为例，可直接进行如下操作：
步骤 1：自然语言输入指令
帮我安装好notebooklm的mcp：https://github.com/PleasePrompto/notebooklm-mcp步骤 2：根据引导进行重启并授权
步骤 3：在「设置」下的「MCP服务器」确认下载成功
十、自动化任务
方式 1：自动化面板
步骤 1：打开「自动化」面板
步骤 2：新建自动化功能 / 选择需求相近的官方样例
步骤 3：完成自动化任务设置
方式 2：日常语言交互设置
通过在对话框与Codex进行日常语言交互，设置自动化任务，例如：
帮我创建一个自动化任务，每周一早上9点。任务内容是：自动执行热门项目推荐的skill，产出一篇图文发到飞书群里
