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 讲两句时，临时会议工具对比说明何时用短时浏览器空间即可。

免费创建空间