Codex Desktop 安装和使用教程不要把 Codex 只理解成一个聊天窗口。它更像是运行在你电脑旁边的执行型助手能读项目文件、调用终端、创建文档、部署网站、连接外部服务也能在你授权后完成一些跨软件的操作。7.1 Codex Desktop 适合解决什么问题Codex 和 Claude Code 都属于编程 Agent但二者的侧重点不完全一样。Claude Code 以终端开发工作流起家现在也有 IDE、Desktop 和 Web 入口适合深度编码、代码审查、复杂重构Codex Desktop 更强调图形界面、本地项目管理、插件连接和日常自动化对零基础用户更友好。对比维度Claude CodeCodex Desktop主要入口终端 CLI也支持 IDE / Desktop / Web 等入口桌面应用也可配合 CLI / VSCode 插件学习门槛终端形态需要熟悉命令行更接近 ChatGPT 的对话体验项目上下文当前工作目录 CLAUDE.md本地项目文件夹 agents.md典型优势编码、重构、规划、代码审查文件处理、图形化管理、插件、自动化任务扩展方式Skills、MCP、Hooks 等Skills、MCP、插件、自动化等适合人群有一定开发经验的用户新手、非技术用户、希望用 GUI 管理任务的人实际选型可以简单一点刚入门害怕终端优先从 Codex Desktop 开始。已经在做工程项目Claude Code 和 Codex 可以一起用一个偏深度开发一个偏日常执行。要处理文件、部署、安装软件、定时任务Codex Desktop 的桌面形态会更顺手。要做复杂代码设计和长链路重构Claude Code 的工程化体验通常更适合。不必纠结“只能选谁”。Agent 工具之间不是互斥关系关键是让不同工具承担它擅长的工作。7.2 安装与首次启动7.2.1 准备账号使用 Codex Desktop 需要 ChatGPT 账号。免费账号通常也可以体验但额度和能力会受限制付费套餐的可用额度更多适合高频使用。具体价格、额度和模型名称会随官方策略变化正式使用前以 OpenAI 页面显示为准。7.2.2 下载客户端官方下载入口https://chatgpt.com/codex/download下载完成后按安装向导操作即可。首次启动时系统可能会询问你的主要用途例如日常办公、学习或编程。这个选择只是为了初始化体验不需要太紧张后面可以继续调整。7.3 权限模式先理解安全边界Codex 能读写本地文件、执行命令、连接插件所以权限设置非常重要。它不是普通聊天机器人而是可能真正改变你电脑文件状态的执行工具。权限模式含义建议使用场景自动审查模式常规操作自动执行高风险操作再请求确认日常学习和普通项目推荐新手使用手动审查模式涉及工具调用时更频繁地等待你确认重要目录、生产环境、敏感文件完全自动模式尽量减少确认步骤让任务连续执行临时项目、沙盒环境、你明确知道风险时新手建议从自动审查模式开始。它能减少频繁弹窗又不会完全放开高风险操作。对于公司代码、客户资料、生产配置等重要目录建议切换到更谨慎的模式并在执行前要求 Codex 先给出计划。一个好习惯是先让 Codex 说明它准备读哪些文件、改哪些文件、执行哪些命令再让它动手。7.4 核心能力一管理本地文件Codex Desktop 的“项目”本质上对应你电脑上的一个文件夹。你选择了某个文件夹它才能在授权范围内读取、分析和修改里面的内容。7.4.1 项目文件夹就是上下文边界进入项目工作区后Codex 会把该文件夹视为当前任务的主要上下文。它可以根据文件内容回答问题也可以生成、移动、重命名或修改文件。适合的任务包括批量整理课程资料文件名把零散笔记合并成一份 Markdown 文档根据图片或视频素材生成清单检查项目目录结构是否混乱把已有文档改写成更适合发布的版本7.4.2 同一项目可以开多个会话一个项目里可以并行存在多个会话。你可以让一个会话分析需求让另一个会话整理文档也可以把不同任务拆开避免上下文互相干扰。不过并行不等于随意。涉及同一批文件的任务最好避免同时修改否则容易出现覆盖或冲突。更稳妥的做法是一个会话负责写另一个会话只负责审查或给建议。7.4.3 产物会落在本地Codex 在项目中生成的 Markdown、图片、PDF、PPT、代码文件等都会保存到你的本地文件夹里。这一点很关键它不是只在聊天记录里给你一段文本而是能把结果变成真实文件。记住一句话项目文件夹既是 Codex 的工作台也是它能看见的主要上下文。7.5 核心能力二调用终端和安装工具Codex 可以在你授权后运行终端命令。对非技术用户来说这个能力尤其有价值因为很多开发环境配置、依赖安装和部署操作本质上都是一串命令。7.5.1 安装基础环境例如你可以直接说请检查我电脑上是否已经安装 Node.js 和 Git。如果没有请给出安装方案确认后再执行。相比直接说“帮我安装”更推荐加上“先检查、再说明、确认后执行”。这样你可以知道它准备做什么也能避免重复安装或装错版本。7.5.2 安装其他开发工具当你想安装某个新工具、CLI 或 Agent 时可以让 Codex 先搜索官方文档再根据系统环境选择安装方式。例如帮我安装 Hermes。请优先查官方仓库或官方文档安装后验证版本并告诉我启动方式。这个提示词比单纯一句“帮我装一下”更可靠因为它明确要求了来源、验证和交付结果。7.5.3 安装 Skills、MCP 或插件相关依赖对于不太知名的工具最好把 GitHub 仓库、官网文档或安装说明链接直接发给 Codex。这样能减少它误判同名项目的概率。这是我要安装的 Skill 仓库链接xxx。请阅读 README说明安装位置和启用方式确认后再修改我的配置。7.5.4 并行任务要有边界Codex 支持同时运行多个任务但不建议把多个会写同一目录的任务同时放出去。可以并行的任务通常有这些一个任务安装工具另一个任务阅读文档一个任务生成方案另一个任务做资料整理一个任务部署项目另一个任务准备发布文案涉及同一份代码或同一批文件时先排队再执行会更稳。7.6 常用操作上下文、额度与模型7.6.1 上下文管理对话越长模型需要携带的历史信息越多。Codex 会用界面上的上下文指示器提醒你当前会话的占用情况。当上下文接近上限时它可能会自动压缩历史。一个任务完成后也可以主动让它总结当前状态请把当前项目进展、已修改文件、未完成事项和下一步建议压缩成一份简短摘要。如果界面支持斜杠命令也可以使用对应的压缩或状态命令。命令名称可能会随版本变化按你当前客户端显示为准。7.6.2 查看额度额度通常可以在设置或状态面板中查看。有些版本也支持在对话中通过状态命令显示当前会话的上下文、短周期额度和周期额度。这里要注意两点复杂任务、长上下文、高速模式或高推理强度通常会消耗更多额度。额度、刷新周期和套餐权益会变化不建议在教程里写死太多数字。7.6.3 选择模型和推理强度日常文件整理、文档改写、简单脚本可以选择默认或中等智能程度。涉及架构设计、复杂调试、跨文件重构时再提高模型能力或推理强度。一个实用原则是低风险任务追求速度高风险任务追求可解释和可确认。7.7 核心能力三持久记忆与agents.mdCodex 的持久记忆可以分成两类一类是你主动写下来的规则另一类是系统自动总结的记忆。对教程学习者来说最值得掌握的是agents.md。7.7.1 全局规则全局规则适合存放跨项目都适用的偏好例如- 默认使用中文回答。 - 修改文件前先说明计划。 - 重要操作前先列出影响范围。 - 文档改写时保留原意不制造未经确认的数据。这些规则相当于你对 Codex 的长期工作约定。写得越清楚后续沟通成本越低。7.7.2 项目规则项目级agents.md只服务当前项目适合记录技术栈、目录结构、运行命令、测试方式、提交规范和禁止事项。推荐在项目初步成型后让 Codex 读取项目并生成一版草稿请阅读当前项目结构帮我生成一份项目级 agents.md。内容包括技术栈、常用命令、目录说明、开发约束和测试要求。先给我预览不要直接写入。审核通过后再写入比一开始凭空写规则更贴合实际。7.7.3 自动记忆自动记忆适合作为补充不适合作为唯一依赖。它可能会根据对话和任务自动总结信息但触发时机、记录内容和召回方式不一定完全可控。明确、稳定、重要的要求仍然建议写进agents.md临时偏好和低风险背景可以交给自动记忆辅助。7.8 核心能力四计划模式与实战开发做复杂任务时不要急着让 Codex 直接写文件。先进入计划模式让它把需求拆开、列出步骤、说明风险再决定是否执行。7.8.1 用个人主页练手你可以创建一个空项目输入我想做一个个人主页。请先用计划模式和我确认目标用户、内容模块、视觉风格、技术栈和部署方式不要立刻写代码。Codex 通常会追问你一些选择题或开放问题例如页面内容、风格偏好、是否需要响应式、是否部署等。你确认方案后它再开始初始化项目。7.8.2 执行中及时纠偏当 Codex 生成过程中方向不对不需要等它全部做完再说。你可以直接补充当前风格太像营销页了请改成更像作品集少用大段宣传语多展示项目和联系方式。很多时候反馈会在下一轮工具调用前被加入上下文。这样既保留了当前进度也能及时修正方向。7.8.3 使用 Fork 保留好上下文如果前半段讨论很有价值但后面走偏了可以从某条回复 Fork 出一个新会话。它相当于从历史分岔点重新开始适合保留前面已经整理好的需求、方案和约束。7.8.4 预览与批注前端项目尤其适合使用内置预览。你可以边看页面边提出修改意见有些版本还支持直接在预览区域批注具体元素。修改页面时尽量给 Codex 可执行的反馈“按钮太靠下移动到首屏右上角”“移动端标题换行不好看请调整字号和宽度”“这张图与主题不符请换成更贴近产品的图片”比起“优化一下”这类反馈更容易得到稳定结果。7.9 核心能力五插件系统插件的作用是让 Codex 连接外部平台和工具。不同版本、账号和系统环境下可见插件可能不同但常见方向大致包括部署、浏览器操作、代码托管和外部应用连接。插件类型典型用途部署类将网站发布到 Vercel、Netlify 等平台代码托管类读取仓库、创建分支、处理 Issue 或 PR浏览器类打开网页、点击按钮、填写表单、截图验证桌面操作类在授权后控制部分本地应用或系统界面7.9.1 部署网站以前端项目为例可以让 Codex 先检查构建命令再连接部署平台请检查这个项目是否可以部署到 Netlify。先运行构建验证说明需要的环境变量和部署步骤确认后再连接插件执行部署。部署完成后让它返回访问链接、构建日志摘要和后续维护建议。7.9.2 浏览器操作类插件浏览器能力很适合做网页验证、后台配置、资料搜集和表单测试。但涉及账号、付款、删除、提交审批等敏感动作时一定要求 Codex 停下来让你确认。可以加一条长期规则凡是涉及登录、付款、删除、发布、提交表单的操作必须先说明影响并等待我确认。7.10 核心能力六SkillsSkills 是把可复用流程沉淀下来的机制。前面我们已经详细讲过 Skills在 Codex 中也可以用类似思路把高频、稳定、步骤清晰的任务封装成技能。适合做成 Skill 的任务包括每周生成技术资讯摘要把课堂录音整理成讲义检查前端页面的响应式问题根据固定模板生成项目周报按统一标准润色课程文档创建 Skill 有两种常用路径。第一种先描述目标让 Codex 帮你起草。我想创建一个“课程文档润色”Skill用于把口语稿改成正式教程。请先和我确认输入、输出、规则和示例。第二种先跑通一次真实任务再沉淀。这种方式更推荐。因为你已经知道流程中哪些步骤有效、哪些检查必须保留生成出来的 Skill 会更实用。7.11 核心能力七MCPMCP 可以理解为让 Agent 连接外部数据源或工具服务的一种协议。对于初学者不需要一开始就深入配置细节先知道它解决什么问题即可当 Codex 需要访问某个外部知识库、数据库、文档系统或业务工具时MCP 可能就是连接方式之一。安装 MCP 时建议遵循三个原则优先使用官方文档或可信仓库。安装前让 Codex 说明配置文件位置、权限范围和凭据保存方式。安装后用一个最小任务验证是否真的连通。示例提示词请根据这个 MCP 官方文档帮我完成配置。先说明它会访问哪些数据、需要哪些密钥、配置会写到哪里等我确认后再执行。7.12 核心能力八自动化任务自动化任务的价值不是“定个闹钟让 AI 说一句话”而是把一套可重复流程交给 Agent 定时执行。例如每周一汇总 GitHub 趋势项目生成中文推荐稿每天早上检查网站是否可访问并整理异常日志每三天汇总课程资料文件夹生成新增内容清单每周生成一次学习进度报告7.12.1 创建自动化的两种方式你可以在自动化面板里手动创建通常需要填写任务提示词、触发时间、模型和推理强度。也可以直接在对话中描述请帮我创建一个自动化任务每周一上午 9 点读取我的项目资料文件夹生成一份本周新增资料摘要。创建前先展示任务内容、执行频率和输出格式。自动化任务要特别注意边界它会在你不盯着屏幕的时候运行所以提示词必须写清楚输入来源、允许做什么、禁止做什么、结果发到哪里。7.13 手机端远程控制部分版本支持通过 ChatGPT 手机 App 连接电脑上的 Codex从手机端发起任务。这个能力适合临时下发轻量任务例如让家里电脑继续整理资料、检查项目状态或生成草稿。一般流程是手机 ChatGPT 和电脑 Codex 都更新到支持该功能的版本。在手机端进入 Codex 入口。按提示完成电脑端配对。在电脑上确认允许该设备远程控制。远程控制的便利性很高但也意味着风险更高。建议只对可信设备开启并避免在手机端随手发起删除、部署、付款、批量修改等高影响操作。学完本章请记住两件事。第一Codex 不是“更会聊天的搜索框”而是可以在你电脑上执行任务的工作代理。它能节省时间也需要你设定边界。第二使用 Agent 的能力不只在于会提问更在于会管理给清楚的目标提供必要上下文要求它先计划执行中及时纠偏最后验收结果。你越会管理任务AI 编程工具越能发挥价值。Codex 和 Claude Code 怎么搭配使用场景推荐选择零基础上手、图形界面学习Codex Desktop深度编码、代码审查、复杂重构Claude Code文件整理、部署、安装工具Codex Desktop编写 Skills、沉淀工作流两者都可以想获得更完整的 Agent 体验两者搭配使用