开发者设置

如需完整文档索引，请参阅 llms.txt。文档页面的 Markdown 版本可通过在页面后追加 .md 来获取 URL。

ChatGPT 网页端将产品和工作区偏好设置存储在 ChatGPT 设置中。 ChatGPT Work 聊天在托管环境中运行，不会读取本地 Codex 配置文件。请使用你的工作区在 ChatGPT 设置中提供的控件；工作区管理员可能会为你管理某些设置。

常规设置页面涵盖应用偏好设置，包括个人资料、键盘快捷键、通知、外观、个性化、记忆和已归档聊天。

项目和终端行为

选择文件打开的位置、聊天中显示多少命令输出，以及终端标签页默认打开的位置。

代码审查

在 设置 > Git下，使用 审查交付 选择内联以在可能时 /review 在当前聊天中运行，或选择分离以启动单独的审查聊天。

IDE 扩展同步

当 ChatGPT 桌面应用和 IDE 扩展在同一项目中打开时，它们会共享活动聊天和编辑器上下文。请在应用 IDE 编写器中开启上下文 ，以允许使用 Codex 编辑器中当前打开的文件。当你希望应用提示排除该编辑器上下文时，请将其关闭。

你可以从 IDE 扩展中打开应用聊天，并在 IDE 应用中继续聊天。两个界面都使用同一项目来确定要共享哪些聊天和上下文。

Agent 配置

Codex 应用中的 agent 会继承与 IDE 扩展和 CLI相同的配置。请使用应用内控件管理常用设置，或编辑 config.toml 以配置高级选项。详见 Agent 审批和安全以及配置基础。

Git

使用 Git 设置来标准化分支命名，并选择 Codex 是否使用强制推送。你还可以设置提示词，供 Codex 用来生成提交消息和拉取请求描述。

集成和 MCP

通过 Model Context Protocol （MCP）连接外部工具。启用推荐的服务器，或添加你自己的服务器。如果服务器需要 OAuth，应用会启动身份验证流程。这些设置也适用于 Codex CLI 和 IDE 扩展，因为 MCP 配置位于 config.toml中。详见 Model Context Protocol 。

浏览器开发者模式

在 开发者模式下，开启 启用完整 CDP 访问权限 ，以允许 ChatGPT 使用 Chrome DevTools 协议进行性能分析和更深入的浏览器调试。如果你的组织已禁用完整 CDP 访问权限，你无法在本地启用它。有关设置、开发者模式风险、审批和管理员要求，详见。

Codex CLI 从以下位置读取你的个人默认设置 ~/.codex/config.toml。添加一个 .codex/config.toml 文件到受信任的项目或子文件夹中，当你需要项目专用覆盖设置时使用。 CLI 和 IDE 扩展共享这些配置层。

检查你的设置

使用这些命令了解当前会话的生效设置：

运行 /status 以查看当前模型、审批策略、可写根目录和令牌用量。
运行 /debug-config 以按优先级顺序查看配置层，以及托管策略要求的来源。
启动 Codex 并使用 --strict-config 将无法识别的 config.toml 键视为错误，而不是忽略它们。

请参阅开发者命令以获取完整的交互式命令参考。

为单次运行更改设置

当存在专用标志时，请使用该标志。常见示例包括 --model、 --sandbox、 --ask-for-approval、 --profile，以及 --search。使用 -c 或 --config 为单次运行覆盖任何受支持的配置键：

codex --model gpt-5.5
codex --profile deep-review
codex --config model_reasoning_effort='"high"'

命令行标志和 --config 值具有最高优先级。完整标志列表请参阅完整标志列表，请参阅开发者命令。

配置层

该 CLI 会先应用命令行标志和 --config 覆盖值，然后再应用项目、 profile、用户、系统和内置设置。利用该优先级，将共享默认值保存在配置文件中，并将一次性更改放在命令行中。

完整顺序和常用选项请参阅配置基础。

在以下位置更改设置 TUI

交互式终端 UI 为常见会话和显示设置提供选择器：

目标	命令	相关配置
选择模型	`/model`	`model`， `model_reasoning_effort`
更改权限	`/permissions`	审批和沙箱设置
选择响应风格	`/personality`	`personality`
配置可选工具	`/experimental`， `/memories`	特定功能的 `config.toml` 键
自定义终端 UI	`/keymap`， `/statusline`， `/title`， `/theme`	以下位置的键 `[tui]`
设置编辑默认值	`/vim`， `/raw`	`tui.vim_mode_default`， `tui.raw_output_mode`

有些命令只应用于当前会话，而有些选择器会提供保存选择的选项。当你希望为未来会话设置默认值时，请设置相关配置键。关于终端主题、编辑器、补全和快捷键工作流，请参阅 CLI 自定义。

设置参考

高级配置涵盖 profile、一次性覆盖以及其他高级工作流。
配置参考列出可用的键和值。
示例配置提供完整的示例文件。
环境变量记录了以下内容使用的变量： CLI 以及安装程序。

该 Codex IDE extension 有两个设置层：

Codex 设置 控制与以下内容共享的 agent 行为： Codex CLI，包括模型、推理强度、权限、沙箱、 MCP 服务器，以及个性化。 Codex 从以下位置读取这些设置： config.toml。
编辑器设置 控制扩展在 VS Code 和兼容编辑器中的行为。这些设置使用 chatgpt.* 编辑器设置系统中的键。

打开 Codex 设置

选择 Codex 侧边栏中的齿轮图标，然后选择 Codex 设置。使用设置面板来进行常见 agent 控制，或选择 打开 config.toml 以直接编辑当前配置层。

关于配置层顺序和常用键，请参阅配置基础。关于每个受支持的 config.toml 键，请参阅配置参考。

更改编辑器设置

要更改设置，请按以下步骤操作：

打开你的编辑器设置。
搜索 @ext:openai.chatgpt、 Codex，或设置名称。
更新该值。

该扩展还会遵循 VS Code 内置的聊天字体设置，用于 Codex 聊天界面。

编辑器设置参考

设置	默认值	说明
`chatgpt.commentCodeLensEnabled`	`true`	显示 CodeLens 在 `TODO` 评论上方，以便 Codex 可以处理它们。
`chatgpt.openOnStartup`	`false`	聚焦 Codex 侧边栏，当扩展完成启动时。
`chatgpt.followUpQueueMode`	`queue`	选择运行期间发送的消息是等待下一次运行（`queue`），还是引导当前运行（`steer`）。该扩展会将旧版 `interrupt` 值视为 `steer`。按 `Cmd`/`Ctrl`+`Shift`+`Enter` 可为单条消息反转该行为。
`chatgpt.composerEnterBehavior`	`enter`	选择 `Enter` 是否始终发送（`enter`）、 `Cmd`/`Ctrl`+`Enter` 是否发送多行提示词（`cmdIfMultiline`），或是否始终需要修饰键（`cmdAlways`）。
`chatgpt.reviewDelivery`	`inline`	运行 `/review` 尽可能在当前聊天中（`inline`）或启动单独的审查聊天（`detached`）。
`chatgpt.localeOverride`	自动	设置 Codex UI的首选语言。留空可自动检测。
`chatgpt.runCodexInWindowsSubsystemForLinux`	`false`	仅限 Windows：运行 Codex 在 WSL 中，当 WSL 可用时。如果你的仓库和工具链位于 WSL2 中，或你需要 Linux 原生工具，请使用此设置。更改此设置会重新加载 VS Code。
`chatgpt.cliExecutable`	未设置	仅开发用途：设置 Codex CLI 可执行文件的路径。除非你正在开发 Codex CLI，否则不需要此设置；手动覆盖捆绑的可执行文件可能会导致扩展的部分功能无法工作。
`chat.fontSize`	编辑器默认值	控制 Codex 侧边栏中的聊天文本，包括聊天内容和输入框。
`chat.editor.fontSize`	编辑器默认值	控制 Codex 聊天中以代码形式渲染的内容，包括代码片段和差异。

上述 chatgpt.* 键属于 IDE 扩展，不应放入 config.toml。对于共享 agent 设置，请使用配置基础、高级配置，以及配置参考。