Codex 上下文告急,别只会 /compact:六条出路一次讲清
Codex CLI 的上下文一旦告急,多数人第一反应就是敲 /compact。可这条命令本质上是破坏式的:整段历史被折叠成一条摘要,细节从此找不回来。其实翻一下 Codex v0.164.0(2026-10-23 发布)的斜杠命令表就会发现,应对上下文压力的路不止一条——/fork 可以分叉并保住原始历史,/worktree 干脆换一个独立的 Git 工作树开新会话,/side 临时开个“旁白”会话不占主线,/new 直接另起炉灶,/memories 负责让关键信息跨会话留存,再加上 AGENTS.md 从系统提示层面砍掉首轮 Token 开销。到底该压缩、分叉还是新建,取决于你对历史保留的需求,本文会把六种方法各自的适用时机、命令写法和坑点一次讲清。
上下文为什么会爆满
先看机制:Codex 在每一次请求里都会把整个会话的历史(system prompt + 全部消息 + 工具调用记录)完整打包发给模型。历史越滚越长,Token 消耗随之水涨船高,直到顶到模型的上下文长度的天花板,届时请求要么被截断,要么直接被拒。
其中有两个现象值得留意:
/compact做的是压缩而非清空:历史被浓缩成一行概要,之后的新消息从概要处往下续。压缩完成后你依然处在原来的 session 中,只是细节已经丢了。- 从 v0.164.0 开始,**背景自动压缩(background compaction)**已接入 turn 生命周期,逼近临界点时有概率自动触发。不想被中途打断的话,关键任务前最好主动处理一下。
第 1 招:/compact:主动压缩,会话 ID 不变
/compact
/compact 在官方代码里的描述是 “summarize conversation to prevent hitting the context limit”(把对话压成摘要,避免撞上长度上限)。它执行完会发生这些事:
- 会话 ID 维持原样,之后仍可用
/resume找回这个会话 - 整段历史被打包压成一条概要,此后消息一律从概要处续起
- v0.164.0 修掉了“压缩失败会留下残缺摘要”的 bug,如今一旦失败会自动回退到压缩动作发生前的原样
适用场景:任务还在推进,只是历史堆得太长,且后面不需要回头翻细节。
要留意的是:
/compact之后,模型对早期对话只剩摘要级别的记忆,如果后面的任务依赖早先出现过的具体文件路径或代码片段,就可能出错。
第 2 招:/fork:分叉出去,原始历史一点不丢
/fork
/fork 的官方描述是 fork the current chat(分叉当前对话)。
它执行后:
- 现有 session 的全部历史被原样克隆进一条新 session
- 原 session 纹丝不动,随时能通过
/resume切回去 - 新 session 中历史记录是全量的,任务可以接着往下推
版本演进上,v0.161.0 先在 TUI 的 command center 里补了 Fork 快捷键,v0.164.0 又调整为“默认保留父 session 的完整历史”(Preserve parent history by default in full agent forks)。
适用场景:想保住原始对话不动,再从当前状态出发试一条新路线。典型情况是调试做了大量工作,想基于现有成果换个方案,又不愿让先前的历史凭空消失。
第 3 招:/worktree:另起一个 Git 工作树,彻底物理隔离
/worktree
/worktree 的官方描述是 start or continue a conversation in a new worktree(在新工作树中开启或延续一段对话)。
它执行后:
- Codex 会在仓库内新建一个 Git 工作树(git worktree),文件系统层面完全独立
- 会话从新工作树里启动,手头的工作树不会被碰
- 并行跑多个分支任务时尤其好用
适用场景:实验要放在独立分支里做,且绝不能跟主工作树互相干扰。举个例子:主线正在修 Bug,同时又想重构某个模块,两条线各干各的。
第 4 招:/side(/btw):临时开旁白,主线 Token 一点不占
/side
/side 与 /btw 是同一命令的两个名字,描述为 start a side conversation in an ephemeral fork(在临时分叉中发起一段旁白会话)。
它执行后:
- 拉起一个短命的“旁路会话”,与主线 session 彻底隔离
- 临时想问个不相干的问题、核对某个细节时正合适
- 旁路聊完即走,主线上下文毫发无损
适用场景:主线干到一半突然要确认一件事,又不想让这轮问答混进主线历史。要知道每条消息都在消耗 Token,把无关问答塞进主线纯属浪费上下文。
第 5 招:/new:干脆利落的新起点
/new
/new 的官方描述是 start a new chat during a conversation(在对话进行中再开一个新对话)。
它执行后:
- 当前 session 转入归档,需要时仍可用
/resume找回 - 在原工作目录里开一条全新 session,上下文彻底清零
适用场景:手头任务已经收尾,接下来是完全不相关的新工作。上一个任务的历史没必要跟着带过去。
顺带区分一下
/new与/compact:前者扔掉历史另起炉灶,后者压一压历史、任务还是同一个。
第 6 招:/memories + AGENTS.md:与其应急,不如预防
前面五条都属于救急,想让上下文压力真正降下来,得从源头下手。
/memories:把关键信息固化下来
/memories
/memories 的官方描述是 configure memory use and generation(设定记忆如何使用与如何生成)。
Memories 这套机制会把你对话里交代过的关键约束(编码规范、个人喜好、项目上下文)单独存档,等下次新开会话时自动注入——既不用反复口头交代,也不挤占当前会话的 Token 预算。
v0.164.0 还把 memory extension 的资源保留期拉长到了 14 天(Extend memory extension resource retention to 14 days),跨会话记忆因此更加耐用。
AGENTS.md:从系统提示层面削减冗余
在项目根目录建一个 AGENTS.md:
/init
AGENTS.md 是 Codex 的系统级指令文件,每个会话启动时一次性注入。它相当于把那些“每次都得反复交代”的背景固化成结构化文档,省去了逐会话重复说明。注意保持精炼——文件越短,首轮 Token 开销越小。
一个实用技巧:凡是高频重复出现的约束(用哪个测试框架、目录怎么组织、哪些路径禁止碰),统统沉淀进 AGENTS.md,让每个会话的起点从源头上就轻装上阵。
到底选哪种:一张对照表走天下

辅助工具:/recap 与 /status
另有两个辅助命令,用来判断当下是否需要处理上下文:
/recap:描述为 “summarize the current conversation now”,立刻产出当前对话的摘要(历史本身不动),可借此核对 Codex 对任务的理解是否跑偏/status:描述为 “show current session configuration and token usage”,展示当前 session 的配置与 Token 用量,剩余空间一目了然
当你感觉模型快“开始忘事”了,不妨先跑一遍 /status 看看 Token 余量,再决定是压缩还是分叉。
写在最后
一句话收束 Codex 上下文告急时的处置顺序:救急选 /compact(压缩历史)或 /fork(带历史分叉);要文件隔离就 /worktree;临时问题交给 /side;彻底换任务用 /new;长期减压靠 /memories 和 AGENTS.md。以上命令均出自 Codex CLI 官方代码库(openai/codex,v0.164.0,2026-10-23),描述文本直接引自 slash_command.rs,信息截至 2026-10-26、以官方发布为准。
更多推荐



所有评论(0)