# Aider 接入指南

Aider 是一款命令行 AI 结对编程工具，可直接在终端中对接你的 Git 仓库进行修改。本文介绍如何让它通过 UModelverse 平台调用模型。

## **系统要求**

| 平台 | 要求 |
| --- | --- |
| Windows | Windows 10 或 Windows 11 |
| macOS | macOS 10.15 (Catalina) 或更高版本 |
| Linux | 主流发行版（Ubuntu、Debian 等） |

所有平台均需要：Python 3.8+、Git 与网络连接。

## **1. 安装 Aider**

推荐使用官方安装脚本：

```
python -m pip install aider-install && aider-install
```

或直接通过 pip 安装：

```
python -m pip install aider-chat
```

安装后执行以下命令验证：

```
aider --version
```

## **2. 配置 UModelverse API**

### 2.1 获取 API Key

访问 [UModelverse 控制台](https://console.ucloud.cn/modelverse/api) 获取您的 API 密钥。可用模型见 UModelverse 平台[支持的模型](https://api.modelverse.cn/v1/models)。

### 2.2 设置环境变量

Aider 通过 OpenAI 兼容方式接入。设置以下两个环境变量（将 `YOUR_API_KEY` 替换为实际 Key）。

macOS / Linux：

```
export OPENAI_API_BASE=https://api.modelverse.cn/v1
export OPENAI_API_KEY=YOUR_API_KEY
```

Windows（PowerShell）：

```
$env:OPENAI_API_BASE="https://api.modelverse.cn/v1"
$env:OPENAI_API_KEY="YOUR_API_KEY"
```

## **3. 启动 Aider**

进入你的项目目录，用 `--model` 指定模型（OpenAI 兼容模型需加 `openai/` 前缀）：

```
cd your-project-folder
aider --model openai/qwen3.7-max
```

> `openai/` 后面的模型名可替换为 UModelverse 平台[支持的模型](https://api.modelverse.cn/v1/models)中的任意一个，例如 `openai/claude-sonnet-4-6`。

也可以把上述环境变量和默认模型写入 `~/.aider.conf.yml`，避免每次重复设置：

```
openai-api-base: https://api.modelverse.cn/v1
openai-api-key: YOUR_API_KEY
model: openai/qwen3.7-max
```

## **常见问题**

### 提示认证失败或无法连接？

请逐项确认：

1.  `OPENAI_API_KEY` 来自 UModelverse 平台，复制完整且无空格。
    
2.  `OPENAI_API_BASE` 为 `https://api.modelverse.cn/v1`。
    
3.  `--model` 指定的模型带 `openai/` 前缀，且是 UModelverse 平台[支持的模型](https://api.modelverse.cn/v1/models)之一。
    
4.  修改环境变量后，需新开终端窗口再运行 `aider`。