调整 App 设置
Codex App 的 settings panel 用来调整 App 行为、文件打开方式,以及外部工具连接方式。
Codex App 的 settings panel 用来调整 App 行为、文件打开方式,以及外部工具连接方式。
打开方式:
- 在 App menu 中打开 Settings。
- 使用快捷键
Cmd+,。
General
General 设置用于控制文件在哪里打开,以及 thread 中显示多少 command output。
你也可以在这里启用两个常用行为:
- multiline prompts 必须按
Cmd+Enter才发送。 - thread 正在运行时,阻止电脑 sleep。
通知
Notifications 设置用于选择 turn completion notifications 何时出现,以及 App 是否要提示 notification permissions。
Agent configuration
Codex App 中的 agents 会继承和 IDE、CLI extension 相同的 configuration。
常用设置可以在 App 内直接调整;高级选项仍然编辑 config.toml。
相关官方文档:
- Codex security:https://developers.openai.com/codex/agent-approvals-security
- Config basics:https://developers.openai.com/codex/config-basic
Appearance
在 Settings 中,你可以调整 Codex App 的外观:
- base theme
- accent color
- background color
- foreground color
- UI font
- code font
你也可以把 custom theme 分享给朋友。
官方截图:
- light:https://developers.openai.com/images/codex/app/theme-selection-light.webp
- dark:https://developers.openai.com/images/codex/app/theme-selection-dark.webp
Codex pets
Codex pets 是 App 中可选的 animated companions。
选择方式:
- 打开 Settings。
- 进入 Appearance。
- 选择 Pets。
- 选择 built-in pet,或从本地 Codex home refresh custom pets。
你也可以用这些方式控制 floating overlay:
- 在 composer 中输入
/pet。 - 在 Settings > Appearance 中使用 Wake Pet 或 Tuck Away Pet。
- 按
Cmd+K或Ctrl+K打开 command palette,运行同样的 commands。
overlay 会让 active Codex work 在你使用其他 apps 时仍保持可见。它会显示 active thread,反映 Codex 当前是 running、waiting for input,还是 ready for review,并配合一段短 progress prompt,让你不用重新打开 thread 也能看到发生了什么。
要创建自己的 pet,先安装 hatch-pet skill:
$skill-installer hatch-pet然后从 command menu reload skills:
- 按
Cmd+K或Ctrl+K。 - 选择 Force Reload Skills。
- 让 skill 创建 pet:
$hatch-pet create a new pet inspired by my recent projectsGit
Git settings 可以统一 branch naming,并选择 Codex 是否使用 force pushes。
你也可以设置 Codex 生成 commit messages 和 pull request descriptions 时使用的 prompts。
Integrations & MCP
通过 MCP,也就是 Model Context Protocol,Codex 可以连接 external tools。
在 App 中你可以:
- 启用 recommended servers。
- 添加自己的 MCP server。
- 在 server 需要 OAuth 时,让 App 启动 auth flow。
这些 settings 同样适用于 Codex CLI 和 IDE extension,因为 MCP configuration 存在 config.toml 中。
官方 MCP 文档:
https://developers.openai.com/codex/mcp
浏览器使用
Browser use settings 用来安装或启用 bundled Browser plugin,并管理 allowed websites 和 blocked websites。
默认情况下,Codex 在使用一个 website 前会先询问你,除非你已经 allow 这个网站。把网站从 blocked list 中移除后,Codex 下次会重新询问是否可以使用它。
browser preview、comment 和 browser use workflows 见:
https://developers.openai.com/codex/app/browser
Computer Use
在 macOS 上,Computer Use settings 用来检查 desktop-app access 和相关 preferences。
如果你要撤销 system-level access,需要到 macOS Privacy & Security settings 中修改:
- Screen Recording permissions
- Accessibility permissions
该功能 launch 时不面向 EEA、United Kingdom 或 Switzerland 提供。
Personalization
你可以把默认 personality 设为:
- Friendly
- Pragmatic
- None
选择 None 会禁用 personality instructions。这个设置之后可以随时改。
你还可以添加自己的 custom instructions。编辑 custom instructions 会更新 AGENTS.md 中的 personal instructions。
上下文-aware suggestions
Context-aware suggestions 会在你启动或回到 Codex 时,提示可能需要继续的 follow-ups 和 tasks。
记忆
Memories 可用时,你可以启用它,让 Codex 把过去 threads 中有用的 context 带到未来工作里。
setup、storage 和 per-thread controls 见:
https://developers.openai.com/codex/memories
Archived threads
Archived threads section 会列出 archived chats,并显示 dates 和 project context。需要恢复时使用 Unarchive。