Aider

Aider是什麼？

Aider是一種運行在命令列終端中的開源AI配對編程工具。開發人員進入本地的Git專案後，可以以自然語言的方式，要求它新增功能、修改多個檔案、重構代碼、撰寫測試用例、修正錯誤，或是編輯設定和文件。

Aider並不限制使用者必須使用特定的編輯器，而是直接以現有的倉庫、模型API以及Git工作流程作為基礎來運作。因此，它很適合那些喜歡使用終端機、希望自行選擇模型，且重視版本控制與可配置性的開發者。

在現有代碼庫中工作

啟動Aider後，使用者可以將需要編輯的檔案加入會話中，或是提供只讀參考檔案給模型使用。Aider會結合目前的需求、對話歷史、目標檔案以及儲存結構來進行修改，然後再將變更內容寫回本地檔案中。

它並不會無條件將整個大型倉庫傳送給模型。開發者應明確任務目標、受影響的目錄、驗收條件以及不可修改的部分，以減少不必要的Token與錯誤修改。

倉庫地圖Repo Map

Aider會為Git倉庫生成簡化的地圖，其中包含重要的檔案、類別、函數、型別以及呼叫簽名。它會利用Tree-sitter來提取相關符號，再根據檔案之間的依賴關係以及當前工作階段的相關性，選出最重要的內容放入模型上下文中。

倉庫地圖讓模型在未讀取所有實現的情況下，就能了解專案的結構，並判斷還需要查看哪些檔案。預設的地圖規模通常較小，對於超大的單一倉庫，則可以調整Token的預算，或限制目前的子樹範圍。

多檔案代碼修改

Aider支援一次修改多個源檔案、測試、設定和文件，常見任務包括介面遷移、跨層新增欄位、重新命名、錯誤修復以及批量更新。不同的模型會使用適配的編輯格式來產生修補程式。

模型可能生成語法正確但業務錯誤的代碼。大改動應拆成可測試的小步驟，並在每次提交後查看差異、運行測試和檢查依賴。

Code模式

Code模式讓主模型直接分析請求並輸出可應用的程式碼編輯結果，適合目標明確、修改範圍較小，或是模型擅長處理編碼格式的任務。它的互動次數較少，因此速度和成本都更易控制。

如果模型能解釋方案卻經常無法正確輸出補丁，可改用Architect模式，或選擇Aider排行榜中更適合代碼編輯的模型。

Architect模式

Architect模式將解決方案的設計與實際編輯分開：主模型負責推理、規劃並提出修改建議，而編輯模型則將這些方案轉換成具體的代碼。它適用於處理複雜的問題，或是那些不擅長嚴格遵循編碼格式的模型。

雙模型流程可能增加Token和呼叫費用。使用者可以配置主模型、編輯模型、弱模型以及是否自動接受編輯，關鍵項目建議先審閱設計再應用。

Ask與Help模式

Ask模式主要用於詢問代碼及討論方案，不會直接修改檔案；Help模式則用於查詢Aider本身的命令與設定。

開發者可以先理解模組或確認實作方向，再切換到編輯模式。

將探索性問題與實際修改分開，有助於避免在需求不清晰時過早改動代碼。

Git自動提交

Aider與Git深度整合。每次完成檔案修改後，它通常會建立包含說明資訊的提交記錄。

如果目標檔案已有未提交的變更，Aider會先將這些原有的變更單獨提交，以避免將使用者的修改與AI的修改混在一起。

自動提交方便用戶查看歷史記錄及進行回退操作，但預設情況下，自動提交會跳過 pre-commit 驗證步驟。那些必須嚴格執行相關驗證規則的團隊，應啟用 Git 的提交驗證功能，並在 CI 環境中繼續執行完整的檢查流程。

查看差異與撤銷

在對話式中，可以查看最近的修改差異、建立的提交記錄、執行Git命令，或是使用撤銷命令來取消上一次的AI更改。由於這些修改已經被記錄在Git的歷史紀錄中，因此使用者也可以使用熟悉的分支、提交和差異檢視工具來進行審查。

撤銷操作可能會遺失最近的變更，執行前要確認其中沒有混入手動編輯的內容。複雜任務最好先建立獨立分支。

Lint與自動修復

Aider可以在修改後自動運行指定的Lint命令，將錯誤反饋給模型並嘗試修復。它支援針對不同語言配置格式化、靜態檢查和類型檢查工具。

自動修復可能會改變更多檔案，不能僅看命令最終是否通過。仍需檢查規則是否被降低、忽略註解是否被濫用，以及格式化是否影響生成的檔案。

測試執行

使用者可以設定測試指令，讓 Aider 在修改後執行測試，並根據失敗的輸出結果繼續修正。它適用於測試驅動開發、回歸錯誤修正以及小範圍的迭代。

透過現有測試並不代表功能一定正確。當需求缺乏覆蓋時，應先要求補充失敗測試，再實作代碼；

涉及資料庫或外部服務的測試還要隔離真實資料。

支援的模型

Aider可連接OpenAI、Anthropic、Google Gemini、DeepSeek、xAI、Cohere、Groq、OpenRouter、Azure OpenAI、Vertex AI、Amazon Bedrock、GitHub Copilot以及其他OpenAI相容服務。它透過統一的模型適配層來管理大多數呼叫。

不同模型的上下文、推理參數、編輯格式和工具能力差異明顯。能聊天的模型不一定能穩定返回可應用的補丁，應參考Aider代碼編輯排行榜並用真實項目測試。

本地模型與Ollama

Aider支援Ollama、LM Studio以及其他與OpenAI相容的本地介面。如此一來，就能在自己的電腦或伺服器上運行模型，從而減少將代碼傳送到外部雲端的需要。

本地運行並不等於效果和成本都更好。大模型需要足夠的內存或顯存，較弱的模型可能頻繁輸出無法應用的編輯結果，最終需要花費更多人工來修正錯誤。

API密鑰配置

雲端模型需要對應供應商的API金鑰，可透過環境變數、命令參數或設定檔來設定。Aider還支援模型別名、API基礎地址、超時時間、推論強度以及自訂模型元資料。

請勿將真正的金鑰上傳到倉庫中。專案級的設定應僅儲存非敏感的參數，而金鑰則應透過環境變數或金鑰管理工具來處理，並定期更換。

提示緩存與成本控制

對於支援緩存的模型，Aider可緩存系統提示、只讀檔案、倉庫地圖以及可編輯檔案的上下文，以此降低重複輸入的成本並提升速度。緩存保活功能則可透過定期請求來延長緩存的壽命。

保活請求本身也可能產生費用，且流式輸出時部分緩存統計不可見。是否啟用應根據會話長度、供應商規則和真實帳單決定。

圖像與網頁上下文

Aider可以將截圖、設計圖和網頁資料加入對話，用於前端實現、錯誤分析及參考文件。是否支援圖像取決於所選的模型。

網頁可能包含不可信的指令，圖像也可能含有隱私資訊。在加入外部內容之前，必須確認其來源與授權，切勿讓網頁內容凌駕於專案的安全規則之上。

語音編程

語音轉代碼功能讓開發者能以口頭方式表達需求，再由模型來修改代碼，非常適合快速記錄功能構想或方便無障礙地使用。使用者可自行設定輸入裝置、語言及音訊格式。

語音識別可能誤聽變數名、路徑和命令。執行前應檢查轉寫文本，涉及刪除、部署和金鑰的指令尤其需要確認。

在IDE中使用

Aider可以監聽檔案，開發人員可以在常用的IDE或文字編輯器中，透過註解來觸發修改，或者直接在編輯器的終端機中執行它。如此一來，就不用放棄VS Code、JetBrains、Vim或其他現有的工作環境了。

它並非傳統IDE擴充商店中所提供的完整圖形插件體驗，其主要互動方式仍以終端、檔案監聽以及瀏覽器介面為主。

瀏覽器介面

除了終端機之外，Aider還提供瀏覽器GUI模式，使用者可以透過網頁介面來發送需求並查看對話內容。這種方式很適合那些不熟悉指令列輸入，或是需要更直觀的聊天界面的使用者。

瀏覽器介面仍運行在本地Aider進程並調用配置的模型，不會改變API費用和代碼審查責任。

腳本與自動化

Aider可透過命令參數來提交單次訊息、讀取訊息檔案、應用既有的編輯內容，或於腳本中調用，適合用於大量資料的維護、自動產生文件，以及實現受控的程式碼處理流程。

無人值守自動化應使用乾淨分支、最小檔案權限、超時及CI門禁，禁止直接將AI提交推送到受保護的生產分支。

設定檔案

大多數設定都可以儲存在使用者目錄、Git倉庫的根目錄，或是目前所在目錄中的設定檔中，而後載入的檔案會有優先權。設定內容包括模型、編輯格式、倉庫結構、Git相關設定、測試相關設定、Lint相關設定、介面設定以及通知相關設定等。

團隊可以提交不包含金鑰的專案設定與編碼規範，讓成員能夠有統一的作業方式。升級後應檢查已被廢棄的參數和模型名稱。

支援的程式設計語言

Aider透過Tree-sitter與文字編輯機制，支援Python、JavaScript、TypeScript、Java、Go、Rust、C、C++、PHP、Ruby、HTML、CSS等大量語言，亦能修改YAML、JSON、Markdown及其他文字。

語言被識別並不代表模型理解所有框架和建構系統。冷門語言、宏系統和生成代碼需要更多人工上下文和測試。

安裝方式

官方建議使用 aider-install 安裝工具，它是以 uv 為基礎所開發的，且在需要時會單獨安裝 Python 3.12，如此一來就能減少與系統環境之間的衝突。此外，也可以透過 pipx、Docker、GitHub Codespaces 以及其他環境來進行安裝。

pipx方式支援的Aider運行Python版本通常為3.9至3.12。若出現依賴衝突，應優先使用獨立環境，避免污染專案原有的虛擬環境。

Aider價格

Aider軟體本身是免費的，沒有官方的Pro版或團隊訂閱服務，其原始碼可依照Apache 2.0授權條款來使用。使用者所需支付的成本，主要是向OpenAI、Anthropic、Gemini、DeepSeek、OpenRouter等服務供應商支付API調用費用。

本地模型不產生雲API帳單，但需要自備硬件、電力和運維。免費API模型通常有速率、每日額度或穩定性限制，不能視為無限免費。

GitHub與開源許可證

Aider的官方源碼儲存在Aider-AI組織的aider倉庫中，採用Apache License 2.0授權條款，允許使用者進行使用、修改及散布，但必須保留授權條款及相關說明。該專案的版本則透過Git標籤和PyPI來發布。

開源的是Aider用戶端，而非它所連接的Claude、GPT、Gemini或其他模型。模型服務、訓練數據及輸出使用權受各供應商條款約束。

隱私與遙測

Aider可啟用匿名分析，也提供關閉分析的配置。發送給雲模型的代碼、提示和檔案由相應API供應商處理；

使用本地模型可以減少外發，但仍要檢查日誌、代理和向量組件。

應透過忽略檔案來排除金鑰、生產設定及敏感資料，並了解倉庫地圖、只讀檔案和會話歷史會進入模型上下文。

Aider使用教學

完成一次基礎任務

1. 明確要在Aider中完成的代碼任務、倉庫範圍和驗收標準；
2. 連接或導入測試專案，並先備份當前分支；
3. 先使用在現有代碼庫中工作生成計劃，再確認將修改的檔案；
4. 使用倉庫地圖Repo Map執行小範圍改動；
5. 運行測試、靜態檢查和建構，不直接接受未驗證的代碼；
6. 人工檢查權限、金鑰、依賴與異常處理後再合併；

建立可重複使用的專業工作流

1. 選取一個低風險真實專案作為模板；
2. 在現有程式碼庫中進行工作的方式、倉庫地圖 Repo Map，以及多個檔案的程式碼修改順序；
3. 記錄環境、模型、提示和失敗條件；
4. 為寫入、部署和刪除動作設定人工審批；
5. 比較速度、成本、測試通過率及返工量；
6. 驗證穩定後再擴展到團隊或生產環境；

適合哪些用戶？

• 習慣使用終端與Git工作流程的軟體開發者；
• 希望自由選擇雲模型或本地模型的用戶；
• 需要在現有大型倉庫中進行多文件修改的團隊；
• 重視開源、可配置和自動測試的工程師；
• 希望將AI編碼納入腳本與CI實驗的高級用戶。

產品優勢

• 免費開源且不綁定單一模型供應商；
• 倉庫地圖兼顧大型專案上下文和Token成本；
• Git自動提交與撤銷便於審查AI改動；
• 支援Code、Architect、Ask等不同模式；
• 可自動運行Lint、測試並迭代修復；
• 同時支援終端、瀏覽器、IDE監聽和腳本。

限制與注意事項

• Aider需要一定命令行、Git和API配置基礎，對純新手不如圖形化AIIDE直觀；
• 雲模型調用可能昂貴，大倉庫和長會話尤其需要控制上下文；
• AI可能誤改代碼、生成不安全命令或提交錯誤邏輯；
• 必須使用分支、測試、代碼審查以及最小權限原則，不能將自動提交視為品質保證的方式；

常見問題

Aider免費嗎？

Aider本身免費開源；使用商業雲模型需要按對應供應商API價格付款。

Aider支援DeepSeek嗎？

支援DeepSeek官方介面，也可透過OpenRouter或其他相容服務連接，需配置相應密鑰與模型名稱。

Aider支援本地模型嗎？

支援Ollama、LM Studio和OpenAI相容的本地介面，但模型需具備可靠的程式碼編輯能力。

Aider會自動提交代碼嗎？

預設情況下，系統會自動為 AI 的修改建立 Git 提交，且可透過會話指令來查看差異或撤銷該修改；此功能可在設定中關閉。

Aider可以運行測試嗎？

可以配置測試和Lint命令，並把失敗結果反饋給模型繼續修復。

Aider有圖形介面嗎？

主要是終端工具，同時提供瀏覽器GUI和檔案監聽方式與現有IDE配合。

Aider是開源嗎？

開源，官方倉庫採用Apache 2.0許可證。