Claude Codeのデータをバックアップする方法|AIの記憶を守る3層構成【2026年版】
Claude Codeを日常的に使っていると、セッションをまたいでAIが学習した情報——プロジェクトの構成・好みの開発スタイル・よく使うコマンド——が memory/ ディレクトリに蓄積されていきます。これはGitで管理されていないローカルデータです。
Macが壊れたり、誤って削除したりすると、AIの記憶は全消失します。
この記事では、Claude CodeのデータをGitHub + OCI + NAS(Time Machine)の3層構成で保護する方法を、実際に構築した構成をもとに解説します。
まずバックアップすべきデータを把握する
~/.claude/ ディレクトリの中身を整理すると、重要度とサイズが大きく異なります。
| ディレクトリ / ファイル | サイズ | 重要度 | 対応 |
|---|---|---|---|
projects/*/memory/*.md |
40KB | 最高 | 必須バックアップ |
~/.claude.json(MCP設定・hooks) |
数十KB | 最高 | 必須バックアップ |
commands/(カスタムスキル) |
小 | 高 | バックアップ推奨 |
plans/(保存済みプラン) |
88KB | 中 | バックアップ推奨 |
history.jsonl |
636KB | 低 | あればラッキー |
debug/ |
962MB | ゼロ | 除外 |
plugins/ |
736MB | 低 | 除外(再インストール可) |
debug/ と plugins/ だけで全体の約2.6GBのうち1.7GBを占めています。これらを除外するだけで、バックアップ対象は劇的に小さくなります。
第1層:GitHub private repo(AIの記憶のバージョン管理)
対象: memory/(40KB)+ claude.json(MCP設定)+ commands/
目的: 変更履歴を追える形で最重要データを保管する
GitHubにプライベートリポジトリを作成し、バックアップスクリプトをcronで毎日実行します。
スクリプトの概要
スクリプト /work/company/tools/backup_claude_data.sh が行う処理:
memory/ディレクトリをリポジトリにrsync~/.claude.jsonから認証情報(oauthAccount)を除外してJSON保存commands/・plans/をコピーgit add -A && git commit && git push(変更があるときのみ)
cronへの登録
毎日 02:00 に自動実行するよう登録します。
- コマンド:
crontab -eで0 2 * * * /bin/bash ~/backup_claude_data.shを追記
これで毎朝2時にGitHubへ差分がpushされます。MCP設定を大幅に変更した日も、翌朝には安全に記録されます。
第2層:OCI rsync(フルデータの日次コピー)
対象: ~/work/(ソースコード全体)+ ~/.claude/(debug/plugins除く)
目的: Mac本体が壊れても1日以内の状態に復元できる
除外するディレクトリ
rsyncの --exclude オプションで生成物を除外します。
| 除外対象 | 理由 |
|---|---|
node_modules/ |
npm installで再生成可能 |
dist/・.astro/ |
ビルドで再生成可能 |
public/thumbnails/・public/images/ |
スクリプトで再生成可能 |
.venv/・__pycache__/ |
pip installで再生成可能 |
.git/ |
GitHubにある |
実際のバックアップ容量
node_modulesなどを除外した結果、~/work/ + ~/.claude/ 合計で約1.4GBに収まりました。OCIの空き容量(27GB)に対して余裕があります。
cronへの登録
毎日 03:00(第1層の1時間後)に自動実行します。
- コマンド:
crontab -eで0 3 * * * /bin/bash ~/backup_to_oci.shを追記
第3層:Time Machine + USB外付けHDD(完全バックアップ)
対象: Mac全体
目的: 上記2層でカバーできない設定・アプリ・書類まで含めた完全復元
必要なもの
- USB外付けHDD(1TB以上推奨。macOS対応済みのもの)
- 容量目安: Macの使用量の2倍以上(500GBのMacなら1TB以上)
私はUSB 1TBのHDDをMacに直結して運用しています。NASより安く、接続の手軽さもあって最初の1台に向いています。ケーブルを挿しておくだけで1時間ごとに自動バックアップが走ります。
設定手順
- USBでHDDをMacに接続
システム設定 → 一般 → Time Machine- 「バックアップディスクを追加…」から接続したHDDを選択
初回バックアップは1〜2時間かかりますが、以降は差分のみで1時間ごとに自動実行されます。
NASでも可: Synology・Buffalo・IODATAのTime Machine対応NASでも同様に構成できます。複数台のMacをまとめてバックアップしたい場合はNASが便利ですが、1台なら直結HDDで十分です。
3層バックアップの全体構成
| 層 | 対象データ | 頻度 | 目的 |
|---|---|---|---|
| GitHub dotfiles | memory/ + MCP設定(40KB) | 毎日 02:00 | バージョン管理・履歴追跡 |
| OCI rsync | work/ + .claude/(1.4GB) | 毎日 03:00 | データ消失対策 |
| Time Machine (USB外付けHDD) | Mac全体 | 1時間ごと | 完全バックアップ |
Time Machineなしの場合のリスク
もしMac本体が故障した場合:
- 第1層のみ: memory/ と MCP設定は復元できる。ソースコードはGitHub経由で復元可能。ただし作業途中のローカル変更は消える
- 第1層 + 第2層: 前日夜03:00時点の状態まで復元できる。1日以内の損失で済む
- 3層すべて: 最後のTime Machineバックアップ(1時間以内)の状態に完全復元できる
AIの記憶だけでなく作業途中のファイルも守るには、3層すべてを揃えるのが理想です。
関連記事
まとめ
| 項目 | 内容 |
|---|---|
| 最優先バックアップ | memory/(40KB)と ~/.claude.json |
| 除外すべき大容量 | debug/(962MB)・plugins/(736MB) |
| 第1層 | GitHub private repo(毎日 02:00) |
| 第2層 | OCI rsync(毎日 03:00、1.4GB) |
| 第3層 | Time Machine + NAS(1時間ごと) |
Claude Codeを本格的に使い込むほど、memory/ に蓄積されるコンテキストは価値を持ちます。ソースコードはGitHubで守られていても、AIの記憶はデフォルトでは無防備です。今日から多層バックアップを始めることをおすすめします。