高阶玩法

把 Codex 用顺手,关键在配好审批策略、给足项目上下文,再把 Profile、MCP 和非交互模式利用起来。命令速查见 命令大全。

#AGENTS.md 项目说明

在项目根放 AGENTS.md,Codex 会读取它了解项目约定,类似 Claude Code 的 CLAUDE.md。

# 项目约定

技术栈:Python + FastAPI
包管理:uv(不要用 pip)

## 命令
- 启动:uv run uvicorn app:main
- 测试:uv run pytest

## 风格
- 类型注解必须写
- 改完跑 pytest 确认通过

#config.toml 进阶

几个常用项(完整见 CLI 配置):

启动时还能用 -c key=value 临时覆盖任意配置,例如 codex -c model_reasoning_effort=high,不必改文件。

#用 Profile 一键切换配置

把不同场景的配置打包成 Profile,用 --profile 切换,免去反复改 config.toml。

# 默认温和;另开一个高自由度 profile 给可信项目
[profiles.fast]
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
approval_policy = "on-failure"
sandbox_mode = "workspace-write"

codex --profile fast "把这个模块补上测试"

#用 MCP 接入外部工具

通过 MCP(Model Context Protocol),Codex 能调用外部工具与数据源 —— 浏览器、数据库、内部 API 等。在 config.toml 里声明服务器即可:

[mcp_servers.my-tool]
command = "npx"
args = ["-y", "@scope/my-mcp-server"]
# env = { API_KEY = "..." }

接好后会话里用 /mcp 查看可用工具与连接状态。

#非交互模式:脚本与 CI

codex exec 不进入 TUI,直接跑完退出,适合放进脚本、git hook 或 CI:

# 一次性任务
codex exec "修复 lint 报错并跑一遍测试"

# 配合管道:把 diff 交给它总结
git diff --staged | codex exec "用一句中文总结这些改动作为 commit message"

无人值守时务必配合收紧的审批 / 沙箱(如 --sandbox read-only 或限定 workspace-write),别直接全放开。

#审批与沙箱

Codex 的安全模型由 approval_policy + sandbox_mode 共同决定:

命令行也能临时指定:--full-auto 在工作区内自动读写;-a(--ask-for-approval)与 -s(--sandbox)分别覆盖审批与沙箱级别;-C <目录> 指定工作目录。

#常见工作流

#接着看