Codex 除錯
在調查 Codex CLI/應用行為、設定解析、工具行為、提示、MCP/應用接線或執行時期錯誤時使用。
原始碼優先
在查閱網頁/文件之前,優先使用本地原始碼:
cd ~/Projects/codex
sed -n '1,220p' codex-rs/AGENTS.md
然後搜尋目標區域:
rg "<symbol|setting|error|feature>" codex-rs/{core,tui,exec,cli,app-server,app-server-protocol,config}
工作流程
- 識別問題行為是 CLI、TUI、應用伺服器、協定、設定,還是執行/工具相關。
- 在提出修改之前,先閱讀所屬模組及其相鄰的測試。
- 只有在理解原始碼合約之後,才檢查
~/.codex/config.toml中的本地設定。 - 偏好使用小型重現案例或焦點測試,而非廣泛的猜測。
備註
- 對於 OpenAI API/產品文件,僅在原始碼不足時才使用 official-docs 路徑。
- 若需在 CLI 中進行本地瀏覽器自動化,請使用
$browser-use;捆綁的 Browser 外掛僅限於 Codex 應用程式。