GitHub設定同期
Claude Codeの共通設定のみをGitHubリポジトリと双方向同期します。
同期対象(共通設定)
| ローカル | リポジトリ | 備考 |
|---|---|---|
~/.claude/skills/ | claude/skills/ | ナレッジベース含む |
~/.claude/CLAUDE.md | claude/CLAUDE.md | |
~/.claude.json の mcpServers | .claude.json | 機密情報はマスク |
mcpServers同期の注意事項
mcpServersセクションは以下のルールで同期:
- •Push時: 環境変数の値(トークン等)を
"<MASKED>"に置換してエクスポート - •Pull時: リポジトリのJSONを参考に手動で設定(機密情報は各自で設定)
機密情報のマスク対象
以下のキーの値は自動的にマスクされる:
- •
GITHUB_PERSONAL_ACCESS_TOKEN - •
*_API_KEY - •
*_TOKEN - •
*_SECRET
同期対象外(PC固有設定)
以下はPC固有のため同期しない:
- •
~/.claude/settings.json- 権限、hooks、statusLine等(PC固有パスやOS依存) - •
~/.claude/hooks/- フックスクリプト - •
~/.claude/projects/- プロジェクト固有設定 - •
~/.claude/plugins/- プラグイン設定 - •
~/.claude/rules/- 廃止済み(skillsに移行) - •その他キャッシュ、履歴、デバッグログ等
リポジトリパス
code
~/git/minorun365/my-claude-code-settings/
実行手順
Push(ローカル → リポジトリ)
- •
差分確認
bashdiff -rq ~/.claude/skills/ ~/git/minorun365/my-claude-code-settings/claude/skills/ diff ~/.claude/CLAUDE.md ~/git/minorun365/my-claude-code-settings/claude/CLAUDE.md
- •
同期実行
bashrsync -av --delete ~/.claude/skills/ ~/git/minorun365/my-claude-code-settings/claude/skills/ cp ~/.claude/CLAUDE.md ~/git/minorun365/my-claude-code-settings/claude/
- •
mcpServers同期(機密情報をマスクしてエクスポート)
bash# jqで mcpServers を抽出し、機密情報をマスク jq '{mcpServers: .mcpServers | walk( if type == "object" then with_entries( if (.key | test("TOKEN|KEY|SECRET"; "i")) and (.value | type == "string") then .value = "<MASKED>" else . end ) else . end )}' ~/.claude.json > ~/git/minorun365/my-claude-code-settings/.claude.json - •
コミット・プッシュ(ユーザー確認後)
bashcd ~/git/minorun365/my-claude-code-settings git add -A git status git commit -m "設定同期" git push
Pull(リポジトリ → ローカル)
- •
リポジトリを最新化
bashcd ~/git/minorun365/my-claude-code-settings git pull
- •
差分確認
bashdiff -rq ~/git/minorun365/my-claude-code-settings/claude/skills/ ~/.claude/skills/ diff ~/git/minorun365/my-claude-code-settings/claude/CLAUDE.md ~/.claude/CLAUDE.md
- •
同期実行(ユーザー確認後)
bashrsync -av --delete ~/git/minorun365/my-claude-code-settings/claude/skills/ ~/.claude/skills/ cp ~/git/minorun365/my-claude-code-settings/claude/CLAUDE.md ~/.claude/
- •
mcpServers適用(手動)
- •
.claude.jsonを参照して~/.claude.jsonのmcpServersを更新 - •
<MASKED>部分は各自の認証情報に置き換える
- •
注意事項
- •機密情報(APIキー等)が含まれていないか確認
- •新しいPCでPullする前に、既存のローカル設定をバックアップ推奨
- •プッシュ前に必ずユーザーに確認を取る