---
title: "调整 App 设置"
description: "Codex App 的 settings panel 用来调整 App 行为、文件打开方式，以及外部工具连接方式。"
verifiedAt: "2026-05-05"
---

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

打开方式：

- 在 App menu 中打开 [**Settings**](codex://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](https://developers.openai.com/codex/agent-approvals-security)
- Config basics：[https://developers.openai.com/codex/config-basic](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](https://developers.openai.com/images/codex/app/theme-selection-light.webp)
- dark：[https://developers.openai.com/images/codex/app/theme-selection-dark.webp](https://developers.openai.com/images/codex/app/theme-selection-dark.webp)

### 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 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：

```text
$skill-installer hatch-pet
```

然后从 command menu reload skills：

1. 按 `Cmd+K` 或 `Ctrl+K`。
2. 选择 **Force Reload Skills**。
3. 让 skill 创建 pet：

```text
$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](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](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](https://developers.openai.com/codex/guides/agents-md)。

## 上下文-aware suggestions

Context-aware suggestions 会在你启动或回到 Codex 时，提示可能需要继续的 follow-ups 和 tasks。

## 记忆

Memories 可用时，你可以启用它，让 Codex 把过去 threads 中有用的 context 带到未来工作里。

setup、storage 和 per-thread controls 见：

[https://developers.openai.com/codex/memories](https://developers.openai.com/codex/memories)

## Archived threads

**Archived threads** section 会列出 archived chats，并显示 dates 和 project context。需要恢复时使用 **Unarchive**。
