【2026 實查】aider 接 OpenRouter 免費模型完整教學：安裝、金鑰、選模型，一天 50 次額度怎麼用才不浪費

aider 是跑在終端機裡的 AI 寫程式工具：你用講的，它直接改你電腦裡的檔案，還會幫你 commit。它本身是 Apache 2.0 開源、完全免費，帳單來自你接的那顆模型（站上 2026-09-05 的查核紀錄也是這樣寫）。

所以問題就變成：有沒有辦法連模型的錢也不用付？有——把它接到 OpenRouter 上那些 :free 結尾的免費模型。2026-09-06 我們直接打 OpenRouter 的模型清單 API 數過：全站 430 個模型裡，有 18 個是 :free 版本，包含好幾個寫程式取向的。

這篇不是講價格，是從零把整條線接起來的操作教學。所有指令都來自 aider 官方文件與 OpenRouter 官方文件的直讀。

步驟一：裝 aider

官方文件給的最短路徑是兩行（需要 Python 3.8–3.13）：

python -m pip install aider-install
aider-install

這個做法會把 aider 裝在自己的獨立 Python 環境裡，需要的話它會另外裝一份 Python 3.12，不會污染你原本的環境。

不想碰 Python 的話，官方也給了一鍵安裝腳本：

• Mac / Linux：curl -LsSf https://aider.chat/install.sh | sh
• Windows：powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"

另外還有 uv tool install --force --python python3.12 --with pip aider-chat@latest 與 pipx install aider-chat 兩條路。官方明講一件事：不建議用系統套件管理員裝，那些版本常常帶錯依賴。

步驟二：金鑰放哪裡（三種寫法，挑一種就好）

aider 對 OpenAI 和 Anthropic 有專屬參數，其他家（包含 OpenRouter）走通用寫法。三種都是官方文件列的：

1. 環境變數

export OPENROUTER_API_KEY=<你的金鑰>      # Mac / Linux
setx OPENROUTER_API_KEY <你的金鑰>        # Windows

Windows 用 setx 之後要把終端機關掉重開才會生效，這是最常見的「明明設了卻說沒金鑰」原因。

2. 專案裡的 .env 檔

OPENROUTER_API_KEY=<你的金鑰>

3. .aider.conf.yml 設定檔

api-key:
  - openrouter=<你的金鑰>

第三種等於幫你設環境變數 OPENROUTER_API_KEY。要臨時試也可以直接下 --api-key openrouter=<你的金鑰>。

步驟三：指定模型，先把清單叫出來

進到你的專案資料夾再啟動，這點很重要，aider 是對「目前資料夾的 git repo」工作的：

cd /到/你的/專案
aider --list-models openrouter/
aider --model openrouter/<供應商>/<模型>

--list-models openrouter/ 會列出你這把金鑰可以用的全部模型。免費模型的辨識方式很單純：ID 結尾是 :free。

2026-09-06 當天我們實抓到的 18 個免費模型裡，寫程式取向的有 cohere/north-mini-code:free、poolside/laguna-s-2.1:free、minimax/minimax-m3:free、nvidia/nemotron-3-super-120b-a12b:free 等；上下文從 6.5 萬到 100 萬 token 都有。這份名單變動很快，請以你自己跑出來的 --list-models 為準，不要抄我們的。

步驟四：官方明講的坑——隱私設定沒開，會直接報錯

這一條是 aider 官方 OpenRouter 說明頁自己寫的：如果你遇到錯誤，去檢查 OpenRouter 的隱私設定，要把「允許可能拿輸入去訓練的供應商」打開，才能用到全部模型。

換句話說，免費模型之所以免費，代價之一是資料條件比較寬鬆。這是取捨，不是 bug：

• 只是拿來練手、改個人專案 → 打開，通常沒問題。
• 手上是公司或客戶的程式碼 → 這條就足以否決整個免費方案，請走付費模型。

不想全域打開的話，aider 支援在家目錄或專案根目錄放一個 .aider.model.settings.yml，逐一控制供應商：

- name: openrouter/anthropic/claude-3.7-sonnet
  extra_params:
    extra_body:
      provider:
        order: ["Anthropic", "Together"]
        allow_fallbacks: false
        data_collection: "deny"
        require_parameters: true

注意 data_collection: "deny" 和「打開可能訓練的供應商」是相反方向的兩個旋鈕：前者是保護資料、後者是換取免費額度。想清楚你要哪一個。供應商路由的完整寫法，我們另外整理在 OpenRouter 怎麼指定便宜的供應商。

步驟五：一天 50 次是什麼概念，怎麼用才不浪費

OpenRouter 官方限制文件裡免費模型的數字（我們直接讀了文件原始碼裡的常數，不是二手轉述）：

也就是說，全新帳號沒儲過值，一天只有 50 次請求。而 aider 不是「一天用 50 次對話」——你每送出一則訊息就至少吃掉一次；用 architect 模式的話，一個規劃模型加一個編輯模型，一則訊息至少兩次。50 次其實很快就見底。

實際省法（都是官方 tips 裡的建議，剛好也省額度）：

1. 只 /add 真的要改的檔案。 官方原文就是「不要加一堆檔案」，無關的程式碼會讓模型分心；aider 本來就有整個 repo 的地圖，知道別處有什麼。
2. 改完就 /drop。 下一步要改別的檔案再 /add 回來，別讓對話一直拖著肥肉。
3. 卡住先 /clear。 把聊天歷史清掉重來，比在爛脈絡上硬凹省很多次請求。
4. 複雜任務先 /ask 討論、再 /code 動手。 ask 模式只討論不改檔，把方向談定後，切回 code 模式只要說一句「go ahead」就會照著做——一次到位比改三次省。
5. 一次一小步。官方原話是把目標拆成一口一口大小。

額度撞牆時會拿到 429，錯誤回應會帶 X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset 這幾個標頭告訴你撞到哪一條；如果餘額不足則是 402。想在撞牆前先看剩多少，可以打 GET https://openrouter.ai/api/v1/key。額度規則的完整拆解見 OpenRouter 免費模型每天只能跑 50 次。

步驟六：git 是你的安全網，先確認它開著

aider 跟 git 是綁在一起的，這件事在免費模型上特別重要——免費模型改壞的機率本來就比較高：

• 它每改一次檔案，就會用一段有意義的訊息幫你 commit。
• 你原本沒 commit 的髒檔案，它會先幫你 commit 一次再動手，你的手寫程式碼跟 AI 的改動因此分得乾乾淨淨。
• 改壞了打 /undo，直接還原上一次改動；/diff 看這輪改了什麼；/commit 手動收尾；/git 直接下原生 git 指令。

真的不想要自動 commit 有 --no-auto-commits，完全不用 git 有 --no-git——但官方自己也寫了「不建議」，而且用免費模型時尤其不建議。

一句話總結

aider 免費、OpenRouter 有 18 個免費模型，接起來確實能做到「改程式零成本」，但你要接受兩件事：資料條件比較寬鬆，以及一天 50 次請求的紀律。拿來練手、改個人專案很划算；公司程式碼就別走這條。

本文操作步驟與數字查核於 2026-09-06，來源為 aider 官方安裝文件、aider 的 OpenRouter 說明頁、aider 金鑰設定文件、OpenRouter 限制文件 與 OpenRouter 模型清單 API 當日實抓。免費模型名單與額度規則隨時可能變動，請以官方頁面為準。aider 的成本結構整理見我們的 aider 工具頁。