Codex IDE 扩展设置
开发者设置
配置跨 ChatGPT 和 Codex 客户端的开发设置
ChatGPT 桌面应用
ChatGPT 网页版会在 ChatGPT 设置中存储产品和工作区偏好设置。ChatGPT Work 聊天在托管环境中运行，不会读取本地 Codex 配置文件。请使用工作区在 ChatGPT 设置中提供的控件； 工作区管理员可能会代你管理部分设置。
通用设置页面介绍 App 偏好，包括个人资料、键盘快捷键、通知、外观、个性化、记忆和已归档聊天。
项目和终端行为
选择文件的打开位置、聊天中显示多少命令输出，以及默认在哪里打开终端标签页。
代码评审
在 Settings > Git（设置 > Git） 中，通过 Review delivery（评审交付方式） 选择 Inline（内联） 或 Detached（分离）。Inline 会尽可能在当前聊天中运行 /review；Detached 则会启动独立的评审聊天。
IDE 扩展同步
当 ChatGPT 桌面 App 和 IDE 扩展在同一项目中打开时，两者会共享当前聊天和编辑器上下文。在 App 输入框中开启 IDE context（IDE 上下文），可让 Codex 使用当前在编辑器中打开的文件；如果不希望 App 提示词包含这些编辑器上下文，请将其关闭。
你可以从 IDE 扩展打开 App 聊天，也可以在 App 中继续 IDE 聊天。两个产品形态通过同一个项目判断要共享哪些聊天和上下文。
智能体配置
App 中的 Codex 智能体会继承 IDE 扩展和 CLI 使用的同一份配置。常用设置可以通过 App 内控件调整；高级选项则编辑 config.toml。详情参见智能体审批与安全和基础配置。
Git
使用 Git 设置统一分支命名，并选择 Codex 是否可以执行 强制推送。你还可以设置 Codex 生成 提交消息 和 PR 描述时使用的提示词。
集成与 MCP
通过 Model Context Protocol（MCP）连接外部工具。你可以启用推荐的 MCP server，也可以添加自己的 MCP server。如果 MCP server 需要 OAuth，App 会启动认证流程。由于 MCP 配置保存在 config.toml 中，这些设置也会应用于 Codex CLI 和 IDE 扩展。详情参见 Model Context Protocol。
浏览器开发者模式
在 Developer mode（开发者模式） 中开启 Enable full CDP access（启用完整 CDP 访问），ChatGPT 就可以使用 Chrome DevTools Protocol 进行性能分析和更深入的浏览器调试。如果组织已禁用完整 CDP 访问，则无法在本地重新开启。设置方式、风险、审批和管理员要求参见开发者模式。
Codex CLI 从 ~/.codex/config.toml 读取你的个人默认设置。如需
为项目或子文件夹设置专用的覆盖项，请在受信任的项目或子文件夹中添加
.codex/config.toml 文件。CLI 和 IDE 扩展共享这些配置
层。
查看设置
使用以下命令了解当前会话的有效设置：
- 运行
/status，查看当前使用的模型、审批策略、可写根目录和 token 使用量。 - 运行
/debug-config，查看按优先级排列的配置层，以及 托管策略要求的来源。 - 使用
--strict-config启动 Codex，将无法识别的config.toml键视为 错误，而不是将其忽略。
如需完整的交互式命令参考，请参阅开发者命令。
更改单次运行的设置
如果有专用标志，请使用该标志。常见的标志包括 --model、
--sandbox、--ask-for-approval、--profile 和 --search。使用 -c 或
--config 可覆盖单次运行中任何受支持的配置键。
以下模型覆盖设置需要 GPT-6.1 Sol 的访问权限。如果你的账户或工作区
无法使用该模型，请省略 --model 或选择 /model 列出的模型。
请参阅各套餐的 GPT-6.1 Sol 可用性。
codex --model gpt-6.1-sol
codex --profile deep-review
codex --config model_reasoning_effort='"medium"'命令行标志和 --config 值具有最高优先级。如需
完整的标志列表，请参阅开发者命令。
配置层级
CLI 会先应用命令行标志和 --config 覆盖项，再应用项目、
配置档案、用户、系统和内置设置。可利用此优先级顺序，将共享的
默认设置保存在配置文件中，将一次性更改放在命令行中。
如需了解完整的优先级顺序和常用选项，请参阅配置基础。
在 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 自定义。
设置参考资料
Codex IDE 扩展包含两个设置层：
- Codex 设置 控制与 Codex CLI 共享的智能体行为，包括
模型、推理强度、权限、沙箱、MCP server和
个性化设置。Codex 从
config.toml读取这些设置。 - 编辑器设置 控制扩展在 VS Code 和
兼容编辑器中的行为。这些设置使用编辑器设置系统中的
chatgpt.*键。
打开 Codex 设置
在 Codex 侧边栏中选择齿轮图标，然后选择 Codex 设置。使用 设置面板调整常用的智能体控制项，或选择 打开 config.toml， 直接编辑当前配置层。
如需了解配置层的优先级顺序和常用键，请参阅配置
基础。如需查看所有受支持的 config.toml 键，请参阅
配置参考。
更改编辑器设置
要更改设置，请按以下步骤操作：
- 打开编辑器设置。
- 搜索
@ext:openai.chatgpt、Codex或设置名称。 - 更新该值。
该扩展还会在 Codex 聊天界面中遵循 VS Code 的内置聊天字体设置。
编辑器设置参考
| 设置 | 默认值 | 说明 |
|---|---|---|
chatgpt.commentCodeLensEnabled |
true |
在 TODO 注释上方显示 CodeLens，以便 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：当 WSL 可用时，在 WSL 中运行 Codex。如果你的代码仓库和工具位于 WSL2 中，或需要 Linux 原生工具，请使用此设置。更改此设置会重新加载 VS Code。 |
chatgpt.cliExecutable |
未设置 | 仅限开发：设置 Codex CLI 可执行文件的路径。除非你正在开发 Codex CLI，否则无需使用此设置；手动覆盖捆绑的可执行文件可能导致扩展的部分功能无法正常工作。 |
chat.fontSize |
编辑器默认值 | 控制 Codex 侧边栏中的聊天文本，包括聊天内容和输入框。 |
chat.editor.fontSize |
编辑器默认值 | 控制 Codex 聊天中以代码形式呈现的内容，包括代码片段和差异。 |
上述 chatgpt.* 键属于 IDE 扩展，不应写入
config.toml。有关共享的智能体设置，请参阅配置
基础、高级配置
和配置参考。