AIによるコード生成が当たり前になった今、エンジニアが次に求めるのは「自分のコードベースをすべて把握した上での提案」です。VS Code拡張の Roo Code(旧Cline) は、プロジェクト全体をスキャンして記憶する「セマンティック検索(RAG)」機能を備えています。
今回は、プライバシーとパフォーマンスを両立させるため、M4 Max Mac Studioのパワーをフル活用し、「すべてをローカル完結させる」 環境構築の全記録をまとめました。
今回の構成とポイント
巷の解説記事はDockerを使うものが多いですが、今回はインフラエンジニアらしく、Macネイティブバイナリとlaunchdを駆使して「軽量・常駐・爆速」を目指します。
脳 (LLM): LM Studio (qwen2.5-coder:32b)
翻訳機 (Embedding): LM Studio (nomic-embed-text-v2-moe)
本棚 (Vector DB): Qdrant (Macバイナリ版)
常駐化: macOS launchd
1. 意外な落とし穴:VS Codeのプロキシ設定
構築を始める前に、一番ハマりやすいポイントを潰しておきます。VS Codeはシステムのプロキシ設定を拾ってしまい、127.0.0.1 への通信すら外へ投げようとすることがあります。
settings.json に以下を追記し、VS Codeを完全に再起動(Cmd+Q)しておきましょう。
JSON
2. Qdrantの導入と常駐化(Docker不要)
Roo Codeが「コードの記憶」を保存するには、ベクトルデータベースの Qdrant が必須です。Dockerを使わずに導入する手順は以下の通り。
バイナリの設置
Bashlaunchdによる自動起動設定
毎回手動で起動するのはスマートではありません。Macの起動時にバックグラウンドで動き、プロセスが落ちても自動復旧するように設定します。
Bashヘルスチェック
Bash
3. LM Studio側の準備
対話用のモデルだけでなく、Embedding用のモデルもロードしておきます。
4. Roo Codeの設定(統合)
VS CodeのRoo Code設定画面(インデックス作成)で以下を入力します。
エンベッダープロバイダー: OpenAI互換
ベースURL: http://127.0.0.1:1234/v1 (末尾の /v1 を忘れずに)
モデル: text-embedding-nomic-embed-text-v2-moe
モデルディメンション: 768
Qdrant URL: http://127.0.0.1:6333
5. 運用とリソース
M4 Max Mac Studio(36GB RAM)環境において、この構成でのリソース消費は驚くほど低いです。
まとめ
1992年からUnixを触り、インフラを見続けてきた人間にとっても、手元のマシンでこれほど高度な検索・推論基盤が完結するのは感慨深いものがあります。
一度デーモン化してしまえば、あとはAIがあなたの過去のコード資産をすべて把握した状態で、最高の相棒として機能してくれます。Dockerを使わずに構築したいMacユーザーの方は、ぜひ試してみてください。