Codex客户端启动很卡怎么办一个 .git 文件夹就解决了 CPU 飙升问题SEO关键词Codex启动卡顿、Codex CPU占用高、Codex客户端卡顿、Codex App启动慢、Codex Git Workspace、Codex Git仓库、Codex Electron卡顿、Codex优化文章摘要Codex Desktop 启动后 CPU 占用很高、界面卡顿、风扇狂转问题可能并不是模型而是工作区没有 Git 仓库。本文分享一次排查过程通过创建一个 Git 壳仓库Shell Repository让 Codex 停止重复扫描 Git 元数据成功解决启动卡顿问题。codex客户端下载https://codexdown.cc/最近发现 Codex Desktop 每次启动都会卡顿十几秒CPU 占用持续很高Electron 进程也一直在工作。一开始我以为是AI 模型初始化MCP 服务加载索引文件过多Electron 自身 Bug后来把日志发给 Codex 分析最终定位到了真正的问题。一、问题原因我的工作区绑定的是一个聚合目录Workspace Root。这个目录下面有很多独立项目但是最外层目录本身并不是一个 Git 仓库。例如Workspace ├── Project-A │ └── .git ├── Project-B │ └── .git ├── Project-C │ └── .git └── ...虽然每个项目都有自己的 Git 仓库但是最外层的 Workspace 并没有.git。Codex Desktop 启动以后会持续尝试读取当前 Workspace 的 Git 元数据。日志里面不断出现类似信息stable-metadata Not a git repository由于一直识别失败桌面端会不断重新尝试读取 Git 信息。最终形成读取 → 失败 → 重试 → 再失败 → 再重试……这个循环会持续占用 Electron 渲染线程因此 CPU 会越来越高整个客户端也会越来越卡。二、解决方法真正解决问题的方法其实非常简单。进入你的 Workspace 根目录cd/path/to/workspace-root执行gitinit就是这么简单。执行完成以后再重新打开 Codex。我这边 CPU 占用几乎立刻下降客户端流畅了很多启动速度也恢复正常。三、推荐使用 Git 壳仓库Shell Repository不过还有一个问题。如果直接在 Workspace 初始化 Git那么整个聚合目录都会变成一个 Git 仓库。很多人可能并不希望这样。因此推荐使用一个壳仓库。也就是顶层只有一个.git不真正管理里面所有内容只是告诉 Codex“这里是一个 Git Workspace”这样既能解决问题又不会影响原来的项目。四、创建 .gitignore初始化以后再创建一个.gitignore。内容如下* !.gitignore它表示默认忽略所有文件不跟踪任何目录仅保留.gitignore自己这样 Git 仓库几乎就是一个空壳。不会把你的几十个项目全部加入版本控制。五、这种方案有哪些好处这种做法有几个明显优点。1、满足 Codex 的 Git Workspace 识别Codex 不再反复扫描失败。避免持续进入Not a git repository错误循环。2、不影响子项目你的每个项目仍然保持自己的 Git 仓库。例如Workspace ├── .git ├── .gitignore ├── Project-A/.git ├── Project-B/.git └── Project-C/.git各个项目依旧独立管理。3、不把大量文件加入 Git由于.gitignore默认忽略全部内容。不会意外把整个 Workspace 纳入版本控制。4、几乎没有额外成本顶层 Git 仓库非常小。既不会占用多少空间也不会影响已有开发流程。六、并不是所有卡顿都是这个原因需要说明的是Codex 启动卡顿可能有很多原因例如MCP 服务响应过慢工作区文件过多插件异常Electron 缓存问题Git 元数据扫描异常如果你的日志中反复出现Not a git repository或者stable-metadata那么就可以尝试本文的方法。如果没有这些日志则需要继续排查其他原因。总结这次排查下来真正导致我客户端启动卡顿的并不是模型也不是 MCP而是 Workspace 根目录没有 Git 仓库。通过在工作区创建一个Git 壳仓库并配合.gitignore默认忽略所有内容成功让 Codex 停止重复读取 Git 元数据CPU 占用明显下降客户端启动也流畅了许多。如果你也遇到了 Codex Desktop 启动慢、CPU 占用高、风扇狂转等情况不妨检查一下当前绑定的 Workspace 是否存在 Git 仓库也许几秒钟就能解决问题。