把 Claude 的项目和记录，迁移到 Codex

这次要带走的是项目文件、可读取的聊天和工作背景。先确认资料在哪，再按下面的步骤处理；账号订阅和工具的登录状态需要另行设置。

准备能正常登录的 Codex；已有则直接继续，尚未安装可查看官方 CLI 安装说明。

如果在 WSL、Docker 或 SSH 服务器运行 Claude Code，请到原环境找记录。设置过 CLAUDE_CONFIG_DIR 或 autoMemoryDirectory 时，以实际目录为准。history.jsonl 只记录输入历史，不能代替完整会话。

先保存正在编辑的内容，暂时保留原目录和缓存。下一步先做副本。

这次要带走的是项目文件、可读取的聊天和工作背景。先确认资料在哪，再按下面的步骤处理；账号订阅和工具的登录状态需要另行设置。

准备能正常登录的 Codex；已有则直接继续，尚未安装可查看官方 CLI 安装说明。

如果在 WSL、Docker 或 SSH 服务器运行 Claude Code，请到原环境找记录。设置过 CLAUDE_CONFIG_DIR 或 autoMemoryDirectory 时，以实际目录为准。history.jsonl 只记录输入历史，不能代替完整会话。

先保存正在编辑的内容，暂时保留原目录和缓存。下一步先做副本。

先保存未落盘的修改，关闭仍在写入的 Claude Code 会话。把示例里的项目路径改成自己的路径；备份目录放在项目和 Claude 数据目录之外。

在 PowerShell 运行。没有 F 盘时，也把 F:\AI\claude-rescue 换成自己的备份位置。

$sourceProject = 'F:\AI\my-project'
$backupBase = 'F:\AI\claude-rescue'
$stamp = Get-Date -Format 'yyyyMMdd-HHmmss'
$backupRoot = Join-Path $backupBase $stamp
$claudeRoot = if ($env:CLAUDE_CONFIG_DIR) {
  $env:CLAUDE_CONFIG_DIR
} else {
  Join-Path $env:USERPROFILE '.claude'
}

if (-not (Test-Path -LiteralPath $sourceProject -PathType Container)) {
  throw '项目目录不存在，请检查 sourceProject'
}
$projectFull = (Resolve-Path -LiteralPath $sourceProject -ErrorAction Stop).Path.TrimEnd('\')
$claudeFull = [IO.Path]::GetFullPath($claudeRoot).TrimEnd('\')
$backupFull = [IO.Path]::GetFullPath($backupRoot).TrimEnd('\')
foreach ($sourceFull in @($projectFull, $claudeFull)) {
  if ($backupFull.Equals($sourceFull, [StringComparison]::OrdinalIgnoreCase) -or
      $backupFull.StartsWith($sourceFull + '\', [StringComparison]::OrdinalIgnoreCase)) {
    throw '备份位置在源目录内，请改到独立目录或磁盘'
  }
}
if (Test-Path -LiteralPath $backupRoot) {
  throw '备份目录已存在，停止以避免覆盖'
}
New-Item -ItemType Directory -Path $backupRoot -ErrorAction Stop | Out-Null
Copy-Item -LiteralPath $sourceProject -Destination (Join-Path $backupRoot 'project') -Recurse -Force -ErrorAction Stop
if (Test-Path -LiteralPath $claudeRoot -PathType Container) {
  Copy-Item -LiteralPath $claudeRoot -Destination (Join-Path $backupRoot 'claude-data') -Recurse -Force -ErrorAction Stop
} else {
  Write-Warning '项目已备份；Claude 数据目录未找到，请检查原运行环境后补充备份'
}
$extraConfig = Join-Path $env:USERPROFILE '.claude.json'
if (Test-Path -LiteralPath $extraConfig) {
  Copy-Item -LiteralPath $extraConfig -Destination $backupRoot -ErrorAction Stop
}
Get-ChildItem -LiteralPath $backupRoot -Force

完成后打开备份里的 project 和 claude-data，抽查文件确实能读。Claude 数据目录没找到时，项目仍会备份，但需要回到原环境补找记录。外置记忆、符号链接或 junction 指向的其他位置要另存副本。

git status --short
git branch --show-current
git log -5 --oneline
git diff --stat

完整备份可能含私人聊天和凭据，留在自己控制的存储中；不要整包提交到公开仓库。

先保存未落盘的修改，关闭仍在写入的 Claude Code 会话。把示例里的项目路径改成自己的路径；备份目录放在项目和 Claude 数据目录之外。

在 Bash 或 Zsh 运行。WSL 请使用运行 Claude Code 的 Linux 用户环境。

source_project='/path/to/my-project'
claude_root="${CLAUDE_CONFIG_DIR:-$HOME/.claude}"
backup_root="$HOME/claude-rescue/$(date +%Y%m%d-%H%M%S)"

backup_claude() {
  [ -d "$source_project" ] || { printf '项目目录不存在\n' >&2; return 1; }
  [ ! -e "$backup_root" ] || { printf '备份目录已存在\n' >&2; return 1; }
  project_full=$(cd "$source_project" && pwd -P) || return 1
  mkdir -p "$(dirname "$backup_root")" || return 1
  backup_parent=$(cd "$(dirname "$backup_root")" && pwd -P) || return 1
  backup_full="$backup_parent/$(basename "$backup_root")"
  case "$backup_full/" in
    "$project_full/"*) printf '备份位置在项目内，请换位置\n' >&2; return 1 ;;
  esac
  if [ -d "$claude_root" ]; then
    claude_full=$(cd "$claude_root" && pwd -P) || return 1
    case "$backup_full/" in
      "$claude_full/"*) printf '备份位置在 Claude 数据内，请换位置\n' >&2; return 1 ;;
    esac
  fi
  mkdir "$backup_root" || return 1
  cp -a "$source_project" "$backup_root/project" || return 1
  if [ -d "$claude_root" ]; then
    cp -a "$claude_root" "$backup_root/claude-data" || return 1
  else
    printf '项目已备份；Claude 数据未找到，请检查原运行环境后补充备份\n' >&2
  fi
  if [ -f "$HOME/.claude.json" ]; then
    cp -a "$HOME/.claude.json" "$backup_root/" || return 1
  fi
  printf '备份位置：%s\n' "$backup_root"
  ls -la "$backup_root"
}
backup_claude

完成后打开备份里的 project 和 claude-data，抽查文件确实能读。Claude 数据目录没找到时，项目仍会备份，但需要回到原环境补找记录。外置记忆、符号链接或 junction 指向的其他位置要另存副本。

git status --short
git branch --show-current
git log -5 --oneline
git diff --stat

完整备份可能含私人聊天和凭据，留在自己控制的存储中；不要整包提交到公开仓库。

网页 ZIP 不能直接交给 Codex CLI 的 /import；本步骤先转为可读资料。解压后有 conversations.json 时，可以转换为 Markdown：

下载后把脚本保存到自己的工具目录。需要 Python 3.10 或更新版本，仅使用标准库；在本机离线运行，不需要登录 Claude 或调用模型。

下载 export_claude.py

以下以脚本保存在 F:\AI\claude-rescue 为例，按实际位置替换路径：

python 'F:\AI\claude-rescue\export_claude.py' 'F:\AI\claude-rescue\web-export\conversations.json' --out 'F:\AI\claude-rescue\archive-web'

--out 后必须是输入目录以外、尚不存在的新目录。已有同名目录就换名字，不要删除旧结果来重跑。转换后打开 INDEX.md，抽查一条熟悉的对话。

如果没有 conversations.json，先打开导出包确认结构；保留可阅读的文件，不要仅改后缀强行转换。没有可转换聊天时，仍可用已有代码和文档继续交接。

网页 ZIP 不能直接交给 Codex CLI 的 /import；本步骤先转为可读资料。解压后有 conversations.json 时，可以转换为 Markdown：

下载后把脚本保存到自己的工具目录。需要 Python 3.10 或更新版本，仅使用标准库；在本机离线运行，不需要登录 Claude 或调用模型。

下载 export_claude.py

以下以脚本保存在 ~/claude-rescue 为例，按实际位置替换路径：

python3 ~/claude-rescue/export_claude.py ~/claude-rescue/web-export/conversations.json --out ~/claude-rescue/archive-web

--out 后必须是输入目录以外、尚不存在的新目录。已有同名目录就换名字，不要删除旧结果来重跑。转换后打开 INDEX.md，抽查一条熟悉的对话。

如果没有 conversations.json，先打开导出包确认结构；保留可阅读的文件，不要仅改后缀强行转换。没有可转换聊天时，仍可用已有代码和文档继续交接。

导入后没有缺项，可以直接进入下一步。手工接入或只缺少一部分资料时，按需要展开对应项：

Get-ChildItem -LiteralPath 'F:\AI\claude-rescue\你的备份目录\claude-data\projects' -Filter '*.jsonl' -Recurse -File |
  Sort-Object LastWriteTime -Descending |
  Select-Object -First 20 FullName, LastWriteTime, Length

python 'F:\AI\claude-rescue\export_claude.py' 'F:\AI\claude-rescue\你的备份目录\claude-data\projects' --out 'F:\AI\claude-rescue\archive-code'

导入后没有缺项，可以直接进入下一步。手工接入或只缺少一部分资料时，按需要展开对应项：

find "$HOME/claude-rescue/你的备份目录/claude-data/projects" -type f -name '*.jsonl'

python3 ~/claude-rescue/export_claude.py ~/claude-rescue/你的备份目录/claude-data/projects --out ~/claude-rescue/archive-code