📚AI 编程官方教程中文版
📘 OpenAI Codex📚 官方教程中文版产品入口

调整 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

相关官方文档:

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

On this page