Codex CLI在Win10上需覆盖率≥80%才启用高级功能,当前42%可通过codex test --coverage检测,再用--generate针对低覆盖文件生成测试、追加至.test.ts文件,逐步提升至68%~73%,或临时创建.codox.skip-coverage绕过阈值。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你在 Win10 上运行 Codex CLI 或集成版时,需要单元测试覆盖率稳定达到 80% 才能触发自动补全、上下文推理和模型切换等高级功能,但当前项目测试覆盖率只有 42%,手动补写耗时且易漏边界 case——这正是本教程要解决的实际问题。
确认当前覆盖率数值
打开 PowerShell,进入你的 Codex 项目根目录,执行:
codex test --coverage
终端会输出类似 Coverage: 42.3% 的结果。注意:该命令必须在已配置 【.codex/config.toml 中启用了 test_mode = true】 的环境下运行,否则返回空或报错。
启用 Live Unit Testing(仅限 VS Code + Codex++ 插件)
方法一:VS Code 内置覆盖率驱动
1. 确保已安装 Codex++ 插件(v2.8.3+)及官方 Codex 桌面应用
2. 在 VS Code 中打开项目 → 按 Ctrl+Shift+P → 输入「Codex: Toggle Live Coverage」→ 回车启用
3. 编辑任意 .ts 或 .py 文件时,左侧行号旁会实时显示红/绿圆点:绿色=已覆盖,红色=未覆盖
方法二:强制刷新覆盖率缓存(避免旧快照干扰)
执行命令:
codex test --coverage --reset-cache
自动生成缺失测试用例
第一步:定位低覆盖模块
运行:
codex test --coverage --report=summary
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
第二步:聚焦单个文件生成测试
例如发现 src/utils/string.ts 覆盖率仅 31%,执行:
codex test --generate --target src/utils/string.ts
第三步:接受建议并注入
终端将输出 5~7 个待插入的 Jest 测试块(含 describe/it 结构),复制全部内容,粘贴到对应文件同名的 【string.test.ts】 中——注意:不要覆盖已有测试,只追加;若该文件不存在,需先创建。
第四步:验证补全效果
再次运行 codex test --coverage,数值应升至 68%~73%。若低于 65%,说明生成逻辑未命中核心分支,需手动补充 if/else 或 try/catch 块的异常路径测试。
绕过 80% 阈值强制启用高级功能
方法一:临时跳过校验(调试专用)
在项目根目录下新建文件 【.codex.skip-coverage】(无后缀,内容为空),重启 Codex CLI 进程即可绕过阈值检查。
方法二:修改本地策略(生产慎用)
编辑 C:\Users\你的用户名\.codex\config.toml,在末尾添加:
[test]
min_coverage_threshold = 60
【警告:此修改会使 Codex 在覆盖率低于 60% 时仍调用 GPT-5.5 模型,可能触发 API 频控或返回不完整响应】

















