一、什麼是 Aider?為什麼它值得你關注?

如果你已經習慣了在終端裡用 Claude CodeCC 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_KEYOPENAI_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 功能會自動:

  1. 使用 tree-sitter 解析倉庫結構
  2. 提取與目前任務相關的程式碼片段
  3. 建構精簡的上下文地圖,發送給 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 keyAuthentication 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! 🚀