Codex 桌面应用设置功能完全指南基于 Codex 官方手册整理涵盖 App Settings 面板所有功能项及其底层配置。打开方式应用菜单 →Settings或快捷键Cmd ,macOS/Ctrl ,Windows。目录General通用Profile个人资料Keyboard Shortcuts键盘快捷键Notifications通知Agent ConfigurationAgent 配置Appearance外观Codex PetsCodex 宠物GitGit 设置Integrations MCP集成与 MCPBrowser浏览器Computer Use计算机控制Personalization个性化Context-aware Suggestions上下文感知建议Memories记忆Archived Threads已归档线程附录 A沙盒与权限体系附录 B模型选择与配置附录 CHooks生命周期钩子附录 DRules命令规则附录 EPlugins插件附录 FAutomations自动化附录 G配置文件层级与优先级1. General通用通用设置控制 Codex 应用的基础行为。设置项说明文件打开位置选择在哪个应用中打开文件如 VS Code、默认编辑器等命令输出显示量控制线程中命令输出展示的多少简洁 / 完整终端标签打开位置设置终端标签页默认打开在哪里多行提示需 CmdEnter开启后发送多行 prompt 需要按CmdEnter避免误触发送运行时阻止休眠当线程运行时防止系统进入睡眠状态适用场景如果你习惯在 VS Code 中查看文件改动可以把文件打开位置设为 VS Code。如果跑长任务时屏幕总是休眠开启阻止休眠。2. Profile个人资料个人资料页面展示你的使用数据和账户信息。2.1 活动洞察Lifetime tokens累计使用的 token 总量Peak tokens单次任务的峰值 token 消耗Streaks连续使用天数最长任务历史耗时最长的单次任务Token 活动趋势token 消耗的时间线图2.2 个人信息可以修改头像显示名称用户名还可以保存一张带有使用数据的Profile Card个人名片在消费者 ChatGPT 计划下可以分享。2.3 邀请功能个人计划用户Invite a friend邀请好友Business 工作区用户Invite a coworker邀请同事具体的邀请奖励、限额和资格见官方定价页面。3. Keyboard Shortcuts键盘快捷键打开快捷键面板可以查看所有命令的当前快捷键绑定自定义快捷键点击某个命令输入新的组合键重置为默认将自定义的快捷键恢复默认搜索快捷键支持按命令名搜索或切换到按键搜索模式按一个组合键反查绑定的命令常用快捷键速查快捷键功能Cmd ,打开设置Cmd K打开命令面板Cmd J切换集成终端Ctrl M语音输入按住说话Ctrl L清空终端4. Notifications通知控制 Codex 桌面通知的行为任务完成通知选择何时显示 turn 完成通知通知权限设置是否允许应用请求系统通知权限开启后当 Codex 在后台完成任务时系统会弹出桌面通知无需一直盯着应用。5. Agent ConfigurationAgent 配置Codex app 中的 Agent 与 CLI、IDE 扩展共享同一套配置。可以在应用内通过 UI 控件调整常用设置也可以直接编辑config.toml进行高级配置。5.1 沙盒模式Sandbox Mode决定 Codex 执行命令时的文件和网络访问边界模式说明read-only只能读取文件不能编辑或执行命令除非逐一审批workspace-write默认模式。可读写工作区内文件可在工作区边界内运行常规命令danger-full-access完全无限制。移除文件和网络边界仅在你清楚风险时使用5.2 审批策略Approval Policy控制 Codex 何时暂停并请求你的许可策略说明untrusted运行非信任命令前都会询问on-request在沙盒内自由工作超出边界时询问never永不询问直接执行还支持granular细粒度审批策略可以按类别单独控制approval_policy { granular { sandbox_approval true, rules true, mcp_elicitations true, request_permissions false, skill_approval false } }5.3 审批审阅者Approvals Revieweruser审批请求直接呈现给你默认auto_review符合条件的审批请求由审阅 Agent 自动处理5.4 权限配置文件Permission Profiles支持命名的权限配置文件可以精细定义文件系统和网络访问内置配置文件:read-only、:workspace、:danger-full-access自定义配置文件在config.toml中用[permissions.name]表定义示例[permissions.project-edit.filesystem] :minimal read [permissions.project-edit.filesystem.:workspace_roots] . write **/*.env deny [permissions.project-edit.network] enabled true [permissions.project-edit.network.domains] github.com allow5.5 Shell 环境策略控制 Codex 向子进程传递哪些环境变量[shell_environment_policy] inherit core # none | core | all set { MY_FLAG 1 } # 额外设置的环境变量 exclude [AWS_*, AZURE_*] # 排除的变量支持通配符 include_only [PATH, HOME] # 仅保留的变量5.6 网络搜索模式模式说明cached默认从 OpenAI 维护的缓存索引中返回结果减少外部内容注入风险live实时从网络获取最新数据等同于--searchdisabled关闭网络搜索工具web_search cached5.7 推理力度Reasoning Effort控制模型在支持推理时投入多少思考model_reasoning_effort high # low | medium | high | xhigh5.8 日志目录log_dir /absolute/path/to/codex-logs5.9 功能开关Feature Flags在[features]表中切换可选和实验性功能功能键默认值成熟度说明appsfalse实验性ChatGPT Apps/connectors 支持codex_git_commitfalse实验性Codex 生成的 git 提交和归因hookstrue稳定生命周期钩子fast_modetrue稳定Fast 模式service_tier “fast”memoriesfalse稳定记忆功能multi_agenttrue稳定子 Agent 协作工具personalitytrue稳定个性化选择控件shell_snapshottrue稳定快照 shell 环境加速重复命令shell_tooltrue稳定默认 shell 工具unified_exectrueWindows 除外稳定统一 PTY 执行工具undofalse稳定基于 git ghost 快照的撤销功能启用方式[features] memories true shell_snapshot true或通过 CLIcodex --enable memories6. Appearance外观自定义 Codex 应用的视觉风格基础主题选择亮色/暗色/跟随系统强调色Accent调整主题强调色背景色Background自定义背景颜色前景色Foreground自定义文字/前景颜色UI 字体设置界面使用的字体代码字体设置代码块使用的字体分享主题可以将自定义主题分享给朋友7. Codex PetsCodex 宠物可选的动画伴侣在 Codex 工作时陪伴你。启用与管理在Settings → Appearance → Pets中选择内置宠物也可以通过refresh custom pets从本地 Codex home 加载自定义宠物在输入框中输入/pet可以切换宠物在设置中使用Wake Pet/Tuck Away Pet唤醒或收起快捷键CmdK→ 运行 Wake Pet / Tuck Away Pet 命令浮动覆盖层宠物浮动覆盖层会在你使用其他应用时保持可见显示当前活跃线程Codex 状态运行中 / 等待输入 / 准备审阅简短的进度提示创建自定义宠物$skill-installer hatch-pet然后$hatch-pet create a new pet inspired by my recent projects8. GitGit 设置标准化 Git 操作和生成内容设置项说明分支命名规范统一 Codex 创建分支时的命名格式是否使用 force push控制 Codex 是否执行强制推送Commit message 提示设置 Codex 生成 commit message 时使用的提示模板PR 描述提示设置 Codex 生成 Pull Request 描述时使用的提示模板9. Integrations MCP集成与 MCPMCPModel Context Protocol是 Codex 连接外部工具和数据源的标准方式。9.1 管理 MCP 服务器推荐服务器启用 Codex 推荐的 MCP 服务器如 Context7、Figma、GitHub 等自定义服务器添加自己的 MCP 服务器OAuth 认证如果服务器需要 OAuth应用会自动启动认证流程9.2 配置方式MCP 配置存储在config.toml中App、CLI 和 IDE 共享[mcp_servers.context7] command npx args [-y, upstash/context7-mcp] [mcp_servers.figma] url https://mcp.figma.com/mcp bearer_token_env_var FIGMA_OAUTH_TOKEN9.3 服务器类型STDIO 服务器以本地进程运行配置command、args、env、cwdStreamable HTTP 服务器通过 URL 访问支持 Bearer token 和 OAuth 认证9.4 常用 MCP 服务器OpenAI Docs MCP搜索和阅读 OpenAI 开发者文档Context7连接最新的开发者文档Figma访问 Figma 设计文件Playwright控制和检查浏览器Chrome Developer Tools控制和检查 ChromeSentry访问 Sentry 日志GitHub管理 PR、Issues 等超越git命令的能力9.5 工具审批控制可以对每个 MCP 服务器的工具设置审批模式[mcp_servers.chrome_devtools] default_tools_approval_mode prompt # auto | prompt | approve [mcp_servers.chrome_devtools.tools.open] approval_mode approve10. Browser浏览器管理 Codex 的浏览器能力10.1 内置浏览器插件安装或启用捆绑的 Browser 插件管理允许和阻止的网站列表Codex 使用网站前会先询问除非你已允许移除被阻止的网站后Codex 下次会再次询问10.2 Chrome 扩展设置 Codex Chrome 扩展让 Codex 使用你的 Chrome 配置文件已登录的会话、扩展等。10.3 开发者模式开启Enable full CDP access可以让 Codex 使用 Chrome DevTools Protocol 进行性能分析深层浏览器调试注意如果你的组织已禁用 CDP 完全访问则无法在本地启用。10.4 浏览器使用场景预览本地开发服务器的实时预览评论在页面上标记具体元素让 Codex 处理反馈Browser Use让 Codex 直接操作页面适用于本地开发服务器和文件预览11. Computer Use计算机控制Computer Use 让 Codex 可以操作 macOS 或 Windows 桌面应用——看屏幕、点击、输入。设置项桌面应用访问权限回顾和管理 Codex 对桌面应用的控制权限系统级权限在 macOS 上通过系统偏好设置 → 隐私与安全 → 屏幕录制 / 辅助功能 来撤销权限适用场景测试桌面应用检查浏览器或模拟器流程操作没有 API/插件的数据源修改应用设置复现 GUI 相关的 bug因为 Computer Use 可以影响项目工作区之外的应用和系统状态建议保持任务范围窄并在继续前审阅权限提示。12. Personalization个性化选择 Codex 的默认交流风格选项说明Friendly友好、温暖的交流风格Pragmatic务实、简洁、直奔主题None禁用个性化指令可以随时更改。配置方式personality friendly运行时可以通过/personality命令切换。自定义指令可以添加自己的自定义指令Custom Instructions。编辑自定义指令会更新你个人AGENTS.md中的指令部分。这些指令会在每次会话中自动注入塑造 Codex 的行为方式。13. Context-aware Suggestions上下文感知建议开启后当你启动或返回 Codex 时会自动浮现后续建议基于之前工作的后续操作推荐任务恢复可能需要继续的任务帮助你快速接续上下文减少我上次做到哪了的困扰。14. Memories记忆Memories 让 Codex 将之前线程中有用的上下文带入到未来的工作中。14.1 启用在 App 设置中开启或在config.toml中设置[features] memories true在 EEA、英国和瑞士地区必须手动启用后才会使用或生成记忆。14.2 工作原理启用后Codex 会从符合条件的历史线程中提取有用的上下文跳过活跃或短暂的会话自动脱敏生成的记忆字段中的敏感信息在后台异步更新不是每个线程结束时立即更新可以记住的内容稳定的偏好设置重复的工作流技术栈信息项目规范已知的坑和注意事项14.3 存储位置记忆文件存储在~/.codex/memories/下包括摘要、持久条目、近期输入和历史线程的佐证。14.4 线程级控制使用/memories命令可以控制当前线程的记忆行为当前线程是否使用已有记忆当前线程是否可以作为未来记忆的生成来源14.5 高级配置[memories] generate_memories true # 是否允许新线程作为记忆生成输入 use_memories true # 是否将已有记忆注入未来会话 disable_on_external_context true # 使用了 MCP/搜索的线程不参与记忆生成 min_rate_limit_remaining_percent 20 # 最低剩余配额百分比才开始生成 extract_model gpt-5.4-mini # 每线程记忆提取使用的模型 consolidation_model gpt-5.5 # 全局记忆整合使用的模型15. Archived Threads已归档线程归档区域列出所有已归档的聊天记录包含归档日期项目上下文使用Unarchive可以恢复一个线程到活跃列表。附录 A沙盒与权限体系沙盒的作用沙盒是 Codex 自主工作的技术边界。它不是限制 Codex 的能力而是定义在这个范围内可以自由行动超出范围需要审批。沙盒减少审批疲劳低风险命令在边界内自动执行不需要逐一确认。平台实现平台实现方式macOS内置 Seatbelt 框架开箱即用Windows原生 Windows 沙盒PowerShell或 WSL2 的 Linux 实现Linux / WSL2需要安装bubblewrapsudo apt install bubblewrap可写根目录Writable Roots如果 Codex 需要操作多个目录[sandbox_workspace_write] writable_roots [/Users/YOU/.pyenv/shims, /Users/YOU/shared-lib] network_access false # 是否允许网络访问 exclude_tmpdir_env_var false # 是否允许 $TMPDIR exclude_slash_tmp false # 是否允许 /tmp权限配置文件详解权限配置文件提供更精细的文件系统和网络控制文件系统权限read、write、deny三级更具体的条目覆盖更宽泛的条目denywriteread网络权限[permissions.my-profile.network] enabled true [permissions.my-profile.network.domains] example.com allow *.example.com allow ads.example.com deny localhost allow还支持 Unix socket 代理配置如 Docker socket。附录 B模型选择与配置推荐模型模型适用场景gpt-5.5首选。复杂编码、Computer Use、知识工作和研究流程gpt-5.4-mini快速、低成本选项适合轻量编码和子 Agentgpt-5.3-codex-spark研究预览面向近实时代码迭代仅 Pro 用户配置默认模型model gpt-5.5临时切换模型CLI/model命令或codex -m gpt-5.5IDE输入框下方的模型选择器App在创建线程时选择自定义模型提供商model gpt-5.4 model_provider proxy [model_providers.proxy] name OpenAI using LLM proxy base_url http://proxy.example.com env_key OPENAI_API_KEY支持的提供商类型OpenAI内置Amazon Bedrock内置Ollama / LM Studio本地AzureMistral任何兼容 Chat Completions / Responses API 的提供商推理与表达控制model_reasoning_effort high model_reasoning_summary none model_verbosity low model_context_window 128000附录 CHooks生命周期钩子Hooks 让你将自己的脚本注入到 Codex 的 Agent 循环中。支持的事件事件触发时机SessionStart会话启动/恢复/清理/压缩时PreToolUse工具调用前PermissionRequest权限请求时PostToolUse工具调用后UserPromptSubmit用户提交 prompt 时PreCompact/PostCompact上下文压缩前后SubagentStart/SubagentStop子 Agent 启动/停止时Stop任务停止时配置方式支持hooks.json或config.toml中的内联[hooks]表[[hooks.PreToolUse]] matcher ^Bash$ [[hooks.PreToolUse.hooks]] type command command /usr/bin/python3 $(git rev-parse --show-toplevel)/.codex/hooks/policy.py timeout 30 statusMessage Checking Bash command放置位置按优先级排列常用位置~/.codex/hooks.json用户级~/.codex/config.toml用户级内联project/.codex/hooks.json项目级需信任项目project/.codex/config.toml项目级内联信任机制非托管的命令钩子需要在运行前审查和信任。使用/hooks命令可以查看、审查和信任钩子。典型用例将会话发送到自定义日志/分析引擎扫描 prompt 防止意外粘贴 API Key自动摘要会话创建持久记忆在 turn 结束时运行自定义校验在特定目录下定制 prompt 行为附录 DRules命令规则Rules 控制哪些命令可以在沙盒外运行实验性功能。创建规则在~/.codex/rules/目录下创建.rules文件prefix_rule(pattern[gh,pr,view],decisionprompt,# allow | prompt | forbiddenjustificationViewing PRs is allowed with approval,match[gh pr view 7888,gh pr view --repo openai/codex,],not_match[gh pr --repo openai/codex view 7888,],)规则字段字段说明pattern必填命令前缀匹配列表decisionallow直接放行/prompt提示确认/forbidden阻止justification规则原因可选match/not_match内联单元测试可选当多条规则匹配时最严格的决定生效forbiddenpromptallow。测试规则codex execpolicy check--pretty\--rules~/.codex/rules/default.rules\-- ghprview7888--jsontitle,body,commentsShell 复合命令处理Codex 会安全地拆分简单的 shell 复合命令如git add . rm -rf /分别对每条命令应用规则最严格结果生效。对于使用高级 shell 特性重定向、变量替换等的命令则保守地作为整体处理。附录 EPlugins插件插件将 Skills、App 集成和 MCP 服务器打包成可复用的工作流。插件目录App 中打开Plugins浏览和安装CLI 中运行/plugins插件分类Curated by OpenAIOpenAI 精选插件Shared with you工作区其他成员分享的插件Created by you你自己创建的插件常见插件Codex Security扫描代码安全漏洞Gmail读取和管理 GmailGoogle Drive操作 Drive、Docs、Sheets、SlidesSlack汇总频道或起草回复Sites创建和部署托管网站安装与使用在插件目录中搜索或浏览点击安装如需外部应用认证按提示完成在新线程中直接使用自然语言描述或plugin-name显式调用管理插件卸载在插件详情页选择Uninstall plugin禁用不卸载[plugins.gmailopenai-curated] enabled false附录 FAutomations自动化自动化让你在后台定期运行重复任务。类型类型说明独立自动化按计划启动全新运行结果出现在 Triage 收件箱项目自动化可以跨多个项目运行线程自动化心跳式的定期唤醒保留线程上下文运行环境Git 仓库中可选择在本地项目或worktree中运行非版本控制项目在本地项目目录直接运行可以自定义模型和推理力度调度预设频率每日、每周等自定义 cron 表达式线程自动化支持分钟级间隔安全模型自动化使用你的默认沙盒设置read-only模式下需要修改文件的工具调用会失败full access模式下后台自动化风险较高可以使用 Rules 选择性允许特定命令与 Skills 结合自动化可以使用 Codex 的所有插件和 Skills。在自动化 prompt 中用$skill-name显式触发。管理所有自动化及其运行结果在侧边栏的Automations面板查看Triage区域作为收件箱展示有发现的自动化运行可以从普通线程中让 Codex 创建或更新自动化附录 G配置文件层级与优先级Codex 从多个位置读取配置优先级从高到低CLI 标志和--config覆盖最高优先级项目配置文件.codex/config.toml从项目根到当前目录最近的生效仅信任的项目Profile 文件--profile profile-name选择的~/.codex/profile-name.config.toml用户配置~/.codex/config.toml系统配置/etc/codex/config.tomlUnix内置默认值最低优先级配置文件位置文件位置说明config.toml~/.codex/用户级配置auth.json~/.codex/文件存储的凭证如使用 keyring 则不存在history.jsonl~/.codex/历史持久化如启用hooks.json~/.codex/或project/.codex/生命周期钩子rules/*.rules~/.codex/rules/或project/.codex/rules/命令规则memories/~/.codex/记忆文件AGENTS.md~/.codex/或仓库根/子目录项目指导项目配置的安全限制项目级.codex/config.toml不能覆盖以下设置安全考虑openai_base_urlchatgpt_base_urlmodel_provider/model_providersnotifyprofile/profilesotel这些设置只能在用户级~/.codex/config.toml中设置。认证方式方式说明ChatGPT 登录默认方式使用订阅额度遵循 ChatGPT 工作区权限和数据策略API Key按用量计费适用于 CI/CD 等程序化场景Access Token企业自动化的非交互式认证ChatGPT Enterprise凭证存储cli_auth_credentials_store keyring # file | keyring | auto文档版本基于 2026-07-01 Codex 官方手册整理。功能可能随版本更新而变化请以官方文档为准。