Codex 桌面應(yīng)用設(shè)置功能完全指南

基于 Codex 官方手冊整理，涵蓋 App Settings 面板所有功能項(xiàng)及其底層配置。
打開方式：應(yīng)用菜單 → Settings，或快捷鍵 Cmd + ,（macOS）/ Ctrl + ,（Windows）。

1. General（通用）

通用設(shè)置控制 Codex 應(yīng)用的基礎(chǔ)行為。

適用場景： 如果你習(xí)慣在 VS Code 中查看文件改動，可以把文件打開位置設(shè)為 VS Code。如果跑長任務(wù)時屏幕總是休眠，開啟"阻止休眠"。

2. Profile（個人資料）

個人資料頁面展示你的使用數(shù)據(jù)和賬戶信息。

2.1 活動洞察

• Lifetime tokens：累計使用的 token 總量
• Peak tokens：單次任務(wù)的峰值 token 消耗
• Streaks：連續(xù)使用天數(shù)
• 最長任務(wù)：歷史耗時最長的單次任務(wù)
• Token 活動趨勢：token 消耗的時間線圖

2.2 個人信息

可以修改：

• 頭像
• 顯示名稱
• 用戶名

還可以保存一張帶有使用數(shù)據(jù)的 Profile Card（個人名片），在消費(fèi)者 ChatGPT 計劃下可以分享。

2.3 邀請功能

• 個人計劃用戶：Invite a friend（邀請好友）
• Business 工作區(qū)用戶：Invite a coworker（邀請同事）

具體的邀請獎勵、限額和資格見官方定價頁面。

3. Keyboard Shortcuts（鍵盤快捷鍵）

打開快捷鍵面板可以：

• 查看所有命令的當(dāng)前快捷鍵綁定
• 自定義快捷鍵：點(diǎn)擊某個命令，輸入新的組合鍵
• 重置為默認(rèn)：將自定義的快捷鍵恢復(fù)默認(rèn)
• 搜索快捷鍵：支持按命令名搜索，或切換到按鍵搜索模式（按一個組合鍵反查綁定的命令）

常用快捷鍵速查：

4. Notifications（通知）

控制 Codex 桌面通知的行為：

• 任務(wù)完成通知：選擇何時顯示 turn 完成通知
• 通知權(quán)限：設(shè)置是否允許應(yīng)用請求系統(tǒng)通知權(quán)限

開啟后，當(dāng) Codex 在后臺 完成任務(wù)時，系統(tǒng)會彈出桌面通知，無需一直盯著應(yīng)用。

5. Agent Configuration（Agent 配置）

Codex app 中的 Agent 與 CLI、IDE 擴(kuò)展共享同一套配置。可以在應(yīng)用內(nèi)通過 UI 控件調(diào)整常用設(shè)置，也可以直接編輯 config.toml 進(jìn)行高級配置。

5.1 沙盒模式（Sandbox Mode）

決定 Codex 執(zhí)行命令時的文件和網(wǎng)絡(luò)訪問邊界：

5.2 審批策略（Approval Policy）

控制 Codex 何時暫停并請求你的許可：

還支持 granular（細(xì)粒度）審批策略，可以按類別單獨(dú)控制：

approval_policy = { granular = {
  sandbox_approval = true,
  rules = true,
  mcp_elicitations = true,
  request_permissions = false,
  skill_approval = false
} }

5.3 審批審閱者（Approvals Reviewer）

• user：審批請求直接呈現(xiàn)給你（默認(rèn)）
• auto_review：符合條件的審批請求由審閱 Agent 自動處理

5.4 權(quán)限配置文件（Permission Profiles）

支持命名的權(quán)限配置文件，可以精細(xì)定義文件系統(tǒng)和網(wǎng)絡(luò)訪問：

• 內(nèi)置配置文件：: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" = "allow"

5.5 Shell 環(huán)境策略

控制 Codex 向子進(jìn)程傳遞哪些環(huán)境變量：

[shell_environment_policy]
inherit = "core"          # none | core | all
set = { MY_FLAG = "1" }  # 額外設(shè)置的環(huán)境變量
exclude = ["AWS_*", "AZURE_*"]  # 排除的變量（支持通配符）
include_only = ["PATH", "HOME"]  # 僅保留的變量

5.6 網(wǎng)絡(luò)搜索模式

web_search = "cached"

5.7 推理力度（Reasoning Effort）

控制模型在支持推理時投入多少"思考"：

model_reasoning_effort = "high"  # low | medium | high | xhigh

5.8 日志目錄

log_dir = "/absolute/path/to/codex-logs"

5.9 功能開關(guān)（Feature Flags）

在 [features] 表中切換可選和實(shí)驗(yàn)性功能：

啟用方式：

[features]
memories = true
shell_snapshot = true

或通過 CLI：codex --enable memories

6. Appearance（外觀）

自定義 Codex 應(yīng)用的視覺風(fēng)格：

• 基礎(chǔ)主題：選擇亮色/暗色/跟隨系統(tǒng)
• 強(qiáng)調(diào)色（Accent）：調(diào)整主題強(qiáng)調(diào)色
• 背景色（Background）：自定義背景顏色
• 前景色（Foreground）：自定義文字/前景顏色
• UI 字體：設(shè)置界面使用的字體
• 代碼字體：設(shè)置代碼塊使用的字體
• 分享主題：可以將自定義主題分享給朋友

7. Codex Pets（Codex 寵物）

可選的動畫伴侶，在 Codex 工作時陪伴你。

啟用與管理

• 在 Settings → Appearance → Pets 中選擇內(nèi)置寵物
• 也可以通過 refresh custom pets 從本地 Codex home 加載自定義寵物
• 在輸入框中輸入 /pet 可以切換寵物
• 在設(shè)置中使用 Wake Pet / Tuck Away Pet 喚醒或收起
• 快捷鍵 Cmd+K → 運(yùn)行 Wake Pet / Tuck Away Pet 命令

浮動覆蓋層

寵物浮動覆蓋層會在你使用其他應(yīng)用時保持可見，顯示：

• 當(dāng)前活躍線程
• Codex 狀態(tài)（運(yùn)行中 / 等待輸入 / 準(zhǔn)備審閱）
• 簡短的進(jìn)度提示

創(chuàng)建自定義寵物

$skill-installer hatch-pet

然后：

$hatch-pet create a new pet inspired by my recent projects

8. Git（Git 設(shè)置）

標(biāo)準(zhǔn)化 Git 操作和生成內(nèi)容：

9. Integrations & MCP（集成與 MCP）

MCP（Model Context Protocol）是 Codex 連接外部工具和數(shù)據(jù)源的標(biāo)準(zhǔn)方式。

9.1 管理 MCP 服務(wù)器

• 推薦服務(wù)器：啟用 Codex 推薦的 MCP 服務(wù)器（如 Context7、Figma、GitHub 等）
• 自定義服務(wù)器：添加自己的 MCP 服務(wù)器
• OAuth 認(rèn)證：如果服務(wù)器需要 OAuth，應(yīng)用會自動啟動認(rèn)證流程

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_TOKEN"

9.3 服務(wù)器類型

• STDIO 服務(wù)器：以本地進(jìn)程運(yùn)行，配置 command、args、env、cwd
• Streamable HTTP 服務(wù)器：通過 URL 訪問，支持 Bearer token 和 OAuth 認(rèn)證

9.4 常用 MCP 服務(wù)器

• OpenAI Docs MCP：搜索和閱讀 OpenAI 開發(fā)者文檔
• Context7：連接最新的開發(fā)者文檔
• Figma：訪問 Figma 設(shè)計文件
• Playwright：控制和檢查瀏覽器
• Chrome Developer Tools：控制和檢查 Chrome
• Sentry：訪問 Sentry 日志
• GitHub：管理 PR、Issues 等（超越 git 命令的能力）

9.5 工具審批控制

可以對每個 MCP 服務(wù)器的工具設(shè)置審批模式：

[mcp_servers.chrome_devtools]
default_tools_approval_mode = "prompt"  # auto | prompt | approve

[mcp_servers.chrome_devtools.tools.open]
approval_mode = "approve"

10. Browser（瀏覽器）

管理 Codex 的瀏覽器能力：

10.1 內(nèi)置瀏覽器插件

• 安裝或啟用捆綁的 Browser 插件
• 管理允許和阻止的網(wǎng)站列表
• Codex 使用網(wǎng)站前會先詢問（除非你已允許）
• 移除被阻止的網(wǎng)站后，Codex 下次會再次詢問

10.2 Chrome 擴(kuò)展

設(shè)置 Codex Chrome 擴(kuò)展，讓 Codex 使用你的 Chrome 配置文件（已登錄的會話、擴(kuò)展等）。

10.3 開發(fā)者模式

開啟 Enable full CDP access 可以讓 Codex 使用 Chrome DevTools Protocol 進(jìn)行：

• 性能分析
• 深層瀏覽器調(diào)試

注意：如果你的組織已禁用 CDP 完全訪問，則無法在本地啟用。

10.4 瀏覽器使用場景

• 預(yù)覽：本地開發(fā)服務(wù)器的實(shí)時預(yù)覽
• 評論：在頁面上標(biāo)記具體元素，讓 Codex 處理反饋
• Browser Use：讓 Codex 直接操作頁面（適用于本地開發(fā)服務(wù)器和文件預(yù)覽）

11. Computer Use（計算機(jī)控制）

Computer Use 讓 Codex 可以操作 macOS 或 Windows 桌面應(yīng)用——看屏幕、點(diǎn)擊、輸入。

設(shè)置項(xiàng)

• 桌面應(yīng)用訪問權(quán)限：回顧和管理 Codex 對桌面應(yīng)用的控制權(quán)限
• 系統(tǒng)級權(quán)限：在 macOS 上，通過系統(tǒng)偏好設(shè)置 → 隱私與安全 → 屏幕錄制 / 輔助功能 來撤銷權(quán)限

適用場景

• 測試桌面應(yīng)用
• 檢查瀏覽器或模擬器流程
• 操作沒有 API/插件的數(shù)據(jù)源
• 修改應(yīng)用設(shè)置
• 復(fù)現(xiàn) GUI 相關(guān)的 bug

因?yàn)?Computer Use 可以影響項(xiàng)目工作區(qū)之外的應(yīng)用和系統(tǒng)狀態(tài)，建議保持任務(wù)范圍窄，并在繼續(xù)前審閱權(quán)限提示。

12. Personalization（個性化）

選擇 Codex 的默認(rèn)交流風(fēng)格：

可以隨時更改。配置方式：

personality = "friendly"

運(yùn)行時可以通過 /personality 命令切換。

自定義指令

可以添加自己的自定義指令（Custom Instructions）。編輯自定義指令會更新你個人 AGENTS.md 中的指令部分。這些指令會在每次會話中自動注入，塑造 Codex 的行為方式。

13. Context-aware Suggestions（上下文感知建議）

開啟后，當(dāng)你啟動或返回 Codex 時，會自動浮現(xiàn)：

• 后續(xù)建議：基于之前工作的后續(xù)操作推薦
• 任務(wù)恢復(fù)：可能需要繼續(xù)的任務(wù)

幫助你快速接續(xù)上下文，減少"我上次做到哪了"的困擾。

14. Memories（記憶）

Memories 讓 Codex 將之前線程中有用的上下文帶入到未來的工作中。

14.1 啟用

• 在 App 設(shè)置中開啟
• 或在 config.toml 中設(shè)置：

[features]
memories = true

在 EEA、英國和瑞士地區(qū)，必須手動啟用后才會使用或生成記憶。

14.2 工作原理

啟用后，Codex 會：

• 從符合條件的歷史線程中提取有用的上下文
• 跳過活躍或短暫的會話
• 自動脫敏生成的記憶字段中的敏感信息
• 在后臺異步更新（不是每個線程結(jié)束時立即更新）

可以記住的內(nèi)容：

• 穩(wěn)定的偏好設(shè)置
• 重復(fù)的工作流
• 技術(shù)棧信息
• 項(xiàng)目規(guī)范
• 已知的坑和注意事項(xiàng)

14.3 存儲位置

記憶文件存儲在 ~/.codex/memories/ 下，包括摘要、持久條目、近期輸入和歷史線程的佐證。

14.4 線程級控制

使用 /memories 命令可以控制當(dāng)前線程的記憶行為：

• 當(dāng)前線程是否使用已有記憶
• 當(dāng)前線程是否可以作為未來記憶的生成來源

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（已歸檔線程）

歸檔區(qū)域列出所有已歸檔的聊天記錄，包含：

• 歸檔日期
• 項(xiàng)目上下文

使用 Unarchive 可以恢復(fù)一個線程到活躍列表。

附錄 A：沙盒與權(quán)限體系

沙盒的作用

沙盒是 Codex 自主工作的技術(shù)邊界。它不是限制 Codex 的能力，而是定義"在這個范圍內(nèi)可以自由行動，超出范圍需要審批"。

沙盒減少"審批疲勞"：低風(fēng)險命令在邊界內(nèi)自動執(zhí)行，不需要逐一確認(rèn)。

平臺實(shí)現(xiàn)

可寫根目錄（Writable Roots）

如果 Codex 需要操作多個目錄：

[sandbox_workspace_write]
writable_roots = ["/Users/YOU/.pyenv/shims", "/Users/YOU/shared-lib"]
network_access = false  # 是否允許網(wǎng)絡(luò)訪問
exclude_tmpdir_env_var = false  # 是否允許 $TMPDIR
exclude_slash_tmp = false       # 是否允許 /tmp

權(quán)限配置文件詳解

權(quán)限配置文件提供更精細(xì)的文件系統(tǒng)和網(wǎng)絡(luò)控制：

文件系統(tǒng)權(quán)限：read、write、deny 三級

• 更具體的條目覆蓋更寬泛的條目
• deny > write > read

網(wǎng)絡(luò)權(quán)限：

[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：模型選擇與配置

推薦模型

配置默認(rèn)模型

model = "gpt-5.5"

臨時切換模型

• CLI：/model 命令或 codex -m gpt-5.5
• IDE：輸入框下方的模型選擇器
• App：在創(chuàng)建線程時選擇

自定義模型提供商

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（內(nèi)置）
• Amazon Bedrock（內(nèi)置）
• Ollama / LM Studio（本地）
• Azure
• Mistral
• 任何兼容 Chat Completions / Responses API 的提供商

推理與表達(dá)控制

model_reasoning_effort = "high"
model_reasoning_summary = "none"
model_verbosity = "low"
model_context_window = 128000

附錄 C：Hooks（生命周期鉤子）

Hooks 讓你將自己的腳本注入到 Codex 的 Agent 循環(huán)中。

支持的事件

配置方式

支持 hooks.json 或 config.toml 中的內(nèi)聯(lián) [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"

放置位置（按優(yōu)先級排列常用位置）

1. ~/.codex/hooks.json（用戶級）
2. ~/.codex/config.toml（用戶級內(nèi)聯(lián)）
3. <project>/.codex/hooks.json（項(xiàng)目級，需信任項(xiàng)目）
4. <project>/.codex/config.toml（項(xiàng)目級內(nèi)聯(lián)）

信任機(jī)制

非托管的命令鉤子需要在運(yùn)行前審查和信任。使用 /hooks 命令可以查看、審查和信任鉤子。

典型用例

• 將會話發(fā)送到自定義日志/分析引擎
• 掃描 prompt 防止意外粘貼 API Key
• 自動摘要會話創(chuàng)建持久記憶
• 在 turn 結(jié)束時運(yùn)行自定義校驗(yàn)
• 在特定目錄下定制 prompt 行為

附錄 D：Rules（命令規(guī)則）

Rules 控制哪些命令可以在沙盒外運(yùn)行（實(shí)驗(yàn)性功能）。

創(chuàng)建規(guī)則

在 ~/.codex/rules/ 目錄下創(chuàng)建 .rules 文件：

prefix_rule(
    pattern = ["gh", "pr", "view"],
    decision = "prompt",  # allow | prompt | forbidden
    justification = "Viewing 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",
    ],
)

規(guī)則字段

當(dāng)多條規(guī)則匹配時，最嚴(yán)格的決定生效：forbidden > prompt > allow。

測試規(guī)則

codex execpolicy check --pretty \
  --rules ~/.codex/rules/default.rules \
  -- gh pr view 7888 --json title,body,comments

Shell 復(fù)合命令處理

Codex 會安全地拆分簡單的 shell 復(fù)合命令（如 git add . && rm -rf /），分別對每條命令應(yīng)用規(guī)則，最嚴(yán)格結(jié)果生效。對于使用高級 shell 特性（重定向、變量替換等）的命令，則保守地作為整體處理。

附錄 E：Plugins（插件）

插件將 Skills、App 集成和 MCP 服務(wù)器打包成可復(fù)用的工作流。

插件目錄

• App 中：打開 Plugins 瀏覽和安裝
• CLI 中：運(yùn)行 /plugins

插件分類

• Curated by OpenAI：OpenAI 精選插件
• Shared with you：工作區(qū)其他成員分享的插件
• Created by you：你自己創(chuàng)建的插件

常見插件

• Codex Security：掃描代碼安全漏洞
• Gmail：讀取和管理 Gmail
• Google Drive：操作 Drive、Docs、Sheets、Slides
• Slack：匯總頻道或起草回復(fù)
• Sites：創(chuàng)建和部署托管網(wǎng)站

安裝與使用

1. 在插件目錄中搜索或?yàn)g覽
2. 點(diǎn)擊安裝
3. 如需外部應(yīng)用認(rèn)證，按提示完成
4. 在新線程中直接使用（自然語言描述或 @plugin-name 顯式調(diào)用）

管理插件

卸載：在插件詳情頁選擇 Uninstall plugin

禁用（不卸載）：

[plugins."gmail@openai-curated"]
enabled = false

附錄 F：Automations（自動化）

自動化讓你在后臺定期運(yùn)行重復(fù)任務(wù)。

類型

運(yùn)行環(huán)境

• Git 倉庫中可選擇在本地項(xiàng)目或 worktree 中運(yùn)行
• 非版本控制項(xiàng)目在本地項(xiàng)目目錄直接運(yùn)行
• 可以自定義模型和推理力度

調(diào)度

• 預(yù)設(shè)頻率（每日、每周等）
• 自定義 cron 表達(dá)式
• 線程自動化支持分鐘級間隔

安全模型

• 自動化使用你的默認(rèn)沙盒設(shè)置
• read-only 模式下需要修改文件的工具調(diào)用會失敗
• full access 模式下后臺自動化風(fēng)險較高
• 可以使用 Rules 選擇性允許特定命令

與 Skills 結(jié)合

自動化可以使用 Codex 的所有插件和 Skills。在自動化 prompt 中用 $skill-name 顯式觸發(fā)。

管理

• 所有自動化及其運(yùn)行結(jié)果在側(cè)邊欄的 Automations 面板查看
• Triage 區(qū)域作為收件箱，展示有發(fā)現(xiàn)的自動化運(yùn)行
• 可以從普通線程中讓 Codex 創(chuàng)建或更新自動化

附錄 G：配置文件層級與優(yōu)先級

Codex 從多個位置讀取配置，優(yōu)先級從高到低：

1. CLI 標(biāo)志和 --config 覆蓋（最高優(yōu)先級）
2. 項(xiàng)目配置文件：.codex/config.toml，從項(xiàng)目根到當(dāng)前目錄（最近的生效；僅信任的項(xiàng)目）
3. Profile 文件：--profile profile-name 選擇的 ~/.codex/profile-name.config.toml
4. 用戶配置：~/.codex/config.toml
5. 系統(tǒng)配置：/etc/codex/config.toml（Unix）
6. 內(nèi)置默認(rèn)值（最低優(yōu)先級）

配置文件位置

項(xiàng)目配置的安全限制

項(xiàng)目級 .codex/config.toml 不能覆蓋以下設(shè)置（安全考慮）：

• openai_base_url
• chatgpt_base_url
• model_provider / model_providers
• notify
• profile / profiles
• otel

這些設(shè)置只能在用戶級 ~/.codex/config.toml 中設(shè)置。

認(rèn)證方式

憑證存儲：

cli_auth_credentials_store = "keyring"  # file | keyring | auto

以上就是Codex桌面應(yīng)用設(shè)置功能完全指南的詳細(xì)內(nèi)容，更多關(guān)于Codex桌面應(yīng)用設(shè)置功能的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論