新手術語速查表
給第一次使用 Codex 的中文開發者快速查詞，先知道概念在哪些場景出現，再去讀對應章節。
📖 本篇術語速查表
| 英文 / 縮寫 | 中文 | 一句話解釋 |
|---|---|---|
| Coding Agent | 編碼代理 | 能進專案現場讀、改、跑、驗的 AI。 |
| sandbox | 沙箱 | 限制 Codex 技術上能不能做某動作的邊界。 |
| AGENTS.md | — | 專案與 Agent 的協作介面檔案。 |
不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你自測對 Codex 核心概念是否真懂，而不是隻記名詞。
你是 Codex 概念自測顧問，幫我檢查對 Codex 核心術語是否真的理解，而不是隻記住名詞。
【角色】
你掌握 Codex 的核心概念（Agent、sandbox、approval、AGENTS.md、MCP、Skill 等），能透過提問檢驗理解深度。
【輸入】
- 我自認為已經懂的概念：___
- 我用 Codex 的主要場景：___
- 我最模糊的地方：___
【工作流程】
1. 針對我的場景挑出最該懂的核心概念
2. 用具體問題檢驗我是真懂還是隻記名詞
3. 指出理解誤區
4. 給補強的最小閱讀建議
【輸出規範】
▌一、該場景最核心的概念清單
▌二、檢驗問題 + 期望答案要點
▌三、常見理解誤區
▌四、補強閱讀建議
【硬約束】
- 檢驗基於應用而非背誦
- 誤區要具體，不空泛
- 不確定的概念標註需查官方文件
- 優先檢驗 sandbox / approval / 上下文這些最容易出事的概念這頁給第一次使用 Codex 的中文開發者快速查詞。先知道這些詞在什麼場景出現，再去讀對應章節，會比一開始背概念更穩。
新手第一天只需要掌握 Codex、Thread、Sandbox、Approval、AGENTS.md、Prompt、Diff 和 Validation。MCP、Skills、Subagents、Hooks 等穩定完成小任務後再學。
核心概念
Codex：OpenAI 面向程式設計任務的 AI coding agent。會在讓它讀專案、改程式碼、跑測試、解釋報錯時遇到。
Agent：能根據目標持續執行多步任務的 AI 助手。會在 Codex 規劃步驟、呼叫工具、等待命令結果時遇到。
Thread：一次連續任務對話。App、Cloud 或 IDE 裡管理多個任務時會看到。
Local thread：在本機專案裡執行的任務。需要讀取本地檔案、修改本機程式碼時使用。
Cloud task：在雲端環境執行的任務。適合非同步等待結果、檢視記錄、建立 PR。
App：Codex 桌面應用，適合本機專案、並行 threads、worktrees、review pane 和 Git 操作。
IDE extension：Codex 編輯器擴充套件，適合在 VS Code、Cursor、Windsurf 等編輯器裡結合目前檔案和選區工作。
CLI：終端裡的 Codex，適合本地工程命令、指令碼化、codex exec、MCP 管理和設定除錯。
Web / Cloud：瀏覽器裡的 Codex 入口，適合連線 GitHub repository，在 cloud environment 中後臺執行任務。
安全和設定
Sandbox：限制 Codex 能訪問和能執行什麼的安全邊界。看到檔案讀寫、命令執行、網路訪問限制時要先看它。
Approval：Codex 執行敏感操作前向你確認。它要聯網、寫檔案、跑有風險命令時會觸發。
AGENTS.md：給 Codex 看的專案規則檔案。適合固定專案約定、測試命令、禁止事項。
config.toml：Codex 的本地設定檔。用於調整模型、審批、沙箱、工具等設定。
Rules：控制某些命令字首 allow、prompt 或 forbidden。它不能替代 sandbox 和人工 review。
Approval policy：決定 Codex 什麼時候暫停請求許可。常見值包括 on-request、never、untrusted。
Sandbox mode：決定 Codex 命令技術上能做什麼。常見值包括 read-only、workspace-write、danger-full-access。
Writable roots：workspace-write 模式下額外允許寫入的目錄。需要跨目錄工作時優先考慮它，而不是直接 full access。
Network access：Codex 是否能訪問網路。CLI / IDE / App 與 Cloud 的預設邊界不同，開啟公網前要確認必要性。
Managed config：組織或團隊下發的設定，用來統一安全、模型、許可權或企業治理要求。
擴充套件能力
MCP：讓 Codex 接入外部工具和上下文的協議。需要連線 GitHub、文件、資料庫、搜尋等工具時會遇到。
Skill：可複用的任務能力包。適合把常用流程沉澱給 Codex 反覆使用。
Subagent：把大任務拆給更小的專門 agent。適合並行探索或分模組處理。
Hook：在特定時機自動執行的檢查或命令。適合任務前後自動 lint、test、記錄記錄。
Workflow：多步驟任務編排。適合把固定工作流交給 Codex 按順序執行。
Plugin：把工具、技能或整合能力打包給 Codex 使用。適合團隊安裝和分發擴充套件。
App connector：讓 Codex 呼叫外部應用能力的聯結器。需要注意 destructive actions 和 approval。
OpenAI Docs skill：查詢 OpenAI 官方文件的技能。寫 Codex、API、模型相關內容時優先用官方資料。
工程協作
Worktree：Git 裡的獨立工作區。讓多個任務並行改程式碼，減少互相影響。
Computer Use：讓 Codex 操作電腦介面。需要開啟 App、點選頁面、做人工驗收時使用。
Prompt：你給 Codex 的任務說明。描述目標、邊界、交付物時使用。
Diff：檔案修改前後的差異。Codex 改完後用它審查具體變更。
Validation：確認改動真的可用的驗證步驟，包括測試、構建、截圖、人工檢查。
Review pane：Codex App 裡審查檔案差異的介面。它可能顯示整個 Git state，不一定只顯示 Codex 修改的檔案。
Last turn changes：只檢視上一輪 Codex 變更的檢視。排查“為什麼出現不是 Codex 改的檔案”時很有用。
Handoff：在 Local 和 Worktree 之間移動 thread 和程式碼。適合把後臺 worktree 任務帶回本地審查。
Local environment：Codex App 的專案級環境設定，用來給 worktrees 配 setup scripts 和常用 actions。
Action：Local environment 裡定義的常用命令，例如 build、dev、test、lint。
Automation：Codex App 中按計劃執行的任務。Git repository 中通常使用後臺 worktree，非 Git 專案會直接在專案目錄執行。
Thread automation：繫結在某個 thread 上的週期性喚醒，適合持續跟進同一個上下文。
Artifact：Codex 生成或展示的非程式碼產物，例如文件、表格、圖片、報告或預覽檔案。
常見易混詞
| 詞 | 容易誤解 | 正確理解 |
|---|---|---|
| Sandbox | 等於安全無風險 | 它只是技術邊界，仍要 review diff 和命令 |
| Approval | 點了就永久授權 | approval scope 可能不同，要看 approve once 還是 session |
| Cloud task | 會使用本機檔案 | 它執行在 cloud environment，不讀取本機未提交檔案 |
| Worktree | 自動避免所有衝突 | 只隔離 checkout，任務邊界仍要人定義 |
| Skill | 魔法能力 | 可複用 instructions 和指令碼，仍要驗證輸出 |
| MCP | 越多越好 | MCP 擴充套件工具面，也擴大許可權和風險面 |
| Validation | Codex 說跑過就算 | 要看真實命令輸出、截圖、記錄或檢查結果 |
| Review pane | 只顯示 Codex 改動 | 預設可能顯示目前 Git state |
新手優先順序
第一天必須懂：
- Codex
- Thread
- Prompt
- Diff
- Validation
- Sandbox
- Approval
- AGENTS.md
完成幾個小任務後再學：
- config.toml
- Worktree
- Local environment
- MCP
- Skill
- Subagent
團隊協作或自動化階段再學：
- Hook
- Workflow
- Plugin
- Automation
- Managed config
- App Server
判斷法
遇到新詞時，不要先問“定義是什麼”，先問三個問題：
- 它是在限制 Codex、擴充套件 Codex，還是讓 Codex 執行任務？
- 它會不會影響本機檔案、網路、憑據或程式碼儲存庫？
- 我需要現在就設定它，還是等真實場景出現再學？
能回答這三個問題，再去讀對應章節，學習效率更高。