Aider 怎么安装：aider-install、pipx、uv 步骤对照

Aider 是在终端里与 AI 模型协作修改本地 Git 项目的命令行工具，安装后可用 aider 启动。

截至本次抓取，PyPI 页面显示 aider-chat 版本为 0.86.2。现在值得先安装，是因为 Aider 的安装入口不止一个：新手可以直接使用官方推荐的 aider-install，已经使用隔离 Python 环境的用户可以选 pipx 或 uv，而 pip install aider-chat 虽然可用，却更容易和系统 Python 里的其他包发生冲突。

先确定安装方式

Aider 在 PyPI 上的包名是 aider-chat，启动命令则是 aider。这两个名字不能混用：python -m pip install aider-chat 安装的是 Python 包，安装完成后才通过 aider 命令运行。

Aider 官方 README 给出的入门流程是：先安装 aider-install，运行 aider-install，进入项目目录，再启动 Aider。官方仓库的 Getting Started 部分也采用同一套命令口径。

安装方式	直接复制执行的命令	适合谁	主要取舍
aider-install	python -m pip install aider-install，然后运行 aider-install	第一次安装、不知道如何隔离 Python 环境	官方 README 的入门路径，步骤最短
pipx	pipx install aider-chat	已用 pipx 管理 CLI 工具	工具与项目环境分离清晰
uv	uv tool install --force --python python3.12 --with pip aider-chat@latest	已安装 uv 的用户	命令较长，但会指定 Python 3.12
一键脚本	curl -LsSf https://aider.chat/install.sh | sh	macOS 或 Linux 用户	依赖脚本和当前 shell，不适合需要精确控制环境的人
普通 pip	pip install -U --upgrade-strategy only-if-needed aider-chat	已经熟悉虚拟环境的用户	简单，但隔离性不如前几种

这里的顺序不是功能排名。aider-install 适合第一次使用；pipx、uv 适合本来就用 Python 工具管理器的人；一键脚本适合不想逐条执行安装命令的 macOS/Linux 用户；普通 pip 应放在已有虚拟环境的场景中。

Python 版本以 PyPI 的 requires_python 字段为准（本文抓取时）：aider-chat 0.86.2 要求 >=3.10,<3.13，也就是 Python 3.10 至 3.12。二手安装资料里”3.8 起””3.9 起”的说法与 PyPI 冲突，一律以 PyPI 为准——安装前先跑 python3 --version，低于 3.10 或已是 3.13 都先换解释器再装，别在版本不满足时反复重试安装命令。

按推荐路径安装 aider-install

这是第一次安装时最容易照着完成的路径。

先安装负责设置环境的工具：

python -m pip install aider-install

安装完成后，运行它：

aider-install

然后进入自己的代码项目。不要只在随机目录运行，否则 Aider 后面无法按预期处理项目文件：

cd /to/your/project

接着启动 Aider。官方 README 给出的模型启动示例如下，分别对应 DeepSeek、Claude 3.7 Sonnet 和 o3-mini：

aider --model deepseek --api-key deepseek=<key>
aider --model sonnet --api-key anthropic=<key>
aider --model o3-mini --api-key openai=<key>

把 <key> 换成对应服务商的 API key。命令中的尖括号只是占位符，实际执行时不要保留尖括号。

使用 pipx 或 uv 安装 aider-chat

如果你已经用 pipx 管理命令行工具，直接执行：

pipx install aider-chat

安装后用下面的命令确认命令已经进入 PATH：

aider --help

pipx 的作用是把应用放进独立的 Python 工具环境，和当前项目依赖分开。相比把 aider-chat 装进系统 Python，这种方式更适合多个项目共用同一台电脑的情况。

已经安装 uv 的用户可以执行：

uv tool install --force --python python3.12 --with pip aider-chat@latest

这组命令明确使用 Python 3.12，并通过 --with pip 安装包。安装后仍然用 aider --help 检查，不要用 aider-chat --help 代替：PyPI 页面显示的是包名 aider-chat，官方示例中的可执行程序是 aider。

macOS、Linux 一键安装与普通 pip

macOS 和 Linux 用户可以使用官方脚本：

curl -LsSf https://aider.chat/install.sh | sh

这条命令会从 aider.chat 下载并执行安装脚本。若系统没有 curl，或者公司网络禁止访问该域名，应改用前面的 aider-install 路径，而不是反复重试脚本。

如果当前目录已经是项目虚拟环境，并且你希望完全控制包版本，可以执行：

pip install -U --upgrade-strategy only-if-needed aider-chat

这里的 only-if-needed 表示只在需要时升级已有依赖。普通 pip 路径没有额外的隔离层，因此不要把这一步当作系统级安装的默认方案。

常见卡点：包名、Python 版本和 PATH

最常见的第一个误区是把包名和命令名混用。安装命令中使用 aider-chat：

pip install aider-chat

启动和检查命令使用 aider：

aider --help

第二个卡点是 Python 版本不匹配。二手安装资料里”pipx 与 pip 支持 3.9–3.12″”aider-install 支持 3.8–3.13″的说法不要照抄——PyPI 上 aider-chat 的 requires_python 是 >=3.10,<3.13，所有安装方式共用这一条硬要求。先查看当前解释器：

python --version

如果系统默认 python 不在 3.10–3.12 范围内，不要继续安装当前项目；可以改用 uv 命令中显式指定的 Python 3.12（uv tool install --force --python python3.12 --with pip aider-chat@latest），或者建一个 3.10–3.12 的虚拟环境再执行普通 pip 安装。

第三个卡点是安装成功但终端找不到 aider。先确认当前 shell 是否能找到可执行程序：

aider --help

如果提示命令不存在，重新打开终端；如果仍然失败，使用安装管理器提供的环境检查方式确认 aider 所在位置。若使用 pipx，可查看已安装的工具列表：

pipx list

这些检查能区分“包没有安装”和“包已安装但 PATH 尚未更新”两种情况。提供的官方 README、PyPI 页面和补充安装资料中没有提供统一的安装报错原文，因此这里不把自拟的英文报错当作官方错误信息。

怎么确认已经装好

先运行：

aider --help

能显示帮助信息，说明命令已经可以被当前终端找到。接着进入一个有 Git 项目的目录：

cd /to/your/project
aider

如果需要明确指定模型，可以沿用官方示例：

aider --model sonnet --api-key anthropic=<key>

成功标志不是仅仅看到安装完成提示，而是 aider --help 能正常运行、aider 能在项目目录启动，并且 Aider 能正常识别当前代码仓库。启动后再用 /help 查看当前会话可用命令；Aider 是终端程序，不是带独立安装向导的桌面应用。

延伸阅读与官方入口

安装命令和项目地址可以从 Aider 官方 GitHub 仓库 获取，仓库 README 还列出了 Usage Guide、Configuration Options、Troubleshooting、FAQ、Release notes 和 Discord Community 入口。

包版本、发布文件和项目简介以 aider-chat 的 PyPI 页面 为准；如果 pip install 与 PyPI 页面显示的版本不一致，先用下面的命令检查本机版本：

aider --version

需要对照 pipx、uv、一键脚本和 Python 版本范围时，可查看这份 Aider 安装说明。它是独立整理的安装资料；具体包版本和官方支持范围，仍应回到上述官方仓库与 PyPI 页面核对。

参考来源

• Aider
• Aider – Aider