Appearance
Codex App 的设置面板集中管理所有行为配置:从界面外观(主题、字体、配色)到 Agent 运行行为(沙箱、审批策略),从 Git 工作流偏好到 MCP 工具接入。本文逐节介绍每个配置区域的用途和关键选项。
Codex App 设置
通过设置面板调整 Codex App 的行为、文件打开方式和工具连接。从应用菜单打开 Settings,或按 Cmd+,(macOS)。
常规
配置文件默认打开位置和线程里命令输出的显示量。
可选项:
- 多行 Prompt 需要
Cmd+Enter才能发送(防误触) - 任务运行期间阻止电脑休眠(长任务不中断)
通知
配置"任务完成"通知的显示时机,以及是否提示系统通知权限申请。
Agent 配置
Codex App 里的 Agent 与 IDE 扩展和 CLI 使用相同的配置。应用内控件覆盖常用设置;高级选项编辑 config.toml。
相关文档:
外观
在 Settings 里自定义 Codex App 外观:
- 选择基础主题(亮/暗/跟随系统)
- 调整强调色、背景色、前景色
- 更改 UI 字体和代码字体
自定义好的主题还可以分享给他人。
Git
统一分支命名规范,选择 Codex 是否使用 force push。
还可以设置 Codex 用于生成 commit 信息和 PR 描述的 Prompt 模板——这样 Codex 生成的提交信息风格就能与团队规范保持一致。
集成与 MCP
通过 MCP(Model Context Protocol)连接外部工具。可以启用推荐 Server,或添加自定义 Server。如果 Server 需要 OAuth 认证,应用会自动发起认证流程。
这里的配置与 Codex CLI 和 IDE 扩展共享——因为 MCP 配置存储在 config.toml 里,所有客户端共用同一份配置。
详见:MCP 接入第三方工具
个性化
选择默认交互风格:Friendly(友好)、Pragmatic(务实)或 None(禁用个性化指令)。随时可以更改。
还可以添加自定义指令。编辑自定义指令会更新 AGENTS.md 里的个人指令。
归档线程
Archived threads 区域列出所有已归档的对话,显示时间和项目上下文。用 Unarchive 可以恢复线程。
常见问题
Q: 在 Codex App 里修改 MCP 配置,CLI 里会同步生效吗?
A: 是的。MCP 配置存储在 config.toml 里,Codex App、CLI 和 IDE 扩展三端共享同一份配置,任意一端修改其他端自动生效。
Q: "个性化指令"和 AGENTS.md 是什么关系?
A: 在设置里编辑的自定义指令会直接写入 AGENTS.md 的个人指令部分。AGENTS.md 是 Codex 读取项目级指令的标准文件,设置界面只是提供了一个图形化的编辑入口。
Q: 如何统一团队的 commit 消息风格?
A: 在 Git 设置里填写 Codex 生成 commit 信息时使用的 Prompt 模板,比如"使用 Conventional Commits 格式,用中文写提交描述"。Codex 生成的消息就会遵循这个模板。