Aider 接入指南

适用角色：开发者、主用户、子用户 更新日期：2026-08-06

Aider 通过 OpenAI Compatible 适配器连接本平台。Aider 命令里的 openai/ 是适配器前缀，本平台接收的模型调用名不包含这一层前缀。

安装

python -m pip install aider-install
aider-install

先用环境变量试运行

macOS、Linux 或 WSL：

export OPENAI_API_BASE="https://<接口地址>"
export OPENAI_API_KEY="YOUR_API_KEY"
aider --model openai/deepseek-v4-flash

以控制台「API Key」页展示的接口地址为准。

PowerShell：

$env:OPENAI_API_BASE="https://<接口地址>"
$env:OPENAI_API_KEY="YOUR_API_KEY"
aider --model openai/deepseek-v4-flash

连接确认后，可以把非敏感配置写进 .aider.conf.yml：

openai-api-base: https://<接口地址>
model: openai/deepseek-v4-flash

API Key 更适合保留在环境变量中。需要使用带分组标识的调用名时，Aider 参数形式为 openai/分组标识/模型名。

在测试仓库验证

先问一个只读问题，确认 Aider 能返回结果且控制台出现使用记录。随后让它修改一处容易检查的文本，并用 Git diff 核对。这样即使模型或工具行为不符合预期，也能直接回滚。

模型未识别时，检查 openai/ 前缀是否存在；本平台返回 Model Not Found 时，则检查前缀之后的模型调用名是否来自控制台。