課題: 非GitワークスペースのCLAUDE.mdはバージョン管理が効かない#

自分の作業環境には、Git管理していないワークスペースが2つある。

1
~/blog_workspace/       ← ブログ執筆用（非Git）
2
│ ├── yurudeep/         ← Astro製ブログのGitリポジトリ
3
│ └── gdrive/           ← Google Driveへのシンボリックリンク
4
│
5
~/kaggle_workspace/     ← Kaggle実験管理用（非Git）
6
  └── gdrive/           ← Google Drive上の実験ディレクトリ

blog_workspace/ はブログのGitリポジトリ yurudeep/ とGoogle Driveのネタ帳を束ねるワークスペースで、kaggle_workspace/ はKaggleコンペの実験管理をGoogle Drive上でやるためのワークスペースだ。

どちらもワークスペース自体はGit管理していない。中にGitリポジトリが入っていたり、Google Driveへのリンクがあったりするだけで、ワークスペースのルートに .git はない。

つまり、ワークスペースルートに置いた CLAUDE.md に対して git log で変更履歴を追うことができない。「さっきの修正で何を消したっけ」が確認できない。マシンが壊れたらCLAUDE.mdも消える。

解決策: dotfilesリポジトリ + シンボリックリンク#

考え方は単純で、CLAUDE.md の実体を dotfiles リポジトリに置き、各ワークスペースにはシンボリックリンクを張る。

1
~/dotfiles/                        ← Gitリポジトリ
2
├── claude/
3
│   └── CLAUDE.md                  ← グローバル設定の実体
4
├── blog_workspace/
5
│   └── CLAUDE.md                  ← ブログ用の実体
6
└── kaggle_workspace/
7
    └── CLAUDE.md                  ← Kaggle用の実体

1
ln -s ~/dotfiles/claude/CLAUDE.md           ~/.claude/CLAUDE.md
2
ln -s ~/dotfiles/blog_workspace/CLAUDE.md   ~/blog_workspace/CLAUDE.md
3
ln -s ~/dotfiles/kaggle_workspace/CLAUDE.md ~/kaggle_workspace/CLAUDE.md

1
$ ls -la ~/blog_workspace/CLAUDE.md
2
lrwxr-xr-x  1 user  staff  44  4 13 13:17 CLAUDE.md -> /Users/user/dotfiles/blog_workspace/CLAUDE.md
3

4
$ ls -la ~/.claude/CLAUDE.md
5
lrwxr-xr-x  1 user  staff  36  4  6 23:09 CLAUDE.md -> /Users/user/dotfiles/claude/CLAUDE.md

3つのCLAUDE.mdの役割分担#

1
# Global Claude Instructions

1
# Blog Workspace — Claude Instructions
2

3
## 概要
4
このワークスペースは「ゆるディープ」ブログの更新作業用ディレクトリ。
5

6
## リポジトリ構成
7
yurudeep/
8
├── src/content/posts/    # 記事ファイル
9
├── public/blogimg/       # 記事用画像
10
...
11

12
## 記事のフォーマット
13
（frontmatterのテンプレート）
14

15
## カテゴリ一覧
16
（7カテゴリの説明）
17

18
## Google Driveネタ管理
19
（gdrive/ の使い方）
20

21
## 注意事項
22
（dist/ は触らない、等）

1
# kaggle_workspace: AI実験プロジェクト構成
2

3
## ディレクトリ構成
4
gdrive/kaggle_experiments/
5
└── {competition-name}/
6
    ├── research/           # コンペ調査資料
7
    ├── EXP/                # 実験ディレクトリ
8
    │   ├── EXP_SUMMARY.md  # 実験履歴の一元管理
9
    │   └── EXP000/         # 各実験
10
    └── data/
11

12
## 実験管理システム（EXP + child-exp）
13
（大きな実験 vs 小さな実験の判断基準）
14

15
## EXP_SUMMARY.md の運用ルール
16
（LBスコア報告時の更新手順）
17

18
## 開発ワークフロー
19
（ローカル / Colab / Kaggle Notebooks の使い分け）

なぜ .claude/rules/ はdotfilesに入れないのか#

CLAUDE.md はdotfilesで管理しているが、.claude/rules/ 配下のルールファイルはワークスペースのローカルに直置きしている。

1
~/blog_workspace/
2
├── CLAUDE.md                    ← dotfilesへのシンボリックリンク
3
└── .claude/
4
    ├── rules/
5
    │   └── reference.md         ← ローカルに直置き
6
    └── settings.local.json      ← ローカルに直置き

理由は2つ。

1. rules はワークスペース固有度が高い

.claude/rules/reference.md はブログの引用スタイルを定義したファイルで、Kaggleワークスペースには関係がない。ワークスペースをまたいで共有する意味がないものはdotfilesに入れても管理が煩雑になるだけだ。

2. settings.local.json は環境依存

.claude/settings.local.json にはパーミッション設定（許可したコマンドのリスト等）が入っている。これはClaude Codeを使っていると自動的に追記されるファイルで、dotfilesでバージョン管理する性質のものではない。

方針: CLAUDE.md だけを dotfiles に寄せ、それ以外はローカルに置く。

CLAUDE.md は「自分で書いて、自分で管理する」ファイルだからdotfilesと相性がいい。一方、.claude/ 配下のその他のファイルは自動生成されたり環境依存だったりするので、dotfilesに入れると差分ノイズが増える。

セットアップ手順#

新しいマシンで同じ環境を再現するときの手順。

1
cd ~
2
git clone git@github.com:username/dotfiles.git

1
# グローバル設定
2
ln -s ~/dotfiles/claude/CLAUDE.md ~/.claude/CLAUDE.md
3

4
# ブログ用ワークスペース
5
mkdir -p ~/blog_workspace
6
ln -s ~/dotfiles/blog_workspace/CLAUDE.md ~/blog_workspace/CLAUDE.md
7

8
# Kaggle用ワークスペース
9
mkdir -p ~/kaggle_workspace
10
ln -s ~/dotfiles/kaggle_workspace/CLAUDE.md ~/kaggle_workspace/CLAUDE.md

1
# ブログ用の引用スタイルルール
2
mkdir -p ~/blog_workspace/.claude/rules
3
# reference.md を手動で作成

CLAUDE.mdの更新フロー#

日常的な更新はこうなる。

1
# ブログ用CLAUDE.mdを編集（シンボリックリンク経由で普通に編集）
2
vim ~/blog_workspace/CLAUDE.md
3

4
# 変更をdotfilesにコミット
5
cd ~/dotfiles
6
git add blog_workspace/CLAUDE.md
7
git commit -m "Update CLAUDE.md for blog workspace"
8
git push

シンボリックリンク経由で編集しても、実体は ~/dotfiles/ 側にあるので git diff でちゃんと差分が見える。Claude Code の中からCLAUDE.mdを参照している最中でも、リンク先のファイルを直接編集すれば即座に反映される。

メリットとデメリット#

まとめ#

非Gitワークスペースが複数ある環境では、CLAUDE.md のバージョン管理が課題になる。dotfiles リポジトリにCLAUDE.mdの実体を集約し、シンボリックリンクで配置するのがシンプルで実用的な解決策だった。

ポイントは CLAUDE.md だけを dotfiles に入れる こと。.claude/rules/ や settings.local.json はワークスペースのローカルに置いた方が管理が楽だ。

Gitリポジトリで開発している人にはこの仕組みは不要だ（CLAUDE.md をリポジトリに直接コミットすればいい）。非Gitワークスペースを使っている人で、CLAUDE.md の管理に困っている人の参考になれば。

参考文献#

1. Anthropic公式ドキュメント — Memory https://docs.anthropic.com/en/docs/claude-code/memory