codex安装失败提示“磁盘空间不足”主因是c盘缺乏至少5gb连续临时空间,需清理%temp%、npm-cache及.codex/cache目录,或通过磁盘管理压缩d盘并扩展c盘。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Codex安装失败提示“磁盘空间不足”,往往不是因为安装包本身大(仅几十MB),而是系统盘(C盘)已无足够临时空间供Node.js解压、缓存依赖及生成临时文件,此时必须先释放空间或扩容,否则连npm install -g @openai/codex都会卡在“extracting”阶段报错。
确认真实可用空间与瓶颈位置
打开终端(PowerShell或CMD),以管理员身份运行,执行:df -h C:(Windows PowerShell)或 dir C:\(CMD),查看C盘剩余空间是否低于3GB。
若显示“可用 1.24GB”,但安装仍失败,说明问题不在总容量——Codex安装过程需额外约2.5GB临时空间用于解压node_modules和构建缓存,【必须保留至少5GB连续可用空间】才能完成全局安装。
接着执行:codex analyze-disk C:(若已预装轻量版)或手动检查:du -sh C:\Users\*\AppData\Local\Temp、du -sh C:\Windows\Temp、du -sh C:\ProgramData\npm-cache。
多数情况下,C:\Users\用户名\AppData\Local\Temp 单独就占8–15GB,且包含大量Node.js残留tar包和未清理的npm install中途产物。
高风险低操作:精准清理C盘临时与缓存目录
方法一:用系统内置工具快速释放基础空间
按下Win + R → 输入cleanmgr → 选择C盘 → 勾选“临时文件”“Windows更新清理”“回收站” → 点击“清理系统文件”。这一步能清掉2–6GB,但对npm缓存、IDE日志、WSL虚拟磁盘无效。
方法二:强制清除Node.js与包管理器缓存(推荐)
在管理员PowerShell中依次执行:npm cache clean --forceRemove-Item -Recurse -Force "$env:LOCALAPPDATA\npm-cache"Remove-Item -Recurse -Force "$env:LOCALAPPDATA\Temp\*npm*"
注意:【不要删除整个Temp文件夹,只删含npm、node、yarn关键字的子项】,否则可能误删正在运行程序的锁文件导致蓝屏。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
方法三:定位并清理Codex专属高占用项
Codex CLI安装时会在C:\Users\用户名\.codex\cache生成模型元数据快照,首次运行后可能达1.8GB;若你之前试装失败过,该目录下还残留多个install-xxxxx.lock和未完成解压的node_modules.tar.gz。直接删除整个.codex文件夹安全无副作用,重装时会重建。
无损扩容C盘:从D盘借空间(无需第三方软件)
第一步:备份D盘关键数据
将D盘根目录下所有文档、图片、视频文件复制到外接硬盘或云盘。此步不可跳过,后续“删除卷”操作不可逆。
第二步:释放D盘未分配空间
按Win + R → 输入diskmgmt.msc → 右键D盘 → 选择“压缩卷” → 输入压缩量(如20480,即20GB)→ 点击“压缩”。成功后出现一块黑色“未分配”区域,紧邻C盘右侧。
第三步:扩展C盘容量
右键C盘 → 选择“扩展卷” → 在向导中默认选择全部未分配空间 → 点击“下一步”→“完成”。
注意:若“扩展卷”为灰色,说明C盘与未分配空间不相邻——此时需先用diskpart命令行清除D盘分区(风险极高),或改用InsCode平台生成的磁盘管理工具可视化调整分区顺序。
第四步:验证扩容结果
打开文件资源管理器,右键C盘 → “属性”,确认已用空间减少、总容量增加。此时重新运行npm install -g @openai/codex,安装流程将顺利通过解压阶段。










