必须将Codex切换至64位模式并扩大Node.js堆内存上限，同时禁用非必要索引与预加载、启用流式解析降级模式，才能稳定处理超大源码文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你用Codex桌面版处理超过50MB的单个源码文件或包含上万行代码的项目时，进程会突然卡死、界面无响应，终端报出FATAL ERROR: Ineffective mark-compacts near heap limit Allocation failed - JavaScript heap out of memory，这是Node.js运行时内存耗尽的明确信号。
确认当前是32位还是64位运行环境
这一步必须先做——Codex默认以32位模式启动时，哪怕你有32GB物理内存，进程也【永远无法突破约3.2GB堆内存上限】，所有后续优化都无效。
打开终端，执行：codex --version --verbose
观察输出中是否含 arch: x64；若显示 arch: ia32 或无此项，则说明正在以32位模式运行。
Windows用户：右键Codex快捷方式 → “属性” → “兼容性”选项卡 → 取消勾选“以兼容模式运行这个程序” → 点击“更改高DPI设置” → 勾选“替代高DPI缩放行为”并选“系统(增强)” → 应用。该操作可强制系统调用64位loader。
macOS/Linux用户：终端中运行 file $(which codex)，若返回 Mach-O 64-bit x86_64 executable 或 ELF 64-bit LSB pie executable 才算合格；否则需重装官方64位版本。
强制提升Node.js堆内存上限
Codex底层由Node.js驱动，其默认堆内存限制（约1.4GB）远低于大文件解析需求。必须显式扩大老生代空间。
方法一：临时生效（适合调试）
在启动Codex前，终端输入：NODE_OPTIONS="--max-old-space-size=6144" codex
其中6144代表6GB，建议设为物理内存的50%～75%，但不超过12288（12GB）。
方法二：永久生效（推荐）
编辑Codex启动脚本（Windows为codex.exe同目录下的codex.bat，macOS/Linux为codex可执行文件）：
在首行插入：@set NODE_OPTIONS=--max-old-space-size=6144（Windows）或export NODE_OPTIONS="--max-old-space-size=6144"（macOS/Linux）。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
【注意：修改后必须完全退出所有Codex进程再重启，旧进程不会自动继承新参数】
禁用非必要索引与预加载
大文件内存溢出常发生在Codex后台自动构建语义索引阶段。此时它会尝试将整个文件AST一次性载入内存，而非流式解析。
第一步：关闭实时补全
打开Codex设置 → Editor → Completions → 关闭 Enable AI completions 和 Auto-suggest on typing。
第二步：限制索引范围
进入 Settings → Indexing → File size limit (MB)，将数值从默认10改为2；Codex将跳过大于2MB的文件索引，仅保留符号跳转基础能力。
第三步：排除冗余路径
在 Settings → Indexing → Exclude patterns 中添加：**/node_modules/**, **/dist/**, **/build/**, **/*.min.js, **/*.log。
这能立即减少80%以上无效文件扫描量，避免索引器误入巨型打包产物。
启用流式解析降级模式
当上述措施仍无法稳定加载单个超大文件（如>100MB的SQL dump或日志）时，需放弃语义分析，改用纯文本流式查看。
① 在Codex中打开命令面板（Ctrl+Shift+P / Cmd+Shift+P）
② 输入并选择：Codex: Open Large File in Plain Mode
③ 选择目标文件 → Codex将跳过AST构建，直接以只读分页方式加载，内存占用恒定在
该模式下保留全文搜索（Ctrl+F）、正则高亮、行号跳转，但不支持函数跳转、变量引用追踪、补全等AI功能。对审阅型任务已足够。
