背景

Claude Codeは現在の作業ディレクトリ（Gitリポジトリ）内のファイルしか参照できない。別のローカルリポジトリにあるコードを参照させたい場合シンボリックリンクを使うと便利。

メリット

• 元のリポジトリで更新すれば自動的に反映される（同期不要）
• .gitignoreに追加すればコミットされない
• Claude Codeからは普通のフォルダとして見える

手順

1. referenceフォルダを作成

mkdir C:\Users\numbe\Git_repo\mdx-playground\reference

2. シンボリックリンクを作成

PowerShellではmklinkが直接使えないので、cmd /c経由で実行する：

cmd /c mklink /D "C:\Users\numbe\Git_repo\mdx-playground\reference\chat-story" "C:\Users\numbe\Git_repo\chat-story"

または、PowerShellネイティブのコマンド：

New-Item -ItemType SymbolicLink -Path "reference\chat-story" -Target "C:\Users\numbe\Git_repo\chat-story"

注意: 管理者権限が必要な場合がある。

3. .gitignoreに追加

echo reference/ >> .gitignore

確認

ls reference\chat-story

リンク先のファイル一覧が表示されれば成功。

結果

これでreference/chat-story/配下のファイルをClaude Codeが参照できるようになる。

mdx-playground/
├── apps/
├── reference/           # .gitignoreで除外
│   └── chat-story/     # シンボリックリンク → C:\Users\numbe\Git_repo\chat-story
└── ...

他の方法との比較

ローカル参照目的ならシンボリックリンクが一番シンプル。