调整 IDE 扩展设置

Codex IDE extension settings 是编辑器里的 Codex 体验层：字体、侧边栏启动、语言偏好、待办 CodeLens、Windows WSL 运行方式。它不是 Codex 的全部配置中心。

真正影响 agent 执行边界的默认模型、approval policy、sandbox mode、network access 等，仍然属于共享的 ~/.codex/config.toml。IDE settings 负责编辑器体验，config.toml 负责 Codex CLI 和 IDE extension 共用的执行策略。

flowchart TB
    User["👤 想调整 Codex 行为"]
    Q{"调整什么？"}
    A["📺 UI / 字号 / 启动行为<br/>语言 / WSL 开关"]
    B["🔐 模型 / approval<br/>sandbox / 网络访问"]
    C["⚡ 临时切模式<br/>临时聚焦本任务"]
    IDE["IDE extension settings<br/>VS Code / Cursor / Windsurf"]
    TOML["~/.codex/config.toml<br/>CLI 与 IDE 共享"]
    Session["Codex 面板 / slash<br/>启动参数"]

    User --> Q
    Q -->|UI 体验| A --> IDE
    Q -->|执行边界| B --> TOML
    Q -->|本次会话| C --> Session

Change a setting

修改设置按下面步骤：

1. 打开 editor settings（编辑器设置）。
2. 搜索 Codex 或具体 setting name（设置名）。
3. 更新 value（值）。

Codex IDE extension 底层使用 Codex CLI。有些行为不在 editor settings 里配置，而是在共享的 ~/.codex/config.toml 文件中配置，例如：

• default model（默认模型）
• approval policy（审批策略）
• sandbox settings（沙箱设置）
• network access（网络访问）

配置基础见：

https://developers.openai.com/codex/config-basic

Extension 也会遵循 VS Code 内置 chat font settings（聊天字体设置），用于 Codex conversation surfaces（对话界面）。

设置分层

实际配置时先分清三层：

这种分层的好处是：团队可以把安全和执行边界写进 config.toml 或 managed config，本地用户仍然可以微调 IDE 使用体验，不会把 UI 习惯误当成安全策略。

Settings reference

关键设置怎么选

聊天和代码字号

如果你觉得 Codex 面板里的正文太小，先改 chat.fontSize。如果只是代码块、diff、inline code 的字号不合适，改 chat.editor.fontSize。

这两个设置来自 VS Code 内置 chat font settings，Codex extension 会遵循它们。它们只影响阅读体验，不影响模型输出、不影响上下文大小，也不改变 diff 的实际内容。

CLI executable

chatgpt.cliExecutable 是 development-only 设置。普通用户不要配置它。

只有在你正在开发 Codex CLI 本身，或者需要让 extension 指向本地构建的 CLI binary 时，才需要设置这个路径。手动指向错误的 executable，可能导致 IDE extension 的部分能力表现异常，例如版本不匹配、命令不可用、面板状态不同步。

待办 CodeLens

chatgpt.commentCodeLensEnabled 会在待办注释上方显示入口，让你可以直接让 Codex 处理选中的待办项。

适合打开的场景：

• 团队习惯把小修复写成待办注释。
• 你希望从代码附近直接发起任务，不想先复制上下文到 chat。
• 你在整理技术债，希望逐条把待办变成可执行任务。

不适合打开的场景：

• 仓库里历史待办注释很多，编辑器界面已经很拥挤。
• 团队把待办注释当作长期注释，而不是行动项。
• 你正在录屏或演示，不希望页面出现额外 CodeLens。

Language override

chatgpt.localeOverride 控制 Codex UI 的首选语言。留空时自动检测。

教程站、双语团队或中文开发者常见做法是：UI 可以保持中文，但 prompt、命令、文件路径、错误文本保留英文原文。这样既方便阅读，也不丢失技术细节。

Open on startup

chatgpt.openOnStartup 会在 extension 启动完成后聚焦 Codex sidebar。

如果你的 IDE 主要用来和 Codex 协同开发，可以打开；如果你经常只想快速看代码，建议关闭，避免每次启动都打断当前文件视图。

Windows WSL 模式

chatgpt.runCodexInWindowsSubsystemForLinux 是 Windows-only 设置。开启后，只要 WSL 可用，Codex 就在 WSL 中运行。

适合开启：

• 仓库实际位于 WSL2 文件系统。
• 构建、测试、包管理都依赖 Linux 工具链。
• 你希望 IDE extension 的命令、审批、文件访问语义和 Linux sandbox 更一致。

适合保持关闭：

• 仓库和工具链都在 Windows 原生环境。
• 你正在使用 Windows sandbox。
• 团队成员不统一使用 WSL2，配置后反而增加环境差异。

修改这个设置会 reload VS Code 才生效。

推荐配置流程

1. 先安装 Codex IDE extension，并确认能登录。
2. 打开一个真实项目，用默认设置完成一次小任务，例如解释项目结构。
3. 只调整 UI 类设置：字号、语言、是否启动自动打开。
4. 如果是在 Windows 上，再决定是否强制 WSL2。
5. 把模型、sandbox、approval、network access 放回 ~/.codex/config.toml 管理。
6. 调整后重开 IDE，跑一次只读任务和一次小 diff 任务确认行为符合预期。

常见误区

自检清单

• 你是否知道哪些设置属于 IDE，哪些属于 ~/.codex/config.toml？
• Windows 用户是否确认仓库位置和工具链是在 Windows 还是 WSL2？
• 是否避免给 chatgpt.cliExecutable 配一个不确定的路径？
• 调整后是否至少跑过一次只读任务和一次小修改任务？
• 团队共享配置是否没有被个人 UI 偏好污染？

官方资料

• Codex IDE extension
• Codex IDE extension settings
• Config basics

接下来去哪