aider 配置教程
官方入口：Aider 官方安装说明
适用范围：Aider 的 OpenAI 兼容提供商；模型名称使用 openai/ 前缀。
版本与验证：2026-09-28 核对本文配置项、步骤和资料入口，补齐验证与排错说明。未在真实账号中验证付费模型调用。
配置速查
| 配置项 | 填写内容 | 注意事项 |
|---|---|---|
| OPENAI_API_BASE | https://api.apizt.com/v1 | 基础地址带 /v1。 |
| OPENAI_API_KEY | apizt API Key | 在启动 aider 的终端设置。 |
| --model | openai/gpt-6-sol | openai/ 是 Aider 的提供商前缀。 |
还没有 API Key？注册获取免费体验额度 · 已注册：进入控制台创建 API Key
为此工具单独创建令牌，并设置合理额度和模型权限。截图中的模型仅作示例，以账号当前可用模型为准；不要公开密钥或上传含密钥的配置文件。
第 1 步：安装与准备项目
python -m pip install aider-install
aider-install进入要协作的项目目录。先确认当前改动已保存，便于检查 Aider 后续产生的差异。
第 2 步：设置兼容接口
macOS / Linux：在启动 Aider 的同一个终端设置以下变量。
export OPENAI_API_BASE="https://api.apizt.com/v1"
export OPENAI_API_KEY="YOUR_tokenba_API_KEY"Windows PowerShell：
$env:OPENAI_API_BASE = "https://api.apizt.com/v1"
$env:OPENAI_API_KEY = "YOUR_tokenba_API_KEY"第 3 步：指定模型启动
aider --model openai/gpt-6-solopenai/ 是 Aider 的提供商前缀，实际网关模型 ID 是 gpt-6-sol。使用真实令牌替换占位符。
第 4 步：验证回复与代码任务
先发送短消息确认回复，再用 /add README.md 添加已有文件，要求总结其内容。查看启动时的模型信息和 apizt 调用日志，然后再尝试小范围代码任务，检查生成的差异。
怎样确认配置已生效
- 启动后显示所选模型而不是默认提供商。
- 短消息有回复，apizt 日志记录 gpt-6-sol。
- 小范围代码任务产生可检查的差异。
接入失败时逐项检查
| 现象 | 检查与处理 |
|---|---|
| 缺少 API key | 在同一终端设置 OPENAI_API_KEY；Windows setx 后须新开终端。 |
| 访问了错误服务 | 检查 OPENAI_API_BASE 和 openai/ 模型前缀。 |
| 模型元信息警告 | 按 Aider 官方模型警告说明补元信息；不要把未知上下文限制当作事实。 |
资料与下一步
遇到问题时保留软件版本、请求时间、模型 ID、错误码和请求 ID，联系支持时先隐藏 API Key。