Codex Fixes：社区维护的 OpenAI Codex Bug 修复工具

codex-fixes 是一个社区维护的开源项目，专门收集和修复 OpenAI Codex 的各种已知问题。每次 Codex 更新后运行一条命令，就能把社区验证过的修复方案应用到本地环境，省去自己排查 bug 的时间。

项目简介

codex-fixes 由开发者 zhuhaow 发起，定位是"让 Codex 不那么烦人"——通过一个轻量的 CLI 工具，将社区收集到的 Codex 缺陷和对应的修复脚本打包分发。项目同时维护一个配套网站 codexfixes.com，用来展示当前活跃的问题列表、修复说明，以及接受社区贡献的入口。

项目当前仍在快速迭代中（短短几天内已发布 5 个版本），目标是成为 Codex 用户排查"已知坑"的第一站，而不是每次都要去翻 issue 区找答案。

核心特性

一条命令应用修复：npx codex-fixes@latest 即可拉取并应用最新的修复集合，无需额外安装
问题登记表（Registry）：每个已知 bug 都有结构化的 issue 元数据和对应的修复脚本，存放在 registry/ 目录下
配套文档网站：apps/site 是一个 Astro 构建的站点，展示活跃问题、修复文档和贡献指南
持续验证：鼓励社区成员验证某个 bug 是否已被 OpenAI 官方修复，并在 issue 区域反馈
轻量 CLI：packages/cli 提供本地诊断和修复应用能力，不依赖复杂的运行环境

技术栈

TypeScript —— 全仓库统一使用 TypeScript 开发，类型安全
Astro —— 用于构建 apps/site 文档/活跃问题展示站点
Node.js 22+ —— CLI 运行环境要求
npm Trusted Publishing —— CLI 包通过 GitHub Actions 从受保护的版本 tag 直接发布到 npm，不依赖手动发布凭证

安装与使用

前置要求

Node.js 22 或更新版本
npm 10 或更新版本

直接运行（推荐）

不需要单独安装，每次 Codex 更新后运行一次即可：

bash

npx codex-fixes@latest

本地开发

如果想参与贡献或调试修复脚本，可以克隆仓库后本地跑：

bash

# 安装依赖
npm install

# 本地启动文档网站
npm run dev

# 构建整个 workspace
npm run build

# 只构建网站部分
npm run build:site

仓库结构

项目是一个 TypeScript-only 的 monorepo，分为三个部分：

text

apps/
  site/        Astro 网站，展示活跃问题、修复文档和贡献入口
packages/
  cli/         Node CLI，提供本地诊断和修复应用
registry/
  issues/      问题清单（issue manifests）和对应修复脚本
  schema/      Registry 的 JSON Schema 定义

registry 是整个项目的数据核心：每一个 Codex 已知问题都在这里有一份结构化记录，CLI 和网站都从这份数据中读取展示内容并执行修复逻辑。

注意事项

项目仍处于早期阶段（GitHub 星标数较少），修复覆盖面有限，建议运行前先看一下 Issues 列表确认是否覆盖了自己遇到的问题
由于 Codex 官方会持续修复 bug，部分修复脚本可能会随官方更新而失效或不再需要，项目也鼓励用户反馈"该问题已被官方修复"
推荐在每次 Codex 客户端更新后都跑一次 npx codex-fixes@latest，保持本地修复集合是最新的

项目链接

GitHub 仓库：zhuhaow/codex-fixes
官方网站：codexfixes.com
问题反馈与贡献：GitHub Issues