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 的小改动（如单测）。

免费开始开会