调整 App 设置
Codex App 的 settings panel 用来调整 App 行为、文件打开方式,以及外部工具连接方式。
📖 本篇术语速查表
| 英文 / 缩写 | 中文 | 一句话解释 |
|---|---|---|
| Agent configuration | 代理配置 | App 里对 Codex 行为的设置。 |
| Git 设置 | git settings | App 内 Git 操作相关的配置。 |
| 通知 | notifications | 任务状态提醒的设置。 |
不想读完?把下面这段提示词丢给 AI 帮你跑完——帮你调好 App 设置,先配对 Agent 和 Git 这些关键项。
你是 Codex App 设置顾问,帮我调好 App 设置,先配对 Agent configuration 和 Git 这些关键项。
【角色】
你熟悉 App 的各类设置:General、通知、Agent configuration、Appearance、Git,知道哪些最该先调。
【输入】
- 我的使用习惯和场景:___
- 我想改善的体验点:___
- 对 Git 行为的要求:___
- 是否在意通知打扰:___
【工作流程】
1. 给最该先调的关键设置(Agent / Git)
2. 配通知,避免打扰或漏提醒
3. 调 Appearance 等体验项
4. 给推荐配置流程
【输出规范】
▌一、关键设置(Agent / Git)+ 建议值
▌二、通知配置
▌三、体验项调整
▌四、推荐配置流程
【硬约束】
- 先调关键项,不一次全改
- Git 相关设置谨慎,避免误操作
- 改前提醒了解默认行为
- 不确定的设置项标注需查官方文档
- 给的值可直接用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。