Agent.Space 博客

Claude Code 换电脑:迁移到远端 Mac 的代码、配置与会话

Claude Code 换电脑后怎么继续项目?迁移到远端 Mac 时,分开处理代码、CLAUDE.md、机器配置、凭据和聊天记录,再验证第一个任务。

换一台电脑继续使用 Claude Code,先分清“搬项目”和“恢复旧对话”。复制仓库可以带走已保存进版本记录的代码和项目说明,但不会自动带走机器配置、凭据和保存在本机的会话记录。迁移到远端 Mac 时,要分别确认这些内容,再继续工作。

第一次迁移先用一个有权处理的小项目。在远端副本通过你真正依赖的检查之前,保留本地原件。本文提供迁移步骤,不表示 Agent.Space 会自动搬走你笔记本上的文件、凭据或已有对话。

是迁移执行环境,还是连接原来的会话?

如果只是换一个屏幕操作,未必需要迁移。符合条件的 Remote Control 可以让任务继续在原电脑执行,这种情况参考 Remote Control 指南。下文处理的是把执行环境搬到另一台电脑。

内容在目标电脑上怎么处理
仓库与未完成修改传输目标版本,保留还没进入 Git 的修改
CLAUDE.md 等项目说明确认相关文件已经带过来,并且仍适用
用户级设置、工具与凭据按这台机器重新核对和配置,不默认仓库里包含这些内容
聊天记录与代码分开处理,选择恢复记录或书面任务交接
正在运行的命令与应用在新环境中重新启动并检查

Anthropic 的记忆文档区分了项目说明与其他记忆、配置。先检查自己的工作流依赖哪些文件,不能把复制一个文件夹当成完成了全部配置。

搬文件前,先记录原来的状态

确认项目目录、当前分支、最近保存的版本,以及尚未完成的工作。如果项目使用 Git,也就是代码版本记录工具,要同时检查已经修改的文件和还没加入版本记录的新文件。重新下载一份仓库,不会包含只留在笔记本上的修改。

在项目目录中,可以用以下只读命令记录原状态:

sh
git status --shortgit branch --show-currentgit rev-parse HEAD

第一条查看修改和未跟踪文件,第二条查看当前分支,第三条查看当前提交版本。它们不会备份文件。仍需按团队原有的分支和备份方式保存工作,不要为了方便传输就把整个目录一股脑提交:本地配置里可能有凭据或无关材料。

也要记下平时用什么命令检查项目,以及目前是否通过。原项目本来就失败的测试,对比远端环境时很有参考价值。否则,旧问题很容易被误认为迁移造成的新问题。

迁移项目,不要复制整个用户账号

通过仓库认可的访问方式获取远端副本,或者用选定的安全文件传输方式复制有权处理的项目目录。确认目标版本和必须保留的未完成工作都已到达。

密钥单独处理。不要为了省事复制整个用户目录、浏览器配置或保存登录信息的文件夹。仓库和依赖软件源的访问权限,应在目标电脑上明确配置。开发配置文件可能确实需要迁移,但其中的秘密值要遵循组织的凭据管理方式。

如果租的是专属 Mac,导入私有文件前先完成机器验收检查。确认分配给你的机器和访问权限,而不是只凭熟悉的桌面壁纸或文件夹名字判断。

在目标电脑上恢复依赖

按照项目文档要求的运行环境版本和安装步骤操作。在其他系统或处理器架构上生成的依赖目录,不一定能在 Mac 上直接使用。优先走项目正常的安装流程,不要未经检查就照搬生成的文件夹。

确认工作目录、运行环境和允许使用的配置。在让 Claude 修改代码之前,先运行项目已有的无破坏性检查。如果失败,记录错误,先解决环境问题。

如果应用有可视界面,也要确定如何打开预览。开发服务器在远端电脑运行,不代表在笔记本输入相同地址就能看到。使用获准的预览或桌面访问方式,不要为了迁移方便直接把服务器公开到互联网。

账号和文件分开确认

装好了 Claude Code、复制好了项目,并不等于已经正确登录。根据这台机器获准使用的路径,参考官方认证说明完成配置。调用模型前先确认由谁付费,不要把凭据粘进任务说明。

使用 Agent.Space 时,要确认选中了哪台电脑、哪种 Agent 路径。Claude Code 产品使用指南解释了这套工作方式。租金和模型用量需要分别确认,搬文件也不会改变模型提供方的账号资格。

换到新 Mac 后,旧聊天会自动出现吗?

不会因为复制了仓库就自动出现。官方会话指南说明,命令行会话以记录文件保存在本机。恢复记录可以恢复对话状态,但不会替你搬项目文件,也不会在新电脑上重新启动中断的命令。

如果必须保留完整历史,先保存原始记录,再按所用客户端和版本查阅官方恢复步骤。继续工作前核对路径、所需工具和恢复后的权限。本文不提供自动搬运会话的工具,也不承诺不同客户端共享同一份历史。

如果主要目的是把项目继续做下去,经过核对的任务交接通常更适合作为起点。原历史仍保留以便查阅,不把一段摘要当成包含了过去所有细节。

把任务上下文明确交接过去

切换入口后,之前的对话未必会跟着项目一起出现。不要默认它已经同步,而是准备一份简短交接:目标、已完成的工作、约束和下一步验证方式。

例如,可以按实际项目调整这段请求:

阅读仓库说明,解释当前项目结构。确认工作目录,以及登录表单涉及的文件。不要修改、安装或部署。指出开始改动前应该运行哪项已有检查,并报告缺少的前置条件。

再补上之前做过的决定和未完成工作。必要时给出文件路径和版本记录,但不要放密码或私有访问 Token。先让 Claude 复述理解,再交给它修改任务。

首个项目指南提供了可以复用的小任务定义和结果检查方法。

看到检查结果以后再切换

先在独立分支或项目副本中做一个小修改。检查具体差异、运行相关检查,并确认结果已保存到获准使用的仓库或备份系统。

第一次测试时,避免两台电脑同时修改同一个分支。如果迁移失败,应能回到保留的本地副本,而不是重新拼凑丢失的工作。远端环境验收通过后,再明确哪份副本负责当前工作,以及结果如何交回团队。

结束租赁前,导出需要的文件和结果,并按服务流程撤销访问。租来的开发电脑不应该是唯一的备份。

第一个远端任务刻意做小一点

第一次成功不需要是一场大规模自动重写。项目正确、账号明确、检查能跑、结果已保存且可查看,就已经达到了验收目的。如果还缺执行电脑,可以拿这些要求核对专属 Mac 配置;如果已经有了,先用上面的只读交接请求,再开始第一次修改。