Codex 测试中模拟外部接口有三种方式：一是用 codex-bridge 做协议级 Mock 代理，需配置 .env 和 openapi.yaml 并修改 config.toml；二是用 Postman 导出 OpenAPI 后通过 mocki.co 创建轻量 Mock；三是直接在 SKILL.md 中硬编码 mock_response 字段实现单点快速验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在 Codex 测试中模拟外部接口，是为了避免真实调用导致的网络延迟、鉴权失败、计费消耗或数据污染，尤其在本地调试 Skill 或 MCP 工具时必须隔离依赖。真实接口未就绪、测试环境无权限、或想验证异常响应路径时，Mock 是唯一可控手段。
用 codex-bridge 做协议级 Mock 代理
第一步：下载 codex-bridge 项目 ZIP 包并解压到本地任意文件夹，例如 C:\mock-proxy\。
第二步：进入解压目录，复制 env.example 并重命名为 .env，用记事本打开，在 MOCK_MODE=true 行取消注释（删除开头的 #），再添加两行：
MOCK_SPEC=openapi.yamlMOCK_PORT=3001
第三步：在同目录下新建一个 openapi.yaml 文件，把你要模拟的接口用 OpenAPI 3.0 格式写进去——必须包含 paths、components.schemas 和至少一个 200 响应示例。Codex 启动后会按这个定义返回结构化 JSON，而不是发真实请求。
第四步：双击运行你之前创建的 启动codex-bridge.cmd（内容为 node --env-file=.env proxy.mjs）。终端输出 Mock server listening on http://localhost:3001 即表示就绪。
第五步：修改 ~/.codex/config.toml，将 base_url 指向 http://localhost:3001，同时确保 wire_api = "responses"。重启 Codex 后所有对外 API 调用都会被拦截并按 openapi.yaml 返回预设响应。
用 Postman + OpenAPI 导出做轻量 Mock
方法一：在 Postman 中选中已调试通的 Collection → 点右上角「⋯」→ Export → 选择「OpenAPI 3.0」格式导出为 mock-api.json。
依托用户知识库、工作记录、项目文件、会议纪要、表格、图片、文稿及评审材料生成高质量职场汇报演示文稿。适用于试用期考核、转正述职、晋升答辩、年度总结、项目进度汇报、项目评审、方案说服、资源申请、部门规划、业务优化或管理决策类 PPT 制作；Codex 需先明确汇报目标、提取佐证材料、生成规范说明书、适配汇报时长、搭建内容大纲、设计每页幻灯片内容，最后生成附带讲稿与佐证材料核对清单的 PPTX 文件。
方法二：访问 mocki.co 网站，粘贴刚导出的 JSON 内容 → 点击「Create Mock」→ 复制生成的 Mock URL（形如 https://5f8b.mocki.io/api/v1/users）。
方法三：在 config.toml 中临时把目标接口的 base_url 替换为该 Mock URL，注意删掉末尾路径，只保留到 /v1 或根域名层级。Codex 发请求时会自动拼接 path，所以 https://5f8b.mocki.io 就够了。
【关键限制】 mocki.co 免费版不支持自定义响应头、无法模拟 401/429 等状态码，仅适合验证 200 成功路径。
在 Skill 中硬编码 Mock 响应
第一步：打开你的 Skill 项目根目录下的 SKILL.md 文件。
第二步：在「工具定义」区块里，找到对应外部接口的 tool 描述，添加一行 mock_response: {"id": "usr_abc123", "status": "active"}。
第三步：保存文件，重新加载 Skill（在 Codex CLI 中执行 codex skill reload）。
第四步：当 Codex 触发该 tool 时，它将跳过网络请求，直接返回你写的 JSON 字符串。这一步无需改 config.toml，也不依赖任何代理服务，适合单点快速验证逻辑流。
