Claude Code 環境一括同期ツール

GitHub リポジトリからすべての設定をローカルの Claude Code 環境に一括同期します。

機能概要

本 skill は一括同期機能を提供し、設定を GitHub リポジトリからローカルに同期します。

• sync_env.py - すべての設定をローカルに同期

同期内容

GitHub リポジトリ構造

your-claude-env/              (GitHub リポジトリ)
├── env-setup.skill/          (または任意の名前、skills/ の下に配置)
│   ├── SKILL.md
│   ├── scripts/
│   │   ├── sync_env.py       (メイン同期スクリプト)
│   │   ├── backup_env.py     (バックアップスクリプト、オプション)
│   │   └── restore_env.py    (復元スクリプト、オプション)
│   └── config/               (設定テンプレートディレクトリ)
│       ├── output-styles/    (会話スタイル設定)
│       │   ├── laowang-engineer.md
│   │   ├── engineer-professional.md
│   │   └── ...
│       ├── CLAUDE.md         (グローバルプロンプト)
│       └── mcp_config.json   (MCP サーバー設定)

使用方法

一、GitHub リポジトリの初期化

メインデバイスでリポジトリを作成します。

# 1. プロジェクトディレクトリを作成
mkdir claude-env-sync
cd claude-env-sync

# 2. env-setup skill をコピー
cp -r ~/.claude/skills/env-setup ./

# 3. 現在の設定を config/ にコピー
cp -r ~/.claude/output-styles/* env-setup/config/output-styles/
cp ~/.claude/CLAUDE.md env-setup/config/

# 4. MCP 設定を抽出
# (手動で作成またはスクリプトを使用して抽出)
# mcp_config.json の形式は下記を参照

# 5. GitHub にプッシュ
git init
git add .
git commit -m "Initial Claude env config"
git remote add origin https://github.com/yourusername/claude-env-sync.git
git push -u origin main

二、新しいデバイスで同期

# 1. リポジトリを skills ディレクトリにクローン
cd ~/.claude/skills
git clone https://github.com/yourusername/claude-env-sync.git

# 2. 同期スクリプトを実行
python ~/.claude/skills/claude-env-sync/env-setup/scripts/sync_env.py

# 3. Claude Code を再起動

三、コマンドラインオプション

# 基本的な使い方（すべての設定を同期）
python scripts/sync_env.py

# 既存のファイルを強制的に上書き
python scripts/sync_env.py --force

# 特定のコンポーネントのみを同期
python scripts/sync_env.py --components output_styles mcp_config

# Claude ディレクトリを指定
python scripts/sync_env.py --claude-dir "/path/to/.claude"

同期オプション：

• output_styles - 会話スタイル設定を同期
• claude_md - グローバル CLAUDE.md を同期
• mcp_config - MCP サーバー設定を同期

構成ファイル形式

mcp_config.json

{
  "mcpServers": {
    "chrome-devtools": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "chrome-devtools-mcp@latest"]
    },
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

注意： センシティブな情報（API keys）は、環境変数を使用するか、リポジトリにコミットしないことをお勧めします。

使用シーン

シーン 1：複数デバイス環境の統一

複数のコンピューターで一貫した Claude Code 設定を維持します。

# メインデバイス：設定を更新後
git add .
git commit -m "Update config"
git push

# 他のデバイス：プルして同期
git pull
python scripts/sync_env.py

シーン 2：チームでの設定共有

チームメンバーで統一された output-styles と MCP 設定を共有します。

1. チーム GitHub リポジトリを作成
2. 各メンバーが ~/.claude/skills/ にクローン
3. 定期的に sync_env.py を実行して更新を同期

シーン 3：素早い PC の乗り換え

# 新しい PC で
git clone https://github.com/yourusername/claude-env-sync.git ~/.claude/skills/
python ~/.claude/skills/claude-env-sync/env-setup/scripts/sync_env.py --force

シーン 4：設定のバージョン管理

# 以前の設定にロールバック
git log --oneline
git checkout <commit-hash>
python scripts/sync_env.py --force

ワークフロー

日常の更新フロー

1. ローカル設定を変更
   ↓
2. config/ ディレクトリを更新
   ↓
3. git add . && git commit -m "Update xxx"
   ↓
4. git push
   ↓
5. 他のデバイス: git pull && python scripts/sync_env.py

注意事項

MCP 設定の同期

• MCP 設定はマージモードを採用し、既存の他の MCP サーバーを上書きしません。
• 同じサーバーの設定は更新されます。
• センシティブな情報（API tokens）について：
  • 環境変数を使用する
  • または mcp_config.json でプレースホルダーを使用し、ローカルで手動で入力する

ファイルの上書き動作

• --force を使用しない場合：既存のファイルはスキップされます（MCP 設定を除く、常にマージされます）。
• --force を使用する場合：既存のファイルは上書きされます。

Claude Code の再起動

同期が完了したら、Claude Code を再起動して有効にする必要があります。

• Output styles が再読み込みされます。
• MCP サーバーが再接続されます。
• CLAUDE.md が更新されます。

クロスプラットフォーム互換性

• スクリプトは Windows/macOS/Linux のパスの違いを自動的に処理します。
• 設定ファイルは UTF-8 エンコードを使用します。

トラブルシューティング

同期失敗

問題： "config/output-styles not found"

• 解決： リポジトリ構造が正しいこと、config/ ディレクトリが存在することを確認してください。

問題： ".claude.json not found"

• 解決： Claude Code がインストールされ、一度実行されたことを確認してください。

問題： MCP 設定が有効にならない

• 解決： mcp_config.json の形式が正しいか確認し、Claude Code を再起動してください。

Git 関連

問題： プッシュに失敗

• 解決： GitHub リポジトリの権限、ネットワーク接続を確認してください。

高度な使い方

ブランチ管理

# デバイス固有の設定ブランチを作成
git checkout -b my-custom-config

# メイン設定に戻る
git checkout main

部分同期

# スタイルのみを同期し、他の設定は保持
python scripts/sync_env.py --components output_styles

# MCP のみを同期し、スタイルは変更しない
python scripts/sync_env.py --components mcp_config

自動同期（オプション）

定期的な同期スクリプトを作成します。

# sync.sh
#!/bin/bash
cd ~/.claude/skills/claude-env-sync
git pull
python env-setup/scripts/sync_env.py

cron またはタスクスケジューラに追加して定期的に実行します。