Aider × Gemma 4 ローカル構築ガイド 2026：無料で使える最強 OSS AI ペアプログラミング環境
2026 年の AI コーディングツールといえば、Codex CLI、Cursor、Claude Code の名前を耳にしたことがあるかもしれません。いずれも優秀ですが、ソースコードを外部のサーバーに送信しているという点は共通しています。「完全 OSS・ローカル動作・Git 自動コミット対応」という条件で選ぶなら、現時点で最も成熟しているのは Aider です。
ただし Aider もデフォルト設定では GPT-4 や Claude を呼び出すため、毎月の API 課金は避けられません。そこで本記事では、Gemma 4 を Ollama 経由でローカルに立てて Aider に接続する方法を紹介します。料金ゼロ、コード流出ゼロ、ターミナル完結のワークフローです。
空のシェルから始めて、新機能追加・横断リファクタ・失敗テストの修復・ユニットテスト生成という 4 つの実戦シナリオまで、一気に走り切ります。
Aider とは？ Codex CLI・Cursor・Claude Code との違い
Aider は Paul Gauthier 氏が 2023 年から開発している OSS の AI コーディング CLI で、GitHub で 30,000 以上のスターを集めています。コンセプトは AI ペアプログラミング。スニペット生成だけでなく、リポジトリ全体を読み、ファイルを直接編集し、生成したメッセージで Git コミットまで自動化します。
主要ツールとの比較は以下のとおりです。
| 項目 | Aider | Codex CLI | Cursor | Claude Code |
|---|---|---|---|---|
| ライセンス | Apache 2.0（完全 OSS） | 一部 OSS | クローズド | クローズド |
| 複数ファイル編集 | ネイティブ対応 | 単一ファイル中心 | 対応 | 対応 |
| Git 自動コミット | メッセージ生成込みで内蔵 | なし | なし | なし |
| Repo Map | 自動生成 | なし | 部分対応 | 部分対応 |
| ローカルモデル | Ollama / LiteLLM をネイティブ対応 | 環境変数設定 | プラグイン必要 | 非対応 |
| 費用 | モデル費用のみ（ローカル=無料） | API 従量 | $20/月 | API 従量 |
Aider 最大の武器は Repo Map です。tree-sitter を使ってファイル・クラス・関数・依存関係のインデックスを作り、会話ごとに必要な箇所を自動で Gemma 4 へ渡します。モデルは当てずっぽうでコードを書くのではなく、実際にプロジェクトを読んだうえで編集するわけです。
OpenAI 系を選びたい方は Gemma 4 × Codex CLI セットアップ もあわせてご覧ください。
事前準備
以下を確認してください。
- Python 3.9 以上（Aider は Python 製）
- Ollama インストール済み・起動済み（ollama.com）
- Gemma 4 26B または 31B を Ollama で取得済み
- ハードウェア：26B なら最低 16GB メモリ、31B なら 24GB 以上
モデル選びで迷う場合は 2026 年版 ローカル AI モデル選定ガイド を参照してください。
Step 1：Aider をインストール
pip 一発で入ります。
pip install aider-chat確認：
aider --versionMac / Linux で Python 環境が汚れている場合は pipx が無難です。
pipx install aider-chatStep 2：Ollama を起動して Gemma 4 を確認
デーモンを立ち上げます。
ollama serve別ターミナルで一覧を表示：
ollama list以下のような出力が見えれば OK です。
NAME ID SIZE MODIFIED
gemma4:26b-a4b abc123... 15 GB 2 hours ago無ければ pull してください。
ollama pull gemma4:26b-a4bStep 3：Aider をローカル Gemma 4 に接続
Aider は Ollama をネイティブに扱えます。リポジトリに入って起動するだけ。
cd /path/to/your/project
aider --model ollama/gemma4:26b-a4b以上です。Aider が自動的に http://localhost:11434 を見つけ、Gemma 4 にリクエストを流します。
毎回フラグを打つのが面倒なら、プロジェクトルートに .aider.conf.yml を置きましょう。
model: ollama/gemma4:26b-a4bこれ以降は aider だけで Gemma 4 が使われます。
上級者向け設定
リモートマシンや非標準ポートで Ollama を動かす場合：
aider --model ollama/gemma4:26b-a4b --ollama-api-base http://192.168.1.100:11434メインは重いモデル、コミットメッセージは軽量モデルで生成する構成：
aider --model ollama/gemma4:26b-a4b --weak-model ollama/gemma4:e4bStep 4：4 つの実戦シナリオ
シナリオ 1：新機能追加
Flask プロジェクトにユーザー登録エンドポイントを追加します。
> app.py に /register エンドポイントを追加してください。email と password を受け取り、バリデーションを通して SQLite に保存します。Aider の動作：
- Repo Map から現在の構造を把握
app.pyを編集（必要に応じて新規ファイルも作成）- diff を提示して承認待ち
- 承認後、自動で
git commit -m "feat: add /register endpoint with email/password validation"
コピペは一切不要です。
シナリオ 2：ファイル横断リファクタ
> utils.py の DB 処理を db.py に切り出し、import も全て更新してください。Aider の真骨頂です。utils.py の編集、db.py の新規作成、すべての呼び出し元の import 書き換えを 1 回のコミットで完了します。Codex CLI ではこの連動はできません。
シナリオ 3：失敗テストの修復
> test_auth.py の test_login_invalid_password が "AssertionError: 200 != 401" で落ちています。直してください。Aider はテストコードと対象コードを両方読み、ロジックバグを特定し、修正後にテストを再実行して緑になることを確認します。
シナリオ 4：ユニットテスト生成
> db.py の公開関数すべてに pytest のユニットテストを書いてください。Aider が test_db.py を新規作成し、ハッピーパスと境界値を含むテストを自動生成します。
実際のところ Gemma 4 は Aider でどれくらい使えるか
正直なところ、Gemma 4 26B は GPT-4 Turbo や Claude 3.5 には敵いません。ただし 日常開発では十分に戦力になります。
得意：
- 単一ファイルのコード生成・編集
- 2〜3 ファイル規模の軽いリファクタ
- エラーメッセージが明確なバグ修正
- テストコード生成
- コードの説明
苦手：
- 5 ファイル以上に渡るアーキテクチャ改変
- フレームワーク固有の設計慣習（DRF の ViewSet など）
- 超長文コンテキスト（128K 対応だが 32K を超えると品質低下）
おすすめの戦略：日常は Gemma 4 26B（無料・高速）で回し、難題だけ aider --model gpt-4o に切り替える。Git 履歴は互換なので混用しても崩れません。
よくあるトラブル
「Model not found」エラー
Ollama が起動しているか（curl http://localhost:11434/v1/models）、モデル名が ollama list の出力と完全一致しているかを確認してください。Aider では ollama/ プレフィックスが必要です（例：ollama/gemma4:26b-a4b）。
レスポンスが遅い
M1 MacBook で Gemma 4 26B は 20〜40 tok/s 程度。長文生成だと 30〜60 秒かかることもあります。遅すぎる場合：
ollama psで GPU が使われているか確認- より強い量子化版に切り替える
- 軽作業は E4B、重作業のみ 26B に切替
自動コミットを無効化したい
aider --model ollama/gemma4:26b-a4b --no-auto-commitsファイル編集のみ行い、コミットは手動になります。
出力が崩れる・文字化けする
多くはコンテキスト不足です。/drop で不要なファイルを外し、/tokens で消費状況を確認してください。
FAQ
Q：Aider は無料ですか？ A：Aider 本体は Apache 2.0 で完全無料。コストはバックエンドのモデル次第で、ローカル Gemma 4 なら 0 円です。
Q：Cursor とはどう違いますか？ A：Cursor は VS Code ベースの GUI エディタ、Aider は純粋な CLI ツールです。Git 自動コミットと Repo Map は Aider だけの強み。両者は同じリポジトリで併用できます。
Q：Gemma 4 E2B（4B）で使えますか？ A：技術的には可能ですが、コード生成品質が低く実用に耐えません。E4B（8B）を最低ライン、本格運用は 26B を推奨します。
Q：Windows で動きますか？ A：動きます。Python も Ollama も Aider も Windows Terminal / PowerShell で問題なく動作します。
Q：対応言語は？ A：tree-sitter 経由で Python・TypeScript・Go・Rust・Java・C/C++・Ruby など 50 以上の言語に対応します。
Q：Gemma 4 と Qwen 3、Aider ではどちらが有利？ A：2026 年前半時点では Gemma 4 26B の指示追従が安定しています。Qwen 3 27B は diff フォーマットを崩すことがあるという報告が散見されます。詳細は Gemma 4 vs Qwen 3 徹底比較 を参照してください。
Q：リモートサーバーで回せますか？
A：可能です。GPU サーバーで Ollama を動かし、SSH 経由でローカル Aider から --ollama-api-base をサーバー IP に向ければ OK です。
Related Articles
- Gemma 4 × Codex CLI セットアップ — OpenAI 系 CLI との比較
- Gemma 4 vs Qwen 3 徹底比較 — OSS モデル選定の参考に
- 2026 年版 ローカル AI モデル選定ガイド — 全体像を掴んでから選ぼう
Stop reading. Start building.
~/gemma4 $ Get hands-on with the models discussed in this guide. No deployment, no friction, 100% free playground.
Launch Playground />
