症状：Ollamaではモデルが動くのに、VS Codeから呼び出せない。あるいは、Macの資源でどのモデルを選べばよいか判断できない。
最速の解決策：macOSと空き容量を確認し、Ollamaで小さく試せるモデルを起動してから、対応するVS Code拡張に接続してください。快適さはモデルとの互換性とMacの資源に左右されるため、まず短いコード生成で確かめます。
Macでローカルモデルを使ってコードを書きたい開発者、OllamaをVS Codeにつなぐのが初めての方に向けた手順です。
モデル選びに迷っている場合や、接続失敗の原因を切り分けたい場合にも役立ちます。
ローカルAIプログラミング環境を作る前に、Macで何を確認する？
ローカル推論では、モデルの処理を手元のMacで実行します。オンラインAIサービスと異なり、モデルのファイルを保存する空き容量や、処理に使える端末資源を自分で確認する必要があります。インターネット接続なしで使えるかどうかも、モデルの取得や拡張機能の仕様によって異なるため、導入後に実際の動作を確かめてください。
まず、次の条件を見ます。
- macOSのバージョンがOllamaの現在の案内に合っているか。
- モデルを保存できる空き容量があるか。取得するモデルのサイズは、Qwen2.5-Coderのモデルタグ一覧で選ぶタグごとに確認します。
- 同時に開く開発ツールやプロジェクトを含め、Macのメモリや処理能力に無理がないか。
- 使いたいVS Code拡張がOllama接続に対応し、必要な設定を公開しているか。
モデルが起動することと、日常の開発で待ち時間や応答品質に納得できることは別です。最初は小さなコード生成で確認し、実際のプロジェクトに使うかはその後に判断してください。
ローカル実行の利点は、モデルの処理を手元で行えることです。一方、モデルの保存領域や更新、端末負荷の管理も必要になります。常時オンラインで使うサービスのように、別の計算資源へ自動で切り替わるとは限りません。
Ollamaをインストールしてモデルを起動する
はじめにOllamaを導入する
Macでのインストールは、OllamaのmacOSダウンロード案内に掲載されている現在の手順に従います。配布物や対応条件は変わる可能性があるため、古い記事の画面を頼りにせず、ダウンロード時に公式案内を確認してください。
インストール後、ターミナルを開いて次のコマンドを実行します。
ollama --version
バージョン情報が表示されれば、コマンドを実行できる状態です。ここでエラーになる場合は、インストールが完了しているか、ターミナルを開き直しても同じかを確認します。OllamaのmacOS版が利用できる条件は、公式のダウンロード案内で照合してください。
モデルを取得して応答を確かめる
最初の動作確認には、用途に合うモデルを選びます。コード補助を試す場合は、モデル名や利用可能なタグを公式のQwen2.5-Coder一覧で確認し、端末の資源に見合うものを選んでください。モデル名だけで判断せず、タグごとの容量も確認してから取得します。
ターミナルで次を実行します。
ollama run qwen2.5-coder
モデルが未取得なら取得処理が始まり、その後に入力を受け付ける状態になります。実際のタグ指定や起動方法は、Ollamaの利用ガイドとモデルの公式一覧を参照してください。短いコード片の説明を入力し、返答が得られるかを確認します。
Ollama上で応答が返っても、VS Codeから利用できるとは限りません。次は、エディター側の拡張機能と接続設定を合わせます。
VS CodeからOllamaのモデルを呼び出す
ここでは、Ollamaをモデル提供元として設定できる拡張機能の例としてContinueを使います。拡張機能の導入方法は、Continueの公式インストール手順に従ってください。拡張の設定画面や構成方法は更新されることがあるため、表示されている公式手順を優先します。
設定では、次の項目を照合します。
- モデル提供元がOllamaになっていること。
- モデル名がOllamaで起動したものと一致していること。
- 接続先が現在のOllamaサービスを指していること。
- 拡張機能に必要なアクセス許可が設定されていること。
Continueのモデル設定例と接続項目は、Ollamaプロバイダーの設定説明で確認できます。拡張機能ごとに設定項目や接続方法は異なるため、別の拡張を選んだ場合は同じ設定をそのまま流用しないでください。
接続先を指定する場合は、Ollamaがローカルで待ち受けているアドレスと、拡張側の設定が一致している必要があります。既定のAPI接続先を含むサービスの動作は、Ollamaの公式FAQで確認できます。
VS Codeのワークスペースを信頼するかどうかは、接続設定とは別の判断です。信頼されていないフォルダーでは拡張機能の動作が制限される場合があるため、内容を確認したうえで設定してください。VS Codeのワークスペース信頼に関する説明も参照できます。
生成テストで接続を確かめ、問題を切り分ける
設定後は、読み取りだけで済む短い依頼を入力します。たとえば「この関数が受け取る値と返す値を説明してください」と頼み、対象の関数だけを渡します。返答が表示され、内容がコードと合っているか確認できれば、Mac、Ollama、モデル、VS Code拡張の基本的な接続を検証できます。
うまくいかない場合は、次の順で原因を絞ります。
- Ollama自体を確認する： ターミナルでモデルを起動し、直接応答が返るか試します。ここで失敗するなら、VS Codeではなくインストール、サービス状態、モデル取得を先に調べます。
- モデル名とタグを照合する： 起動したモデルと拡張機能に登録したモデル名が一致しているか確認します。モデルが見つからない場合は、公式一覧にあるタグと取得状態を見直します。
- 接続設定を確認する： 拡張機能の提供元、接続先、モデル設定を、ContinueのOllama接続手順と照合します。
- 負荷と互換性を分けて考える： 応答が遅い、または処理が止まる場合、モデルの互換性やMacの資源不足が原因の可能性があります。設定不備と決めつけず、別の適合モデルで短い依頼を試します。
- ワークスペースの状態を確認する： フォルダーが信頼されているか、拡張機能に必要な権限があるかを確認します。信頼の設定を変える前に、対象プロジェクトの内容を確認してください。
日常利用に進む前の確認リスト
- [ ] macOSの対応条件とモデルの保存に必要な空き容量を確認した。
- [ ] Ollamaのコマンドを実行でき、モデルから直接応答を得られた。
- [ ] VS Code拡張の公式手順に沿って、Ollamaとモデルを設定した。
- [ ] 短いコード生成または説明を依頼し、返答内容を確認した。
- [ ] 実際の開発作業で負荷や待ち時間を確かめ、利用範囲を決めた。
Macの資源が足りないと分かったら、次に何を選ぶ？
テストで問題が見つかったら、まず原因を分けます。Ollama単体で動かないなら導入やモデルの選択、単体では動くがVS Codeから呼べないなら拡張設定、どちらも動くが作業に耐えないならMacの資源やモデルとの相性が見直しの対象です。モデルを変更しても改善しないときは、手元のMacで継続する必要があるか、開発環境を別に用意するかを検討します。
ローカル実行を続ける場合は、モデルのサイズや用途を見直せます。オンラインサービスは端末のローカル資源に依存しにくい一方、外部への接続やデータの取り扱いを確認する必要があります。遠隔のMac環境も選択肢ですが、手元での実行と同じ操作感やネットワーク条件が得られるとは限りません。物理接続が必要な作業や、外部環境に出せないデータを扱う場合は、移行前に要件を整理してください。
手元の構成でOllamaとVS Codeを試し、資源不足や遠隔開発の必要性が確認できた場合は、Mac miniの利用方法を読み、作業を別環境へ移す条件を整理できます。さらに検討する場合は、日本向けMac miniの案内に掲載された構成や受け渡し条件を確認し、自分の開発要件に合うか判断してください。性能やAI対応を事前に決めつけず、実際に掲載されている情報と必要な作業を照らし合わせて選ぶのが安全です。