Aider 怎么开通使用：免费安装、模型 Key 与账号设置
截至 2026-11-01 抓取时，PyPI 上 aider-chat 的版本为 0.86.2。Aider 是运行在终端里的开源 AI 结对编程工具，可连接云端或本地 LLM；它本身不提供订阅套餐，真正需要开通的是模型厂商账号和 API Key。
现在值得先弄清，是因为“安装 Aider”“登录 Aider”“购买 Aider 订阅”经常被混在一起。实际上，Aider 的客户端无需单独注册；开源工具本身没有付费档，运行费用来自所连接模型的 API 消耗。下面按安装、选择模型、连接账号、验证和排错依次操作。
先分清：Aider 客户端、模型账号与 API Key
Aider 的完整请求链路分成三部分：终端里的 Aider 客户端、实际生成代码的大语言模型、模型厂商提供的 API Key 或本地模型。
官方仓库将 Aider 描述为“AI pair programming in your terminal”，项目采用 Apache-2.0 许可证。官方 README 和 PyPI 项目页给出的入门方式，都是安装客户端后通过 --model 与 --api-key 连接模型，没有出现 Aider 官网账号注册或购买套餐的步骤。
| 要开通的对象 | 是否需要单独账号 | 需要付费吗 | 费用发生在哪里 |
|---|---|---|---|
| Aider 客户端 | 不需要 Aider 账号 | 不需要 | 客户端本身 |
| 云端模型 | 需要对应模型厂商账号 | 取决于模型 | 厂商按 API 用量计费 |
| 本地模型 | 通常不需要云端模型账号 | 不产生云端模型 API 费用 | 承担本机运行成本 |
第三方成本资料也明确指出 Aider 没有订阅、席位费或高级档，采用自带 Key 的模式。这个结论与官方安装流程一致，但费用和套餐信息毕竟不是官方 README 明文列出的表格，本文将其作为交叉核对结果，而不是官方套餐承诺。
三步安装并进入项目
1. 安装 Aider
官方 PyPI 页面当前提供两种安装入口，页面展示的版本是 aider-chat 0.86.2：
pip install aider-chat官方仓库 README 还给出了独立的安装器方式：
python -m pip install aider-install
aider-install新手优先使用第一种；需要按仓库 README 的独立安装流程时，再使用第二种。安装完成后，在终端执行 aider --help，能显示帮助信息就说明命令已加入当前环境。
2. 进入需要修改的 Git 项目
cd /to/your/project把 /to/your/project 换成实际目录。Aider 能读取代码库、生成仓库地图，并根据修改自动创建 Git 提交，因此最好先进入一个 Git 仓库，而不是直接在空目录里运行。可用 git status 确认当前目录是否受 Git 管理。
3. 启动 Aider
从项目目录执行：
aider随后在 Aider 交互界面中输入 /model，选择已经配置好凭据的模型，或选择本地模型。/model 是 Aider 会话内切换模型的入口；首次配置凭据时，则可以按下面一节直接用命令行传入 Key。
模型 Key 怎么填：按厂商选择一种方式
Aider 支持云端和本地 LLM。官方仓库列出的 DeepSeek、Claude Sonnet、OpenAI o3-mini 都可通过 --model 与 --api-key 连接，PyPI 页面给出的命令模板如下：
aider --model deepseek --api-key deepseek = <key>Claude 3.7 Sonnet 的官方模板是：
aider --model sonnet --api-key anthropic = <key>执行前需要把 <key> 替换成模型厂商控制台生成的密钥。命令里的 deepseek = <key> 和 anthropic = <key> 表示“模型厂商与 Key”的对应关系；实际操作时不要保留尖括号。
也可以先进入 Aider，再通过 /model 选择模型。这种方式适合已经配置过环境变量或凭据文件的用户，但首次使用者只靠 /model 往往还不知道该选哪个厂商。此时按官方模板逐项代入最直接：把 deepseek 替换为你的模型名，把 anthropic 替换为实际提供该模型的厂商名。
已有本地模型时，不需要再购买云端 API。Aider 官方 README 明确写明支持连接几乎所有 LLM，包括本地模型。首次不要用 /models 的结果判断本地模型是否存在，因为该列表可能只反映云端目录；应直接选择已在本机启动、且 Aider 能访问的模型。
首次成功长什么样
验证时看四个可观察结果，而不是只看命令有没有报错：
- 在项目目录运行
aider后，终端进入交互会话，没有停在安装提示或导入错误上。 - 输入
/model后能看到模型选择入口；本地模型路径下，应能选择你实际运行的模型。 - 输入一个范围很小的修改要求，例如创建测试文件，观察 Aider 能在项目中给出文件变更。
- 使用
git status查看工作区；Aider 已修改文件但尚未提交时，Git 会显示相应改动。官方 README 说明它会自动提交修改，可用提交记录和 Git 差异继续确认结果。
如果前两步正常、第三步也能修改文件，就已经证明 Aider 客户端、模型接口和项目目录三者连通。此时不需要寻找“Aider 会员中心”，后续账单应在对应模型厂商账户中查看。
常见卡点：先分清客户端错误与模型账单
/models 显示的免费模型不存在
官方仓库的 Issue #4781 记录了一个具体问题：/models 曾列出 openrouter/deepseek/deepseek-r1:free，但该模型实际不存在；同一问题给出的正确名称是 deepseek/deepseek-r1-0528:free。
解法是不要照抄列表里的旧别名。在 Aider 会话中执行 /model，改用问题记录中的正确名称，或切换到你已经配置且能实际调用的模型。若本地模型可用，直接选择本地模型，可以避开 OpenRouter 目录和账户状态。
提示必须先付费才能使用
Issue #4781 中的原文是：Requires upfront payment to OpenRouter to get prompt. 以及 Cannot list models or see a prompt without paying first. 这说明付款要求来自 OpenRouter 账户流程，不是 Aider 突然增加了订阅门槛。
如果本来就要用 OpenRouter 的付费模型，进入其账户完成充值和 OAuth 授权后，再在 Aider 中执行 /model 重试；如果只是想先体验，则改用另一个已配置凭据的模型厂商，或直接选择本地模型。不要把 OpenRouter 的预充值误当成 Aider 套餐，也不要为了测试 Aider 盲目充值。
安装后找不到 aider 命令
如果 aider --help 无法运行，先确认安装命令使用的 Python 环境与当前终端一致。Windows 下也可以使用 PyPI 页面展示的模块形式：
python -m pip install aider-chat
python -m aider安装完成后再次运行 python -m aider，这是验证模块是否进入当前 Python 环境的最直接方式。
费用、入口与后续核验
Aider 没有需要升级的 Free、Plus 或 Pro 套餐。客户端免费且开源，支出发生在模型 API 一侧；第三方成本资料给出的控制方式是模型选择、提示词缓存、上下文范围和模型厂商侧的硬性消费上限。需要控制预算时，应在模型厂商账户设置预算，而不是寻找不存在的 Aider 充值页面。
接下来可从三个入口继续操作：
- Aider 官方 GitHub 仓库：查看 README、提交记录、故障排查和 release notes。
- Aider 的 PyPI 项目页：查看当前版本、安装命令和项目元数据。
- Aider 官方仓库 Issue #4781：核对模型列表与 OpenRouter 预付门槛的具体表现。
- Aider 成本与定价说明：用于交叉核对“无订阅、费用来自自带 Key”的口径，模型价格仍以各厂商账单为准。
参考来源
评论区
登录后可评论。