> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yelu.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex CLI 示例

> 通过 Yelu 使用 Codex CLI 安全完成仓库分析、功能实现、代码审查、图片输入和非交互自动化。

以下示例假设已经按照 [Codex CLI 配置指南](/zh/guides/codex-cli) 配置 `yelu` Provider。请在 Git 仓库中运行，并确保当前环境已经设置 `YELU_API_KEY`。

## 在只读 Sandbox 中分析

```bash macOS / Windows / WSL theme={"theme":{"light":"github-light","dark":"github-dark"}}
codex --model gpt-5.4 --sandbox read-only \
  "解释当前仓库的架构、入口、外部依赖、测试覆盖和运行风险。引用检查过的文件，不要修改任何内容。"
```

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

## 实现并验证改动

```bash macOS / Windows / WSL theme={"theme":{"light":"github-light","dark":"github-dark"}}
codex --model gpt-5.4 --sandbox workspace-write \
  "为用户创建接口增加输入校验。保持响应契约不变，为有效和无效请求添加聚焦测试，运行相关检查，并展示最终 Diff 摘要。"
```

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

## 审查本地改动

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

```bash Terminal theme={"theme":{"light":"github-light","dark":"github-dark"}}
codex review --uncommitted \
  "优先检查正确性、授权漏洞、数据丢失、并发风险和缺失的回归测试，包含文件与行号。"
```

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

```bash Terminal theme={"theme":{"light":"github-light","dark":"github-dark"}}
codex review --base main
```

## 运行非交互审计

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

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

## 保存最终报告

<CodeGroup>
  ```bash macOS / WSL theme={"theme":{"light":"github-light","dark":"github-dark"}}
  codex exec --model gpt-5.4 --sandbox read-only \
    --output-last-message audit.md \
    "总结测试缺口，并提出最小且高价值的测试计划。"
  ```

  ```powershell Windows PowerShell theme={"theme":{"light":"github-light","dark":"github-dark"}}
  codex exec --model gpt-5.4 --sandbox read-only `
    --output-last-message audit.md `
    "总结测试缺口，并提出最小且高价值的测试计划。"
  ```
</CodeGroup>

## 使用图片上下文

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

<CodeGroup>
  ```bash macOS / WSL theme={"theme":{"light":"github-light","dark":"github-dark"}}
  codex --model gpt-5.4 --image ./error.png \
    "诊断截图中的错误，定位相关代码并给出最小修复方案。"
  ```

  ```powershell Windows PowerShell theme={"theme":{"light":"github-light","dark":"github-dark"}}
  codex --model gpt-5.4 --image .\error.png `
    "诊断截图中的错误，定位相关代码并给出最小修复方案。"
  ```
</CodeGroup>

## 恢复最近的 Session

```bash Terminal theme={"theme":{"light":"github-light","dark":"github-dark"}}
codex resume --last
```

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

## 添加仓库指令

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

```markdown AGENTS.md theme={"theme":{"light":"github-light","dark":"github-dark"}}
# 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.
```

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