tidemeet

如何安裝並使用 Aider：pip/uv、API Key 與第一次倉庫改動

用 pip 或 uv 安裝 Aider，接上 API Key，再在真實 Git 倉庫裡完成第一次改動。

你要的是一個能讀本機 Git 倉庫、提出 diff、改檔案的結對代理，而且整段循環留在終端機裡。

這篇依官方文件走完 如何安裝並使用 Aider：用 pip、pipx 或 uv 安裝 aider-chat，接上 API Key，再在真實倉庫裡做第一次改動。步驟以 aider.chat/docs/install.html 與 aider.chat/docs/usage.html 為準。

安裝 接上 API Key 第一次倉庫改動

它適合誰、不適合誰

Aider 對著本機 Git 倉庫工作：看檔案、出補丁、依確認寫入，並可建立提交。它不是網頁聊天視窗，也不要求先裝 IDE 擴充功能。倉庫必須已經是 Git 專案。

01

對著真實倉庫

先 cd 進既有 Git 專案再啟動。第一次只加一兩個檔，例如 README，再要一句可覆核的說明。

02

金鑰走環境，不走聊天

官方用法是 OPENAI_API_KEY 或 ANTHROPIC_API_KEY。可以 export，或放在倉庫根目錄的 .env。不要把金鑰貼進提示詞，也不要提交該檔。

03

提交預設可能打開

Aider 常會在接受改動後自動 git commit。動手前確認工作區乾淨，金鑰與本機設定已在 .gitignore。

安裝、接金鑰、第一次改動

  1. 1

    安裝 aider-chat

    官方套件名是 aider-chat，不是單獨的 aider。常用：python3 -m pip install aider-chat。隔離環境用 pipx install aider-chat，或 uv tool install --python python3.12 aider-chat。裝完執行 aider --help 確認命令在 PATH 裡。

  2. 2

    接上 API Key

    在 shell 裡 export OPENAI_API_KEY=… 或 export ANTHROPIC_API_KEY=…。長期使用可把同名變數寫進倉庫根的 .env，並把該檔加入 .gitignore。用 aider --list-models 看本機識別到的提供方；具體模型名以 aider.chat/docs/llms.html 為準。

  3. 3

    做第一次倉庫改動

    進入倉庫，執行 aider README.md（或你真正要改的檔）。要一次聚焦改動，例如給 README 加一行說明。看完 diff 再接受。需要關自動提交時，查官方 usage 裡的 commit 開關，而不是事後從歷史裡挖金鑰。

0
額外 IDE 依賴
2
常用金鑰變數
1
第一次提示詞
python3 -m pip install aider-chat
# pipx install aider-chat
# uv tool install --python python3.12 aider-chat

export OPENAI_API_KEY=sk-...
# export ANTHROPIC_API_KEY=sk-ant-...

cd ~/code/your-repo
aider README.md
# Add a one-line note to the README that this repo uses Aider for local edits

第一次容易卡住的地方

方式帳單更適合
OPENAI_API_KEYOpenAI Platform 價GPT 系列本機改倉庫
ANTHROPIC_API_KEYAnthropic 按量價Claude 系列本機改倉庫
倉庫根 .env同上金鑰本機反覆開工作階段
必須先是 Git 倉庫
Aider 依賴 Git 做上下文與提交。空目錄先 git init 並至少有一次提交，再啟動。不要對著沒有版本控制的資料夾試第一次。
把 .env 當密碼
不要提交、不要貼進工單。若已經推進遠端，到對應雲端控制台輪換金鑰，而不是只刪提交說明。
自動提交會帶走工作區裡的檔
接受 diff 前看暫存範圍。金鑰、本機覆蓋設定、大型產物應已 ignore。需要人工提交時，依官方文件關掉 auto-commit。

官方提醒：API 呼叫按供應商計費。第一次用便宜、短上下文的模型摸流程，再換到你真正要付的模型。

改完要和人對著看時

代理改完常缺一張圖：動了哪些檔、為什麼能合。不必再裝會議套件。可在tidemeet用瀏覽器開短時空間，或看如何建立空間。畫布用法見共享白板基礎。同站另一條終端機代理入門見Codex CLI。

還有疑問？

必須先裝 IDE 擴充功能嗎？

不必。Aider 是獨立的終端機程式。第一次倉庫改動只需要 Python、Git 和一把有效的 API Key。

pip 和 uv 有什麼差別？

功能相同，裝的都是 PyPI 上的 aider-chat。pip 寫進目前解譯器；pipx 與 uv tool 做成隔離命令，較適合本機長期用。選你已經在用的一種即可。

第一次該讓它改很大一塊嗎？

不建議。先指定檔案，再要一句可覆核的改動。工作區先乾淨，金鑰已 ignore，看完 diff 再接受。

和臨時協作工具有什麼關係？

沒有產品綁定。只是要對著 diff 講兩句時，臨時會議工具對比說明何時用短時瀏覽器空間即可。

免費建立空間