1. 从卡顿说起Codex 会话堆积到底有多要命用 Codex 有一段时间的朋友大概率都经历过这样一个过程刚开始装好、登录、跑第一个任务丝滑得不行用了两三周某天早上打开客户端光标转圈转了半天界面才慢吞吞地出来甚至直接卡在启动画面不动。很多人第一反应是是不是网络问题是不是版本太旧了折腾一圈重装结果用几天又卡了。我自己踩过这个坑后来才定位到真正的元凶本地会话历史堆积。Codex 这类工具会把每一次对话、每一次任务执行的上下文都落盘保存方便你随时回看、继续。但问题是这些会话文件不会自动清理日积月累下来几百上千个会话目录堆在本地客户端启动时要扫描、要索引、要加载元数据启动自然越来越慢。这跟浏览器开了几百个标签页会卡是同一个道理——不是电脑不行是待处理的东西太多了。所以这篇内容我想聊三件事Codex 怎么删除单个会话、怎么批量清理历史聊天记录、以及怎么从根上解决启动卡顿。顺带把会话管理的底层逻辑、清理时的避坑点、以及清理之后如何保持长期流畅一并讲透。不管你是刚装 Codex 的新手还是已经用了一两个月感觉变慢的老用户都能直接照着操作。文中涉及的具体路径和命令我会说明为什么这么设计、参数怎么理解而不是让你无脑复制。提示本文所有操作都基于本地客户端的常规使用场景涉及删除文件的操作请务必先备份尤其是你还没导出过的重要会话。2. 先搞懂 Codex 的会话是怎么存的在动手删之前你得先知道东西存在哪、长什么样。不然要么删错地方没效果要么把配置一起删了导致要重新登录。这是很多人清理失败的根本原因——没搞清楚存储结构就乱删。2.1 会话目录的典型结构Codex 的本地数据一般放在用户主目录下的隐藏配置文件夹里。以常见的桌面客户端为例大致是这样一套结构不同版本、不同系统路径会有差异但逻辑一致# macOS / Linux 常见路径 ~/.codex/ ├── sessions/ # 会话历史核心清理对象 │ ├── 2024-xx-xx-xxx/ │ └── ... ├── config.toml # 配置文件别乱动 ├── auth.json # 登录凭证删了要重新登录 └── logs/ # 运行日志可清理 # Windows 常见路径 C:\Users\你的用户名\.codex\关键点在于sessions目录才是会话历史的家config.toml和auth.json是配置和凭证清理卡顿时千万别碰这两个。我见过有人图省事直接把整个.codex文件夹删了结果登录状态、自定义配置全没了还得从头配一遍得不偿失。2.2 为什么会话多了会卡这里稍微展开讲下原理理解了你就知道为什么删会话能治卡顿。客户端启动时大致要做这几件事扫描sessions目录列出所有会话文件读取每个会话的元数据时间、标题、消息数构建索引供你在历史列表里搜索、排序加载最近会话的上下文。会话数量少的时候这几步几十毫秒就完事。但当目录里有几百上千个会话时光是遍历文件系统 解析元数据就可能耗掉好几秒如果单个会话文件还特别大比如一次长任务塞了几万 token 的上下文读取和解析会更慢。卡顿的本质是 I/O 和解析开销随会话数量线性甚至超线性增长。所以清理会话不是玄学提速而是实打实减少了启动时的扫描和解析负担。这也是为什么很多人清理完立刻感觉快了一大截。2.3 清理前必须做的两件事动手前先做这两步能帮你避免 90% 的后悔备份整个 sessions 目录直接复制一份到别处万一删错了还能找回。命令很简单cp -r ~/.codex/sessions ~/codex_sessions_backup。确认哪些会话要留如果你有正在进行的项目依赖某个历史会话的上下文先记下它的目录名清理时排除掉。注意不要用清空回收站式的暴力删除尤其是跨平台工具同步的目录删之前确认没有正在运行的任务在写入。3. 删除单个会话精准清理的正确姿势有时候你不需要大扫除只是想删掉某几个不想留的会话。这种情况最稳妥的方式是通过客户端界面删其次是手动定位目录删。3.1 界面内删除首选大多数 Codex 客户端在历史会话列表里鼠标悬停或右键某个会话会有删除移除之类的选项。这是最安全的方式因为客户端会同时清理索引和关联的元数据不会留下孤儿文件导致列表里显示异常。操作路径通常是打开历史/会话列表 → 找到目标会话 → 右键或点更多菜单 → 删除 → 确认。删完之后建议重启一次客户端让索引重建确认列表里确实没了。3.2 手动删除单个会话目录如果界面里找不到删除入口有些版本确实藏得深或者干脆没有就得手动来。步骤先关闭 Codex 客户端确保没有进程在读写进入~/.codex/sessions/找到对应会话的目录一般以时间戳或会话 ID 命名删除该目录重启客户端。怎么确认哪个目录对应哪个会话可以打开目录里的会话文件通常是.json或.jsonl看开头几行里的标题或首条消息内容对上了再删。别嫌麻烦这一步能防止误删。3.3 单个删除的适用场景与局限单个删除适合我就想清掉几个敏感会话或者某个会话文件特别大拖慢加载的情况。但如果你有几百个会话要清一个个删就是折磨自己了这时候得上批量方案。删除方式适用场景优点风险界面删除少量、零散会话安全自动清索引部分版本无入口手动删目录界面无入口时精准可控需自行确认对应关系批量脚本大量历史会话高效彻底易误删需备份4. 批量清理历史聊天一次清干净的实操方案会话攒了几百个手动删不现实。批量清理的核心思路是按时间或数量筛选保留近期的清掉陈旧的。下面给你几套可直接抄的方案从保守到激进都有。4.1 方案一按时间清理推荐最常见的需求是保留最近一个月的其余全删。用find命令按修改时间筛选最合适# 先预览要删哪些重要先看再删 find ~/.codex/sessions -maxdepth 1 -type d -mtime 30 # 确认无误后执行删除 find ~/.codex/sessions -maxdepth 1 -type d -mtime 30 -exec rm -rf {} 参数解释一下-maxdepth 1表示只处理 sessions 下的一级目录不递归进子目录乱删-type d限定只匹配目录-mtime 30表示修改时间在 30 天以前的。先跑不带-exec的那条预览确认列表符合预期再删这是我强烈建议的习惯。4.2 方案二按数量清理保留最近 N 个如果你更在意只留最近 50 个会话可以按时间排序后删掉多余的# 进入会话目录按修改时间倒序列出跳过前50个删除其余 cd ~/.codex/sessions ls -t | tail -n 51 | xargs -I {} rm -rf {}ls -t按修改时间从新到旧排序tail -n 51从第 51 行开始取也就是跳过最新的 50 个xargs把结果传给删除命令。同样先把rm -rf换成echo跑一遍看看要删的是不是你想删的。4.3 方案三Windows 下的批量清理Windows 用户没有find那么顺手可以用 PowerShell# 预览列出30天前的会话目录 Get-ChildItem $env:USERPROFILE\.codex\sessions -Directory | Where-Object { $_.LastWriteTime -lt (Get-Date).AddDays(-30) } # 确认后删除 Get-ChildItem $env:USERPROFILE\.codex\sessions -Directory | Where-Object { $_.LastWriteTime -lt (Get-Date).AddDays(-30) } | Remove-Item -Recurse -ForcePowerShell 的好处是预览和删除逻辑一致你只要把最后一段Remove-Item去掉就是预览。Windows 用户记得路径里的.codex是隐藏文件夹在资源管理器里要先开启显示隐藏文件才能看到。4.4 清理后的收尾动作批量删完别急着开客户端。建议做两件事清一下日志目录logs目录同样会堆积顺手清掉能再省一点启动时间重启客户端并观察第一次启动可能因为重建索引稍慢第二次开始应该明显变快。提示如果你用的是带同步功能的版本清理本地后注意别让同步把云端旧会话又拉回来必要时在设置里关掉会话同步或调整同步范围。5. 启动卡顿的系统性排查删会话只是第一步删会话能解决大部分用久了变卡的问题但卡顿的原因不止一个。如果你清理完还是卡或者想从根上避免下面这套排查思路值得过一遍。5.1 卡顿原因速查表现象可能原因排查方向启动转圈很久会话/日志堆积清理 sessions、logs启动直接卡死某个超大会话文件损坏定位并删除异常大文件登录后卡凭证或配置异常检查 auth、config操作中卡上下文过长新开会话别一直续偶发卡顿后台任务占用看进程、关多余任务5.2 定位罪魁祸首会话有时候不是数量多而是某一个会话文件异常巨大比如一次任务塞了超长上下文文件几百 MB加载它特别慢。定位方法# 按文件大小排序找出最大的几个会话 du -sh ~/.codex/sessions/* | sort -rh | head -10跑完看前几名如果某个会话大得离谱正常一般几 MB 以内基本就是它拖后腿。这种会话要么删掉要么先导出内容再删。5.3 配置层面的优化除了删文件配置上也有几个能提速的点关闭不必要的启动加载项有些版本会默认加载最近会话的完整上下文可以在设置里改成仅加载元数据限制历史保留数量如果客户端支持直接设置最多保留 N 个会话让它自动清理一劳永逸定期重启长时间不关客户端内存和句柄会累积定期重启能保持状态干净。5.4 版本与安装问题导致的卡顿热词里出现了不少安装未完成打不开启动卡的搜索这类问题往往不是会话堆积而是安装本身有问题。常见情况Windows 安装未完成多半是权限或杀软拦截换个目录、以管理员身份重装试试启动直接报错打不开先看日志目录里的报错信息比盲目重装高效得多登录相关报错确认凭证文件完整必要时重新登录。这类问题跟会话清理是两条线别混为一谈。先分清是用久了变卡还是一开始就打不开前者清会话后者查安装和配置。6. 会话管理的长期习惯让卡顿不再复发清理是一次性的习惯是长期的。想让 Codex 一直保持流畅光靠卡了再清不够得养成几个日常习惯。6.1 定期清理节奏我的建议是每月清一次或者会话数超过 100 个就清。可以设个日历提醒也可以写个定时任务自动跑。自动清理脚本示例macOS/Linux配合 crontab# 每月1号凌晨清理30天前的会话 0 3 1 * * find ~/.codex/sessions -maxdepth 1 -type d -mtime 30 -exec rm -rf {} 自动化的前提是你已经手动验证过命令没问题别一上来就挂定时任务万一参数写错就是灾难。6.2 重要会话及时导出清理之前把有价值的会话导出成文本或 Markdown 存档。很多客户端支持导出没有的话手动复制关键内容也行。别把重要上下文只留在会话里一旦清理就找不回来了。6.3 新任务新会话一个很实用的习惯别在一个会话里无限续下去。长会话不仅文件大、加载慢上下文太长还会影响响应质量。做完一个任务就新开一个既清爽又高效。6.4 关注版本更新客户端更新经常会优化会话存储和加载逻辑。热词里codexcodex 使用教程这类搜索热度高说明很多人在折腾各种版本和用法。保持版本较新往往能白捡一些性能优化。7. 常见问题与避坑实录最后这部分是我自己踩坑和帮别人排查时攒下的经验都是文档里不会写的。Q删了会话历史列表里还显示怎么办A多半是索引没重建。完全退出客户端再打开或者手动删掉索引缓存文件让它重建。别反复删会话问题不在会话本身。Q清理后要重新登录了A说明你误删了auth.json或整个.codex目录。这就是为什么我一直强调只动sessions。重新登录一次即可配置如果也丢了就得重配。Q批量删除命令跑完没效果A检查路径对不对尤其是 Windows 的隐藏目录和 macOS 的~展开。先跑预览命令确认匹配到了文件再执行删除。Q清理完还是卡A按第 5 节的速查表逐项排查重点看有没有超大异常文件、配置是否合理、版本是否有问题。删会话解决的是数量型卡顿解决不了单文件损坏或安装问题。Q能不能直接删整个 sessions 目录A可以但等于清空所有历史。如果你不在乎历史记录这是最彻底的方案删完重启即可。但记得先备份。注意任何rm -rf命令在执行前务必把命令里的删除动作替换成echo或ls预览一遍。这个习惯帮我避免过至少三次误删。我个人在实际操作中的体会是Codex 的卡顿问题八成都能靠清会话 清日志 定期重启这套组合拳解决剩下两成才是安装、配置或版本问题。与其一卡就重装不如先花五分钟看看sessions目录里堆了多少东西——往往答案就在那里。清理的时候记住那条铁律只动 sessions 和 logs别碰 config 和 auth这样既能提速又不会把自己搞到要重新登录的尴尬境地。