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;捆绑的浏览器插件仅适用于 Codex 应用。