Claude 换号搬家 · Claude Account Mover
换了 Claude 账号后,把旧账号在本机留下的 Code 会话和 Cowork 会话复制到当前 账号的侧边栏里,点开即可继续;同时识别已经丢失对话记录的空壳会话,并把记录 保留期调到足够长,避免再被自动清理。
Triggers
Activate when
- “换了 Claude 账号,之前的 session 都不见了”“把旧账号的会话搬到新账号”。
- “切换账号但不要丢历史会话”“旧账号不用了,数据和 session 要继续用”。
- "I switched Claude accounts and lost my sessions", "help me move the sessions from my old Claude account to the new one".
- 用户问 Cowork 会话或 Code 会话的记录为什么会过期、如何延长保留期。
Do not activate when
- 只想临时切回旧账号查看:直接退出再用旧账号登录即可,会话按账号保存,不会丢。
- 搬迁或重命名项目目录、让
claude --resume跟着新路径走:交给lov-cc-mv。 - 切换 API 供应商、代理或第三方模型:属于 CC Switch 一类供应商切换工具,与账号会话无关。
- 迁移 claude.ai 网页聊天、Projects、connector 授权或云端会话:这些存在服务器上,本 Skill 无法搬运。
Background the agent must know
- 桌面版按「账号 UUID / 组织 UUID」分目录保存侧边栏索引:Code 会话在
claude-code-sessions/,Cowork 会话在local-agent-mode-sessions/。换号只是换了 读取的目录,旧会话仍在磁盘上。细节见references/desktop-storage.md。 - Code 会话的完整对话记录在 Claude Code 配置目录的
projects/下,所有账号共用; Cowork 会话的对话记录在各自会话目录里的.claude/,跟着会话目录走。 - Claude Code 默认只保留 30 天对话记录(
cleanupPeriodDays)。被清掉的会话在侧边栏 只剩标题,无法恢复;Cowork 会话使用独立配置,不继承用户全局设置。
User Profile (cross-session)
Read skill.yaml and the shared user-profile/v1 Profile at the start of every
run, including skills.lov-claude-account-migrate.records. Supported records:
records.retention_days— preferredcleanupPeriodDaysfor migrated Cowork sessions.records.include_orphans— whether title-only sessions should also be copied.
When the user directly states one of these as a lasting preference, save it with
scripts/profile_store.py record ... --confirm and report the saved path. Never
store emails, account UUIDs, tokens, or credentials in the Profile. See
references/user-profile.md.
Skill Group Composition
Read references/skill-composition.md before routing to an adjacent capability.
lov-cc-mv and session analysis Skills are optional, separate handoffs.
Workflow (MANDATORY)
Step 0: Resolve the script and context
export SKILL_DIR="${SKILL_DIR:-<installed lov-claude-account-migrate directory>}"
# A function, not a string variable: zsh does not word-split an unquoted $CAM.
CAM() { python3 "$SKILL_DIR/scripts/claude_account_migrate.py" "$@"; }
The script defaults to the macOS desktop data directory and to $CLAUDE_CONFIG_DIR
or the home .claude directory for transcripts. On other platforms pass
--data-dir; if the store is missing, stop and report the expected path.
Step 1: Scan accounts (read-only)
CAM scan
Report per account: whether it is current, the activity date range, Code session count with how many still have transcripts, Cowork session count, and archived count. Emails are shown only when unambiguous; otherwise identify the old account by date range, counts, and a few session titles. Ask one focused question only if the source account remains ambiguous.
Step 2: Plan the migration (read-only)
CAM migrate --from <old account uuid | prefix | email>
--to defaults to the desktop app's current account. Explain the plan in plain
terms: how many sessions will be copied, how many are already present, and how
many are title-only orphans. Orphans are skipped by default because they cannot
be opened or resumed; copy them only when the user wants the titles, using
--include-orphans.
Step 3: Apply
CAM migrate --from <old account> --apply
The copy is additive: existing target files are never overwritten, the source account folder is never modified, and credentials or app configuration are never touched. No backup is needed for this step. Repeat Step 2 and Step 3 for each old account the user wants to keep.
Step 4: Verify in the app
- The desktop app rescans its session folders within minutes; a restart is not normally required. If the host offers session-management tools, list or fetch a migrated session to confirm it is visible; otherwise ask the user to check the sidebar. Only if sessions are still missing, ask the user to quit with Cmd+Q and reopen.
- Re-run the Step 2 plan: it must report
to copy 0for every org. - The app rebuilds
archived-sessions.idxfrom each session'sisArchivedflag, so archived state survives.
Step 5: Protect transcripts
- If the plan warns that the CLI
cleanupPeriodDaysis unset or 30 days or less, tell the user that older transcripts will be deleted and recommend raising it in the user's Claude Codesettings.json; change it only with the user's consent. migratealready setscleanupPeriodDays(default 3650) inside every copied Cowork session. For Cowork sessions that already belong to an account:
CAM retention --account current # plan
CAM retention --account current --apply # write
Step 6: Report
State, per source account: sessions copied, already present, orphans skipped or copied, Cowork retention updates, and whether the app shows them. Also state:
- The source account folder must stay if the plan reported Cowork sessions that still write outputs there.
- Scheduled tasks, claude.ai chats, Projects, connector authorizations, and cloud sessions are not migrated.
- Title-only sessions cannot be recovered without an external backup.
Dependencies
None beyond Python 3.9+ standard library. scripts/profile_store.py is the
standard Profile helper.
Validation
python3 scripts/validate_skill.py .
