开发者设置

身份 非官方简体中文镜像

翻译状态 AI 翻译

来源版本 官方未提供

同步日期 2026-07-31

官方原文 learn.chatgpt.com

如需完整文档索引，请参阅 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 键，请参阅 配置参考。

更改编辑器设置

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

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

该扩展还会遵循 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 设置，请使用 配置 基础、 高级配置， 以及 配置参考。