Skip to content

術語表 ​

這一頁是我們自己寫的

官方也有一份術語表, 但那一頁的詞條是由前端元件渲染的,Markdown 裡沒有正文,映象不過來, 所以這裡重寫了一份。以官方頁面為準。

智慧體與執行 ​

智慧體(Agent) 會自己讀檔案、改檔案、跑指令、看結果並繼續推進的程式。 和補全工具的區別在於它有行動能力,所以「它被允許動什麼」和「它寫得對不對」同等重要。

子智慧體(Subagent) 由 Codex 啟動、受委派處理特定任務的智慧體。返回摘要而不是原始輸出, 用來把容易產生干擾資訊的工作移出主執行緒。→ 進階 03

智慧體執行緒(Agent thread) 子智慧體執行工作的執行緒。CLI 裡用 /agent 檢視和切換。

子智慧體工作流(Subagent workflow) Codex 並行執行多個智慧體並彙總結果的工作流。

上下文汙染 / 上下文腐化 前者指有用資訊被雜亂的中間輸出淹沒,後者指聊天被低相關細節填滿導致效能逐漸下降。 子智慧體和開新工作階段是主要對策。→ 快速上手 06

推理強度(model_reasoning_effort) 模型在給出答案前投入多少推理。強度高質量好但慢且貴。

權限與安全 ​

沙盒模式(Sandbox mode,--sandbox) Codex 執行指令時技術上能做到什麼。三檔:read-only、workspace-write、 danger-full-access。→ 快速上手 04

核准策略(Approval policy,--ask-for-approval) 哪些動作必須先停下來問你。三檔:untrusted、on-request、never。 注意它和沙盒是兩層,never 不等於放開權限。

工作區(Workspace)workspace-write 下可寫的範圍:當前目錄加上 /tmp 之類的臨時目錄。 用 /status 看當前工作階段具體包含哪些目錄。

受保護路徑(Protected paths) 可寫根目錄裡仍然只讀的地方:.git、.agents、.codex,遞迴生效。 這保證了 Git 這條退路始終有效。

自動審查(approvals_reviewer = "auto_review") 把符合條件的核准請求先交給一個審查智慧體,按策略檢查資料外洩、憑據探測、 削弱安全防護、破壞性操作等風險。→ 自動審查

安全監控(Safety monitoring) 非同步執行的監控,檢測到模型可能存在不安全行為時可以暫停任務。 暫停可能在觸發它的活動發生之後才生效,不能替代沙盒、權限控制和結果審查。

受信任的專案(Trusted project) 只有信任某個專案,Codex 才會載入它的 .codex/ 配置層——包括專案本地配置、鉤子和規則。 這是一道真實的安全閘,別一路回車過去。

規則(Rules) 控制哪些指令能在沙盒外執行,放在生效配置層旁的 rules/ 目錄裡, 用 prefix_rule 寫。屬於實驗階段功能。→ 規則

requirements.toml 管理員下發的強制約束,管本地執行時能做什麼。和 ChatGPT 工作區的角色、群組分開管理。 → 託管配置

指令與擴充功能 ​

AGENTS.md 專案指令檔案。Codex 在執行任何工作前都會讀。支援分層:全域性 → 專案根 → 子目錄, 越靠近當前目錄的越晚出現、覆蓋前面的。→ 快速上手 05

AGENTS.override.md 同一層裡存在時完全取代 AGENTS.md,不是疊加。用來做臨時覆蓋而不刪基礎檔案。

指令鏈(Instruction chain) Codex 啟動時按優先順序構建的一條指令序列,每次執行只構建一次。

技能(Skill) 一項具體任務或工作流所需的指令和配套資源,打包成一個含 SKILL.md 的目錄。 採用漸進式披露:先只加載名稱和描述,選中了才讀完整指令。→ 進階 01

漸進式披露(Progressive disclosure) 技能的上下文管理機制。初始技能列表最多佔模型上下文視窗的 2% (視窗未知時最多 8000 字元)。

外掛程式(Plugin) 可安裝的套件,可以包含技能、連接器或兩者。ChatGPT 和 Codex 共用同一個外掛程式目錄。

連接器(Connector) 由 MCP 伺服器提供支援的外部服務連線,可以帶自定義 ChatGPT 介面。

MCP(模型上下文協議) 給智慧體接外部工具的協議。兩種形態:STDIO(本地程序)和 Streamable HTTP(通過地址存取)。 → 進階 02

鉤子(Hooks) 在特定時機(如 PreCompact / PostCompact / SessionStart)觸發的自定義動作。 → 鉤子

指令與執行方式 ​

codex exec 非互動模式。進度流到 stderr,只有最終訊息打到 stdout。 預設在只讀沙盒裡跑。→ 進階 04

--ephemeral 這次執行不在磁碟上持久儲存工作階段記錄。

--output-schema 要求最終響應符合指定的 JSON Schema,供下游自動化消費。

工作樹(Worktree) Git 工作樹,把改動隔離在一個單獨的檢出裡,不碰你正在編輯的分支。 桌面應用開 Codex 聊天時可以選這個模式。→ Git 工作樹

Codex 雲端(Codex cloud) 在 OpenAI 託管的隔離容器裡跑。兩階段模型:設定階段可聯網裝依賴, 智慧體階段預設離線;給環境配的機密只在設定階段可用。必須用 ChatGPT 賬號登入。

配置方案(Profile) 存成 ~/.codex/profile-name.config.toml 的一組設定,用 --profile profile-name 選。

壓縮(Compaction) 上下文逼近閾值時把歷史濃縮成摘要。相關配置:model_auto_compact_token_limit、 model_auto_compact_token_limit_scope。

介面 ​

Codex CLI — 終端裡的 Codex,也是唯一能直接進指令碼和 CI 的形態。

Codex IDE 擴充功能 — 編輯器裡的 Codex。

ChatGPT 桌面應用 — macOS / Windows / Linux;開 Codex 聊天時選本地、工作樹或雲端。

ChatGPT Work — 要一份能審的成品時用的模式,和「聊天」「Codex」在同一個切換器裡。

相關官方文件 ​

非官方社群教程 · 「官方文件」區為 learn.chatgpt.com 中文原文映象 · 以官方頁面為準