一、概述1.1 Codex 桌面端是什么Codex 桌面端是装在本机上的 AI 编程助手。用户指定一个文件夹并用自然语言描述需求Codex 可在该文件夹内创建文件、修改代码、执行命令。与 ChatGPT 网页聊天的区别Codex 桌面端会直接修改本机文件用户可在 App 内查看变更Diff并在文件夹中验收结果。1.2 主要能力能力说明本地写代码在指定文件夹内创建、修改文件多任务并行同时开启多条对话分别执行不同任务变更审查在 App 内查看 AI 修改了哪些代码行自动化Automations 按计划在后台执行任务技能扩展Skills 为 Agent 增加专项能力本教程默认使用 Local 本地模式即 AI 直接在本机项目文件夹中工作。二、使用前准备2.1 登录方式正常是需要使用 ChatGPT 账号登录。Plus、Pro、Business、Enterprise、Edu 等订阅通常包含 Codex 使用额度。那么没有账号的小伙伴也可使用 OpenAI API Key去登录可参考 Codex配置使用教程2.2 项目文件夹在桌面新建空文件夹例如C:\Users\你的用户名\Desktop\我的第一个项目命名宜简短可用中文或英文避免特殊符号。不要选择整个桌面、文档目录或 C 盘根目录作为项目以免 AI 误改范围过大。2.3 Git可选建议安装 Git便于在 AI 改乱文件时回退。Windows 下载https://git-scm.com/download/win三、安装与登录3.1 安装步骤打开 https://openai.com/codex下载对应系统的安装包Intel Mac 需选 Intel 版本双击安装按向导完成启动 App点击 Sign In使用 ChatGPT 账号登录登录成功后应能看到主界面左下角显示账号信息。3.2 常见安装问题现象处理办法卡在 Logo 画面Windows设置 → 应用 → Codex → 修复或重置后重启登录后闪退从官网下载最新版覆盖安装登录后 App 无响应检查网络、防火墙可暂时关闭 VPN 重试提示无权限确认订阅有效或尝试 API Key 登录Mac 无法打开系统设置 → 隐私与安全性 → 允许打开四、创建第一个项目4.1 绑定文件夹打开 Codex点击 Select a project选择项目选中已创建的项目文件夹点击选择文件夹此后 AI 创建、修改的文件均在该文件夹内。4.2 确认 Local 模式在界面顶部或侧边栏确认已选中 Local。Local 表示 AI 直接修改所选文件夹中的文件。若显示 Cloud请先切换为 Local 再发送消息。4.3 连通测试在底部输入框发送你好请看看这个文件夹里有什么文件用中文介绍一下你能帮我做什么。若 Codex 用中文回复并说明文件夹状态及可提供的帮助说明项目绑定成功。五、界面概览5.1 主要区域界面分为四部分左侧边栏项目、对话、Skills、Automations、中间对话区、右侧审查面板Diff、底部输入框。另可通过顶部按钮打开集成终端。区域作用项目切换打开、切换不同文件夹Local 模式确认本地模式已开启对话列表管理历史对话建议一个任务一条对话对话内容查看 AI 回复与执行步骤变更预览审查 AI 修改了哪些文件的哪些行输入框输入需求并发送日常使用建议一个任务开一条新对话AI 改完后先查看 Diff最后打开文件或浏览器验收结果。5.2 整体布局顶部工具栏终端、Diff、侧边栏、弹出窗口等左侧项目、对话线程、Skills、Automations中间对话内容、执行步骤、审批提示右侧审查面板、任务侧栏或内置浏览器预览底部输入区Composer、模型选择、运行模式集成终端顶部图标或 CtrlJMacCmdJ六、界面选项与按钮说明以下按区域说明常见按钮与选项。界面可能随版本更新名称以 App 内英文显示为主。Windows 快捷键记为 CtrlMac 记为 Cmd。6.1 左侧边栏项目Projects操作位置作用Add new project项目列表上方或 CtrlO绑定新的本机文件夹点击项目名称项目列表切换到该项目Remove悬停项目名 → 三点菜单从侧边栏移除不删除本机文件夹建议每个代码库或小工具对应一个项目不要将整个桌面设为项目。对话线程Threads每个 Thread 是一次独立任务对话拥有独立上下文。项目指文件夹线程指在该文件夹内的一次对话。操作快捷键作用New threadCtrlN / CmdN新建对话Search threadsCtrlG / CmdG搜索历史对话Previous / Next threadCtrlShift[ ] / CmdShift[ ]切换对话Find in threadCtrlF / CmdF在当前对话内查找FilterThreads 旁筛选图标调整排序或筛选方式Pin对话菜单固定常用对话Archive对话菜单归档可在 Settings 中恢复Skills技能入口作用侧边栏 Skills浏览、启用、管理技能包输入 $技能名在对话中调用指定 Skill输入 /已启用 Skill 会出现在斜杠命令列表示例$imagegen调用图片生成$hatch-pet创建桌面宠物见 Appearance 设置。Automations自动化入口作用侧边栏 Automations创建、管理定时任务编辑器内 引用项目或 Skill部分版本类型适用场景项目 / 独立自动化定时启动新任务如每周总结变更线程自动化在同一条对话内定时唤醒 AI延续上下文自动化运行时电脑通常需保持开机。Chats纯聊天不绑定代码项目文件夹的对话适合调研、规划等。工作目录默认为~/.codex/threads。任务侧栏长任务执行时可能显示 Plan计划、Sources来源、Artifacts产物预览、Summary摘要便于中途调整方向。6.2 顶部工具栏按钮 / 功能快捷键作用Toggle sidebarCtrlB / CmdB显示或隐藏左侧边栏Toggle diff panelCtrlAltB / CmdOptionB显示或隐藏审查面板Toggle terminalCtrlJ / CmdJ打开或关闭集成终端Pop-out窗口菜单或按钮将对话弹出为独立窗口自定义快捷按钮窗口顶部若已配置一键执行常用操作终端说明作用范围限定在当前项目或 worktreeCtrlL 清空终端CtrlK 为命令菜单Codex 可读取终端输出。6.3 底部输入区Composer基本操作操作作用Enter发送消息可在设置中改为 CtrlEnter 换行Shift 拖拽图片将图片加入上下文拖拽图片附加图片参考上方向键恢复上一条输入模型选择输入框附近下拉菜单可选择 AI 模型。对话中输入/model可运行时切换。运行模式模式说明适用场景Local直接修改当前项目文件夹新手默认Worktree在 Git worktree 中隔离修改已是 Git 项目且怕改乱主分支时Cloud在 OpenAI 云端环境运行需预先配置云端环境语音输入按住 CtrlM 可语音输入转写后可编辑再发送。斜杠命令输入 /命令作用/plan计划模式先规划再执行/review代码审查模式/status查看线程 ID、上下文用量、速率限制/goal设定持久目标/init生成 AGENTS.md 脚手架/mcp查看 MCP 连接状态/feedback提交反馈输入$可显式调用 Skill。审批提示AI 执行敏感操作运行命令、访问网络等时需用户确认选项含义Approve once仅批准本次Approve for session本次对话内同类操作不再询问Deny拒绝执行不确定时建议选择批准一次并看清命令内容后再确认。6.4 审查面板Review / Diff显示范围范围说明未提交改动默认当前工作区相对 Git 的变更All branch changes相对主分支的全部分支改动Last turn changes仅 AI 上一轮的改动若项目非 Git 仓库面板会提示先初始化 Git。绿色表示新增行红色表示删除行。面板操作操作作用Stage将改动加入暂存区Unstage取消暂存Revert丢弃改动Stage all暂存全部改动Revert all丢弃全部未提交改动慎用按文件 / 按块单独 stage 或 revert行内评论在 diff 行上留言让 Codex 按评论修改Git 与 PR项目为 Git 仓库且已配置远程时可在 App 内 Commit、Push、创建 PR并处理 PR 评论。6.5 集成终端通过顶部图标或 CtrlJ 打开。用于git status、npm test、启动开发服务器等。Codex 也会在此执行命令并可读取输出。6.6 内置浏览器可在 App 内预览 localhost 或本地 HTML。支持 Browser comments页面标注反馈与 Browser use自动操作页面需在 Settings → Browser 配置。不支持登录态、Cookie 及浏览器插件。6.7 命令菜单CtrlShiftP 或 CtrlKMacCmdShiftP 或 CmdK打开命令面板可搜索执行设置、重载 Skills、切换主题等操作。6.8 设置面板Settings打开方式菜单 → Settings或 Ctrl,MacCmd,。分类主要选项General文件打开方式、命令输出量、多行输入、运行时防止休眠Profile用量统计、头像昵称、邀请Keyboard Shortcuts查看、自定义、重置快捷键Notifications任务完成与审批通知Agent configuration审批策略、沙箱权限、高级配置Appearance主题、字体、PetsGit分支命名、提交与 PR 模板、force push 策略Integrations MCP连接外部工具MCP 服务器Browser内置浏览器、允许 / 禁止的网站列表Computer Use桌面应用操控权限Personalization回复风格、自定义指令AGENTS.mdMemories跨对话记忆偏好与规范Archived threads查看、恢复已归档对话6.9 常用快捷键操作WindowsmacOS命令菜单CtrlShiftP 或 CtrlKCmdShiftP 或 CmdK设置Ctrl,Cmd,快捷键帮助Ctrl/Cmd/打开项目CtrlOCmdO新建对话CtrlNCmdN搜索对话CtrlGCmdG对话内查找CtrlFCmdF切换侧边栏CtrlBCmdB切换 DiffCtrlAltBCmdOptionB切换终端CtrlJCmdJ清空终端CtrlLCtrlL语音输入CtrlM按住CtrlM按住6.10 界面相关常见问题问题答案项目和对话有何区别项目指文件夹对话指在该文件夹内的一次任务Local 和 Worktree 如何选新手用 Local怕改乱主代码且已是 Git 项目时用 Worktree如何只看 AI 刚改的内容审查面板选 Last turn changesAI 要跑命令该批准吗先看命令内容不懂则批准一次找不到历史对话CtrlG 搜索或调整 Threads 筛选或在 Settings 查看归档七、实战制作待办清单网页7.1 第一步创建网页向 Codex 发送请在这个文件夹里创建一个待办清单网页要求如下 1. 只要一个 index.html 文件使用 HTML、CSS、JavaScript 2. 功能添加待办、删除待办、标记完成或取消完成 3. 数据保存在 localStorage刷新后不丢失 4. 界面为中文风格简洁 5. 完成后说明如何在 Windows 浏览器中打开验收文件夹中出现index.html双击用浏览器打开测试添加、完成、刷新后数据是否保留。7.2 第二步美化界面在同一条对话中发送请优化 index.html 的视觉效果 居中布局、浅色背景、蓝色强调色、卡片式待办项、完成项显示删除线。 只改样式不要破坏现有功能。验收刷新浏览器外观改善且功能正常。7.3 第三步增加功能在同一条对话中发送在现有待办清单上增加 1. 未完成 / 已完成数量统计 2. 清除已完成按钮 3. 输入框支持 Enter 添加 4. 空输入不添加 改完后说明如何测试。验收统计、清除已完成、Enter 添加均正常。7.4 第四步可选README请创建 README.md中文含项目简介、功能列表、打开方法、改进建议。 不要修改 index.html。八、审查 AI 的修改Diff 用绿色标新增、红色标删除。不必读懂全部代码但应确认修改的文件是否正确、有无大段误删、实际效果是否符合预期。检查项做法改了几个文件是否只改了预期的文件有无误删红色删除行是否异常效果是否正确在浏览器或文件中亲自测试不满意时可在同一条对话中继续说明例如请撤销上一步对样式的修改恢复到我让你优化外观之前的状态。「清除已完成」按钮点击没反应请修复不要改其他功能。九、如何向 Codex 描述需求描述越具体结果越好。类型示例不宜帮我做个网站不宜做一个像微信一样的 App建议在 index.html 增加深色模式按钮指定配色不引入外部 CSS 框架可套用结构在某文件或文件夹中做某功能要求某效果不要改动某部分。原则一次只做一件事说明不要改什么结尾写明如何验收。十、进阶功能多对话并行新建多条对话分别处理代码、文档、检查等任务审查与回滚通过 Diff 逐文件查看不满意可在对话中要求撤销Automations侧边栏或设置中配置定时任务Skills启用后可在 prompt 中要求按某 Skill 规范执行多项目可绑定多个文件夹在 App 内切换十一、常见问题问题答案不懂代码能用吗可以用户负责描述需求与验收必须用英语吗对话可用中文界面为英文改乱了怎么办查看变更预览对话中要求撤销或用 Git 回退会修改其他文件夹吗仅修改所选项目文件夹内的文件免费版 ChatGPT 能用吗通常需 Plus 及以上以官网政策为准Windows 无法打开 html右键 → 打开方式 → Chrome 或 Edge运行命令安全吗Local 模式可能在项目文件夹内执行命令请使用专用文件夹并备份十二、项目备份大改前建议 Git 备份。可让 Codex 执行请在这个文件夹里初始化 git 仓库添加所有文件并提交说明写「待办清单初版」。也可手动执行git init、git add .、git commit -m 待办清单初版。改乱可用git checkout .回退。十三、常用 Prompt 参考从零创建在【文件夹】里创建【工具名】单文件 HTML中文界面 功能【列举 35 条】localStorage 保存说明如何打开。只改外观只优化【文件名】的 CSS指定风格不修改 JavaScript 逻辑。修 bug【描述现象】请定位原因并修复说明验证步骤。加功能在现有项目基础上增加【功能】不破坏已有逻辑说明如何测试。只问不改用中文解释【文件名】的结构分页面、样式、逻辑三部分不要改文件。写文档为项目写 README.md中文不要修改代码文件。
