Aider 安裝與 OmniProxy 設定

Aider 是一款在終端機中協助修改程式碼的工具。它會為整個程式碼儲存庫整理一份地圖，協助模型理解較大型的專案；Git 則是記錄程式碼變更的版本控制工具，可用來檢視差異及復原修改。把工作交給 Aider 後，它會逐步處理並撰寫提交說明。如果不滿意這次修改，可以使用 /undo 撤銷。

安裝前準備

常用的安裝方式有兩種：

電腦上已有 Python 3.8 至 3.13：先安裝 aider-install。Python 是執行 Aider 所需的程式環境。
沒有合適的 Python：使用單行安裝指令，並在需要時一併準備 Python 3.12。

Mac 與 Linux

install.sh

curl 後用 sh 執行
需要時會安裝 Python
沒有 curl 可用 wget

Windows

install.ps1

用 PowerShell 執行
安裝後重新開啟終端機
環境變數使用 setx

已有 Python

aider-install

先用 pip 安裝這個套件
再執行 aider-install
它會自行建立環境

單行安裝會在需要時準備 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。

單行安裝

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"

這些單行指令以 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 使用單行安裝指令安裝至 Aider v0.86.2。安裝過程中若顯示快取與目標不在同一個磁碟，並改為複製檔案，安裝仍會完成。

安裝完成後，請進入專案目錄。相容介面是指使用 OpenAI 格式與其他模型服務通訊的介面，啟動格式如下：

aider --model openai/<model-name>

其中 <model-name> 必須替換成下一節從 OmniProxy 複製的完整模型 ID；模型 ID 是用來準確指定模型的名稱。

從 OmniProxy 取得連線參數

需要設定以下兩個環境變數。環境變數可以理解為終端機程式所讀取的一組連線設定：

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，供應商文件中的兩個參考 ID 為 gemini-3.8-flash 和 grok-4.7。如果目前的清單中沒有這些名稱，請勿直接照抄，應使用清單中實際存在的完整 ID。

位址

OPENAI_API_BASE

指向 OmniProxy
填寫至 /v1
不要寫入儲存庫

金鑰

OPENAI_API_KEY

使用閘道提供給你的金鑰
Windows 修改後要重新開啟
供應商金鑰保留在閘道

啟動

openai/模型

cd 到專案目錄
模型名稱加上 openai/
名稱以閘道清單為準

兩個環境變數加上帶有 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 "這個檔案的第一行是什麼？不要修改檔案。" --no-auto-commits

--message 用來直接交付一項工作給 Aider，--no-auto-commits 表示這次執行期間不要自動建立 Git 提交。

2026-10-09，已使用 Aider v0.86.2 讀出受追蹤檔案的第一行。如果檔案尚未受 Git 追蹤，Aider 會回答無法看到內容，但這不代表介面位址有誤。完成提問後，再到 OmniProxy 的呼叫記錄中核對請求來源及模型 ID。

啟動

aider 能啟動

找得到命令
環境變數已生效
位於專案目錄

任務

它查看了檔案

詢問一個特定檔案
查看它的說明
不熟悉的模型會顯示警告

記錄

閘道看得到

來源是 Aider
模型 ID 一致
金鑰沒有進入頁面

確認環境變數已生效、系統能找到指令，再完成一次實際提問。

常見錯誤

找不到 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 模型頁面中查看。

用你自己的 OmniProxy 設定取代每個佔位符。不要發布真實金鑰。

儲存成功或 HTTP 200 不單獨代表完整 Agent 相容性。請在 OmniProxy 呼叫記錄中確認來源和模型。

官方來源 · Aider ↗