换电脑跑 Claude Code最烦的是会话失忆。TaoToken 是统一 API 接入通道先到 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 建一把 Key把它配进新电脑的 Claude Code你才有机会把旧机器上那段聊到一半的上下文原样接回来。很多人以为跨电脑迁移就是拷个.jsonl拷过去发现历史对话空白、/context也不显示 token 用量于是怀疑文件损坏——其实文件没问题是新机器上这条通道没打通。这篇按我自己的迁移顺序写先看清楚~/.claude里哪些数据必须搬再解决新电脑上的接入配置然后才是路径编码、cwd修正这些细活。整个过程手动做下来几分钟难点从来不是复制粘贴而是搞清楚「为什么新电脑不认旧会话」。中间那些报错我也会按实际遇到的样子列出来方便你对照。1. 新电脑上 Claude Code 不认识旧会话卡点其实有两个1.1 会话转录复制过去了为什么还是空白Claude Code 把对话记录按项目路径分目录存在~/.claude/projects/下文件名是 session id后缀.jsonl。它并不是「打开就自动读」的而是靠sessions/目录里的元数据把当前工作目录cwd和 session id 关联起来。你只拷了.jsonl没拷sessions/或者拷了但cwd还指向旧电脑的路径Claude Code 就找不到该把哪段对话挂到当前项目上。另一层是路径编码。projects/下的目录名不是原始路径而是把C:\Users\A\Desktop\xxx里的冒号和反斜杠统统换成-得到的字符串。用户名从 A 变成 B编码名就变了文件放在旧编码名的目录里新电脑自然视而不见。这两件事叠在一起表现出来就是「项目代码都在会话却像从没存在过」。1.2 被忽略的第二个卡点新机器上那把能用的 Key还有个更隐蔽的问题。Claude Code 恢复会话之后你大概率会随手敲一个/context想确认上下文占用或者用claude --resume看看历史能不能拉起来。这一步要真正发请求就需要新电脑上有可用的凭据。如果新机器上什么都没配你连「迁移成没成功」都判断不了——/context拿不到 token 用量恢复出来的会话到底有没有生效全靠猜。所以正确的顺序是装完 Claude Code先配好通道再搬会话数据。通道去哪配打开 TaoToken 注册账号、创建 API Key这一步花不了一分钟但没有它后面所有验证都是空中楼阁。2. 摸清 ~/.claude 目录projects、sessions、file-history 谁管什么2.1 一份目录结构清单动手之前先认路。~/.claude下和迁移相关的主要是这几个目录/文件作用迁移必要性projects/编码路径/session-id.jsonl完整对话转录核心数据必须projects/编码路径/memory//memory保存的持久记忆建议sessions/pid.json会话元数据含cwd、session id必须且要改file-history/session-id/文件编辑历史/diff用可选tasks/session-id/任务追踪状态可选history.jsonl全局历史索引可用来查 session id参考settings.json用户全局设置含环境变量新机器自己配settings.local.json本地权限配置一般不用搬.highwatermark和.lock这类是运行时状态跟着搬过去反而容易出怪问题直接让新电脑自己生成。2.2 路径编码规则C:\Users\A 怎么变成 C--Users-A-Desktop-------编码逻辑很朴素冒号、反斜杠、斜杠以及*?|这些字符都替换成一个-非 ASCII 字符比如中文文件夹名每个字符也替换成一个-其余原样保留。所以C:\Users\A\Desktop\挑战杯数据集会变成C--Users-A-Desktop-------中文六个字对应六个短横线。这里有个细节容易踩projects/下的目录名和sessions/*.json里cwd字段的写法是两套东西。前者是编码后的字符串后者是带双反斜杠转义的原始路径。改的时候别改错字段把编码名塞进cwd就彻底对不上了。3. 在 B 电脑上装 Claude Code并把它指到 TaoToken3.1 装完先跑一次让它生成 ~/.claude 骨架新电脑上装好 Claude Code然后随便找个目录执行一次claude进去之后输入/exit退出。这一步的意义是让它把~/.claude/下的目录骨架、默认配置文件都创建出来后面你往里拷东西才不会出现「目标目录不存在」这种低级问题。如果你还没装按照官方文档装完再回来。骨架生成之后先别急着拷会话把接入配置做完再继续。3.2 settings.json 的 env 里填 Base URL 和 KeyClaude Code 读取~/.claude/settings.json里的env字段作为进程环境变量。要让新电脑走 TaoToken 的通道把下面三行填进去{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_MODEL: MODEL_ID_FROM_MODEL_LIST } }ANTHROPIC_BASE_URL就填https://taotoken.net/api注意末尾不要加/v1加了会被当成不存在的路径。ANTHROPIC_AUTH_TOKEN换成你从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 控制台创建的那把 Key也就是YOUR_API_KEY的位置。ANTHROPIC_MODEL填哪个模型以模型广场当时的列表为准别照抄别人文章里的旧名字。提示settings.json是全局设置对所有项目生效如果某台机器上要区分项目用settings.local.json覆盖局部字段。3.3 用环境变量做一次临时验证不想动配置文件也可以在当前终端里临时导出验证通道是否可用export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENYOUR_API_KEY export ANTHROPIC_MODELMODEL_ID_FROM_MODEL_LISTPowerShell 写法是$env:ANTHROPIC_BASE_URLhttps://taotoken.net/api其余两行同理。这种方式只在当前窗口有效关掉就没了适合先确认「Key 到底通不通」再决定要不要写进配置文件。3.4 /context 能出数字说明通道通了配好之后在任意项目目录里启动 Claude Code输入/context。如果能看到 token 用量和上下文占用比例说明 Key 和 Base URL 都生效了。这一步是后面迁移验证的前提——先有一个能用的基准再谈「新电脑的用量和旧电脑一致」。如果这一步就报错先别去碰会话文件先把通道问题解决掉否则你会把两类问题混在一起排查。4. 两条迁移路线路径一致就覆盖路径变了就重映射4.1 方案 A用户名和盘符都能复刻最省事的做法是从一开始就让两台机器长得一样同样的盘符、同样的用户名、项目放在同样的父目录下。满足这个条件时迁移只有两步——把项目文件夹拷到新电脑的相同位置再把整个~/.claude/打包拷过去覆盖或合并。因为编码名完全一致sessions/*.json里的cwd也不用改。启动 Claude Code历史对话直接就在。现实里这个前提经常不成立。公司电脑和家里电脑用户名不同、系统盘符不同、桌面路径带中文随便中一条就得走方案 B。4.2 方案 B用户名变了重算编码名再拷方案 B 多出来的工作量就三件事算出新电脑的编码目录名、把.jsonl放进这个新目录、把sessions/*.json里的cwd改成新路径。听起来简单但顺序错了会白折腾所以第 5 节我把每一步拆开写。顺带说一句查找 session id 的小技巧打开~/.claude/history.jsonl搜索旧电脑的项目路径就能看到对应的 session id 字段。比在projects/里逐个目录翻快得多。5. 七步落地从算编码名到改掉 sessions 里的 cwd5.1 第 2 步算新编码名在新电脑上跑一段脚本把新路径按同样的规则编码。把路径换成你自己的p rC:\Users\B\Desktop\challenge-data enc .join(- if (c in :\\/*?| or ord(c) 127) else c for c in p) print(enc)输出类似C--Users-B-Desktop-challenge-data把它记下来这就是新电脑上projects/下要用的目录名。注意中文目录名每个字对应一个短横线数错一个目录就对不上。5.2 第 3 步复制 .jsonl 和 memory在~/.claude/projects/下创建上一步算出来的目录把旧电脑迁移包里的.jsonl对话转录拷进去mkdir -p ~/.claude/projects/C--Users-B-Desktop-challenge-data/ cp /path/to/migration/projects/OLD_ENCODED/66762821-XXXX-XXXX-XXXX-XXXXXXXXXXXX.jsonl \ ~/.claude/projects/C--Users-B-Desktop-challenge-data/如果旧目录里还有memory/且不为空一并拷过来这个目录装的是/memory命令持久化的内容跨会话有效丢了可惜。5.3 第 4 步迁 sessions 并修正 cwd会话元数据放在~/.claude/sessions/文件名通常是 pid。拷过去之后必须改cwd字段否则 Claude Code 会去旧路径找项目import json, os path os.path.expanduser(~/.claude/sessions/1111.json) new_cwd rC:\Users\B\Desktop\challenge-data with open(path, encodingutf-8) as fp: data json.load(fp) data[cwd] new_cwd with open(path, w, encodingutf-8) as fp: json.dump(data, fp, ensure_asciiFalse, indent2) print(cwd -, new_cwd)Windows 路径里的反斜杠在 JSON 里会写成\\用脚本读写成 JSON 会自动处理转义比手动改稳妥。如果你习惯手改记得别把双反斜杠改成单反斜杠。5.4 第 5 步补 file-history 和 tasks这两个目录不是必须的但想让/diff还能翻到当时的编辑记录、任务追踪状态也接着走就把它们按 session id 拷过去mkdir -p ~/.claude/file-history/66762821-XXXX-XXXX-XXXX-XXXXXXXXXXXX/ cp -r /path/to/migration/file-history/66762821-XXXX-XXXX-XXXX-XXXXXXXXXXXX/* \ ~/.claude/file-history/66762821-XXXX-XXXX-XXXX-XXXXXXXXXXXX/tasks/同理。记住目录名用的是 session id不是 pid两者别搞混。5.5 第 6、7 步拷源码、启动、对账把整个项目文件夹拷到cwd指定的那个路径上路径要和 5.3 里写的完全一致包括大小写和盘符。然后cd C:\Users\B\Desktop\challenge-data claude进去后按上箭头看能不能翻到历史对话再输入/context。如果 token 用量和旧电脑上看到的基本一致说明会话恢复成功而且新电脑上这条通道确实在正常消耗 token。要更彻底一点用claude --resume强制恢复指定会话再验一次。6. 迁移后对不上号的四种情况逐个排掉6.1 有 token 用量但看不到历史这种一般是终端渲染或者会话关联的小问题。先用claude --resume主动恢复一次还是不行就回去检查sessions/*.json里的cwd是否和项目实际路径逐字符一致。大小写、盘符、末尾有没有多余的斜杠都算不一致。6.2 sessions 文件损坏或格式不对如果启动时提示会话元数据有问题最省事的办法是直接删掉那个sessions/*.json让 Claude Code 重建元数据。对话转录在projects/下的.jsonl里不受影响重启之后历史记录依然在。删之前可以先备份一份万一要回退。6.3 Key 没配好导致的请求失败如果/context直接报鉴权错误八成是ANTHROPIC_AUTH_TOKEN里还留着YOUR_API_KEY没替换或者 Key 被复制时带了空格。还有一种是把 Base URL 写成了带/v1的地址导致请求路径拼错。回 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 控制台重新复制一次 Key粘贴时注意首尾别带空白字符。6.4 新电脑上已有别的项目会话会不会串不会。每个会话靠 session id 和 pid 独立区分你新加的那个sessions/*.json不会覆盖其他项目的元数据。唯一要注意的是别图省事把所有sessions/文件都拷过来导致同一台机器上出现指向不存在路径的僵尸元数据那种情况下启动时可能不太安静。7. 下次再换机器只想花五分钟7.1 备份、CLAUDE.md、/memory 三件事迁移做得多了会发现真正省时间的不是脚本而是习惯。定期把~/.claude打包备份换成新机器时就不用东拼西凑。架构决策、接口约定这类关键信息写进项目根目录的CLAUDE.md任何环境下 AI 都能快速进入状态不依赖某一段对话上下文。重要结论用/memory持久化跨会话依然有效。如果条件允许把多台机器的用户名统一了方案 A 直接覆盖就行连编码名都不用算。7.2 配完之后去控制台对一下这次调用整条链路跑通后建议做最后一步核账在 TaoToken 模型对话 里用同一把 Key 发一条测试消息确认模型 ID 和 Base URL 都没填错。要长期在新电脑上写代码可以看看 Coding Plan 的套餐够不够用Key 随时能在 控制台 API Keys 里重新创建。环境变量和模型字段的对应关系见 Claude Code 接入文档。回到最开始那个判断/context里的 token 用量对得上历史对话翻得出来这次迁移就算成了。剩下的就是把旧电脑上的.jsonl收好别哪天顺手清目录给删了。