---
title: "新手術語速查表"
description: "給第一次使用 Codex 的中文開發者快速查詞，先知道概念在哪些場景出現，再去讀對應章節。"
verifiedAt: "2026-05-07"
---

import { Cards, Card } from 'fumadocs-ui/components/card';

這頁給第一次使用 Codex 的中文開發者快速查詞。先知道這些詞在什麼場景出現，再去讀對應章節，會比一開始背概念更穩。

> [!TIP]
> 新手第一天只需要掌握 Codex、Thread、Sandbox、Approval、AGENTS.md、Prompt、Diff 和 Validation。MCP、Skills、Subagents、Hooks 等穩定完成小任務後再學。

<Cards>
  <Card title="Quickstart" href="/zh-Hant/docs/codex/official/00-getting-started/01-quickstart">
    先完成一次只讀到小改動的閉環。
  </Card>
  <Card title="Codex overview" href="/zh-Hant/docs/codex/official/00-getting-started/00-codex-positioning">
    理解 Codex 和普通聊天機器人的差別。
  </Card>
  <Card title="Sandbox" href="/zh-Hant/docs/codex/official/02-config-security/49-sandbox-boundaries">
    先弄清許可權邊界，再學擴充套件能力。
  </Card>
</Cards>

## 核心概念

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

## 判斷法

遇到新詞時，不要先問“定義是什麼”，先問三個問題：

1. 它是在限制 Codex、擴充套件 Codex，還是讓 Codex 執行任務？
2. 它會不會影響本機檔案、網路、憑據或程式碼儲存庫？
3. 我需要現在就配置它，還是等真實場景出現再學？

能回答這三個問題，再去讀對應章節，學習效率更高。

## 官方資料

- [OpenAI Codex overview](https://developers.openai.com/codex)
- [OpenAI Codex Quickstart](https://developers.openai.com/codex/quickstart)
- [OpenAI Codex configuration reference](https://developers.openai.com/codex/config-reference)
- [Codex CLI reference](https://developers.openai.com/codex/cli/reference)
- [Codex App features](https://developers.openai.com/codex/app/features)
- [Agent approvals & security](https://developers.openai.com/codex/agent-approvals-security)
