Appearance
Codex IDE 扩展设置的完整参考手册。大多数基础行为(字体、启动行为、语言)在 VS Code 编辑器设置里调整;模型、审批策略、沙箱等核心 Agent 行为通过共享的 ~/.codex/config.toml 配置,在 App/CLI/IDE 扩展三端生效。
Codex IDE 扩展设置参考
修改设置
- 打开编辑器设置
- 搜索
Codex或设置名称 - 修改值
注意:模型、审批策略、沙箱等核心 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.localeOverride | Codex 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 里切换。详见 基础配置。