接入软件
Aider
终端里的 AI 配对编程工具:两个环境变量加一个 `openai/` 前缀。
约 4 分钟适合:在终端里用 Aider 改代码的开发者
开始之前
- 已安装 Aider(
aider --version能运行) - 一把 Key,以及从模型广场复制的模型名
步骤 1 · STEP 0x01
设置地址和 Key
bash
export OPENAI_API_BASE=https://api.suanlimao.shop/v1
export OPENAI_API_KEY=<你的 Key>terminal
$ export OPENAI_API_BASE=https://api.suanlimao.shop/v1$ export OPENAI_API_KEY=<你的 Key>
- 官方 OpenAI 兼容页面就是这两个变量:
OPENAI_API_BASE填接入地址,OPENAI_API_KEY填 Key。 - Windows 用
setx之后要重新打开终端才生效(官方提示)。
官方页面没写地址要不要带 /v1。先用
https://api.suanlimao.shop/v1;报 404 再试 https://api.suanlimao.shop。也可以用命令行参数 --openai-api-base / --openai-api-key 代替环境变量。完整 Key 只在创建时显示一次,关闭页面就看不到了。没来得及保存?吊销它,再创建一把新的。
步骤 2 · STEP 0x02
用 openai/ 前缀启动
terminal
$ aider --model openai/<模型名>Aider v…Model: openai/<模型名> with whole edit formatGit repo: .git with N files
- 模型名前面加
openai/,告诉 Aider 走 OpenAI 兼容接口。 - 想固定下来,可以写进
.aider.conf.yml(Aider 会在 git 根目录、当前目录和家目录查找)或.env文件,键名见官方配置文档。
模型名不要自己猜:到「模型广场」点模型卡片上的「复制模型名」,再粘贴到软件里。模型名写错是最常见的报错原因。
步骤 3 · STEP 0x03
发一个任务
terminal
> 给 README 加一节「快速开始」(Aider 会提出修改并询问是否应用)
Aider 不认识的模型名会弹出「model warnings」提示,不影响使用;确认模型名与模型广场一致即可。
✓ 怎么确认成功了
- Aider 能回答并提出代码修改。
- 控制台「用量」页出现这次请求。
常见问题
401?
OPENAI_API_KEY 没设置、没复制全,或 Windows 下 setx 后没重开终端。
404?
先检查模型名是否带了 openai/ 前缀且与模型广场一致;再在 OPENAI_API_BASE 里试带 / 不带 /v1。
想换成 Claude 系列模型?
仍然走 OpenAI 兼容接口即可:openai/ 加上模型广场里的 Claude 模型名。
相关教程
还是不行?
先看排错教程;仍然解决不了,提交工单时附上 request_id、时间、模型和报错原文(不要贴 Key)。