执行摘要

• 一句话：新增 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 则文档中的配置无法工作。