安装指南

快速开始使用 aider-install

如果你已经安装了 Python 3.8-3.13,可以按照以下方式快速开始使用。

首先,安装 aider:

python -m pip install aider-install
aider-install

开始在你的代码库中使用 aider:


# 切换到你的代码库目录
cd /to/your/project


# 使用 DeepSeek 模型
aider --model deepseek --api-key deepseek=<key>


# 使用 Claude 3.7 Sonnet 模型
aider --model sonnet --api-key anthropic=<key>


# 使用 o3-mini 模型
aider --model o3-mini --api-key openai=<key>

这将在独立的 Python 环境中安装 aider。
如果需要,
aider-install 还会安装单独的 Python 3.12 版本供 aider 使用。

安装完成后,
还有一些可选安装步骤可供选择。

查看使用说明开始使用 aider 进行编码。

单行命令安装

以下单行命令将安装 aider,如果需要还会安装 Python 3.12。
这些命令基于
uv 安装器

Mac & Linux

使用 curl 下载脚本并通过 sh 执行:

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

如果系统没有 curl,可以使用 wget:

wget -qO- https://aider.chat/install.sh | sh

Windows

powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"

使用 uv 安装

可以通过 uv 安装 aider:

python -m pip install uv  # 如果需要安装 uv
uv tool install --force --python python3.12 --with pip aider-chat@latest

这将使用您现有的 Python 3.8-3.13 版本安装 uv,
并用它来安装 aider。
如果需要,
uv 会自动安装单独的 Python 3.12 供 aider 使用。

另请参阅
其他安装 uv 的方法文档

使用 pipx 安装

可以通过 pipx 安装 aider:

python -m pip install pipx  # 如果需要安装 pipx
pipx install aider-chat

可以使用 pipx 在 Python 3.9-3.12 版本下安装 aider。

另请参阅
其他安装 pipx 的方法文档

其他安装方法

您可以使用下面描述的方法安装 aider,但通常上述方法更安全。

使用 pip 安装

如果选择使用 pip 安装,建议使用 虚拟环境 来隔离 aider 的依赖项。

您可以通过 pip 在 Python 3.9-3.12 版本上安装 aider:

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

在某些环境中,您可能会遇到”aider command not found”错误。 您可以尝试使用 python -m aider 命令, 或查看此处获取更多信息

通过包管理器安装

建议优先使用上述推荐的方法安装 aider。 虽然某些系统包管理器也提供 aider, 但它们通常会安装错误的依赖项。

后续步骤…

您可以考虑一些可选安装步骤。 查看使用说明开始使用 aider 进行编码。


目录