一、什麼是 Aider?為什麼它值得你關注?
如果你已經習慣了在終端裡用 Claude Code 或 CC Switch 做 AI 輔助程式設計,那麼 Aider 可能會讓你眼前一亮——它是一個純 CLI 的開源 AI 結對程式設計工具,但設計理念完全不同:Git-first。
終端 AI 程式設計工具的崛起
過去兩年,AI 程式設計助手從 IDE 外掛(GitHub Copilot)走向獨立應用(Cursor、Windsurf),再到終端 CLI(Claude Code、OpenCode)。終端形態的優勢在於:
- 無 GUI 依賴:SSH 遠端開發、伺服器運維場景下依然可用
- 腳本化能力強:可與 shell 腳本、Makefile、CI/CD 流水線無縫整合
- 輕量級:無 Electron 包袱,記憶體佔用遠低於桌面應用
但大多數終端 AI 工具只是把聊天介面搬到了終端裡,缺乏對開發者工作流的深度理解。Aider 的不同之處在於,它從第一天起就圍繞 Git 工作流設計。
Aider 的核心優勢
| 特性 | Aider | Claude Code | Cursor |
|---|---|---|---|
| Git 自動 commit | ✅ 每次修改自動提交 | ❌ 需手動 | ❌ 需手動 |
| 一鍵復原(/undo) | ✅ | ❌ | ❌ |
| Repo Map 智慧上下文 | ✅ 自動提取相關程式碼 | ⚠️ 部分支援 | ✅ |
| 支援語言數 | 100+(tree-sitter) | 主流語言 | 主流語言 |
| 模型選擇自由度 | 50+ 模型任選 | Anthropic 為主 | OpenAI/Anthropic |
| 開源授權 | Apache 2.0 | 閉源 | 閉源 |
Git-first 意味著什麼?
當你讓 Aider 重構某個函式時,它會自動:
1. 分析相關檔案,提取最小必要上下文(Repo Map)
2. 生成修改後的程式碼
3. 自動執行 git add + git commit,commit message 由 AI 生成
4. 如果你對修改不滿意,輸入 /undo 即可一鍵復原到修改前的狀態
這種「大膽嘗試、隨時復原」的工作流,極大降低了 AI 輔助程式設計的心理負擔。你不再需要擔心「改壞了怎麼辦」,因為每一次修改都有完整的 Git 歷史記錄。
誰適合用 Aider?
- 終端重度使用者:習慣 Vim/Neovim、Emacs 或純 CLI 工作流的開發者
- 多模型切換需求者:想在不同任務中使用不同模型(如 DeepSeek V3 日常開發、Claude 3.7 Sonnet 複雜重構)
- 團隊協作場景:Git commit 歷史天然記錄了 AI 參與的每次修改,便於 code review
- 成本敏感型開發者:可以自由選擇性價比最高的模型,不被單一供應商綁定
接下來,我們從頭到尾帶你上手 Aider。
二、安裝 Aider:3 種方法任選
Aider 支援 macOS、Linux 和 Windows(preview beta),提供多種安裝方式。
方法 1:一鍵安裝腳本(推薦新手)
這是官方推薦的最快方式,會自動偵測系統並安裝所需依賴。
macOS / Linux:
curl -LsSf https://aider.chat/install.sh | sh
Windows(PowerShell):
powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"
安裝完成後,執行 aider --version 驗證安裝成功。
方法 2:pipx 安裝(推薦 Python 開發者)
如果你的系統已安裝 Python 3.9+,可以使用 pipx(隔離環境管理工具):
# 安裝 pipx(如果尚未安裝)
pip install pipx
pipx ensurepath
# 安裝 Aider
pipx install aider-chat
pipx 的好處是每個套件運行在獨立的虛擬環境中,不會汙染全域 Python 套件。
方法 3:uv 安裝(最快,自動管理 Python 版本)
uv 是一個極速的 Python 套件管理器,用 Rust 編寫。如果你追求極致速度:
# 安裝 uv
curl -LsSf https://astral.sh/uv/install.sh | sh
# 使用 uv 安裝 Aider(自動下載 Python 3.12)
uv tool install --force --python python3.12 --with pip aider-chat@latest
uv 的優勢在於: - 無需預先安裝 Python,自動下載指定版本 - 安裝速度比 pip/pipx 快 10-100 倍 - 磁碟佔用更小
驗證安裝
無論使用哪種方法,安裝後都應驗證:
aider --version
# 輸出類似:aider v0.85.0
如果提示 command not found,請檢查 PATH 環境變數是否包含安裝目錄(通常在 ~/.local/bin 或 ~/.cargo/bin)。
三、快速上手:第一個 Aider 會話
安裝完成後,讓我們進入一個真實專案,體驗 Aider 的核心工作流。
啟動 Aider 並新增檔案
# 進入你的專案目錄
cd /path/to/your/project
# 啟動 Aider(不帶參數會掃描目前目錄)
aider
# 或者指定具體檔案
aider src/main.py src/utils.py
首次啟動時,Aider 會提示你配置 API Key。你可以選擇:
- 命令列傳入:--api-key anthropic=<key>(推薦,避免寫入配置檔案)
- 環境變數:設定 ANTHROPIC_API_KEY、OPENAI_API_KEY 等
- 配置檔案:~/.aider.conf.yml(適合固定使用某模型的場景)
發出第一個程式碼修改請求
假設我們有一個簡單的 Python 專案,想重構資料庫連線邏輯:
> 重構 main.py 中的資料庫連線部分,改用非同步連線池(asyncpg)
Aider 會:
1. 分析 main.py 及相關檔案,建構 Repo Map
2. 生成修改後的程式碼,顯示 diff
3. 詢問你是否確認修改
4. 確認後自動執行 git add + git commit
你可以在聊天中繼續迭代:
> 給新的連線池新增超時重試機制
> 編寫對應的單元測試
查看 Git commit 歷史
每次修改後,Aider 都會自動生成有意義的 commit message:
git log --oneline
# 輸出類似:
# abc1234 Refactor database connection to use asyncpg with retry logic
# def5678 Add unit tests for connection pool
# 789abcd Initial commit
如果你對某次修改不滿意,可以一鍵復原:
# 在 Aider 聊天中輸入
/undo
# 或者手動用 Git 復原
git reset --hard HEAD~1
這種「大膽嘗試、隨時復原」的工作流,是 Aider 區別於其他 AI 程式設計工具的核心價值。
四、多模型配置:DeepSeek、Claude、GPT-4o 任選
Aider 支援 50+ 種 LLM,包括閉源模型(Claude、GPT-4o、Gemini)和開源模型(Llama 3、DeepSeek、Qwen)。下面介紹最常用的幾種配置方式。
獲取 API Key
| 模型供應商 | API Key 申請地址 | 免費額度 |
|---|---|---|
| Anthropic(Claude) | https://console.anthropic.com/ | $5 信用額度 |
| DeepSeek | https://platform.deepseek.com/ | 新使用者贈送 token |
| OpenAI(GPT-4o) | https://platform.openai.com/ | $5 信用額度 |
| Google(Gemini) | https://aistudio.google.com/ | 免費 tier |
命令列指定模型
啟動時直接指定模型和 API Key:
# 使用 DeepSeek V3(高性價比日常開發)
aider --model deepseek --api-key deepseek=<your_key>
# 使用 Claude 3.7 Sonnet(複雜重構首選)
aider --model sonnet --api-key anthropic=<your_key>
# 使用 GPT-4o
aider --model gpt-4o --api-key openai=<your_key>
# 使用本機模型(如 Ollama 執行的 Llama 3)
aider --model ollama_chat/llama3 --api-key none
聊天中動態切換模型(/model 命令)
Aider 允許在會話中隨時切換模型,無需重新啟動:
# 在 Aider 聊天中輸入
/model claude-3-7-sonnet
# 或使用簡寫 alias
/model sonnet
/model deepseek
/model gpt-4o
實用技巧: 日常小修改用 DeepSeek V3(成本低),遇到複雜重構時切換到 Claude 3.7 Sonnet(成功率高)。
2026 年最佳性價比模型推薦
根據 Aider 官方維護的 LLM Leaderboard,以下是綜合程式碼編輯成功率和成本的推薦:
| 模型 | 程式碼編輯成功率 | 單次任務成本 | 推薦場景 |
|---|---|---|---|
| Claude 3.7 Sonnet (32k thinking) | 64.9% | $36.83 | 複雜重構、多檔案修改 |
| DeepSeek R1 Reasoner | 71.4% | $4.80 | 需要推理的複雜任務 |
| DeepSeek V3 Chat | 55.1% | $1.12 | 日常開發、高性價比 |
| o3-mini (high) | 60.4% | $18.16 | 中等複雜度任務 |
| GPT-4o | 23.1% | $7.03 | 簡單補全、快速迭代 |
省錢建議: - 80% 的日常任務用 DeepSeek V3($1.12/次) - 20% 的複雜任務用 Claude 3.7 Sonnet($36.83/次) - 平均成本遠低於全程使用 Claude
五、進階功能:Repo Map、Chat Modes、IDE 整合
掌握基礎用法後,這些進階功能能讓你的效率再上一個台階。
Repo Map:讓 Aider 自動理解你的程式碼庫
傳統 AI 程式設計工具需要你手動 @mention 相關檔案,而 Aider 的 Repo Map 功能會自動:
- 使用 tree-sitter 解析倉庫結構
- 提取與目前任務相關的程式碼片段
- 建構精簡的上下文地圖,發送給 LLM
這意味著你無需告訴 Aider「參考 file_a.py 和 file_b.py」,它自己就能找到相關檔案。
最佳化大倉庫效能:
# 限制 Repo Map 的 token 數量(預設 1024)
aider --map-tokens 512
# 只掃描子目錄(適合 monorepo)
aider --subtree-only
# 建立 .aiderignore 檔案排除無關目錄
echo "node_modules/" >> .aiderignore
echo "dist/" >> .aiderignore
Chat Modes:四種模式應對不同場景
Aider 提供四種聊天模式,透過 /mode 命令切換:
| 模式 | 用途 | 觸發命令 |
|---|---|---|
| code | 預設模式,直接修改程式碼 | /mode code |
| architect | 架構設計討論,不直接改程式碼 | /mode architect |
| ask | 純問答,不修改任何檔案 | /mode ask |
| help | 查詢 Aider 自身功能 | /mode help |
典型工作流:
1. 用 architect 模式討論設計方案
2. 切換到 code 模式執行具體修改
3. 用 ask 模式查詢某個函式的用途
--watch 模式:在 IDE 中寫註解,Aider 自動回應
如果你更喜歡在 VS Code / Neovim 中編輯程式碼,可以讓 Aider 監聽檔案變化:
aider --watch src/
當你在 IDE 中新增特殊註解時,Aider 會自動回應:
# TODO: refactor this function to use async/await
# AIDER: please convert this to async
def fetch_data():
...
Aider 偵測到 AIDER: 標記後,會自動執行註解中的指令並提交修改。
語音互動和圖片輸入(可選)
Aider 還支援: - 語音輸入:配置麥克風後,可以說出程式碼修改需求 - 圖片/網頁輸入:新增截圖或文件連結到對話中
這些功能適合特定場景(如 UI 設計回饋),但大多數開發者仍以文字互動為主。
六、Aider vs Claude Code:該選哪個?
很多開發者會在 Aider 和 Claude Code 之間猶豫。以下是關鍵對比:
功能對比表
| 維度 | Aider | Claude Code |
|---|---|---|
| 開源狀態 | ✅ Apache 2.0 | ❌ 閉源 |
| 模型選擇 | 50+ 模型任選 | 主要 Anthropic |
| Git 自動 commit | ✅ | ❌ |
| 一鍵復原 | ✅ /undo |
❌ |
| Repo Map | ✅ 自動提取 | ⚠️ 需手動 @mention |
| IDE 整合 | --watch 模式 |
原生 VS Code 外掛 |
| 多語言支援 | 100+(tree-sitter) | 主流語言 |
| 成本 | 自選模型,靈活 | 按 Anthropic 定價 |
| 學習曲線 | 中等(CLI 命令較多) | 低(自然語言互動) |
適用場景建議
選擇 Aider,如果: - 你重視 Git 工作流,希望每次 AI 修改都有完整歷史記錄 - 需要在不同模型間切換以平衡成本和品質 - 習慣純 CLI 工作流,或在遠端伺服器上開發 - 團隊需要透明的 AI 參與記錄(便於 code review)
選擇 Claude Code,如果: - 你主要使用 Anthropic 模型,不需要多模型切換 - 偏好更自然的對話式互動,不想記憶 CLI 命令 - 重度依賴 VS Code 整合 - 對開源狀態不敏感
最佳實踐: 兩者可以互補使用——Aider 處理需要 Git 記錄的正式修改,Claude Code 用於快速原型探索。
七、常見問題排查
"aider command not found"
原因: PATH 環境變數未包含安裝目錄。
解決:
# 檢查安裝位置
which aider # macOS/Linux
where aider # Windows
# 新增到 PATH(以 ~/.local/bin 為例)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
API Key 配置錯誤
症狀: 啟動時報錯 Invalid API key 或 Authentication failed。
解決:
1. 確認 API Key 正確(複製時不要包含多餘空格)
2. 檢查模型名稱拼寫(deepseek 而非 deep-seek)
3. 驗證帳戶餘額是否充足
Token 超限處理
症狀: Aider 報錯 Context length exceeded。
解決:
# 減少 Repo Map 的 token 數量
aider --map-tokens 512
# 只新增必要檔案,而非整個目錄
aider src/specific_file.py
# 使用 .aiderignore 排除無關檔案
echo "tests/" >> .aiderignore
大倉庫效能最佳化
對於大型專案(>1000 檔案),Aider 的 Repo Map 可能較慢:
# 只掃描子目錄
aider --subtree-only
# 停用 Repo Map(手動管理上下文)
aider --map-tokens 0
# 使用更快的模型(DeepSeek V3 比 Claude 快)
aider --model deepseek
八、總結:Aider 適合誰?
Aider 代表了終端 AI 程式設計工具的一個新方向:不是簡單地把聊天介面搬到終端,而是圍繞開發者的核心工作流(Git、程式碼審查、多語言支援)重新設計。
它的核心價值在於:
1. Git-first:每次修改自動提交,/undo 一鍵復原,降低試錯成本
2. 模型自由:50+ 模型任選,不被單一供應商綁定
3. 智慧上下文:Repo Map 自動提取相關程式碼,無需手動 @mention
4. 開源透明:Apache 2.0 授權,社群驅動發展
如果你是終端重度使用者,或者希望在團隊中建立透明的 AI 輔助程式設計規範,Aider 值得你投入時間學習。
下一步行動: - 訪問 Aider 官網 了解更多 - 查看 GitHub 倉庫 參與社群討論 - 閱讀 官方文件 探索更多進階功能 - 如果想對比其他終端 AI 工具,可以參考我們的 開源 AI 程式設計助手橫評
Happy coding with Aider! 🚀