项目和聊天
如需完整文档索引,请参阅 llms.txt。文档页面的 Markdown 版本可通过在页面后追加
.md来获取 URL。
使用项目来组织相关聊天,并为 ChatGPT 提供所需的上下文。 在 项目 视图中, ChatGPT 桌面应用包含 ChatGPT 项目和 连接到你电脑上文件夹的本地项目。
选择一个项目,或不使用项目直接开始
Section titled “选择一个项目,或不使用项目直接开始”当工作会持续一段时间、产生多个 输出,或依赖相同文件和来源时,请创建项目。当工作本身完整且不需要共享项目上下文时, 无需项目即可开始聊天。
使用项目将相关聊天、文件、指令和来源放在一起。 同一个项目可以包含通过 Chat 或 ChatGPT Work发起的聊天。
选择项目或不使用项目聊天
Section titled “选择项目或不使用项目聊天”当工作会持续一段时间、会产生多个 输出,或依赖相同文件和来源时,请创建项目。当工作自成一体 且不需要共享项目上下文时,可以不使用项目开始聊天。
每个项目都有一个 聊天 部分,用于列出项目聊天,以及一个 来源 部分,用于上传的文件和已连接的上下文。项目指令会应用于 其所有聊天。 ChatGPT 项目不会提供对你电脑上文件夹的 直接访问权限,因此请上传或连接你想要 ChatGPT 使用的来源。
无论选择哪种方式,都请从项目中发起新聊天,以使用其共享文件和 指令,然后在 聊天下返回该聊天。
Codex CLI 会将你启动它所在的目录视为该聊天的项目。
请在你想要 codex 工作的目录中运行 Codex ,或传入
--cd <directory> (-C)来明确设置它。 CLI 不会显示
ChatGPT 项目视图。
该 IDE 扩展会将你的 IDE 中打开的文件夹或工作区视为本地 项目。在多根工作区中,请为聊天选择工作区根目录。该 扩展不会显示 ChatGPT 网页或桌面应用中的项目视图。
在项目中工作
Section titled “在项目中工作”该 项目 视图会将 ChatGPT 项目和本地项目集中到一处。 ChatGPT 项目会在相关聊天之间携带项目文件和上下文。本地 项目让聊天能够访问你电脑上的一个或多个文件夹,例如 一组源文件或一个代码库。
为每个不同的结果单独开启聊天,这样其消息和结果就能保持 聚焦,同时项目会保持相关工作的有序组织。
交互内容: CodexScreenshot 的动态演示请参阅页面顶部的官方原文链接。
在项目中工作
Section titled “在项目中工作”一个 ChatGPT 项目会让其聊天访问相同的已上传文件、项目 指令和已连接来源。使用 Chat 进行快速聊天,或使用 ChatGPT Work 处理更大的交付物;两者都会作为聊天显示在项目的 聊天 部分中。为每个不同的结果单独开启聊天,这样其 消息和结果就能保持聚焦,同时项目会保留共享上下文。
在项目目录中工作
Section titled “在项目目录中工作”从应提供聊天文件上下文的目录启动 Codex 。使用
/new 为每个不同结果发起单独聊天。使用 /resume 当
Codex 处于打开状态时,或运行 codex resume,以继续已保存的聊天。
聊天会保留其转录记录和已记录的工作目录,而 Codex 会读取
当前工作树中的文件。请将持久的项目指导保存在
AGENTS.md 或已检入的文档中,以便未来聊天使用。
在工作区中工作
Section titled “在工作区中工作”打开应提供聊天文件上下文的文件夹或工作区。为每个不同结果发起 一个新聊天,然后从 最近聊天 中选择它以 继续。相同项目中的聊天可以使用相同文件,而每个 聊天都会保留自己的转录记录。
当前选择和打开的文件会为当前轮次提供上下文。请将
持久的项目指导保存在 AGENTS.md 或已检入的文档中,以便
未来聊天使用。
整理项目和聊天
Section titled “整理项目和聊天”让活跃工作保持可见,并把已完成工作移到一旁:
- 固定项目 可将其保留在侧边栏靠上的位置。你也可以 从项目视图固定它。
- 固定聊天 适用于你经常返回该聊天的情况,即使更新的聊天显示在 项目中。
- 重命名聊天 使用一个简短标题描述其结果,例如“Q3 发布简报”或“Checkout 无障碍评审”。
- 搜索项目 从项目视图进行。按 Cmd/Ctrl+G 在你记得某个短语或分支名称但 不记得标题时搜索过去的聊天。
- 归档聊天 适用于你完成工作时。从项目菜单中选择 归档聊天 可一起归档其聊天。
固定不会添加上下文,也不会改变 ChatGPT 可访问的内容。它只会改变 项目或聊天在侧边栏中的显示位置。
从 设置 > 已归档聊天恢复已归档聊天。
整理项目和聊天
Section titled “整理项目和聊天”让活跃工作保持可见,并把已完成工作移到一旁:
- 固定项目 可将其保留在侧边栏靠上的位置。你也可以 从项目视图固定它。
- 固定聊天 适用于你经常返回该聊天的情况,即使更新的聊天显示在 项目中。
- 重命名聊天 使用一个简短标题描述其结果,例如“Q3 发布简报”或“Checkout 无障碍评审”。
- 搜索项目 从项目视图进行。使用 Cmd/Ctrl+K 在你记得某个短语或 分支名称但不记得标题时搜索过去的聊天。
- 归档聊天 适用于你完成工作时。
固定不会添加上下文,也不会改变 ChatGPT 可访问的内容。它只会改变 项目或聊天在侧边栏中的显示位置。
从 设置 > 数据控制 > 已归档聊天恢复已归档聊天。
将本地项目用于文件夹和代码库
Section titled “将本地项目用于文件夹和代码库”当 ChatGPT 需要读取或更改你电脑上的文件时,添加本地项目。 项目不需要文件夹,但你可以按需附加文件夹。
要添加或更改文件夹,请打开项目菜单并选择 编辑项目。 选择 添加文件夹 以附加多个文件夹。 ChatGPT 可以读取和更改 每个已附加文件夹中的文件。要更改默认工作目录,请指向一个 文件夹并选择 设为主文件夹。
新聊天会从主文件夹开始。 Codex 也会将该文件夹用于 Git
操作以及自动发现 AGENTS.md、技能和 config.toml。
辅助文件夹仍可用于文件搜索、读取和编辑,但
Codex 不会从辅助
文件夹自动发现这些项目文件。
当相关工作位于不同位置时使用多个文件夹,例如一个应用和 其文档,或一个网站和其后端。对于 无关工作,或当每个聊天应只访问仓库的一部分时,请创建单独的项目。 这会让工作上下文保持聚焦。远程项目目前支持一个 文件夹。
使用 本地环境 为项目定义设置 操作和常用命令。Git 评审、拉取请求和 worktree 操作会以主 仓库为目标。当你在 worktree 中发起聊天时,其他文件夹仍会 保持附加。
项目和 worktree 用于整理工作,但 沙箱 会强制限制本地命令可读取、更改或通过网络访问的内容。
不使用项目开始聊天
Section titled “不使用项目开始聊天”选择 新建聊天 当工作本身完整且不需要共享 项目文件、指令或文件夹访问权限时使用。当多个聊天将依赖相同上下文时, 请先创建项目。
不使用项目开始聊天
Section titled “不使用项目开始聊天”从 ChatGPT 主页开始聊天,当该聊天不需要共享项目 文件、指令或来源时。你可以使用 Chat 或 ChatGPT Work;在网页上, 两者都会创建聊天。
如果工作范围扩大,请将其移入项目,并为每个 结果使用清晰的聊天名称。项目可以容纳用于研究、起草、评审和 后续跟进的并行聊天,而不会把每条消息混在同一个上下文中。
使用快速聊天提一个快速问题
Section titled “使用快速聊天提一个快速问题”快速聊天会打开一个普通的 ChatGPT 聊天。 ChatGPT 聊天不会显示在 Codex 侧边栏中,侧边栏包含你的 Codex 聊天和项目。
指向 新建聊天,然后选择其右侧的 快速聊天 图标。你 也可以按
Cmd+Option+N 在 macOS 上,或 Ctrl+Alt+N 在 Windows 上。从 新建 聊天中,你可以打开一个现有的 ChatGPT 聊天并将其添加到一个 Codex 聊天。
引入其他工具和上下文
Section titled “引入其他工具和上下文”-
直接将文件或 图像输入 附加到聊天 ,当它们只适用于该请求时。
-
安装 插件 ,以从其他 服务引入上下文和操作。
-
配置 MCP 服务器,当你的组织或开发者设置 通过 Model Context Protocol公开工具时。
-
使用 记忆(如可用),将有用上下文从 过去工作带入未来聊天。
-
将 图像输入 传递给聊天,当视觉上下文 只适用于该请求时。
-
安装 插件 ,以从其他 服务引入上下文和操作。
-
配置 MCP 服务器,当你的组织或开发者设置 通过 Model Context Protocol公开工具时。
-
使用 记忆(如可用),将有用上下文从 过去工作带入未来聊天。
-
引用打开的文件或在编辑器中选择代码,以为 当前轮次添加上下文。
-
配置 MCP 服务器,当你的组织或开发者设置 通过 Model Context Protocol公开工具时。
-
使用 记忆 来自已连接的 Codex 宿主(如 可用),将有用上下文带入未来聊天。
-
将文件和已连接来源添加到项目的 来源 部分,当它们 应可供其所有聊天使用时。
-
直接将文件或 图像输入 附加到聊天,当 它们只适用于该聊天时。
-
在 ChatGPT Work中,安装 插件 ,以从其他服务引入上下文和 操作。
-
使用 记忆(如可用),将有用上下文从 过去工作带入未来聊天。