设置

通过设置面板自定义 Codex 桌面应用的行为。使用 Cmd + ,（macOS）或 Ctrl + ,（Windows）打开设置，也可以在线程输入框中输入 /settings 或使用深度链接 codex://settings。

通用（General）

通用设置控制 Codex 应用的核心行为。

• 默认项目：设置 Codex 启动时自动打开的默认项目目录。
• 沙箱模式：控制 Codex 的文件系统和网络访问权限。
  • 只读：Codex 只能读取文件，无法修改任何内容。
  • 工作区写入：Codex 可以修改当前工作区内的文件，但无法访问网络或工作区外的文件。
  • 完全访问：Codex 可以修改任意文件、运行命令和访问网络。风险较高。
• 审批策略：决定 Codex 在执行工具调用前的审批行为。
  • 始终询问：每次执行工具前都需确认。
  • 工作区写入时自动批准：在工作区内的写入操作自动执行。
  • 从不询问：所有操作自动执行（仅限自动化场景）。
• 默认模型：选择 Codex 使用的默认 AI 模型。不同模型在速度、能力和成本上有所差异。
• 推理强度：控制模型在回答前进行深度推理的程度。更高的推理强度适合复杂问题，但会消耗更多资源。
• 最大上下文窗口：设置单次对话的上下文长度上限。达到上限后，Codex 会自动压缩或截断较早的消息。
• 终端：选择 Codex 运行命令所使用的终端应用。
• 自动更新：控制 Codex 是否自动下载和安装更新。

通知（Notifications）

管理 Codex 何时以及如何通知你。

• 桌面通知：启用或禁用系统级桌面通知。当自动化完成或线程需要关注时会弹出通知。
• 声音：控制是否在通知时播放提示音。
• 自动化完成时通知：当后台自动化运行完成时发送通知。
• 任务请求审批时通知：当 Codex 等待你批准某个操作时发送通知。
• 通知频率：设置通知合并的频率，避免过多的消息打扰。

代理配置（Agent Config）

控制 Codex 代理的行为方式。

• 代理名称：为你的 Codex 代理设置一个自定义名称。
• 工作目录偏好：设置 Codex 运行命令的默认工作目录。
• 环境变量：为 Codex 的运行环境添加或修改环境变量。适用于需要特定环境配置的项目。
• 命令超时：设置长时间运行的命令的超时时间，防止任务无限挂起。
• 并行任务数：控制 Codex 同时运行的最大并行任务数量。更多的并行任务可以加快进度，但会增加系统资源消耗。
• 重试策略：当某个步骤失败时，Codex 是否自动重试以及重试次数。
• 日志级别：设置 Codex 的日志详细程度。调试时可选择详细日志。

外观（Appearance）

自定义 Codex 应用的外观。

• 主题：在浅色主题、深色主题或跟随系统主题之间切换。
• 字体大小：调整线程内容的字体大小。
• 代码字体：选择代码块的等宽字体。
• 紧凑模式：切换更紧凑的界面布局，适合小屏幕。
• 侧边栏位置：将侧边栏放置在左侧或右侧。
• 显示行号：在代码块中显示或隐藏行号。
• Markdown 渲染：控制富文本 Markdown 的渲染方式。

Codex 宠物（Codex Pets）

Codex 宠物是一个趣味功能，为你的编码体验增添陪伴感。

• 选择宠物：从可用列表中选择一个 Codex 宠物。宠物会在应用窗口中显示动画。
• 宠物行为：设置宠物的活跃程度——安静、正常或活跃。
• 交互频率：控制宠物与你交互的频率。
• 显示宠物：开启或关闭宠物显示。
• 宠物位置：将宠物固定在屏幕的某个角落或让它自由移动。

Git

配置 Codex 与 Git 的集成方式。

• 默认分支：设置创建新分支和拉取请求时的默认目标分支（如 main 或 master）。
• 提交信息风格：控制 Codex 生成 Git 提交信息的风格——简洁、详细或遵循 Conventional Commits 规范。
• 自动暂存：Codex 是否在提交前自动执行 git add。
• 推送行为：控制 Codex 在提交后是否自动推送到远程仓库。
• 拉取请求：配置 Codex 创建拉取请求的默认行为——草稿模式、自动分配审查者等。
• Git 用户信息：覆盖当前仓库的 Git 用户名和邮箱。
• 签名提交：启用 GPG 签名验证的提交。

集成与 MCP（Integrations & MCP）

管理第三方集成和 MCP（Model Context Protocol）服务器。

• MCP 服务器：添加、配置和管理 MCP 服务器。MCP 允许 Codex 连接到外部工具和数据源。
• GitHub 集成：连接你的 GitHub 账户，使 Codex 能够读取和管理仓库、问题、拉取请求等。
• Slack 集成：连接 Slack，使 Codex 能够发送消息、读取频道和响应提醒。
• Linear / Jira 集成：连接项目管理工具，使 Codex 能够管理工单和任务。
• 自定义集成：通过 API 密钥或 OAuth 添加额外的第三方服务。
• 连接状态：查看所有已配置集成的连接状态，并在需要时重新授权。
• 插件管理：安装、启用、禁用或卸载 Codex 插件。插件可以扩展 Codex 的能力，如添加对新语言的支持。

浏览器使用（Browser Use）

配置 Codex 的应用内浏览器行为。

• 启用浏览器：开启或关闭应用内浏览器功能。
• 浏览器插件：安装并启用 Browser 插件，使 Codex 能够操控应用内浏览器。
• 允许的网站：管理 Codex 可以直接访问的网站列表，无需每次询问。
• 阻止的网站：管理 Codex 永远不允许访问的网站列表。
• 自动打开：控制 Codex 是否自动在浏览器中打开 URL。
• 默认视口大小：设置浏览器视口的默认宽度和高度。
• 用户代理：自定义浏览器请求的 User-Agent 字符串。
• Cookie 和会话：管理浏览器 Cookie（注意：应用内浏览器不支持持久登录态）。

计算机使用（Computer Use）

配置 Codex 操作桌面 GUI 的方式（目前仅支持 macOS）。

• 启用计算机使用：开启或关闭计算机使用功能。
• 安装插件：安装计算机使用插件，该插件需要屏幕录制和辅助功能权限。
• 屏幕录制权限：查看和授予屏幕录制权限的状态。Codex 需要此权限才能”看到”桌面。
• 辅助功能权限：查看和授予辅助功能权限的状态。Codex 需要此权限才能点击、输入和导航。
• 允许的应用：指定 Codex 可以操作的应用白名单。
• 阻止的应用：指定 Codex 永远不能操作的应用黑名单。
• 操作延迟：设置 Codex 在连续操作之间的最小延迟，避免过快操作。
• 截图质量：控制 Codex 截取屏幕截图时的图像质量。

个性化（Personalization）

根据你的偏好定制 Codex 的行为。

• 自定义指令：编写全局指令，告诉 Codex 你的偏好、工作风格和约束条件。这些指令会在每个对话中生效。
• 回复风格：选择 Codex 的回复风格——简洁直接、详尽解释或平衡模式。
• 语言偏好：设置 Codex 回复时使用的语言。
• 代码风格：设置 Codex 生成代码时的风格偏好（如缩进宽度、引号类型、分号使用等）。
• 命名约定：设置文件、变量和函数的命名约定偏好。
• 文档生成：控制 Codex 是否自动为新代码生成文档注释。

上下文感知建议（Context-aware Suggestions）

配置 Codex 基于当前上下文提供智能建议的方式。

• 启用建议：开启或关闭上下文感知建议功能。
• 建议频率：控制 Codex 主动提供建议的频率。
• 文件关联建议：编辑文件时，Codex 是否建议相关的文件。
• 命令建议：Codex 是否根据历史记录和项目结构建议常用命令。
• 搜索建议：Codex 是否在对话中主动建议搜索项目文件。
• 建议灵敏度：调整触发建议的上下文匹配阈值。

记忆（Memories）

管理 Codex 跨对话的记忆功能。

• 启用记忆：开启或关闭 Codex 的记忆功能。开启后，Codex 会记住你告诉它的偏好和信息。
• 查看记忆：浏览所有已保存的记忆条目。
• 删除记忆：选择性地删除不再需要的记忆条目。
• 清除所有记忆：一次性删除所有已保存的记忆。
• 记忆优先级：设置记忆信息的优先级——全局或按项目划分。
• 自动记忆：控制 Codex 是否自动保存你提到的偏好信息。

已归档线程（Archived Threads）

管理已归档的对话线程。

• 查看归档：浏览所有已归档的线程。
• 恢复线程：将归档的线程恢复到活动列表中。
• 永久删除：永久删除归档的线程，此操作不可撤销。
• 自动归档：设置不活跃线程的自动归档时间。超过指定天数未活动的线程将被自动归档。
• 归档前保留工作树快照：归档时是否保留工作树的快照，以便之后恢复。
• 批量操作：选择多个线程进行批量归档、恢复或删除操作。

另见

• 功能特性
• 命令与快捷键
• 工作树
• 自动化任务