Codex [history] 本地会话记录配置:关闭历史落盘(persistence = "none")与 max_bytes 容量上限控制

担心 Codex 在共享开发机留下本地提示词记录,或者长期使用后 history.jsonl 体积不断膨胀。本文拆解 config.toml 中 [history] 表的 persistence 与 max_bytes 写法,附隐私清理与容量控制实践。

NNathaniel bigo··原创首发·AI 辅助撰写
12 分钟读完
资料核对于 2026-11-19 · 依据官方文档与公开资料整理 Plus 账号

结论先说

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

Codex history 三种配置策略对比

图:本站根据 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 整理的示意图

  1. 手动清除旧 history.jsonl:把 persistence 改成 "none" 只会阻止新增记录,不会删掉已有文件。请在确认不再需要历史记录后手动删除 ~/.codex/history.jsonl(若自定义过 CODEX_HOME,需前往对应目录清理)。
  2. 同步检查会话恢复目录:Codex 用于 codex resume 的会话快照通常保存在 $CODEX_HOME/sessions/ 下。涉及敏感内容时,需要了解会话分支管理与清理机制(详见 /guides/codex-fork-session-branching-parallel-guide 与 /guides/codex-tui-auto-recap-session-history-cleanup-guide)。
  3. CI 与脚本任务加 --ephemeral:在自动化流水线或无状态容器里调用 codex exec 时,建议配合 --ephemeral 参数运行(CI 流水线配置见 /guides/codex-exec-full-auto-ephemeral-ci-pipeline-guide),避免把大量一次性日志会话堆满工作节点磁盘。
  4. 不要把 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,自助兑换无需交出账号密码,并可开具增值税发票;实时价格以商品页展示为准,售后执行掉订阅按剩余天数折退、封号不在质保范围的政策。

相关教程

参考资料

  • 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

Nathaniel 的更多内容

  1. 01

    独立开发者用 ChatGPT + Codex 跑通产品全流程:市场验证、PRD、原型到代码上线复盘清单

    单人做独立产品最容易陷入「闭门写两个月代码上线零用户」或「AI 写到一半目录越改越崩」。本文整理「ChatGPT 负责市场验证、PRD 与复盘 + Codex 负责工程实现与测试」的五阶段双轨流程,附起手提示词与 7 项上线复盘清单。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成规范文件命名规则、整理混乱目录树与合并零散发票抬头清单脚本

    面对满桌面的「新建文件夹」「最终版2」和上百张零散电子发票,手工改名抄台账耗时又容易漏重。本文分享先脱敏取样、再用 ChatGPT 生成带预演和回滚日志的本地 Python 脚本,离线安全完成目录整理与发票抬头合并去重的实战流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外邮件营销(EDM)受众分层文案、A/B 主题行测试与防进垃圾箱自检

    做海外独立站或出海 SaaS 邮件营销(EDM),最怕千人一面群发被直接送进垃圾箱。本文结合 Gmail/Yahoo 批量发件人规范,梳理用 ChatGPT 设计受众分层文案、批量生成 A/B 主题行矩阵并开展发前垃圾词与合规自检的实战提示词。

    ChatGPT0
  4. 04

    用 ChatGPT 写 Notion Formula 2.0 公式、Obsidian Dataview 查询与 Airtable 自动化脚本

    给 Notion 数据库写多条件 Formula 2.0 公式、给 Obsidian 写 Dataview 动态看板,或在 Airtable 里写自动化脚本,经常因为一个小括号或类型不匹配报错半天。本文整理三大工具的通用上下文喂料规范与三套直接可复制的生成提示词。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 处理复杂 JSON / YAML / XML 字段映射、格式转换与校验规则编写实战

    对接第三方 API、迁移 Kubernetes 配置或解析政企 XML 报文时,手工对照几百行嵌套字段既慢又容易漏掉空值与类型边界。本文整理用 ChatGPT 完成字段映射表梳理、生成确定性转换脚本以及编写 JSON Schema / Pydantic / XSD 校验规则的实战流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 准备本科/硕士毕业论文答辩:提炼答辩 PPT 结构、模拟导师犀利追问与 3 分钟自述稿

    毕业论文写完后,要在 3–5 分钟内讲清研究价值并顶住答辩评委的连环追问并不轻松。本文整理在严格遵守高校学术规范的前提下,用 ChatGPT 提炼答辩 PPT 结构、打磨 3 分钟口语自述稿并开展模拟导师犀利追问的排练流程与提示词。

    ChatGPT0

同产品的其他教程

  1. 01

    用 ChatGPT 整理家庭装修预算明细、隐蔽工程验收清单与主材优缺点对比表实战

    第一次装修面对几十页施工报价单、密密麻麻的水电防水隐蔽项目与五花八门的主材参数,极易踩坑增项。本文梳理用 ChatGPT 审查装修报价漏项、生成带公式的预算明细表、定制工地隐蔽工程验收单与主材对比表的实战提示词。

    ChatGPT0
  2. 02

    用 ChatGPT 做费曼学习法读书共读:反向追问检验自己是否真读懂专业书籍与整理书单笔记

    读完一本专业硬书常感觉「合上书就忘」,直接让 AI 概括全书又容易产生懂了的错觉。本文介绍用 ChatGPT 结合 Study Mode 与费曼学习法做反向追问共读,通过通俗复述、挑刺盲区到沉淀书单卡片的完整流程与提示词。

    ChatGPT0
  3. 03

    用 ChatGPT 做外贸产品多语种目录、展会邀约与客户跟进节奏表(附脱敏与本地化提示词)

    做外贸展会与海外推广时,手工翻译十几款产品目录费时且容易留下一堆中式英文,展后客户跟进也常缺节奏。本文梳理用 ChatGPT 先脱敏建术语库、再批量产出多语种目录、展前邀约函与展后 21 天跟进节奏表的实战流程与提示词。

    ChatGPT0
  4. 04

    用 ChatGPT 写高质量技术专栏文章、开源项目 Release Notes 与版本更新日志实战

    让 AI 直接凭空写技术文章容易满篇空洞套话,直接甩 Git 记录写更新日志又常常漏掉破坏性变更。本文整理用 ChatGPT 结合真实代码片段、压测数据与 PR 摘要,高效产出深度技术专栏、GitHub Release Notes 与 CHANGELOG 的实战工作流。

    ChatGPT0
  5. 05

    用 ChatGPT 做产品用户访谈纪要编码、提炼高频痛点需求池与 RICE 优先级打分实战

    手头攒了十几份用户访谈逐字稿,手工贴便利贴归纳痛点耗时又容易带入主观偏见。本文分享用 ChatGPT 完成脱敏检查、逐份开放式编码、跨样本聚类高频痛点并搭建 RICE 优先级打分表的 5 步实战流,附可直接复制的三段核心提示词。

    ChatGPT0
  6. 06

    ChatGPT 网页版上传超过 10 个文件或回形针附件按钮变灰怎么办:打包合并与配额限制排查

    在 ChatGPT 网页版批量分析文档时,常遇到一次选超 10 个文件被拦截或输入框回形针按钮变灰。本文依据 OpenAI 文件上传与存储说明,梳理 6 类常见报错的分流排查法,提供 ZIP 打包、本地合并与 Projects 复用方案及可直接复制的解包提示词。

    ChatGPT0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~