Skip to content

Codex IDE 扩展设置的完整参考手册。大多数基础行为(字体、启动行为、语言)在 VS Code 编辑器设置里调整;模型、审批策略、沙箱等核心 Agent 行为通过共享的 ~/.codex/config.toml 配置,在 App/CLI/IDE 扩展三端生效。

Codex IDE 扩展设置参考

修改设置

  1. 打开编辑器设置
  2. 搜索 Codex 或设置名称
  3. 修改值

注意:模型、审批策略、沙箱等核心 Agent 行为通过共享配置文件 ~/.codex/config.toml 配置,而不是在编辑器设置里。这些配置同时对 Codex App、CLI 和 IDE 扩展生效。详见 基础配置

扩展也会使用 VS Code 内置的 chat 字体设置。


设置项参考

设置名说明
chat.fontSize控制 Codex 侧边栏的对话文字大小,包括对话内容和输入框
chat.editor.fontSize控制对话中代码渲染内容的字体大小,包括代码片段和 diff
chatgpt.cliExecutable仅供开发使用:指定 Codex CLI 可执行文件路径。除非正在开发 Codex CLI,否则不需要设置。手动设置后部分扩展功能可能无法正常工作
chatgpt.commentCodeLensEnabled在 TODO 注释上方显示 CodeLens,方便用 Codex 直接完成待办任务
chatgpt.localeOverrideCodex UI 的首选语言。留空则自动检测
chatgpt.openOnStartup扩展启动完成时自动聚焦 Codex 侧边栏
chatgpt.runCodexInWindowsSubsystemForLinux仅 Windows:可用时在 WSL 里运行 Codex。推荐开启以获得更好的沙箱安全性和性能。Codex Agent 模式在 Windows 上目前需要 WSL。修改此设置会重新加载 VS Code

常见问题

Q: 改了 chatgpt.runCodexInWindowsSubsystemForLinux 为什么没有立即生效?

A: 这个设置修改后需要 VS Code 重新加载才能生效,编辑器会自动提示重新加载。

Q: chatgpt.commentCodeLensEnabled 开启后会在所有注释上都显示 CodeLens 吗?

A: 只在 TODO 风格的注释上显示(如 // TODO: 开头的注释),不会在所有注释上显示。

Q: 我想改默认模型,应该在哪里改?

A: 在 ~/.codex/config.toml 里配置 model 字段,这样 Codex App、CLI 和 IDE 扩展三端都会统一使用这个默认模型,不需要每次在 UI 里切换。详见 基础配置