Codex Mover · by Dawn

便携版 Windows 工具 / Portable Windows tool

把 Codex 的数据与工作区从爆满的 C 盘迁移到另一个盘（如 G 盘）。原路径保留为目录联接（junction），Codex 无需任何配置即可继续工作。全程带备份、逐项校验与自动回滚。

Move Codex data and workspace folders off a full C: drive to another drive. Original paths stay valid as directory junctions, so Codex keeps working without configuration changes. Every step is backed up, verified, and rolled back on failure.

界面预览 / Screenshots

主界面 / Main	运行中 / Running	完成 / Done

迁移内容 / What gets moved

默认迁移以下目录（GUI 里可以取消勾选）:

C: 路径	说明
%USERPROFILE%\.codex	配置、会话、日志、skills、插件缓存、登录凭证
%USERPROFILE%\.cache\codex-runtimes	运行时缓存
%LOCALAPPDATA%\OpenAI\Codex	桌面应用本地数据
%APPDATA%\Codex	桌面应用漫游数据
%USERPROFILE%\Documents\Codex	桌面应用默认工作区（新对话的项目文件）

使用 / Usage

图形向导（推荐）/ GUI wizard

WPF 图形向导（Dawn 浅色界面，v1.2.0）:

1. 双击 CodexMover-GUI.cmd 启动向导。
2. 勾选要迁移的目录、选择目标盘。
3. 正式迁移前需完全退出 Codex（含托盘图标）；只想预览的话勾选“演练模式”即可，无需关闭 Codex。
4. 点击“开始迁移”，日志实时滚动；右上角状态徽章变绿“完成”后重新打开 Codex。

命令行 / Console

# 先演练一遍（不修改任何东西）
powershell -NoProfile -ExecutionPolicy Bypass -File .\codex-mover.ps1 -TargetRoot G:\CodexData -DryRun

# 正式迁移
powershell -NoProfile -ExecutionPolicy Bypass -File .\codex-mover.ps1 -TargetRoot G:\CodexData

安全机制 / Safety

• 先复制到目标盘并校验（文件数、字节数、robocopy 反向对比），确认一致才动原目录。
• 原目录先改名、后建联接；备份再次校验后才释放 C 盘副本。
• 任何失败自动回滚；中断后可自动从备份修复缺失文件。
• 运行日志保存在目标盘 migration-<时间戳>.log，GUI 内同步滚动显示。

验证 / Verify

Get-Item C:\Users\<you>\.codex | Format-List LinkType,Target

应显示 LinkType : Junction，Target 指向目标盘。

回滚 / Restore

powershell -NoProfile -ExecutionPolicy Bypass -File .\codex-mover.ps1 -TargetRoot G:\CodexData -Restore

安装 skill / Install the skill

• 双击 install.cmd 安装捆绑的 codex-mover skill 到 ~/.codex/skills（该目录现在通常已通过联接位于目标盘）。
• 或从 GitHub 用官方 skill-installer 安装（skill 仓库：codex-mover-skill）：

install-skill-from-github.py --repo ZhaowTao/codex-mover-skill --path codex-mover

注意事项 / Notes

• 仅 Windows。macOS/Linux 请改用 CODEX_HOME 环境变量（无需联接）。
• 目录联接是社区验证的通用方案；官方 App 尚未正式支持迁移（openai/codex issue #34070）。
• 迁移后先保留 G:\CodexData\_backup-* 几天，确认稳定后再删除。
• 迁移中断后可能出现 *.pre-migration-* 残留目录，不影响使用；重启后可删除，或由后续运行自动清理。
• GUI 需要 Windows PowerShell 5.1 与 .NET Framework 4.x（Windows 10/11 自带）。

已知不适用场景 / Known limitations

下面这些情况不要直接迁移，先看最后一列怎么绕。

场景	为什么不行	怎么办
目标盘是 exFAT 或 FAT32（多数移动硬盘、U 盘的默认格式）	目录联结点只能在 NTFS 上创建，mklink /J 会直接报错	把目标盘格式化成 NTFS，或改用 CODEX_HOME 方案
目标盘是外接盘、U 盘或网络盘	盘一拔，C 盘那个联结点就指向空气，Codex 启动报找不到目录	换成内置硬盘的另一个分区
公司电脑被组策略禁用符号链接	创建联结点返回拒绝访问，非管理员也过不去	让 IT 放开策略，否则改用 CODEX_HOME
Codex 还在运行（包括托盘图标没退）	文件被占用，复制会漏文件，后面的校验必然失败	完全退出，任务管理器里确认没有 Codex 相关进程
目标盘剩余空间不足源数据的两倍	迁移过程中源数据和备份会同时存在，中途耗尽会触发回滚	先腾空间，留出源数据两倍的余量
目标路径下已经有同名目录	工具会拒绝覆盖，避免误删你已有的数据	换一个空目录，或先把旧目录移走

遇到问题 / Something broke

迁移动的是目录联接和真实文件，出问题请直接提 issue，不要自己硬删残留目录，容易把回滚要用的备份一起删掉。

提交问题 →

提之前先确认两件事：场景不在上面的「已知不适用场景」里；目标盘根目录的 migration-<时间戳>.log 还在。

要提供什么	怎么拿到
Windows 版本	winver，或 设置 → 系统 → 关于
PowerShell 版本	$PSVersionTable.PSVersion
Codex 版本	应用内关于页，或 codex --version
卡在哪一步	GUI 右上角状态徽章，加日志最后 20 行
报错截图	有红字的那一屏
目标盘文件系统	Get-Volume -DriveLetter G | Format-List FileSystem

日志里会带你的用户名和本地路径，贴之前把 C:\Users\你的名字 这类替换掉。

许可 / License

MIT