Codex 常用场景速查给新手和学生的实用用法这份文档不是官方说明书而是偏实际使用的速查稿。你可以把 Codex 理解成一个能读文件、改文件、运行命令、查资料、生成内容的 AI 助手。它最适合处理那些“我知道想要什么但不知道从哪下手”的任务。使用时有一个简单原则任务越具体结果越稳。不要只说“帮我优化一下”最好说清楚目标、范围和不要动的地方。1. 让 Codex 先看懂项目适合场景刚拿到一个课程项目、开源项目、模板工程不知道每个文件夹是干什么的。可直接复制请先不要修改任何文件。 帮我阅读当前项目说明 1. 这个项目大概是做什么的 2. 主要目录和文件分别负责什么 3. 我应该从哪个文件开始看 4. 如果我要运行它需要哪些步骤 请用适合编程新手的方式解释术语可以保留英文但要讲清楚意思。如果你只想快速知道怎么运行请帮我找出这个项目的启动方式。 要求 1. 先检查 README、package.json、requirements.txt、pyproject.toml 等可能的配置文件 2. 告诉我需要安装什么 3. 给出可以直接复制运行的命令 4. 暂时不要修改代码2. 修报错适合场景项目启动失败、终端报错、网页白屏、Python 脚本运行不了。可直接复制我遇到了报错请帮我定位原因并修复。 要求 1. 先解释报错大意 2. 找到最可能相关的文件 3. 只做必要修改不要大范围重构 4. 修改后运行相关命令验证 5. 最后告诉我改了哪些文件、为什么这么改如果你还不想让它直接改先不要修改文件。 请只分析这个报错的原因并给我 2-3 个可能的解决方案。 每个方案说明风险和适用情况最后推荐一个最稳的做法。3. 小范围改代码适合场景加按钮、改页面文案、增加搜索、修一个小功能。可直接复制请帮我实现这个小功能[在这里写你的功能] 限制 1. 尽量保持现有代码风格 2. 不要改无关文件 3. 不要重构整个项目 4. 如果需要新增依赖先说明原因再安装 5. 完成后运行测试或启动项目验证例子请帮我给用户列表页面增加一个搜索框。 要求 1. 可以按用户名和邮箱搜索 2. 不要改后端接口先在前端本地过滤 3. 保持现有 UI 风格 4. 改完后告诉我涉及哪些文件4. 改网页样式和移动端适配适合场景页面太丑、手机上错位、按钮太挤、文字溢出。可直接复制请帮我优化这个页面的样式但不要改变功能。 重点检查 1. 手机端是否可用 2. 按钮和文字是否重叠 3. 页面间距是否统一 4. 颜色是否太单调或刺眼 5. 交互状态是否清楚比如 hover、disabled、loading 完成后请启动页面并用浏览器截图或检查结果说明是否正常。如果你想要更像正式产品请把这个页面调整得更像一个真实可用的产品界面而不是演示页面。 要求 1. 不做营销落地页 2. 第一屏直接展示主要功能 3. 信息密度适中适合反复使用 4. 移动端和桌面端都要检查 5. 不要使用过度装饰性的渐变和大卡片5. 生成图片或视觉素材适合场景文章配图、App 封面图、游戏素材、头像、海报背景、产品示意图。如果是在支持生图的 Codex 环境里可以直接说请生成一张适合作为文章封面的图片。 主题AI 编程助手帮助大学生完成课程项目 风格真实、干净、现代不要赛博朋克不要夸张科幻 画面一名学生在笔记本电脑前查看代码和任务清单环境像大学自习室 比例16:9 要求不要出现可读文字不要出现品牌 logo生成产品示意图请生成一张产品使用场景图。 主题一个新手用户用 AI 助手修复网页报错 风格写实、自然光、桌面工作场景 画面重点电脑屏幕上有代码编辑器和简洁的任务面板 避免夸张机器人形象、复杂背景、明显 AI 味的蓝紫光效 比例4:3如果你要生成游戏素材请生成一组 2D 游戏道具图标。 内容金币、钥匙、药水、地图、宝箱 风格清晰、轻量、适合休闲手游 要求 1. 每个道具居中 2. 透明背景 3. 不要文字 4. 保持同一套视觉风格小技巧生图时要说清楚“用途、比例、风格、画面内容、不要什么”。其中“不要什么”很重要能减少跑偏。6. 写文章、报告和 README适合场景写课程报告、项目说明、产品介绍、使用教程。可直接复制请帮我写一份 README。 面向对象第一次打开这个项目的新手 内容包括 1. 项目是做什么的 2. 如何安装依赖 3. 如何启动 4. 常见问题 5. 项目目录说明 要求 1. 用中文 2. 不要写得像 AI 宣传稿 3. 命令用代码块方便复制 4. 不要编造不存在的功能课程报告模板请根据当前项目帮我整理一份课程项目报告初稿。 结构 1. 项目背景 2. 功能介绍 3. 技术选型 4. 主要实现过程 5. 遇到的问题和解决方法 6. 总结 要求 1. 语气像学生自己写的不要太官腔 2. 技术部分要准确 3. 不要夸大项目能力 4. 如果有不确定的信息请标注出来不要硬编7. 查资料和快速下载东西适合场景查官方文档、下载数据集、拉取 GitHub 项目、安装依赖。查资料时建议这样说请帮我查找这个问题的最新官方资料[写问题] 要求 1. 优先看官方文档 2. 给出链接 3. 用中文总结重点 4. 如果资料可能过期请说明日期下载项目请帮我下载这个 GitHub 项目并检查如何运行 [粘贴 GitHub 链接] 要求 1. 下载到当前工作目录下 2. 不要放到系统盘根目录或用户主目录 3. 先阅读 README 4. 给我可复制的启动命令下载大文件或数据集时建议加上这句如果需要下载大量数据请先告诉我预计大小并优先放到非系统盘或我指定的目录不要默认塞到 C 盘。安装依赖时请检查当前项目缺少哪些依赖并安装必要依赖。 要求 1. 只安装项目运行必需的依赖 2. 不要全局安装除非确实必要 3. 安装后运行项目验证 4. 告诉我安装了什么、为什么需要8. 调用 skillSkill 可以理解成 Codex 的“专项工作规则”。比如处理 PDF、表格、PPT、浏览器自动化、学术论文、图片生成等任务时Codex 可以按对应 skill 的流程来做减少乱来。最简单的调用方式是直接点名请使用 pdf skill帮我读取这个 PDF总结主要内容并提取关键表格。请使用 spreadsheets skill帮我整理这个 Excel生成一个按月份统计的表格和图表。请使用 playwright skill打开本地网页检查手机端布局有没有问题并截图说明。请使用 imagegen skill生成一张适合公众号封面的配图。也可以不点名只说任务。比如你说“帮我改 PPT”Codex 通常会自动选择演示文稿相关 skill。但新手建议直接点名减少误判。常见可用 skill 场景请使用 academic-research skill帮我查 10 篇关于 AI 辅助编程教育的近年论文按主题分类总结。请使用 doc skill帮我把这份 Word 文档排版得更正式并检查标题、页眉、表格格式。请使用 Data Analysis skill分析这个 CSV 数据找出最重要的趋势并生成图表。9. 授权后的方便之处Codex 在获得相应授权后会更像一个“能自己动手的助手”。这里的授权可能包括允许访问当前文件夹、允许运行命令、允许联网、连接 GitHub、打开浏览器、使用本地工具等。一个典型场景请帮我修复这个项目的启动问题。 你可以 1. 阅读当前目录文件 2. 安装必要依赖 3. 运行启动命令 4. 根据报错继续修复 限制 1. 不要删除我的源代码 2. 不要改无关文件 3. 每次大改前先说明 4. 完成后给我总结连接 GitHub 后可以这样用请帮我查看这个 PR 的修改内容并做一次代码审查。 重点看 1. 是否有明显 bug 2. 是否缺少测试 3. 是否有安全风险 4. 是否有不必要的大改 请按严重程度排序不要只做泛泛总结。如果要它修 GitHub Actions请帮我检查这个 PR 失败的 CI。 要求 1. 先看失败日志 2. 找出最可能原因 3. 只修改和失败相关的代码 4. 修改后说明为什么能解决授权后的关键好处是少复制粘贴。你不用把每个文件、每段报错、每个命令结果手动贴给它它可以自己去看。但这也意味着你要给清楚边界尤其是“不能改什么”。10. 做一个完整工作流适合场景你想让 Codex 从理解项目到修改、测试、总结完整做一轮。通用模板请按下面流程处理这个任务[写任务] 流程 1. 先阅读相关文件确认任务范围 2. 简短说明你的实现计划 3. 修改代码 4. 运行必要的测试或检查命令 5. 如果失败继续修复 6. 最后总结改动、验证结果和风险 限制 1. 不要改无关文件 2. 不要做大规模重构 3. 不确定的地方先说明 4. 面向新手解释关键修改前端页面工作流请帮我完成这个前端任务[写任务] 要求 1. 先找出相关页面和组件 2. 保持现有设计风格 3. 同时检查桌面端和手机端 4. 启动本地服务进行验证 5. 如果页面空白、元素重叠或文字溢出请继续修 6. 最后告诉我本地访问地址数据分析工作流请帮我分析这个数据文件。 目标[写你想知道的问题] 要求 1. 先检查字段含义和数据质量 2. 说明是否有缺失值、异常值 3. 做必要的统计和可视化 4. 用普通人能懂的话解释结论 5. 不要只堆图表要给出判断论文资料工作流请帮我围绕这个主题做文献调研[写主题] 要求 1. 优先找近 5 年论文 2. 按研究方向分类 3. 每篇说明研究问题、方法、结论和局限 4. 最后总结这个方向还有哪些可做的问题 5. 给出 DOI 或论文链接11. 更稳的提问方式不要这样问帮我优化一下项目。更好的问法请只优化登录页面的手机端布局。 不要改登录逻辑不要改接口。 重点解决按钮太挤、输入框宽度不一致、错误提示换行难看的问题。 改完后请启动页面检查。不要这样问帮我写个系统。更好的问法请先帮我设计一个最小可用版本。 场景学生课程任务管理 用户一个学生自己用 核心功能添加任务、设置截止日期、标记完成、按课程筛选 要求 1. 先给页面和数据结构方案 2. 不要直接写代码 3. 用新手能懂的话解释12. 常用限制语句这些句子很适合加在提示词最后请先不要修改文件只分析。只改和这个问题相关的文件不要顺手重构。如果需要安装新依赖请先说明原因。请用适合编程新手的语言解释。请给我可以直接复制运行的命令。不要编造不存在的功能或结果。如果你不确定请明确说不确定并告诉我怎么验证。涉及大文件下载时不要默认放到系统盘。13. 新手最推荐的使用方式第一次用 Codex不建议直接让它接管一个大项目。更稳的顺序是第一步帮我看懂项目不改文件。 第二步帮我运行项目记录问题。 第三步一次只修一个问题。 第四步每次修改后总结改了什么。 第五步让我确认后再继续下一个任务。你可以直接这样发我是编程新手。请你按教学模式帮我处理这个项目 1. 先解释不要急着改 2. 每次只处理一个问题 3. 修改前告诉我要改哪里 4. 修改后解释为什么这么改 5. 所有命令都放在代码块里方便我复制14. 一句话总结Codex 最适合做三件事看懂项目、处理具体任务、把麻烦步骤自动化。它不适合一句话丢过去就全自动完成复杂项目。对新手来说最好的用法不是让它替你写而是让它带着你一步步完成。