跳到主要内容

本文为非官方中文翻译,内容以 OpenAI 官方英文文档为准。
官方来源:https://developers.openai.com/codex/app/settings

Codex 应用设置

配置 Codex 应用的行为和偏好设置

使用设置面板来调整 Codex 应用的行为、打开文件的方式以及连接工具的方式。从应用菜单打开 Settings,或按 Cmd+,。

常规

选择文件打开的位置以及线程中显示多少命令输出。你还可以要求多行提示词使用 Cmd+Enter,或在线程运行时防止设备进入睡眠。

通知

选择何时显示轮次完成通知,以及应用是否应提示获取通知权限。

Agent 配置

应用中的 Codex agents 会继承与 IDE 和 CLI 扩展相同的配置。常见设置可使用应用内控件,高级选项可编辑 config.toml。更多详情请参阅 Codex securityconfig basics

外观

Settings 中,你可以通过选择基础主题、调整强调色、背景色和前景色,以及更改 UI 和代码字体来更改 Codex 应用的外观。你还可以与朋友分享你的自定义主题。

Codex 应用外观设置,显示主题选择、颜色控件和字体选项

Codex pets

Codex pets 是应用的可选动画伙伴。在 Settings 中, 前往 Appearance,然后选择 Pets 以选择内置 pet,或 从你的本地 Codex home 刷新自定义 pets。在 编辑器中输入 /pet,在 Settings > Appearance 中使用 Wake PetTuck Away Pet,或 按 Cmd+K 或 Ctrl+K 并运行相同的命令, 以切换浮动覆盖层。

该覆盖层会在你使用其他应用时保持可见的活动 Codex 工作。它 会显示活动线程,反映 Codex 是正在运行、等待输入还是已准备好审查, 并将该状态与简短的进度提示配对, 这样你无需重新打开线程也能快速了解发生了哪些变化。

要创建你自己的 pet,请安装 hatch-pet skill:

$skill-installer hatch-pet

从命令菜单重新加载 skills。按 Cmd+K 或 Ctrl+K, 选择 Force Reload Skills,然后让该 skill 创建一个 pet:

$hatch-pet create a new pet inspired by my recent projects

Git

使用 Git 设置来标准化分支命名,并选择 Codex 是否使用强制推送。 你还可以设置 Codex 用于生成提交消息和拉取请求描述的提示词。

Integrations & MCP

通过 MCP (Model Context Protocol) 连接外部工具。启用推荐的服务器或添加你自己的服务器。如果某个服务器需要 OAuth,应用会启动认证流程。由于 MCP 配置保存在 config.toml 中,这些设置也适用于 Codex CLI 和 IDE 扩展。详情请参阅 Model Context Protocol docs

浏览器使用

使用这些设置来安装或启用捆绑的 Browser 插件、设置 Codex Chrome extension,以及管理允许列表和阻止列表中的网站。除非你已将某个网站加入允许列表,否则 Codex 在使用该网站前会先询问。将某个网站从阻止列表中移除后,Codex 会再次在浏览器中使用它之前先征求你的许可。

有关浏览器预览、评论和浏览器使用工作流,请参阅 In-app browser

Computer Use

在 macOS 上,设置完成后,请检查你的 Computer Use 设置,以查看桌面应用访问权限及相关偏好。要撤销系统级访问权限,请在 macOS 的 Privacy & Security 设置中更新 Screen Recording 或 Accessibility 权限。该功能在发布时不适用于 EEA、英国或瑞士。

个性化

选择 FriendlyPragmaticNone 作为你的默认个性。使用 None 可禁用个性指令。你可以随时更新此设置。

你还可以添加自己的自定义指令。编辑自定义指令会更新你在 AGENTS.md 中的个人指令

上下文感知建议

使用上下文感知建议,在你开始使用或返回 Codex 时展示你可能想要继续的后续事项和任务。

Memories

在可用时启用 Memories,让 Codex 将过去线程中的有用上下文带入未来的工作。有关设置、存储和按线程控制,请参阅 Memories

已归档线程

Archived threads 部分会列出已归档的聊天及其日期和项目上下文。使用 Unarchive 可恢复线程。