跳转到内容

本地环境

身份 非官方简体中文镜像
翻译状态 AI 翻译 / AI 审校
来源版本 官方未提供
同步日期 2026-07-26
官方原文 learn.chatgpt.com

本地环境可让你为工作树配置设置步骤,以及项目的常见操作。

本地环境仅在 ChatGPT 桌面应用中的 Codex 里可用。请先选择 Codex,然后再配置或使用本地环境。

你可以通过 ChatGPT 桌面应用设置面板配置本地环境。你可以将生成的文件提交到项目的 Git 仓库中,与其他人共享。

Codex 将此配置存储在项目根目录的 .codex 文件夹中。如果你的代码仓库包含多个项目,请打开包含共享 .codex 文件夹的项目目录。

由于工作树运行在与本地聊天不同的目录中,项目可能未完成全部设置,也可能缺少未提交到代码仓库的依赖项或文件。每次新聊天开始时,Codex 创建新的工作树后,设置脚本会自动运行。

使用此脚本运行配置环境所需的命令,例如安装依赖项或运行构建流程。

例如,对于 TypeScript 项目,你可能希望使用设置脚本安装依赖项并执行初始构建:

Terminal window
npm install
npm run build

如果设置过程与平台相关,请分别为 macOS、Windows 或 Linux 定义设置脚本,以覆盖默认设置。

使用操作定义常见任务,例如启动应用的开发服务器或运行测试套件。这些操作会显示在 ChatGPT 桌面应用的顶部栏中,方便快速访问。操作会在应用的集成终端中运行。

操作有助于避免重复输入常见命令,例如触发项目构建或启动开发服务器。对于一次性的快速调试,你可以直接使用集成终端。

ChatGPT 桌面应用设置中显示的项目操作列表

ChatGPT 桌面应用设置中显示的项目操作列表

例如,对于 Node.js 项目,你可以创建一个包含以下脚本的“运行”操作:

Terminal window
npm start

如果操作中的命令与平台相关,请分别为 macOS、Windows 和 Linux 定义平台专用脚本。

为便于识别操作,请为每个操作选择一个相关图标。

在 Codex 中,ChatGPT 桌面应用会在每个本地项目和工作树旁提供常用的 Git 控件。差异面板会显示当前检出内容中的更改,并允许你添加行内评论,让 Codex 处理这些评论。你可以暂存或还原单个代码块,暂存或还原整个文件,提交更改、推送分支,以及创建拉取请求,而无需离开应用。

对于应用中未提供的 Git 操作,请使用集成终端。如需将并发更改与本地检出内容隔离,请在工作树中启动任务。

Codex 环境摘要面板