大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



這是在 X 看到的文章 Getting started with Codex: Best practices for better results，翻譯後分享給大家。

--

如果你是第一次使用 或一般的程式代理（coding agents），這份指南可以幫助你更快取得更好的成果。
內容涵蓋讓 Codex 在 CLI、IDE 擴充套件與 Codex App 中更有效率的核心習慣，從 提示（prompting）、規劃（planning）、驗證（validation）、MCP、技能（skills）到自動化（automations）。

Codex 的**使用方式，是 不要把它當成一次性的助手，而是把它當成一位可以長期配置與優化的團隊夥伴。

一個實用的思考模型是：

• 先提供正確的任務上下文
• 使用 AGENTS.md 提供長期可持續的指引
• 讓 Codex 配置成符合你的工作流程
• 用 MCP 連接外部系統
• 將重複工作變成 Skills
• 將穩定流程變成 Automations

不過 清楚的提示能讓結果更可靠，尤其是在：

• 大型程式碼庫
• 重要或高風險任務

如果你在大型或複雜的專案中工作，最大的提升通常來自：

提供正確的任務上下文與明確的任務結構。

建議在提示中包含四個部分：

Goal（目標）
你想要修改或建立什麼？

Context（上下文）
哪些檔案、資料夾、文件、範例或錯誤訊息與任務相關？
你可以使用 @提及檔案 來提供上下文。

Constraints（限制條件）
需要遵循哪些標準、架構、安全規則或開發慣例？

Done when（完成條件）
任務完成時應該滿足哪些條件，例如：

• 測試通過
• 行為改變
• bug 修復

這樣可以幫助 Codex：

• 限制工作範圍
• 減少錯誤假設
• 產出更容易檢查與驗證的結果

可依任務難度調整推理程度：

• Low：快速、範圍明確的任務
• Medium / High：較複雜的修改或除錯
• Extra High：長時間推理、代理型任務

新手建議：

先從小成功開始，例如：

• 問 Codex 有關程式碼庫的問題
• 讓它修一個小 bug

另外，Codex App 的語音輸入功能可以大幅提升操作速度。

如果任務：

• 很複雜
• 描述模糊
• 難以清楚說明

建議 先讓 Codex 規劃（plan），再開始寫程式。

常見方法：

對多數使用者來說最簡單有效。

Plan Mode 會讓 Codex：

• 收集上下文
• 提出澄清問題
• 建立更完整的實作計畫

開啟方式：

/plan

或

Shift + Tab

如果你只有模糊想法，可以請 Codex：

• 先向你提問
• 挑戰你的假設
• 把模糊想法變成具體需求

再開始寫程式。

在較進階流程中，可以使用：

PLANS.md

來定義長任務或多步驟執行計畫。

當某種提示方式有效後，下一步就是：

不要再每次手動重複提示。

這時就要使用：

AGENTS.md

你可以把它想像成：

AI 代理的 README

它是一種簡單的開放格式，會自動加入到上下文中，最適合用來定義：

Codex 在這個專案中的工作方式

一個好的 AGENTS.md 通常包含：

• 專案目錄結構
• 如何執行專案
• build / test / lint 指令
• 工程開發規範
• PR 規則
• 禁止事項
• 完成標準與驗證方式

CLI 中可以用：

/init

快速建立 AGENTS.md。

但建議依照團隊實際流程修改。

你可以建立多層：

全域設定

~/.codex/AGENTS.md

專案層級

repo/AGENTS.md

子資料夾層級

repo/subdir/AGENTS.md

越接近目前工作目錄的檔案優先權越高。

AGENTS.md 應該：

• 簡短
• 準確
• 可操作

而不是長篇抽象規則。

如果 Codex 重複犯同樣錯誤：

1. 請它做一次回顧（retrospective）
2. 更新 AGENTS.md

配置（configuration）可以讓 Codex：

• 跨 session
• 跨工具
• 行為更一致

可以設定：

• 模型
• 推理等級
• sandbox
• approval policy
• profiles
• MCP

建議配置方式：

個人設定

~/.codex/config.toml

專案設定

repo/.codex/config.toml

CLI 覆蓋

只用於一次性設定。

config.toml 可定義：

• MCP servers
• profiles
• multi-agent
• 實驗功能

Codex 有兩個重要控制：

Approval mode

何時需要你批准指令。

Sandbox mode

Codex 可以讀寫哪些檔案。

新手建議：

先使用保守權限

只在可信任專案中放寬。

不要只讓 Codex 修改程式碼。

同時要求它：

• 建立測試
• 執行測試
• 驗證結果
• 檢查程式碼

例如：

• 撰寫或更新測試
• 執行測試套件
• lint / formatting / type check
• 確認行為符合需求
• 檢查 diff

Codex App 中可開啟：

diff panel

逐行檢視修改。

/review 指令

/review

可進行：

• PR review
• 未提交變更 review
• commit review
• 自訂 review

如果有：

code_review.md

也可以讓 Codex 遵循。

如果 Codex 所需資訊不在 repo 中，可以使用：

MCP（Model Context Protocol）

它是一個開放標準，讓 Codex 連接：

• 外部工具
• API
• 系統

適合情境：

• 資料不在 repo
• 資料經常變動
• 想讓 Codex 使用工具
• 需要跨專案整合

Codex 支援：

• STDIO
• Streamable HTTP
• OAuth

當某個流程開始重複時：

不要再寫長 prompt。

建立：

SKILL.md

Skills 可以包含：

• 指令
• 上下文
• 腳本
• 邏輯

適合任務：

• log triage
• release notes
• PR review
• migration planning
• incident summary
• debugging

當流程穩定後，可以建立：

Automation

讓 Codex 在背景定期執行。

可設定：

• project
• prompt
• schedule
• execution environment

例如：

• commit summary
• bug scan
• release notes
• CI failures
• standup summary

Codex session 不只是聊天紀錄。

它是：

累積上下文與決策的工作線程。

CLI 常用指令：

/resume
/fork
/compact
/agent
/theme
/apps
/status

建議：

一個 thread 對應一個問題。

新手常見問題：

• 把規則寫在 prompt 而不是 AGENTS.md
• 沒告訴 agent 如何 build/test
• 跳過 planning
• 一開始就給完整權限
• 多個 thread 修改同一檔案
• 尚未穩定就自動化

開始使用 Codex 時：

• 提供 Goal / Context / Constraints / Done when
• 困難任務先 planning
• 建立 AGENTS.md
• 設定 build / test / review
• 設定 config
• 連接 MCP
• 建立 Skills
• 使用 Automations

當你把 工作流程、標準與上下文都轉換成 Codex 可以理解的形式後，你就會真正看到 AI coding agent 的威力。

現在就開始吧。