AI 编程教程中文版
官方教程中文版产品入口

调整 App 设置

Codex App 的 settings panel 用来调整 App 行为、文件打开方式,以及外部工具连接方式。

📖 本篇术语速查表
英文 / 缩写中文一句话解释
Agent configuration代理配置App 里对 Codex 行为的设置。
Git 设置git settingsApp 内 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

相关官方文档:

Appearance

Settings 中,你可以调整 Codex App 的外观:

  • base theme
  • accent color
  • background color
  • foreground color
  • UI font
  • code font

你也可以把 custom theme 分享给朋友。

官方截图:

Codex pets

Codex pets 是 App 中可选的 animated companions。

选择方式:

  1. 打开 Settings
  2. 进入 Appearance
  3. 选择 Pets
  4. 选择 built-in pet,或从本地 Codex home refresh custom pets。

你也可以用这些方式控制 floating overlay:

  • 在 composer 中输入 /pet
  • Settings > Appearance 中使用 Wake PetTuck Away Pet
  • Cmd+KCtrl+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:

  1. Cmd+KCtrl+K
  2. 选择 Force Reload Skills
  3. 让 skill 创建 pet:
$hatch-pet create a new pet inspired by my recent projects

Git

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

本页目录