客户端接入 · Aider

Aider 接入 HardysAPI:两个环境变量搞定

Aider 是终端里的结对编程工具,配置靠环境变量。它认 /v1 结尾的 base,但模型名前面的 openai/ 前缀容易踩坑。

先准备两样东西:在 控制台 创建 API 密钥(复制 sk- 开头的完整字符串), 以及要用的模型名(从 模型价格 里挑,名字要一字不差)。

环境变量

bash / zshbash
export OPENAI_API_BASE=https://hardysapi.com/v1
export OPENAI_API_KEY=sk-你的密钥

# 启动时指定模型
aider --model openai/claude-sonnet-4-5

Windows PowerShell 用 $env:OPENAI_API_BASE="https://hardysapi.com/v1", 长期生效写进「系统环境变量」。

openai/ 前缀规则

Aider 用 厂商/模型名 的写法判断走哪套协议。走中转站的 OpenAI 兼容接口时,一律加 openai/ 前缀:

  • openai/claude-sonnet-4-5 ✅ 走 /v1/chat/completions
  • claude-sonnet-4-5 ❌ Aider 会去猜 Anthropic 原生协议,可能请求到别的路径

常见坑

  • 404 / model not found:模型名没加前缀,或者该模型不在密钥所属分组;
  • model not in list:Aider 启动时会校验模型是否在其内置列表里,新版可用 --model 直接指定任意名字,旧版需加 --openai-api-base 并升级;
  • 启动很慢:Aider 会先拉一次模型列表,网络慢时可加 --no-check-update。

验证

先用手动请求确认bash
curl https://hardysapi.com/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY"

这个请求成功后,Aider 用的是同一套凭据,问题只可能在命令行参数上。

常见问题

Aider 的 OPENAI_API_BASE 要带 /v1 吗?

要,写成 https://hardysapi.com/v1。Aider 在此基础上拼接 /chat/completions。

Aider 里模型名为什么要加 openai/ 前缀?

前缀决定 Aider 使用哪套协议。中转站提供的是 OpenAI 兼容接口,加 openai/ 才会走 /v1/chat/completions。