选gpt-5.4生成中等复杂度技术文档最稳；轻量级用gpt-5.3-codex，高结构化才需gpt-5.5。CLI用--model参数或改config.yaml，VS Code插件需确认通道支持，Web版须登录Plus/Pro账号才可见gpt-5.5。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Codex生成文档时选错模型，会导致注释啰嗦、结构混乱、术语错误甚至漏掉关键章节，尤其在写API文档、技术白皮书或团队内部规范时特别明显。
先确认你生成的是哪类文档
技术文档分三类：轻量级（如函数注释、README片段）、中等复杂度（如模块说明、配置指南）、高结构化（如跨服务接口协议、SDK使用手册）。模型选错，轻文档会变冗长，重文档会丢逻辑链。
gpt-5.3-codex适合第一类——它响应快、术语精准、不擅自扩展上下文；gpt-5.4对第二类最稳，能保持段落层级和术语一致性；gpt-5.5只在第三类才真正必要，比如你要让Codex基于5个微服务代码文件自动生成一份带调用时序图的集成文档。
CLI命令行生成文档时的模型指定方法
方法一：直接在命令中加--model参数
执行codex generate --input docs/req.md --output api-spec.md --model gpt-5.4。这一步操作起来很简单，但注意：如果当前CLI版本低于0.132.0，该参数会被忽略，默认回落到gpt-5.3-codex。
方法二：改配置文件中的默认模型
打开~/.codex/config.yaml，找到model:这一行，把右边值改成gpt-5.4。⚠️【改完必须重启codex服务，否则新配置不生效】。这个设置会影响所有后续未显式指定模型的命令，包括codex explain和codex doc子命令。
通过 Codex CLI 生成图片，支持尺寸控制和批量模式。依赖：codex (npm)。代理默认启用。用 generate.sh 生成单张，batch_generate.sh 批量生成游戏 UI 素材，gen_size.sh 指定尺寸。所有输出保存至 ~/.codex/generated_images/。
VS Code插件里生成文档怎么选模型
第一步：右键点击待生成文档的代码文件 → 选择「Codex: Generate Documentation」
第二步：弹出的输入框下方会出现模型选择器，点击下拉箭头 → 从列表中选gpt-5.4（日常首选）或gpt-5.5（多文件联动场景）
第三步：确认后等待生成。如果生成结果出现“此处应补充鉴权流程但未展开”，说明模型推理强度不够，需手动在插件设置里将model_reasoning_effort调为medium或high。
注意：插件界面里看不到gpt-5.5选项？那说明你当前走的是API key直连通道，不是官方ChatGPT全计划通道——【强行在设置里填gpt-5.5会导致生成中断并报错“model not found”】，此时请改用gpt-5.4。
Web版生成文档的模型切换路径
进入Codex Web界面 → 点击左下角「Model」下拉框 → 选择gpt-5.4 → 在编辑区粘贴原始代码或需求描述 → 点击「Generate Doc」按钮。
这一步不需要重启、不用改配置，选完立刻生效。但要注意：Web版的「Model」框只有在登录Plus/Pro/Business账号后才会显示gpt-5.5选项；Free用户最多看到gpt-5.4，别浪费时间找不存在的选项。
