claude-sync は何をしますか？
Claudeプロジェクトを主要なクラウドストレージサービス（WebDAV対応のプライベートストレージを含む）と同期し、完全なスナップショットをサポートするツールです。
機能
- クラウドストレージ同期: Google Drive、Dropbox、OneDrive、Boxなどの主要サービスに対応。
- WebDAVサポート: NextCloud、ownCloud、Synology NASなど、WebDAVプロトコルを使用するプライベートストレージと同期可能。
- 完全スナップショット: プロジェクトの状態をスナップショットとして保存し、過去のバージョンに簡単に復元。
- 自動バックアップ: 定期的な同期を設定して、データ損失を防止。
対応プラットフォーム
- Claude Code
- Cursor（拡張可能）
- その他のAIエージェントツール
インストール
npm install -g claude-sync
または、リポジトリをクローンしてローカルで使用：
git clone https://github.com/alessiobravi/claude-sync.git
cd claude-sync
npm install
npm link
設定
claude-sync.yaml ファイルを作成して設定します：
storage:
provider: "google_drive" # または "dropbox", "onedrive", "webdav"
# WebDAVの場合:
# provider: "webdav"
# url: "https://your-server.com/remote.php/dav/files/username/"
# username: "your-username"
# password: "your-password"
auth:
token: "your-auth-token"
sync:
interval: 3600 # 秒単位（オプション、定期的な同期用）
directories:
- ".claude"
- "projects"
使用方法
初期セットアップ
初回使用時に認証情報を設定：
claude-sync init
手動同期
設定されたプロジェクトをクラウドストレージと同期：
claude-sync sync
スナップショットの作成
現在のプロジェクト状態のスナップショットを作成：
claude-sync snapshot create my-snapshot
スナップショットの復元
以前のスナップショットから復元：
claude-sync snapshot restore my-snapshot
スナップショット一覧
利用可能なスナップショットを表示：
claude-sync snapshot list
環境変数
CLAUDE_SYNC_TOKEN: 認証トークン（設定ファイルよりも優先）CLAUDE_SYNC_CONFIG: 設定ファイルへのパス（デフォルト:./claude-sync.yaml）
トラブルシューティング
- 認証エラーが発生した場合、
claude-sync initを再実行してトークンを更新。 - WebDAV接続に問題がある場合、URLが正しいこと、およびサーバーがアクセス可能であることを確認。
- スナップショットの復元に失敗した場合、バックアップファイルが破損していないか確認。
ライセンス
MIT