Skip to content

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 或连接器,不要依赖过期的手动副本。

管理项目和聊天

保持侧边栏清晰,可以按下面的方式整理:

  1. 置顶经常返回的项目和聊天;
  2. 用成果命名聊天,例如“结算页无障碍审查”,不要只写“新聊天”;
  3. 在 Codex 桌面应用中使用 Cmd/Ctrl + G 搜索历史聊天;网页端使用 Cmd/Ctrl + K
  4. 完成后归档聊天,Codex 桌面应用可从 Settings → Archived chats 恢复;
  5. 不相关的工作拆到不同项目,减少误读文件和上下文干扰。

置顶只改变显示位置,不会给 ChatGPT 增加上下文,也不会扩大文件访问权限。

一套推荐工作流

  1. 为长期主题创建项目,并只添加真正相关的文件夹或来源;
  2. 在项目说明或 AGENTS.md 中写清技术约束、常用命令和验收要求;
  3. 每个明确成果新建一个聊天,开头说明目标、相关文件和完成标准;
  4. 大文件保留在本地项目中,告诉 Codex 先检索、抽样或分段读取;
  5. 需要跨聊天复用的结论,写回仓库文档或项目来源,不要只留在聊天记录里;
  6. 完成后要求 Codex 报告修改文件、验证命令和结果,再归档聊天。

处理大型日志时,可以这样提问:

text
请分析 logs/service.log。不要一次输出全文:
1. 先统计错误类型和时间分布;
2. 再按错误类型分段读取相关上下文;
3. 最后给出证据行、可能原因和排查顺序。

处理代码项目时,可以这样提问:

text
目标:修复订单重复提交问题。
相关范围:@src/order 和 @tests/order。
约束:不要修改支付模块;先复现,再修复并运行相关测试。
完成时请列出改动文件、测试命令和结果。

常见误区

  • 把项目当成一个无限长的聊天: 项目负责共享上下文,聊天仍应按成果拆分。
  • 把本地文件限制等同于附件限制: 512 MB 等限制适用于 ChatGPT 上传;本地项目通过工作区访问文件。
  • 认为添加文件夹就能无限读取: Codex 仍受权限、上下文和工具输出限制,大文件应按需分段处理。
  • 把不相关目录全部加入同一项目: 可访问范围越大,检索噪声和误操作风险越高。
  • 只依赖聊天历史保存规则: 重要决定、命令和验收标准应写回 AGENTS.md 或项目文档。
  • 认为置顶会增强记忆: 置顶只影响侧边栏排序,不会改变模型可用的上下文。

官方资料

iKun API 使用、接入与故障排查文档