Appearance
ChatGPT / Codex 项目与聊天使用技巧
Projects(项目)用于把相关聊天、文件、说明和来源组织在一起。最简单的判断方式是:需要持续推进、会产生多个成果、或多次使用同一批资料时创建项目;一次就能完成且不需要共享上下文时直接新建聊天。
NOTE
本文根据 OpenAI Learn 的 Projects and chats 页面整理。用户提供的旧地址 /docs/projects-and-chats 已迁移到 /docs/projects。界面名称和功能可能随客户端版本、套餐或工作区策略变化。
Codex 桌面应用:先区分两种文件方式
IMPORTANT
如果你使用的是 Codex 桌面应用,需要区分“本地项目文件”和“直接附加到聊天”这两种方式。处理大型代码、日志或数据文件时,优先把文件放入 Codex 的本地项目目录,让 Codex 按需查找和分段读取,不要把整个大文件作为聊天附件上传。
| 方式 | 如何使用 | 限制与适用场景 |
|---|---|---|
| 本地项目文件 | 把文件放在已添加的工作区文件夹中;输入 @ 后选择工作区内的文件路径,或直接在提示词中说明路径 | 这是访问本机工作区,不是传统的聊天附件上传。OpenAI 当前没有在 Codex 项目文档中公布专属的单文件 MB 上限,但仍会受到模型上下文、读取速度、沙箱权限和工具输出长度等实际限制 |
| 直接附加到聊天 | 在输入框中把文件作为当前聊天的附件添加 | 适合只与这次请求相关、无需长期留在项目目录中的材料;遵循 ChatGPT 文件上传规则 |
严重警告:非常不推荐上传超大文件
附件达到“允许上传”的大小,不代表它适合直接交给模型解析。长 PDF、大型日志、完整代码压缩包或超大表格会占用大量上下文;PDF 还可能同时处理提取文本和页面图像。在按用量计费或消耗 credits 的场景中,这会让模型用量和扣费快速放大,一次任务就可能消耗远超预期的额度。
不要把 512 MB 当作推荐上传大小。 文件越大、内容越复杂、反复分析次数越多,成本失控的风险越高。
推荐做法:本地存放,按需读取
- 大型代码、日志和数据文件放入 Codex 本地项目目录,通过
@文件路径或明确路径引用; - 先让 Codex 统计文件大小、行数、目录或错误类型,再只读取相关片段;
- 必须上传时,先裁剪无关内容、拆分文件,只附加完成当前任务所需的最小范围;
- 对日志和表格优先使用检索、抽样、筛选列和分段分析,避免整份文件反复进入上下文。
ChatGPT 聊天附件的当前硬限制为:
| 文件类型 | 单文件限制 |
|---|---|
| 任意文件 | 最大 512 MB |
| 文本和文档 | 最大 200 万 tokens;表格不适用此 token 限制 |
| CSV 或电子表格 | 约 50 MB,实际大小取决于每行数据量 |
| 图片 | 每张最大 20 MB |
这些数值针对上传到 ChatGPT 对话或 GPT 的文件,不应当被理解为 Codex 读取本地项目文件的专属上限。上传频率、账号存储空间和工作区策略还可能带来额外限制,请以 OpenAI File Uploads FAQ 的最新说明为准。
什么时候应该创建项目
适合创建项目的情况:
- 同一工作会持续多天,需要反复回来继续;
- 研究、实现、测试和文档需要拆成多个聊天;
- 多个聊天都要使用相同的文件、项目说明或外部来源;
- 需要让相关成果集中保存,方便搜索和回顾。
适合直接新建独立聊天的情况:
- 问题可以一次完成;
- 不需要访问项目文件或共享说明;
- 内容与现有项目无关;
- 只是临时查询、解释或短草稿。
TIP
一个项目对应一个长期主题,一个聊天对应一个明确成果。 例如,同一项目里分别建立“需求整理”“接口实现”“测试补充”和“发布说明”聊天,比把全部内容塞进一个超长聊天更容易维护。
ChatGPT 项目和本地项目不是一回事
| 项目类型 | 文件来源 | 适合用途 |
|---|---|---|
| ChatGPT 项目 | 上传到项目的文件、项目说明和已连接的来源 | 网页端协作、资料研究、写作和跨聊天共享来源 |
| Codex 本地项目 | Mac 或 Windows 上添加的一个或多个文件夹 | 代码库、本地文档、日志、数据文件以及需要直接读写文件的任务 |
ChatGPT 网页项目不能直接访问电脑上的任意文件夹。希望多个网页聊天共同使用资料时,应把文件加入项目的 Sources(来源),或连接可用的数据源。
Codex 桌面应用的本地项目可以添加多个相关文件夹。项目的主文件夹会作为新聊天的默认工作目录,也用于 Git 操作以及自动发现 AGENTS.md、Skills 和 config.toml。其他附加文件夹仍可被查找、读取和编辑,但不会自动发现其中的这些项目配置。
共享资料和单次资料怎样选择
- 多个聊天都会使用:放进项目的 Sources,或放在 Codex 本地项目文件夹中。
- 只在当前请求使用:直接附加到聊天。
- 长期执行规则:写入项目说明;代码项目则优先写入
AGENTS.md或仓库文档。 - 个人稳定偏好:使用自定义指令或 ChatGPT / Codex 记忆。
- 来自其他服务的实时资料:使用 Plugins、MCP 或连接器,不要依赖过期的手动副本。
管理项目和聊天
保持侧边栏清晰,可以按下面的方式整理:
- 置顶经常返回的项目和聊天;
- 用成果命名聊天,例如“结算页无障碍审查”,不要只写“新聊天”;
- 在 Codex 桌面应用中使用
Cmd/Ctrl + G搜索历史聊天;网页端使用Cmd/Ctrl + K; - 完成后归档聊天,Codex 桌面应用可从 Settings → Archived chats 恢复;
- 不相关的工作拆到不同项目,减少误读文件和上下文干扰。
置顶只改变显示位置,不会给 ChatGPT 增加上下文,也不会扩大文件访问权限。
一套推荐工作流
- 为长期主题创建项目,并只添加真正相关的文件夹或来源;
- 在项目说明或
AGENTS.md中写清技术约束、常用命令和验收要求; - 每个明确成果新建一个聊天,开头说明目标、相关文件和完成标准;
- 大文件保留在本地项目中,告诉 Codex 先检索、抽样或分段读取;
- 需要跨聊天复用的结论,写回仓库文档或项目来源,不要只留在聊天记录里;
- 完成后要求 Codex 报告修改文件、验证命令和结果,再归档聊天。
处理大型日志时,可以这样提问:
text
请分析 logs/service.log。不要一次输出全文:
1. 先统计错误类型和时间分布;
2. 再按错误类型分段读取相关上下文;
3. 最后给出证据行、可能原因和排查顺序。处理代码项目时,可以这样提问:
text
目标:修复订单重复提交问题。
相关范围:@src/order 和 @tests/order。
约束:不要修改支付模块;先复现,再修复并运行相关测试。
完成时请列出改动文件、测试命令和结果。常见误区
- 把项目当成一个无限长的聊天: 项目负责共享上下文,聊天仍应按成果拆分。
- 把本地文件限制等同于附件限制: 512 MB 等限制适用于 ChatGPT 上传;本地项目通过工作区访问文件。
- 认为添加文件夹就能无限读取: Codex 仍受权限、上下文和工具输出限制,大文件应按需分段处理。
- 把不相关目录全部加入同一项目: 可访问范围越大,检索噪声和误操作风险越高。
- 只依赖聊天历史保存规则: 重要决定、命令和验收标准应写回
AGENTS.md或项目文档。 - 认为置顶会增强记忆: 置顶只影响侧边栏排序,不会改变模型可用的上下文。
