结论先说
- 用
persistence = "none"立即停止历史落盘。在~/.codex/config.toml中增加[history]配置段并写上persistence = "none",Codex 将不再向本地history.jsonl追加输入与交互历史记录。 - 保留历史但怕无限膨胀,用
max_bytes设硬上限。默认persistence = "save-all"且不设体积封顶;只要加上max_bytes = 10485760(10 MB),文件超限时 Codex 会自动淘汰最旧条目。 - 关闭
[history]不会自动抹掉已经存在的旧记录。修改persistence = "none"只影响后续新写入,之前已落盘的history.jsonl仍留在磁盘上,敏感环境下必须手动清理历史文件。 - 注意区分输入历史与完整会话归档。
[history]管辖的是history.jsonl本地历史记录;如果同时需要避免单次自动化任务留下会话恢复文件,应配合codex exec --ephemeral与定期会话清理策略。 - 在多项目里稳定开展日常开发与合规审计需匹配合适会员档位。国内若无外币支付手段,可在本站自助开通 ChatGPT Plus 或配额更充裕的 ChatGPT Pro,团队统一采购也可查看 ChatGPT Business 团队定制。

图:本站根据 OpenAI Codex 官方文档:Configuration Reference 整理的示意图
本文根据 OpenAI Codex 官方文档《Configuration Reference》整理,资料核对于 2026-11-19。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 OpenAI 官方网站。
适用于谁
- 在多人共用开发机、远程跳板机或客户现场终端上跑 Codex,希望彻底关闭本地历史落盘避免泄露提示词的开发者;
- 长期高频使用 Codex CLI,发现
~/.codex/history.jsonl持续增长、拖慢历史检索或占用磁盘的用户; - 需要为团队制定统一日志留存上限与本地数据最小化规范的研发负责人。
一、[history] 配置段字段详解与适用场景
默认情况下,Codex CLI 会在 $CODEX_HOME(未单独设置环境变量时为 ~/.codex,Windows 为 %USERPROFILE%\.codex)中写入 history.jsonl,用来保存提示词输入历史,方便你在交互终端按上下方向键回溯或复用之前的指令(CODEX_HOME 隔离方法见 /guides/codex-cli-config-override-and-codex-home-isolation)。
在 config.toml 中,[history] 表提供两个核心字段:
persistence:字符串枚举,可选"save-all"(默认值,正常记录本地历史)或"none"(关闭历史落盘,不向history.jsonl追加新条目);max_bytes:可选正整数,单位为字节(Byte)。当persistence = "save-all"且设置了max_bytes时,每次追加导致文件体积超过阈值,Codex 会自动丢弃最老的记录并压缩文件,确保磁盘占用始终受控。
如果你的机器上经常粘贴包含业务 SQL、内网接口结构、排障堆栈的提示词,又不想让同机其他账号或备份软件扫走这些内容,就应该主动配置 [history],而不是一直沿用「无限追加」的默认状态。
二、三套可直接复制的 config.toml 配置模板
打开 ~/.codex/config.toml(完整结构可参考 /guides/codex-config-toml-complete-guide),按自己的使用场景选择对应写法。
模板 1:个人主力开发机,保留历史并限制在 10 MB 以内(本站建议)
日常开发既想保留方向键回溯历史,又不想半年后文件涨到几十兆,可以给 max_bytes 设一个合理阈值(例如 5 MB = 5242880,10 MB = 10485760):
toml
#:schema https://developers.openai.com/codex/config-schema.json
[history]
persistence = "save-all"
max_bytes = 10485760
模板 2:共享服务器 / 高敏项目,彻底关闭历史落盘
在跳板机、公共测试机或涉密项目目录下,直接关闭持久化写入:
toml
[history]
persistence = "none"
如果是临时只对某一次会话禁止落盘,也可以通过命令行参数即时覆写,不必改动全局配置:
bash
codex -c 'history.persistence="none"'
模板 3:配合 Profile 按项目切换留存策略
平时普通项目照常记录,一进敏感仓库就切到无痕配置档:
toml
[history]
persistence = "save-all"
max_bytes = 10485760
[profiles.no-trace]
# 仅在使用 --profile no-trace 时关闭本地历史落盘
[profiles.no-trace.history]
persistence = "none"
订阅与账号准备提示:在长时间重构或批量巡检代码时,高频多轮交互更容易触达窗口配额(额度规则参考 /guides/codex-usage-limits)。若日常工作对持续响应要求高,可在本站升级 ChatGPT Pro 充值 或选择 ChatGPT Pro 5x iOS 可覆盖档;新注册 OpenAI 账号在手机验证环节受阻时,也可参考 Codex 注册手机验证服务。
三、关闭落盘后的隐私补漏清单(本站建议)
很多开发者以为改完 persistence = "none" 本地就彻底「零痕迹」了,实际排查时常常漏掉以下四个环节:

图:本站根据 OpenAI Codex 官方文档:Configuration Reference 整理的示意图
- 手动清除旧
history.jsonl:把persistence改成"none"只会阻止新增记录,不会删掉已有文件。请在确认不再需要历史记录后手动删除~/.codex/history.jsonl(若自定义过CODEX_HOME,需前往对应目录清理)。 - 同步检查会话恢复目录:Codex 用于
codex resume的会话快照通常保存在$CODEX_HOME/sessions/下。涉及敏感内容时,需要了解会话分支管理与清理机制(详见 /guides/codex-fork-session-branching-parallel-guide 与 /guides/codex-tui-auto-recap-session-history-cleanup-guide)。 - CI 与脚本任务加
--ephemeral:在自动化流水线或无状态容器里调用codex exec时,建议配合--ephemeral参数运行(CI 流水线配置见 /guides/codex-exec-full-auto-ephemeral-ci-pipeline-guide),避免把大量一次性日志会话堆满工作节点磁盘。 - 不要把
max_bytes设得过小:如果把max_bytes设成几百字节,单条长提示词就会频繁触发截断淘汰,失去保留历史的意义;本站建议普通个人开发至少设置在 2 MB 到 10 MB 之间。
常见问题
问:设了 persistence = "none" 之后,还能在同一轮还没退出的终端对话里继续追问吗?
答:完全可以。[history] 控制的是本地磁盘上的历史记录持久化落盘,不影响当前活跃会话在内存里的多轮上下文连续对话。
问:max_bytes 可以写 "10MB" 这种带单位的字符串吗?
答:不行。max_bytes 在配置 Schema 中是整数类型,单位固定为字节,必须直接写数字(例如 5 MB 写 5242880,10 MB 写 10485760),带单位引号会导致 TOML 解析报错。
问:国内没有外币信用卡,或者公司研发团队需要开增值税发票报销,怎么开通能跑 Codex 的订阅?
答:可在本站 AI 会员充值总览 按需选购 ChatGPT Plus、ChatGPT Plus 官网直充 或高配额的 ChatGPT Pro,团队批量采购可直接查看 ChatGPT Business 团队定制。支持支付宝、微信支付与 AlipayHK,自助兑换无需交出账号密码,并可开具增值税发票;实时价格以商品页展示为准,售后执行掉订阅按剩余天数折退、封号不在质保范围的政策。
相关教程
- Codex TUI 自动回顾与本地会话历史清理指南
- Codex exec 全自动与 --ephemeral 无状态 CI 流水线指南
- Codex CLI 参数覆写(-c)与 CODEX_HOME 多环境隔离教程
- Codex config.toml 配置文件完整指南
参考资料
- OpenAI Developers 文档:Codex Configuration Reference — https://developers.openai.com/codex/config-reference
- OpenAI Codex 官方文档:Configuration Reference — https://learn.chatgpt.com/docs/config-file/config-reference
- OpenAI Codex GitHub 仓库 — https://github.com/openai/codex
0 条评论
还没有评论,来抢沙发~