应先通过codex界面和cli双重验证项目废弃状态，再执行/unregister命令从projects.db中安全移除元数据，最后手动清理快照、缓存及孤儿会话文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想删掉 Codex 里那些早已废弃、不再打开的项目目录，又怕误删正在用的项目或破坏 Codex 的内部索引关系，必须从项目元数据和物理路径两个层面同步清理。
确认项目是否真正“不再使用”
打开 Codex 应用 → 左侧边栏点击「项目」→ 观察每个项目右侧的时间戳和最后活动状态。若某项目超过 30 天未被点击、无任何对话线程、且对应本地文件夹已手动删除或重命名，则可判定为废弃项目。【切勿仅凭文件夹不存在就认定项目可删】，因为 Codex 仍可能在 ~/.codex/projects.db 中保留其元数据引用。
执行命令行验证：在终端中运行 codex-history list --cwd "your-project-name"，若返回空结果且无匹配路径，说明该名称未被任何会话关联。
从 Codex 内部移除项目记录
第一步：启动 Codex CLI 并进入交互模式
codex
第二步：输入 /projects 列出所有注册项目
第三步：对目标项目执行 /unregister project-name（将 project-name 替换为实际项目名）
这一步会从 ~/.codex/projects.db 中安全删除该项目条目，同时清除其在左侧边栏的显示。若项目名含空格或特殊字符，需用英文引号包裹，例如 /unregister "my old api"
通过 Codex CLI 生成图片，支持尺寸控制和批量模式。依赖：codex (npm)。代理默认启用。用 generate.sh 生成单张，batch_generate.sh 批量生成游戏 UI 素材，gen_size.sh 指定尺寸。所有输出保存至 ~/.codex/generated_images/。
第四步：退出 CLI 后重启 Codex 桌面应用，检查左侧边栏是否已消失该条目。
彻底清理残留文件与缓存
方法一：手动清理项目专属快照与状态
进入 ~/.codex/shell_snapshots/ 目录 → 查找以该项目名或其哈希前缀命名的 .json 文件 → 删除所有匹配项。这些快照不随 /unregister 自动清除，残留会导致下次同名项目注册时加载错误状态。
方法二：清空项目级缓存目录（仅限 macOS/Linux）
rm -rf ~/.codex/cache/projects/$(basename "$(realpath /path/to/your/project)")
Windows 用户请改用 PowerShell：
Remove-Item -Recurse -Force "$env:USERPROFILE\.codex\cache\projects\$(Split-Path -Leaf 'C:\path\to\your\project')"
方法三：验证并清理孤儿会话（推荐）
执行 codex-history purge-orphans → 该命令会扫描 projects.db 中已注销但仍有会话记录的项目，并批量清理其 ~/.codex/sessions/ 下的残留对话文件。这步不可跳过，否则项目虽不见，历史消息仍占磁盘空间。
