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 的代码编辑器如 CursorCodex 会自动识别并集成到界面中。集成步骤部署编辑器通过自然语言指令让 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」七、插件插件位置情况插件中文大全必装插件板块可以做什么ChromeFeatured / 精选用你的浏览器登录态处理网页任务适合查资料、测试页面、整理网页信息。GitHubFeatured / 精选查看仓库、PR、Issue 和 CI 状态适合代码协作、审查和发布流程。OpenAI DevelopersFeatured / 精选查询 OpenAI API、Agents、ChatGPT Apps、Codex 等官方开发资料。VercelFeatured / 精选构建和部署 Web 应用、Agent、预览环境。NetlifyCoding / 编程与工程部署前端项目、管理预览环境、配置站点和函数。SentryCoding / 编程与工程查看线上错误和事件帮助定位 bug、复现问题和评估影响范围。RemotionDesign / 设计根据提示创建 动态图像 / 程序化视频。HyperFrames by HeyGenDesign / 设计编写 HTML 并渲染视频适合生成动态视觉内容。重点插件介绍插件名称功能作用适用场景场景案例备注Browser让Codex操作内置浏览器一般用于前端的自动化测试1. 自动登录网站2. 点击按钮3. 填写表单4. 翻页截图5. 确认页面功能和样式是否正常处理公开网页、本地预览、无需登录的页面则优先使用 Codex 自带 BrowserComputer Use让codex多一双“眼睛”和“鼠标”能操控所有电脑软件1. 命令行或插件不够用的场景2. 完全依靠图形界面交互的场景1. 测试桌面 App2. 复现界面 Bug3. 检查导入导出流程4. 打开音乐软件搜歌5. 使用微信界面发消息目前仅限mac系统Chromecodex控制真实的谷歌浏览器并在后台执行浏览器操作适合处理“必须登录真实网站才能完成”的浏览器任务1. 打开 Gmail 查邮件2. 进公司后台改资料3. 跨多个网页整理资料不会直接接管你正在用的窗口导致影响你正常使用谷歌浏览器八、SkillsCLI推荐下载的skillskill名称功能Find-Skill根据用户需求查找和安装来自agent skill开放生态的元技能Frontend- Design创建具有独特风格、生产级品质且设计精良的前端界面humanizer-zhHumanizer 的汉化版本消除文本内容的 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推荐的CLICLI名称功能飞书CLI飞书官方CLI工具覆盖消息、文档、多维表格、电子表格、幻灯片、日历、邮箱、任务、会议等核心业务域提供200命令及24个AI Agent SkillsOpenCLI万能命令行工具箱通用命令行中心与AI原生运行平台能将任何网站、桌面应用或本地程序变成统一命令行操作界面CLIGitHub 的官方命令行工具。它将拉取请求、问题和其他 GitHub 概念带到终端中与你已经在使用git和代码的地方并排显示。gemini-CLIGemini CLI 可将 Gemini 的功能直接引入终端。它提供轻量级的 Gemini 访问方式能够以最直接的方式从终端命令访问 Gemini 模型。九、MCPMCP位置MCP安装把开源 MCP 项目地址给到工具由工具执行下载部署跟随页面提示授权即可。以notebooklm mcp为例可直接进行如下操作步骤 1自然语言输入指令帮我安装好notebooklm的mcphttps://github.com/PleasePrompto/notebooklm-mcp步骤 2根据引导进行重启并授权步骤 3在「设置」下的「MCP服务器」确认下载成功十、自动化任务方式 1自动化面板步骤 1打开「自动化」面板步骤 2新建自动化功能 / 选择需求相近的官方样例步骤 3完成自动化任务设置方式 2日常语言交互设置通过在对话框与Codex进行日常语言交互设置自动化任务例如帮我创建一个自动化任务每周一早上9点。任务内容是自动执行热门项目推荐的skill产出一篇图文发到飞书群里
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 的代码编辑器如 CursorCodex 会自动识别并集成到界面中。集成步骤部署编辑器通过自然语言指令让 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」七、插件插件位置情况插件中文大全必装插件板块可以做什么ChromeFeatured / 精选用你的浏览器登录态处理网页任务适合查资料、测试页面、整理网页信息。GitHubFeatured / 精选查看仓库、PR、Issue 和 CI 状态适合代码协作、审查和发布流程。OpenAI DevelopersFeatured / 精选查询 OpenAI API、Agents、ChatGPT Apps、Codex 等官方开发资料。VercelFeatured / 精选构建和部署 Web 应用、Agent、预览环境。NetlifyCoding / 编程与工程部署前端项目、管理预览环境、配置站点和函数。SentryCoding / 编程与工程查看线上错误和事件帮助定位 bug、复现问题和评估影响范围。RemotionDesign / 设计根据提示创建 动态图像 / 程序化视频。HyperFrames by HeyGenDesign / 设计编写 HTML 并渲染视频适合生成动态视觉内容。重点插件介绍插件名称功能作用适用场景场景案例备注Browser让Codex操作内置浏览器一般用于前端的自动化测试1. 自动登录网站2. 点击按钮3. 填写表单4. 翻页截图5. 确认页面功能和样式是否正常处理公开网页、本地预览、无需登录的页面则优先使用 Codex 自带 BrowserComputer Use让codex多一双“眼睛”和“鼠标”能操控所有电脑软件1. 命令行或插件不够用的场景2. 完全依靠图形界面交互的场景1. 测试桌面 App2. 复现界面 Bug3. 检查导入导出流程4. 打开音乐软件搜歌5. 使用微信界面发消息目前仅限mac系统Chromecodex控制真实的谷歌浏览器并在后台执行浏览器操作适合处理“必须登录真实网站才能完成”的浏览器任务1. 打开 Gmail 查邮件2. 进公司后台改资料3. 跨多个网页整理资料不会直接接管你正在用的窗口导致影响你正常使用谷歌浏览器八、SkillsCLI推荐下载的skillskill名称功能Find-Skill根据用户需求查找和安装来自agent skill开放生态的元技能Frontend- Design创建具有独特风格、生产级品质且设计精良的前端界面humanizer-zhHumanizer 的汉化版本消除文本内容的 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推荐的CLICLI名称功能飞书CLI飞书官方CLI工具覆盖消息、文档、多维表格、电子表格、幻灯片、日历、邮箱、任务、会议等核心业务域提供200命令及24个AI Agent SkillsOpenCLI万能命令行工具箱通用命令行中心与AI原生运行平台能将任何网站、桌面应用或本地程序变成统一命令行操作界面CLIGitHub 的官方命令行工具。它将拉取请求、问题和其他 GitHub 概念带到终端中与你已经在使用git和代码的地方并排显示。gemini-CLIGemini CLI 可将 Gemini 的功能直接引入终端。它提供轻量级的 Gemini 访问方式能够以最直接的方式从终端命令访问 Gemini 模型。九、MCPMCP位置MCP安装把开源 MCP 项目地址给到工具由工具执行下载部署跟随页面提示授权即可。以notebooklm mcp为例可直接进行如下操作步骤 1自然语言输入指令帮我安装好notebooklm的mcphttps://github.com/PleasePrompto/notebooklm-mcp步骤 2根据引导进行重启并授权步骤 3在「设置」下的「MCP服务器」确认下载成功十、自动化任务方式 1自动化面板步骤 1打开「自动化」面板步骤 2新建自动化功能 / 选择需求相近的官方样例步骤 3完成自动化任务设置方式 2日常语言交互设置通过在对话框与Codex进行日常语言交互设置自动化任务例如帮我创建一个自动化任务每周一早上9点。任务内容是自动执行热门项目推荐的skill产出一篇图文发到飞书群里
