# PR #41358 完整报告

- 仓库：`vllm-project/vllm`
- 标题：[Doc] Add Codex usage example
- 合并时间：2026-05-02 13:27
- 原文链接：http://prhub.com.cn/vllm-project/vllm/pull/41358

---

# 执行摘要

- 一句话：新增 Codex 集成使用文档
- 推荐动作：该 PR 是纯文档新增，内容结构清晰，但示例命令中存在遗留问题（模型名、参数）需要 fix。建议在后续 PR 中更新模型名为实际存在的版本，并补全 `--served-model-name` 等必要参数，同时修复 Codex 链接。值得参考其清晰的文档结构和配置说明。

# 功能与动机

代码补全工具 Codex 可以通过 OpenAI-Responses API 接入 vLLM，允许用户使用本地模型替代 OpenAI API。该文档旨在指导用户完成集成配置，提升 vLLM 在 Agentic 编程场景的可用性。关联 PR #41355 实现了底层的 Responses API 支持。

# 实现拆解

本 PR 仅新建了一份 Markdown 文档，无代码变更：
1. **新建文档**：在 `docs/serving/integrations/codex.md` 中编写完整的使用指南，涵盖 Codex 简介、工作原理、模型要求、安装步骤、vLLM 服务启动命令及 Codex 的 TOML 配置示例。
2. **示例配置**：文档中提供了一个完整的 `config.toml` 示例，配置了 `model_providers.vllm` 相关字段，并详细解释了每个字段的含义。
3. **依赖说明**：明确文档依赖于 PR #41355 提供的 Responses API 支持。

关键文件：
- `docs/serving/integrations/codex.md`（模块 文档；类别 docs；类型 documentation）: 唯一变更文件，新增 Codex 集成使用文档，包含配置示例和启动命令。

关键符号：未识别


# 评论区精华

自动化机器人 gemini-code-assist[bot] 提出了三个高优先级问题：
- 链接失效：文档中 Codex 仓库链接 `https://github.com/openai/codex` 返回 404，建议提供正确的链接。
- 模型版本错误：示例中的 `Qwen/Qwen3-27B` 不存在，建议改为 `Qwen/Qwen2.5-Coder-32B-Instruct`。
- 命令参数缺漏：建议添加 `--served-model-name my-model` 以匹配配置中的模型名；同时建议调整 `tensor-parallel-size` 和 `max-model-len` 以适应典型本地环境。
这些评论均未得到作者回复或代码修改，文档最终合入时的内容与原始提交一致，因此这些问题在合并时仍存在。

- 链接失效 (documentation): 未修复，文档合入时仍使用原链接。
- 模型版本错误 (documentation): 未采纳，最终文档仍使用 Qwen3 版本（合入时实际为 Qwen3.6-27B）。
- 启动命令缺参数 (documentation): 未采纳，最终命令未包含该参数。

# 风险与影响

- 风险：作为纯文档变更，无直接技术风险。但示例命令中使用了不存在的模型名和不正确的工具调用解析器（`qwen3_coder` 可能尚未稳定），可能导致用户启动失败。此外，链接无效会降低文档可信度。
- 影响：
 - 用户侧：为希望使用本地模型代替 OpenAI API 的 Codex 用户提供配置指引，有助于提升 vLLM 在开发工具生态中的使用率。
 - 系统侧：无影响。
 - 团队侧：新增的文档需要保持同步更新，尤其是模型支持列表和参数变化时。
 - 风险标记：文档示例可能误导用户

# 关联脉络

- PR #41355 [Responses API] Support OpenAI Responses API: 本文档依赖的底层 API 实现 PR，没有此 PR 则文档中的配置无法工作。