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