首页/报错百科/Aider 连接模型失败
ERROR CODE 客户端 · 常见

Aider 连接模型失败

Aider 的命令行模型配置与 API Key 环境变量。,附原因排序、修复步骤与责任判定。

更新 2026-10-28 核验 2026-10-28 · 码农阿风 aidercli

30 秒结论

Aider 通过环境变量和 --model 参数选模型,格式有约定。

报错原文对照

Model not found

AuthenticationError

原因排序

概率原因
45%模型名格式不对
35%环境变量没设
20%Base URL 没配

修法

先在自己这边查

  1. 用 --model openai/模型名 的格式
  2. 设 OPENAI_API_KEY / OPENAI_API_BASE
  3. aider --list-models 看支持列表

再往服务方查

这一项不是你这边能解决的。

责任判定表

现象责任方
提示模型命名格式
401Key
404Base

什么时候该换

Aider 的模型名带 provider 前缀,这是最容易错的。

你在这个站点上遇到过这个问题?

认领站点后可补充证据、申请公开核验;认证不改榜单排序,只对应可复核的检测与复测。

认领 / 申请认证

双确认订阅,可随时退订。不发广告,不卖排名。