换一台电脑用 Claude Code，配置该带走哪些、不该带走哪些

我本机的 Claude Code 配了很多东西：全局指令、权限、插件、自己的技能、记忆，还有一个自己 fork 的插件。要换一台电脑，我想把这些都带过去，就问助手有没有方便的复制办法。

先盘点，再分成要带的和不要带的

助手没有直接给方案，先看了本机 ~/.claude 里实际有什么。

要带的，都是配置本体，体积很小：

内容	位置
全局指令	~/.claude/CLAUDE.md 和它引用的文件
设置	~/.claude/settings.json，权限、hooks、状态栏、已启用的插件、模型和缓存时长都在里面
自定义 hooks	~/.claude/hooks/
本地技能	~/.claude/skills/
记忆	~/.claude/projects/<项目>/memory/，只带 memory/ 这个子目录
MCP 配置	~/.claude.json 里的 mcpServers
插件清单	plugins/installed_plugins.json 和 known_marketplaces.json，到新机器上会自动重新拉取插件

不要带的：

• projects/：1.1 GB，这是会话记录。需要历史会话的话，另用工具单独迁移。
• jobs/、file-history/、cache/、shell-snapshots/、sessions/、telemetry/ 和 plugins/cache：全是运行时产物，会自动重建。
• 整个 ~/.claude.json：里面有机器和用户的标识。整份复制会让两台机器的标识冲突，只取 mcpServers 就够了。

几个容易踩的坑

软链接的技能会变成死链。 我的好几个技能，是指向别的工具目录的符号链接。直接复制只会带过去一个指向不存在位置的链接，应该先在新机器上把那个工具装好，再重建链接。真实目录的技能可以直接复制。

配置里有绝对路径。 状态栏脚本的路径写死在 settings.json 里，新机器的用户名和目录不同就要改。这个脚本本身也要一起带走。

配置里有令牌。 我的接口地址和密钥都放在 settings.json 的 env 里。不能把它放进 git 或明文同步的网盘，传输走 AirDrop、U 盘或加密压缩包，或者在新机器上手动填。

有些 hooks 不是自己写的。 我 settings.json 里十几个 hook，几乎都是 Orca（我用来同时管理多个 AI 编码会话的桌面应用）自动写进去的，真正是我自己的只有一个。迁移文档要求只带我自己的那一个，其他的让新机器上的 Orca 自己生成。

自定义的插件要确认真的在远端。 我有一个自己 fork 的插件。助手检查了本地和远端分支完全一致，没有没提交的改动，也没有没推送的提交，这才能放心地让新机器直接从 GitHub 拉，不用放进包里。

让新机器上的 Claude 自己装

我最后选的做法是，不写迁移脚本，让助手写一份迁移说明，到时候直接丢给新机器上的 Claude，让它按文档一步步装。

说完这个，我才想到真正想搬的不止 Claude Code 自己的配置，还有我装的各种命令行工具，新机器上什么都没有。助手于是把这台机器上的东西盘点了一遍：包管理器、全局命令行工具、应用、shell 配置、网络代理。后来我又补了一句，新机器是 WSL2 里的 Ubuntu，连 gh 都没装，这类前置工具也要写进去。文档因此改写成了两部分，必须先做第一部分。

• 工具和环境： 网络代理、包管理器和软件清单、运行时和全局命令行工具、手动安装的应用和后台服务、shell 配置、各个账号的登录（必须我本人操作）、项目代码怎么拉取。
• Claude Code 配置： 前面表格里的各项，加上插件安装的写法和核对清单。

文档里还有几条给新机器上 Claude 的规矩：覆盖任何文件前先备份，删除只用废纸篓命令，不回显令牌，大体积的软件和我自己的开发环境先问我再装。

配置包只有 57 KB，里面不放 ~/.ssh、~/.aws、Codex 的认证文件、cc-switch 的数据库和全部会话记录。这些文档里都写明了让新机器上的 Claude 来问我，不会擅自拷。

因为目标换成了 Linux，包和文档都按 Ubuntu 重做了一遍：Homebrew 路径要改，Orca、Karabiner、Computer Use 这些只有 macOS 才有的东西要拿掉。

还有一处要小心

助手在查 Codex 的配置文件时，脱敏没有生效，里面的令牌在命令输出里原样露出来了一次。这是我自己的密钥，只出现在本机终端，但还是提醒了我可以考虑更换。

提醒：让 AI 读配置文件，要当心输出

读取含令牌的配置，要让它在命令里就把值遮掉，而不是事后再叮嘱它不要复述。输出一旦进入会话记录，就留在了磁盘上。

没验证的部分

这份迁移说明，助手在目标机器上没有跑过任何命令，里面的安装命令都还没有验证过。它给的只是一份经过盘点的清单，到了新机器上还要逐项核对。