Aider 安装与 OmniProxy 配置

Aider 是一个在终端里协助修改代码的工具。它会为整个代码库整理一张地图，帮助模型理解较大的项目；Git 则是记录代码变化的版本管理工具，可以用来查看差异和恢复改动。你交给 Aider 一件任务后，它会分步骤处理并写提交说明。如果不喜欢这次改动，可以使用 /undo 撤销。

安装前准备

安装有两条常用路线：

电脑上已经有 Python 3.8 到 3.13：先安装 aider-install。Python 是 Aider 运行所需的程序环境。
没有合适的 Python：使用一行安装命令，需要时会一起准备 Python 3.12。

Mac 与 Linux

install.sh

curl 后用 sh 执行
需要时会装 Python
没有 curl 可用 wget

Windows

install.ps1

PowerShell 执行
装完重开终端
环境变量用 setx

已有 Python

aider-install

先 pip 装这个包
再运行 aider-install
它会自建环境

一行安装会在需要时准备 Python 3.12。直接 pip 安装 aider-chat 较不稳妥。

准备好正在运行的 OmniProxy。安装完成后，先进入你准备修改的项目目录，再启动 Aider。

安装并首次启动

已经有 Python 3.8 到 3.13

依次执行：

python -m pip install aider-install
aider-install

aider-install 会把 Aider 安装到单独的 Python 环境中，避免和电脑里其他 Python 项目混在一起。需要时，它还会再安装一个供 Aider 使用的 Python 3.12。

一行安装

Mac 和 Linux 执行：

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

如果电脑里没有 curl，可以改用：

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

Windows PowerShell 执行：

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

这些一行命令基于 uv；uv 是用来安装和管理 Python 工具及环境的程序。也可以使用下面这条命令：

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

此外还可以使用 pipx。直接通过 python -m pip install aider-chat 安装时，可用的 Python 版本是 3.9 到 3.12，但这种方式属于其他安装方式，优先使用前面的安装方法。系统包管理器中的 Aider 可能出现依赖不匹配，因此不要优先用它们安装。

2026-10-09 使用一行安装命令安装到 Aider v0.86.2。安装过程中如果提示缓存和目标不在同一块磁盘、改为复制文件，安装仍然会完成。

安装结束后进入项目目录。兼容接口是指使用 OpenAI 格式与其他模型服务通信的接口，启动形式如下：

aider --model openai/<model-name>

其中 <model-name> 要换成下一节从 OmniProxy 复制的完整模型 ID；模型 ID 就是用来准确指定模型的名称。

从 OmniProxy 取得连接参数

需要设置以下两个环境变量。环境变量可以理解为终端程序读取的一组连接设置：

export OPENAI_API_BASE=https://your-omniproxy-origin.example/v1
export OPENAI_API_KEY=<YOUR_OMNIPROXY_API_KEY>

OPENAI_API_BASE 是接口地址，必须写到 /v1。OPENAI_API_KEY 是访问接口时使用的密钥。

Windows 使用 setx 保存变量。执行后需要重开终端：

setx OPENAI_API_BASE https://your-omniproxy-origin.example/v1
setx OPENAI_API_KEY <YOUR_OMNIPROXY_API_KEY>

模型名从 OmniProxy 当前列表中整段复制，模型 ID 里的斜杠也要保留。启动 Aider 时，再在完整 ID 前加上 openai/。

2026-10-09 供应商文档里的两个对照 ID 是 gemini-3.8-flash 和 grok-4.7。如果当前列表里没有这些名字，不要直接照抄，请使用列表中实际存在的完整 ID。

地址

OPENAI_API_BASE

指向 OmniProxy
写到 /v1
不要写进仓库

密钥

OPENAI_API_KEY

用网关发给你的
Windows 改完要重开
供应商密钥留在网关

启动

openai/模型

cd 到项目目录
模型名加 openai/
名称以网关列表为准

两个环境变量加上带 openai/ 前缀的模型名，就是官方的兼容接口写法。

填写工具配置

这里不需要另外创建配置文件。先进入项目目录，再启动 Aider，并把模型 ID 换成 OmniProxy 当前列表里实际存在的名字：

cd /path/to/your/project
aider --model openai/gemini-3.8-flash

如果要换成另一个举例模型，执行：

aider --model openai/grok-4.7

遇到 Aider 不熟悉的模型时，界面会显示警告。这个警告本身不代表地址填错，需要到 OmniProxy 的调用记录中确认是否出现了这次请求。

Aider 只会把 Git 已经跟踪的文件放进上下文；上下文就是本次任务中模型能够读取的代码和信息。如果当前目录还不是 Git 仓库，Aider 会自行创建仓库，但没有被 Git 跟踪的文件仍然无法读取。请先用 git add 加入文件并提交，再启动 Aider。

Aider 仍然可能修改文件。--no-auto-commits 只会关闭自动提交，不会阻止文件被修改。第一次使用时，建议选择一个不重要的仓库，任务结束后执行 git diff 查看实际改动。

不要把真实密钥写进项目文件或公开页面。供应商的密钥只放在 OmniProxy 里。如果网关不校验密钥，OPENAI_API_KEY 可以填写一串只在本机使用的占位字符。

验证一个真实任务

先确认要读取的文件已经提交进 Git，然后在项目目录执行下面的命令。模型 ID 需要换成 OmniProxy 当前列表里的完整 ID：

aider --model openai/gemini-3.8-flash --message "这个文件的第一行是什么？不要修改文件。" --no-auto-commits

--message 用来直接交给 Aider 一次任务，--no-auto-commits 表示这次运行不要自动创建 Git 提交。

2026-10-09，已使用 Aider v0.86.2 读出已跟踪文件的第一行。如果文件还没有被 Git 跟踪，Aider 会回答看不到内容，这不表示接口地址有误。完成提问后，再到 OmniProxy 的调用记录中核对请求来源和模型 ID。

启动

aider 能开

命令找得到
环境变量已生效
停在项目目录

任务

它看了文件

问一个具体文件
看它的说明
不熟的模型会有警告

记录

网关看得到

来源是 Aider
模型 ID 一致
密钥没有进页面

环境变量生效、命令找得到，再完成一次真实提问。

常见错误

找不到 aider：先重开终端。如果使用 pip 直接安装，可以尝试 python -m aider。
Windows 改了变量仍连到旧地址：执行 setx 后必须重开终端，新窗口才会读取更新后的变量。
模型名前没有 openai/：兼容接口要求写成 openai/<model-name>。
出现不熟悉模型的警告：这是一种正常提示，不等于连接失败。接着检查 OmniProxy 是否收到请求。
模型 ID 无效：从 OmniProxy 当前列表重新复制完整 ID，保留 openai/ 前缀以及 ID 中原有的斜杠。
它说没有文件内容：先确认文件已经被 Git 跟踪。空仓库或未跟踪的文件不会进入上下文。

官方参考

安装步骤见 Aider installation。环境变量和模型前缀见 OpenAI compatible APIs。举例使用的模型 ID 可在 Gemini 模型列表和 xAI 模型页中查看。

用你自己的 OmniProxy 配置替换每个占位符。不要发布真实密钥。

保存成功或 HTTP 200 不单独等同完整 Agent 兼容。请在 OmniProxy 调用记录中确认来源和模型。

官方来源 · Aider ↗