Aider - 终端 AI 结对编程助手 - apps / aider | 88API AI API 接入、配置与使用文档

使用 Aider 的 OpenAI 兼容配置连接 88API，在终端中完成代码理解与修改。

适用范围

Aider 是运行在终端中的开源 AI 结对编程工具，可以读取代码仓库、修改文件，并将改动与 Git 工作流结合。本教程适用于 Windows、macOS 和 Linux。

官方文档：https://aider.chat/docs
GitHub 仓库：https://github.com/Aider-AI/aider
PyPI 项目：https://pypi.org/project/aider-chat/

使用前准备

登录 88API，创建 API Key，并确认账户有可用余额。
安装 Python 3。
准备一个 Git 代码仓库。Aider 可以不依赖 Git 运行，但在 Git 仓库中更容易查看和撤销修改。
确认账户当前可用的模型 ID。下文以 gpt-4.1 为例。

安装 Aider

Aider 官方当前推荐先安装独立安装器，再由安装器创建 Aider 环境：

python -m pip install aider-install
aider-install

安装完成后检查版本：

aider --version

如果终端提示找不到 aider，关闭并重新打开终端，使安装器添加的 PATH 生效。仍然找不到时，按照安装器最后输出的路径提示处理，不要反复在不同 Python 环境中安装。

配置 88API

Aider 会依次读取用户主目录、Git 仓库根目录、当前目录和 --env-file 指定的 .env，后读取的文件优先级更高。为了让多个项目共用 88API，同时避免把密钥放进代码仓库，推荐编辑用户主目录的 .env：

系统	推荐文件
Windows	`%USERPROFILE%\.env`
macOS / Linux	`~/.env`

如果文件已经存在，请保留原有内容并追加以下三行，不要覆盖其他配置：

AIDER_MODEL=openai/gpt-4.1
AIDER_OPENAI_API_BASE=https://88api.ai/v1
AIDER_OPENAI_API_KEY=你的88api密钥

在 .env 中配置 88API 并启动 Aider

图中 ①～③ 是 .env 中必须核对的三个变量，④ 是保存后执行的启动命令。API Key 只用遮罩表示；实际文件中应填写从 88API 控制台创建的密钥。

三个变量的作用：

变量	说明
`AIDER_MODEL`	Aider 主模型；OpenAI 兼容模型必须使用 `openai/` 前缀
`AIDER_OPENAI_API_BASE`	88API 的 OpenAI 兼容基础地址
`AIDER_OPENAI_API_KEY`	88API API Key，仅供 Aider 的 OpenAI 提供商读取

模型前缀不能省略

Aider 官方要求自定义 OpenAI 兼容模型写成 openai/<model-name>。因此应填写 openai/gpt-4.1，不能只写 gpt-4.1。

如果只想给某个项目使用不同配置，可以在项目根目录创建 .env。项目文件会覆盖用户主目录中的同名变量，因此要将它加入 .gitignore，避免提交 API Key。

第一次启动

打开终端，进入代码仓库后启动 Aider：

cd /path/to/your/project
git status
aider

Windows PowerShell 示例：

Set-Location 'C:\path\to\your\project'
git status
aider

启动信息中应显示主模型 openai/gpt-4.1。先进行一条只读测试：

只分析当前仓库的目录结构和主要语言，不要修改文件。

收到回复后，打开 88API 控制台使用日志，确认出现对应请求。

让 Aider 修改代码

可以先用 /add 把目标文件加入聊天，再描述修改：

/add hello.py
把 hello.py 的输出从 hello 改为 goodbye，并说明修改内容。

Aider 默认会为模型产生的代码修改创建 Git 提交。提交前后可以使用 git diff、git log 或 Aider 的 /diff 查看变化。首次试用如果不希望自动提交，可以这样启动：

aider --no-auto-commits

临时切换模型

命令行参数可以覆盖 .env 中的主模型：

aider --model openai/另一个可用模型ID

仍然要保留 openai/ 前缀。模型 ID 必须来自账户实际可用列表，不能根据显示名称猜测。

常见问题

提示找不到 API Key

确认变量名是 AIDER_OPENAI_API_KEY，.env 文件没有被保存成 .env.txt。如果项目根目录或当前目录也有 .env，检查其中是否用空值覆盖了主目录配置。

返回 401

重新复制 88API API Key，确认等号两侧没有空格，值没有引号或多余换行。修改 .env 后退出当前 Aider 会话并重新启动。

返回 404 或接口路径异常

基础地址应为 https://88api.ai/v1，不要再添加 /chat/completions。Aider 会自行拼接 OpenAI 兼容接口路径。

提示模型不存在

确认 AIDER_MODEL 同时满足两点：以 openai/ 开头，后半部分与 88API 的实际模型 ID 完全一致。

出现 Unknown model、上下文长度或费用警告

Aider 会为熟悉的模型维护元数据。自定义别名可能可以正常调用，但缺少上下文长度和价格信息，因此出现警告。先确认请求确实成功；需要精确上下文和费用估算时，再按官方 Model Metadata 文档补充模型元数据，不要随意填写数值。

能返回文字，但不能正确应用代码修改

代码修改依赖模型遵循 Aider 编辑格式的能力。先用简单的单文件修改验证；如果仍失败，换用编程能力更强、且已知适配 Aider 的模型。仅能聊天不代表模型能稳定生成可应用的编辑块。

配置改了但仍使用旧值

Aider 按“主目录 → Git 根目录 → 当前目录 → --env-file”顺序读取 .env，后面的值会覆盖前面的值。检查项目内是否存在同名变量，并重新启动 Aider。

Aider - 终端 AI 结对编程助手