算力猫
← 返回教程列表

接入软件

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 只在创建时显示一次,关闭页面就看不到了。没来得及保存?吊销它,再创建一把新的。

去创建 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)。