
Codex 的上下文迁移指在三类场景下保留、传递或重建 AI 的工作记忆从其他编程工具Claude Code、Cursor迁移时把配置与历史带过来跨会话保持项目规则与个人偏好以及在单个长任务中管理 272,000 token 上下文窗口不被溢出截断。三类场景机制不同工具也不同——工具迁移靠一键导入与 AGENTS.md 转换跨会话靠 Memories 系统默认关闭需手动启用长任务靠自动压缩与 PreCompact Hook 注入摘要。本文按场景逐一给出完整操作步骤以及一张哪类信息放哪里的分层速查表帮助开发者在任何切换点都不丢失已积累的项目上下文。三类场景一张图场景核心问题主要工具工具迁移从 Claude Code / Cursor 切换历史配置怎么带走一键导入、AGENTS.md 转换跨会话延续关了再开AI 还记得项目规范和我的偏好吗AGENTS.md规则 Memories偏好长任务接续任务没做完上下文快满了怎么不断线继续自动压缩、PreCompact Hook、手动重置场景一工具迁移——把上下文从别的工具带来从 Claude Code 一键导入Codex 内置了专门针对 Claude Code 的导入入口操作路径Settings → General → 从其它 AI 应用导入工作内容一键可导入的内容配置项说明Skills技能包整体迁移目录结构兼容插件MCP 规则打包的插件一并导入agent.md → AGENTS.mdClaude Code 的 CLAUDE.md 内容自动映射到 AGENTS.md聊天记录最近30 天的对话历史CLAUDE.md 和 AGENTS.md 在语法上高度兼容Codex 导入时会做字段映射少量 Claude Code 专用指令如#bash-hook需手动确认是否在 Codex 侧同样有效。从 Cursor 手动迁移Cursor 暂无一键导入按以下步骤手动处理1. 目录重命名# 将 Cursor 目录重命名为 Codex 认识的目录mv.cursor .agents# skills/ 子目录无需改动直接复用2. 全局规则迁移Cursor 的全局规则写入 CodexSettings → Personalization → Custom Instructions等同于编辑~/.codex/AGENTS.md。3. Memories 迁移让 Codex 读取 Cursor 的 memories 文件后执行一次总结并写入自己的记忆Computer 读取 ~/.cursor/memories/ 目录下的所有文件把其中的项目偏好和个人规范总结后保存到 ~/.codex/memories/4. MCP 配置Settings → MCP Servers手动逐条添加原有 MCP 服务器配置工作目录设为项目根路径则为项目级设为~则为全局。场景二跨会话上下文延续Codex 跨会话记忆依赖两套机制AGENTS.md 是确定性规则每次必读Memories 是概率性偏好异步生成默认关闭。AGENTS.md规则永不丢失AGENTS.md 在每次会话启动时自动注入无需任何配置是零成本跨会话记忆的核心。位置与优先级~/.codex/AGENTS.md ← 全局所有项目生效 项目根目录/AGENTS.md ← 项目级覆盖全局同名规则 子目录/AGENTS.md ← Monorepo 子包级最高优先级放进去的典型内容## 构建规范 - 包管理器pnpm禁止 npm install - 测试命令pnpm test --run - 格式化prettier --write提交前必须执行 ## 禁止修改的目录 - dist/、.next/生成文件禁止手动编辑 ## 提交要求 - 修改后运行 pnpm typecheck pnpm lint - commit message 用英文格式feat/fix/chore: 简短描述**不应放进去的内容**短期任务、版本号频繁变化、API 密钥、当前进行中任务的状态。Memories偏好异步沉淀Memories 从历史对话中自动提炼个人偏好注入后续会话——弥补 AGENTS.md需要手动维护的短板。启用方式# ~/.codex/config.toml [features] memories true或Settings → Personalization → Enable memories核心配置项[memories] use_memories true # 向后续会话注入已有记忆 generate_memories true # 允许从新会话中学习 disable_on_external_context true # 使用了 MCP/搜索的会话不参与生成防污染 min_rate_limit_remaining_percent 25 # 配额低于 25% 时跳过生成文件路径~/.codex/memories/明文 Markdown分享前检查是否含敏感信息三个关键限制异步生成会话结束后需等待空闲足够长时间才更新不是实时生成可能因 rate limit 被跳过不保证每次都有新记忆写入不适合放必须生效的规则——那是 AGENTS.md 的职责场景三长任务中的上下文管理Codex 的有效上下文窗口为 272,000 tokenGPT-5.62026 年 7 月更新压缩阈值 0.95 后实际可用约 258k token。OpenAI 于 2026 年 7 月将 GPT-5.6 的默认输入上下文从 372,000 缩减至 272,000该变更引发开发者社区集中反馈GitHub issue #9429 呼吁提升至 350,000截至 2026-07-29 仍在讨论中。自动压缩机制Token 用量接近窗口上限时Codex 自动触发压缩无需用户操作将历史对话提炼为摘要替换原始消息压缩后空间仍不足时执行头截断——移除最早的消息手动触发在对话框输入/compact可在任意时刻主动压缩。PreCompact Hook给压缩注射记忆疫苗PreCompact Hook 在自动压缩触发前执行允许你把关键上下文强制注入摘要防止重要决策被压缩掉。在AGENTS.md中配置## PreCompact 摘要规范 压缩前请保留以下内容 - 当前任务目标一句话 - 已完成的步骤编号列表 - 已知未解决的错误或阻塞项 - 下一步计划主动重置策略对于超长任务比被动等压缩更可靠的做法是主动在关键节点创建 handoff 文档!-- task-handoff.md每完成一个阶段更新 -- ## 当前状态2026-07-29 - 已完成用户认证模块、数据库 Schema 设计 - 进行中支付接口集成第 3 步 - 未解决Webhook 验签逻辑有 race condition见 src/webhook.ts:142 - 下一步完成支付回调处理再写集成测试新会话开始时把 handoff 文档路径告诉 Codex读取 ./task-handoff.md继续完成其中进行中的任务这样即使上下文完全重置任务也不会断线。上下文分层速查表口诀规则进 AGENTS事实进文档方法进 Skill偏好进 Memory临时证据留在任务。信息类型放哪里理由包管理器、测试命令、禁止目录AGENTS.md每轮必须生效确定性个人表达偏好、常用语言设置Memories无需强制召回辅助即可跨任务可复用的发布流程Skills按需触发不占基础上下文系统架构图、决策记录项目文档README/ADR权威来源长期稳定任务进度、报错日志、测试输出handoff 文档 / 当前会话临时性任务结束提炼后丢弃API 密钥、生产凭据任何地方都不放安全红线常见问题Q导入 Claude Code 历史后AGENTS.md 会自动覆盖还是合并合并。Codex 导入时会把 CLAUDE.md 内容追加到 AGENTS.md 中不会删除已有规则。导入后建议人工过一遍去掉 Claude Code 专用指令如特定 hook 语法和已不适用的旧规则。QMemories 开启后AI 会记住我输入的密码或密钥吗官方文档说明 Memories 会对生成内容自动脱敏但仍建议不要在会话中明文输入任何凭据。记忆文件是本地明文 Markdown分享~/.codex/目录时务必检查memories/内容。Q上下文窗口满了之前的对话内容会永久丢失吗会话内会被压缩历史摘要替换原始消息但不影响 AGENTS.md 和 Memories——它们是独立存储的。真正需要跨会话保留的内容应在触发压缩前手动写入 handoff 文档或更新 AGENTS.md。Q从 Cursor 迁移时Skills 目录为什么直接兼容Codex 的 Skills 目录结构.agents/skills/name/SKILL.md与 Cursor 的技能规范有意保持了兼容。只需把.cursor重命名为.agentsCodex 就能识别并加载已有 Skill 文件无需改写内容。QAGENTS.md 有大小限制吗根据 Codex 源码分析AGENTS.md 合并注入后不宜超过 32KB过大会占用大量上下文窗口适得其反。规则要精简可执行不要把设计文档放进去。总结Codex 上下文迁移的核心思路是让规则不依赖会话存活。AGENTS.md 确保项目规范每次自动注入Memories 让个人偏好在多次对话中慢慢沉淀handoff 文档让长任务在任意断点都能精准续接——三层机制协同才能真正做到AI 换了会话工作不断线。本文内容基于 OpenAI 官方文档及 2026 年 7 月社区实测数据272k 上下文窗口变更引发的开发者讨论GitHub #9429仍在进行中建议关注后续更新。延伸资源Codex Memories 官方文档learn.chatgpt.com/docs/customization/memoriesCodex GitHub issue #9429上下文窗口讨论github.com/openai/codex/issues/9429AI 编程工具模型配置大全含 Codex/Claude Codedeveloper.qiniu.com/aitokenapi/13417/tools-AI-Coding-api