Aider 安裝與 OmniProxy 設定
想使用工具協助修改程式碼，但擔心變更難以審核？Aider 可在終端機中逐步處理任務，並透過 Git 記錄差異，讓變更內容易於檢查與還原。
Aider 是一款能協助你在終端機修改程式碼的工具。它會建立整個程式碼庫的對應圖，協助模型理解大型專案。Git 是一種版本控制工具，能記錄程式碼變更，讓你檢查差異並還原至先前的版本。當你指派任務給 Aider 後，它會逐步處理並撰寫提交訊息（commit message）。如果你不滿意變更內容，可以使用 /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
- 它會建立獨立的環境
請確保 OmniProxy 正在執行。安裝完成後，在啟動 Aider 前，請先進入你打算修改的專案目錄。
首次安裝與啟動
如果你已安裝 Python 3.8 至 3.13
請依序執行以下指令：
python -m pip install aider-install
aider-installaider-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，這是一個用於安裝與管理 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 月 9 日，單行安裝指令安裝的是 Aider v0.86.2。安裝過程中，你可能會看到快取與目標位於不同磁碟、檔案將被複製的訊息，安裝仍會順利完成。
安裝完成後，進入專案目錄。相容 API 是一種能以 OpenAI 格式與其他模型服務溝通的介面。請使用此模式啟動 Aider：
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 是 API 端點，必須包含 /v1。OPENAI_API_KEY 是存取 API 所需的金鑰。
在 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 月 9 日，供應商文件中的兩個參考 ID 為 gemini-3.8-flash 與 grok-4.7。如果這些名稱不在目前的清單中，請勿直接複製。請使用清單中實際出現的完整 ID。
位址
OPENAI_API_BASE
- 指向 OmniProxy
- 包含 /v1
- 請勿放入儲存庫中
金鑰
OPENAI_API_KEY
- 使用閘道提供的金鑰
- 變更後請重新開啟 Windows 終端機
- 將供應商金鑰保留在閘道中
啟動
openai/model
- 切換至專案目錄
- 在模型名稱前加上 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 已追蹤的檔案加入上下文（context）。上下文是指模型在目前任務中可讀取的程式碼與資訊。如果目前目錄尚未成為 Git 儲存庫，Aider 會自動建立一個，但 Git 未追蹤的檔案仍無法讀取。請在啟動 Aider 前，使用 git add 加入檔案並提交。
Aider 仍可修改檔案。--no-auto-commits 僅停用自動提交，並不會阻止檔案修改。首次使用 Aider 時，請選擇一個不重要的儲存庫，並在任務完成後執行 git diff 來審核實際變更。
請勿將真實金鑰放入專案檔案或公開頁面。僅將供應商金鑰儲存在 OmniProxy 中。如果閘道未驗證金鑰，你可以將 OPENAI_API_KEY 設定為僅在本地電腦使用的預留字串。
以實際任務驗證
首先，確保 Aider 要讀取的檔案已提交至 Git。接著在專案目錄中執行以下指令。將模型 ID 替換為目前 OmniProxy 清單中的完整 ID：
aider --model openai/gemini-3.8-flash --message "What is the first line of this file? Do not modify the file." --no-auto-commits--message 會直接傳送任務給 Aider，而 --no-auto-commits 則告知 Aider 在此執行期間不要自動建立 Git 提交。
截至 2026 年 10 月 9 日，Aider v0.86.2 已成功讀取已追蹤檔案的第一行。如果檔案未被 Git 追蹤，Aider 會表示無法看到內容。這並不代表 API 端點錯誤。完成查詢後，請檢查 OmniProxy 的請求記錄，驗證請求來源與模型 ID。
啟動
Aider 啟動
- 指令可用
- 環境變數已生效
- 在專案目錄中
任務
它檢查了檔案
- 詢問特定檔案
- 審核其解釋
- 不熟悉的模型可能會觸發警告
記錄
在閘道中可見
- 來源為 Aider
- 模型 ID 相符
- 金鑰未在頁面上輸入
常見錯誤
- 找不到
aider：請先重新開啟終端機。如果是直接透過 pip 安裝，請嘗試python -m aider。 - 變更變數後 Windows 仍連線至舊端點：執行
setx後必須重新開啟終端機。只有新視窗才會讀取更新後的變數。 - 模型名稱未以
openai/開頭：相容 API 要求格式為openai/<model-name>。 - 出現不熟悉模型的警告：這是正常警告，不代表連線失敗。請檢查 OmniProxy 是否收到請求。
- 模型 ID 無效：請再次從目前的 OmniProxy 清單中複製完整 ID。保留
openai/前綴以及 ID 中已有的任何斜線。 - Aider 表示沒有檔案內容：確保檔案已由 Git 追蹤。空儲存庫中的檔案或未追蹤的檔案不會加入上下文。
官方參考
關於安裝步驟，請參閱 Aider 安裝。關於環境變數與模型前綴，請參閱 OpenAI 相容 API。範例模型 ID 可在 Gemini 模型清單 與 xAI 模型頁面 中找到。
將所有佔位符替換為您自己的 OmniProxy 配置值。切勿發布真實金鑰。
保存的結果或 HTTP 200 單獨存在並不證明完整的 Agent 相容性。請在 OmniProxy 的呼叫記錄中檢查來源與模型。