wbmeet

如何用 pip 安裝並設定 Aider：OpenAI/Anthropic API Key 與 Git 倉庫終端結對編程

pip 安裝 aider-chat、設定 API Key、在 Git 倉庫啟動 aider 並完成一次可審查改動。

第一次在 Git 倉庫里用终端 AI 結對編程，Aider 常见卡点不是提示词，而是 pip 装错包、OPENAI_API_KEY / ANTHROPIC_API_KEY 没进环境，或当前目录不是 Git 工作区。按官方文档用 pip install aider-chat 安裝，匯出密钥，在倉庫根目录跑 aider，再让模型改一行你能 git diff 審查的代码。

檢索詞是 如何用 pip 安裝并設定 Aider 终端結對編程。下文對照 Aider 官方站点 aider.chat 的安裝、LLM 設定与 Git 集成说明。Aider 是独立开源终端助手，不是本站会议产品。改完 diff 要约人过一遍，用 wbmeet 开短会即可，步骤见 如何建立与加入房间。

pip 安裝設定 API KeyGit 倉庫里 aider

Aider 在终端里做什么

Aider 是面向已有 Git 倉庫的终端結對編程工具：你把自然语言任务发给大模型，它读写项目文件，并可通过 Git 提交改动。官方包名是 aider-chat（PyPI），命令通常是 aider。支持 OpenAI、Anthropic 等多家 API；密钥通过環境變數或 .env 传入，不要写进倉庫。需要本机已安裝 Python 3.8+ 与 git，并在要改动的项目里初始化或克隆好倉庫。

pip
aider-chat 包
git
必须在倉庫内
.env
密钥勿提交

用 pip 安裝 Aider

  1. 1

    准备 Python 与 Git

    确认 python3 --version 为 3.8 或更高，git --version 可用。建议在虚拟环境（python3 -m venv .venv 并 source .venv/bin/activate）里安裝，避免污染系统 Python。

  2. 2

    安裝 aider-chat

    运行 python -m pip install -U aider-chat（或 pip install aider-chat）。装完后执行 aider --version 核对。若找不到命令，检查虚拟环境是否激活，或 pip show aider-chat 查看安裝路径是否在 PATH 中。

  3. 3

    可选：固定版本

    团队可在 requirements-dev.txt 里 pin 版本号，但不要把 API Key 写进该文件。升级时用 pip install -U aider-chat，并以 release notes 为准核对破坏性变更。

設定 OpenAI 或 Anthropic API Key

  1. 1

    在提供商控制台建立密钥

    OpenAI：在 platform.openai.com 建立 API Key。Anthropic：在 console.anthropic.com 建立密钥。计费、区域与用量限制以各平台条款为准；不要把真实密钥贴进 issue、截图或 Git。

  2. 2

    匯出環境變數

    在 shell 設定或当前会话中设置，例如 export OPENAI_API_KEY=sk-… 或 export ANTHROPIC_API_KEY=sk-ant-…。Aider 文档说明还支持在倉庫根目录放 .env（须已忽略提交）。可同时只配一家，启动时用 --model 指定模型 id。

  3. 3

    选对模型名

    首次建议用官方文档列出的默认或推荐模型（如 OpenAI 的 gpt-4o 系列或 Anthropic 的 Claude 型号，以 aider.chat 当前列表为准）。模型不存在或无权访问时会报 404/401，先在小倉庫用只读问题试通再做大改动。

在 Git 倉庫里結對編程

  1. 1

    进入项目根目录

    cd 到你的 Git 倉庫根（含 .git）。若提示不是 git 倉庫，先 git init 或克隆远程。未提交的本地改动建议先 git status 看清，方便之后 review。

  2. 2

    启动 aider

    运行 aider，必要时加 --model MODEL。首次可只添加要讨论的文件：aider path/to/file.py，避免把整个 monorepo 一次塞满上下文。终端里用自然语言描述任务，例如「解释这个模块的入口」或「给未测试的 helper 补单测，先展示 diff」。

  3. 3

    審查 diff 再提交

    Aider 会修改工作区文件；用 git diff 審查每一行。官方支持自动 git commit（取决于选项与版本）；第一小时建议手动 commit，commit message 自己写，确保可 git revert。

# First hour · Aider · 2026-09
python3 -m venv .venv && source .venv/bin/activate
python -m pip install -U aider-chat
export ANTHROPIC_API_KEY=...   # or OPENAI_API_KEY
cd /path/to/your/git/repo
aider --model sonnet
# or: aider src/utils.py
# task: add one unit test; show diff before commit

能力对照与常见坑

环节适合第一次注意
pip aider-chat本机/CI 虚拟环境激活 venv 再跑 aider
OPENAI / ANTHROPIC云端模型密钥仅环境或 .env
Git 倉庫可追踪改动先 status 再改
指定文件启动大倉庫缩小上下文
git diff審查第一小时手动 commit
01

aider: command not found

虚拟环境未激活，或 pip 装到了用户目录但 PATH 未包含 Scripts/bin。

02

401 / 模型不可用

检查密钥、账户余额与 --model 名称是否与提供商文档一致。

03

改动面太大

只 add 相关文件；任务拆小；要求「先 diff 再应用」。

官方路径：pip install aider-chat → 設定 OPENAI/ANTHROPIC → 在 Git 倉庫运行 aider → git diff 審查。细节以 aider.chat 文档为准。

和 Claude Code / Copilot CLI 的区别
各家终端代理的安裝与认证不同。本站有 Claude Code 与 Copilot CLI 安裝笔记可对照；按任务选一个即可。
必须 OpenAI 吗
不必。Anthropic 与其他 Aider 支持的提供商均可，见官方 LLM 列表。
教程页不是会议说明书
只讲 Aider 第一次。短会白板见 wbmeet。

還想核對的問題

沒有 API Key 能用 Aider 吗？

Aider 需要可调用的大模型 API（或文档支持的本地/OpenRouter 等設定）。没有密钥时无法完成结对改代码，只能先读安裝文档规划环境。

.env 可以提交到 Git 吗？

不可以。API Key 只能放在被 .gitignore 忽略的 .env 或 shell 环境中。

Aider 會自動 push 吗？

默认行为以你使用的选项与版本为准；第一小时只在本地 commit，确认 diff 后再自己 push。

第一個任務必須改正式環境程式吗？

不必。先让 Aider 解释一个文件，再做一个可 revert 的小改动（如单测）。

免費開始開會