Source: https://wiki.niceai.dev/guide/clients/aider

# Aider 接入自定义 API

Aider 通过 OpenAI 兼容接口接入：把 `OPENAI_API_BASE` 设为 `https://api.niceai.dev/v1`、`OPENAI_API_KEY` 设为 NiceAI 密钥，启动时模型名前加 `openai/` 前缀，例如 `aider --model openai/<模型名>`。

## 准备工作

1. 安装 Aider：`python -m pip install aider-install`，然后运行 `aider-install`。
2. 在 NiceAI 控制台「[API 密钥](https://niceai.dev/keys)」页面创建密钥，分组按要用的模型选择。

## 配置步骤

1. 设置接口地址和密钥：

   ::: code-group

   ```bash [macOS / Linux]
   export OPENAI_API_BASE=https://api.niceai.dev/v1
   export OPENAI_API_KEY=sk-你的密钥
   ```

   ```powershell [Windows]
   setx OPENAI_API_BASE https://api.niceai.dev/v1
   setx OPENAI_API_KEY sk-你的密钥
   # setx 之后要重新打开终端
   ```

   :::

2. 进入项目目录：`cd /你的/项目`。
3. 启动 Aider，模型名加 `openai/` 前缀：

   ```bash
   aider --model openai/<模型名，见模型广场>
   ```

## 验证

启动后 Aider 会显示当前使用的模型，随便提一个小需求，能正常回复并修改文件即接入成功。

## 常见问题

### 启动时提示不认识这个模型？

Aider 对不在它内置列表里的模型会给出警告（例如不知道上下文长度和价格），一般不影响使用。按 Aider 文档的 model warnings 说明处理即可。

### 为什么要加 openai/ 前缀？

前缀告诉 Aider 用 OpenAI 兼容协议发请求。不加前缀时，Aider 可能按模型名去找别的服务商。

### 返回 404？

`OPENAI_API_BASE` 要以 `/v1` 结尾。见 [接口地址要不要加 /v1](https://wiki.niceai.dev/guide/v1-404)。

## 下一步

- [OpenCode 接入](https://wiki.niceai.dev/guide/clients/opencode)
- [客户端一览](https://wiki.niceai.dev/guide/clients/)
