Codex CLI 示例 - Yelu AI API

以下示例假设已经按照 Codex CLI 配置指南配置 yelu Provider。请在 Git 仓库中运行，并确保当前环境已经设置 YELU_API_KEY。

在只读 Sandbox 中分析

macOS WSL

codex --model gpt-5.4 --sandbox read-only \
  "解释当前仓库的架构、入口、外部依赖、测试覆盖和运行风险。引用检查过的文件，不要修改任何内容。"

进入交互界面后，使用 /status 检查 Yelu Provider，通过 /permissions 查看或调整执行边界。

实现并验证改动

macOS WSL

codex --model gpt-5.4 --sandbox workspace-write \
  "为用户创建接口增加输入校验。保持响应契约不变，为有效和无效请求添加聚焦测试，运行相关检查，并展示最终 Diff 摘要。"

workspace-write 允许在当前 Workspace 内编辑，同时保留 Sandbox 边界。提交前检查 Diff 与测试输出。

审查本地改动

审查所有已暂存、未暂存和未跟踪的改动，并保持工作区不变：

Terminal

codex review --uncommitted \
  "优先检查正确性、授权漏洞、数据丢失、并发风险和缺失的回归测试，包含文件与行号。"

审查相对于基准分支的改动：

Terminal

codex review --base main

运行非交互审计

Terminal

codex exec --model gpt-5.4 --sandbox read-only --ephemeral \
  "审计认证与授权边界，输出包含严重程度、证据和修复建议的具体问题；不要修改文件。"

--ephemeral 不保存本次 Session Rollout。最终回答写入标准输出，过程信息写入标准错误。

保存最终报告

codex exec --model gpt-5.4 --sandbox read-only \
  --output-last-message audit.md \
  "总结测试缺口，并提出最小且高价值的测试计划。"

codex exec --model gpt-5.4 --sandbox read-only `
  --output-last-message audit.md `
  "总结测试缺口，并提出最小且高价值的测试计划。"

使用图片上下文

可以附加错误截图、UI 参考图或架构图：

codex --model gpt-5.4 --image ./error.png \
  "诊断截图中的错误，定位相关代码并给出最小修复方案。"

codex --model gpt-5.4 --image .\error.png `
  "诊断截图中的错误，定位相关代码并给出最小修复方案。"

恢复最近的 Session

Terminal

codex resume --last

同一仓库有多个任务时，执行 codex resume 打开 Session Picker。

添加仓库指令

可以在 Codex 中执行 /init，或提交经过 Review 的 AGENTS.md：

AGENTS.md

# Repository guidance

## Validation
- Run `npm test` for unit tests.
- Run `npm run lint` and `npm run typecheck` before completion.
- Add regression coverage for every fixed bug.

## Boundaries
- Do not read `.env`, credential files, or production exports.
- Do not change lockfiles unless dependencies intentionally change.
- Do not run deployments or irreversible database operations.
- Keep changes focused on the requested task.

普通本地开发应始终保留 Sandbox 与 Approval。只有进程已经运行在单独加固的一次性环境中时，才考虑 --dangerously-bypass-approvals-and-sandbox。

​在只读 Sandbox 中分析

​实现并验证改动

​审查本地改动

​运行非交互审计

​保存最终报告

​使用图片上下文

​恢复最近的 Session

​添加仓库指令

在只读 Sandbox 中分析

实现并验证改动

审查本地改动

运行非交互审计

保存最终报告

使用图片上下文

恢复最近的 Session

添加仓库指令