Codex客户端启动卡顿怎么办?一招解决CPU 飙升问题

Codex Desktop 启动后 CPU 占用很高、界面卡顿、风扇狂转？问题可能并不是模型，而是工作区没有 Git 仓库。本文分享一次排查过程，通过创建一个 Git 壳仓库（Shell Repository），让 Codex 停止重复扫描 Git 元数据，成功解决启动卡顿问题。

最近发现 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

执行：

git init

就是这么简单。

执行完成以后，再重新打开 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 仓库，也许几秒钟就能解决问题。

到此这篇关于Codex客户端启动卡顿怎么办?一招解决CPU 飙升问题的文章就介绍到这了,更多相关Codex启动卡顿解决方法内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！

最新评论