Aider のインストールと OmniProxy の設定

Aider は、ターミナル上でコードの修正を支援するツールです。コードベース全体のマップを作成し、モデルが大規模なプロジェクトを理解できるようにします。Git はコードの変更を記録するバージョン管理ツールで、差分の確認や変更の復元に使用できます。Aider にタスクを渡すと、段階的に処理し、コミットメッセージを作成します。変更が気に入らない場合は、/undo で取り消せます。

インストール前の準備

一般的なインストール方法は2つあります。

パソコンに Python 3.8〜3.13 がすでにある場合：まず aider-install をインストールします。Python は Aider の実行に必要な環境です。
適切なバージョンの Python がない場合：1行のインストールコマンドを使用します。必要に応じて Python 3.12 も準備されます。

Mac と Linux

install.sh

curl の後に sh で実行
必要に応じて Python がインストールされる
curl がなければ wget を使用できる

Windows

install.ps1

PowerShell で実行
インストール後にターミナルを再起動
環境変数には setx を使用

Python 導入済み

aider-install

先に pip でこのパッケージをインストール
次に aider-install を実行
専用環境が自動作成される

1行インストールでは、必要に応じて Python 3.12 も準備されます。pip で aider-chat を直接インストールする方法は、比較的安定性に欠けます。

OmniProxy が稼働していることを確認してください。インストール後、修正するプロジェクトのディレクトリに移動してから Aider を起動します。

インストールと初回起動

Python 3.8〜3.13 がすでにある場合

次のコマンドを順番に実行します。

python -m pip install aider-install
aider-install

aider-install は Aider を独立した Python 環境にインストールし、パソコン上のほかの Python プロジェクトと混在しないようにします。必要に応じて、Aider 用の Python 3.12 もインストールされます。

1行でインストールする

Mac と Linux では次を実行します。

curl -LsSf https://aider.chat/install.sh | sh

パソコンに curl がない場合は、代わりに次を使用できます。

wget -qO- https://aider.chat/install.sh | sh

Windows PowerShell では次を実行します。

powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"

これらの1行コマンドは uv を使用します。uv は Python のツールと環境をインストール、管理するためのプログラムです。次のコマンドも使用できます。

uv tool install --force --python python3.12 --with pip aider-chat@latest

このほか、pipx も使用できます。python -m pip install aider-chat で直接インストールする場合、対応する Python のバージョンは 3.9〜3.12 ですが、これは別のインストール方法です。前述の方法を優先してください。システムのパッケージマネージャーにある Aider は依存関係が一致しない場合があるため、優先して使用しないでください。

2026-10-09 に、1行のインストールコマンドで Aider v0.86.2 をインストールしました。インストール中に、キャッシュとインストール先が同じディスク上にないためファイルをコピーするというメッセージが表示されても、インストールは完了します。

インストール後、プロジェクトディレクトリに移動します。互換インターフェースとは、OpenAI 形式を使用してほかのモデルサービスと通信するインターフェースです。次の形式で起動します。

aider --model openai/<model-name>

<model-name> は、次のセクションで OmniProxy からコピーする完全なモデル ID に置き換えてください。モデル ID は、モデルを正確に指定するための名前です。

OmniProxy から接続情報を取得する

次の2つの環境変数を設定する必要があります。環境変数は、ターミナルプログラムが読み取る接続設定の一式と考えることができます。

export OPENAI_API_BASE=https://your-omniproxy-origin.example/v1
export OPENAI_API_KEY=<YOUR_OMNIPROXY_API_KEY>

OPENAI_API_BASE はインターフェースのアドレスで、末尾まで /v1 を含める必要があります。OPENAI_API_KEY はインターフェースへのアクセスに使用するキーです。

Windows では setx を使用して変数を保存します。実行後はターミナルを開き直す必要があります。

setx OPENAI_API_BASE https://your-omniproxy-origin.example/v1
setx OPENAI_API_KEY <YOUR_OMNIPROXY_API_KEY>

モデル名は、OmniProxy の現在の一覧から完全な名前をそのままコピーしてください。モデル ID 内のスラッシュも残します。Aider を起動するときは、完全な ID の先頭にさらに openai/ を付けます。

2026-10-09 時点で、プロバイダーのドキュメントにある比較用の2つの ID は gemini-3.8-flash と grok-4.7 です。現在の一覧にこれらの名前がない場合は、そのままコピーせず、一覧に実際に存在する完全な ID を使用してください。

アドレス

OPENAI_API_BASE

OmniProxy を指定
/v1 まで含める
リポジトリには書き込まない

キー

OPENAI_API_KEY

ゲートウェイから発行されたものを使用
Windows では変更後に再起動が必要
プロバイダーのキーはゲートウェイに保持

起動

openai/モデル

cd でプロジェクトディレクトリに移動
モデル名に openai/ を付ける
名前はゲートウェイの一覧に合わせる

2つの環境変数と、openai/ プレフィックス付きのモデル名を組み合わせるのが、互換インターフェースの指定方法です。

ツールの設定を入力する

ここでは、別途設定ファイルを作成する必要はありません。まずプロジェクトディレクトリに移動して Aider を起動し、モデル ID を OmniProxy の現在の一覧に実際に存在する名前へ置き換えます。

cd /path/to/your/project
aider --model openai/gemini-3.8-flash

別のサンプルモデルに切り替える場合は、次を実行します。

aider --model openai/grok-4.7

Aider が認識していないモデルを使用すると、画面に警告が表示されます。この警告だけではアドレスが間違っていることを意味しません。OmniProxy の呼び出し履歴で、該当するリクエストが記録されているか確認してください。

Aider がコンテキストに含めるのは、Git がすでに追跡しているファイルだけです。コンテキストとは、今回のタスクでモデルが読み取れるコードや情報を指します。現在のディレクトリがまだ Git リポジトリでない場合、Aider がリポジトリを作成しますが、Git に追跡されていないファイルは引き続き読み取れません。先に git add でファイルを追加してコミットしてから、Aider を起動してください。

Aider はファイルを変更する可能性があります。--no-auto-commits は自動コミットを無効にするだけで、ファイルの変更を防ぐものではありません。初めて使用するときは、重要でないリポジトリを選び、タスクの終了後に git diff を実行して実際の変更内容を確認することをおすすめします。

実際のキーをプロジェクトファイルや公開ページに書き込まないでください。プロバイダーのキーは OmniProxy 内だけに保存します。ゲートウェイでキーを検証しない場合、OPENAI_API_KEY にはローカル環境だけで使用する任意のプレースホルダー文字列を設定できます。

実際のタスクで確認する

まず、読み取るファイルが Git にコミットされていることを確認します。その後、プロジェクトディレクトリで次のコマンドを実行してください。モデル ID は、OmniProxy の現在の一覧にある完全な ID に置き換える必要があります。

aider --model openai/gemini-3.8-flash --message "このファイルの1行目は何ですか？ファイルを変更しないでください。" --no-auto-commits

--message は Aider にタスクを直接1件渡すためのオプションです。--no-auto-commits は、今回の実行で Git コミットを自動作成しないことを意味します。

2026-10-09 に、Aider v0.86.2 を使用して、追跡済みファイルの1行目を読み取れることを確認しました。ファイルがまだ Git に追跡されていない場合、Aider は内容を確認できないと回答しますが、これはインターフェースのアドレスが間違っていることを意味しません。質問が完了したら、OmniProxy の呼び出し履歴でリクエスト元とモデル ID を確認してください。

起動

aider が起動する

コマンドが見つかる
環境変数が反映されている
プロジェクトディレクトリにいる

タスク

ファイルを確認した

特定のファイルについて質問する
その説明を確認する
未対応のモデルでは警告が表示される

記録

ゲートウェイで確認できる

送信元は Aider
モデル ID が一致している
キーがページに入力されていない

環境変数が反映され、コマンドが認識されたら、実際の質問を1回実行します。

よくあるエラー

aider が見つからない：まずターミナルを開き直してください。pip で直接インストールした場合は、python -m aider を試せます。
Windows で変数を変更しても古いアドレスに接続される：setx の実行後は、必ずターミナルを開き直してください。更新後の変数は新しいウィンドウで読み込まれます。
モデル名の先頭に openai/ がない：互換インターフェースでは openai/<model-name> の形式で指定する必要があります。
未認識モデルの警告が表示される：これは通常の通知であり、接続失敗を意味するものではありません。続いて、OmniProxy がリクエストを受信したか確認してください。
モデル ID が無効：OmniProxy の現在の一覧から完全な ID をもう一度コピーし、openai/ プレフィックスと ID 内に元からあるスラッシュを残してください。
ファイルの内容がないと言われる：ファイルが Git に追跡されていることを確認してください。空のリポジトリや未追跡のファイルはコンテキストに含まれません。

公式リファレンス

インストール手順については Aider installation を参照してください。環境変数とモデルプレフィックスについては OpenAI compatible APIs を参照してください。例で使用したモデル ID は、Gemini モデル一覧と xAI モデルページで確認できます。

プレースホルダーをすべて独自の設定値に置き換えてください。実際のキーを公開しないでください。

保存された結果や HTTP 200 だけでは完全なエージェント互換性が証明されません。OmniProxy の呼び出し記録でソースとモデルを確認してください。

公式ソース · Aider ↗