# Aider 接入指南

## 适用范围与前提

本页提供 Aider 对接本站的配置说明。需要启用的本站密钥、可用余额以及协议匹配的实际可用模型。2026-10-24 已核对官方资料；这不代表每个客户端版本及上游模型都已完成全流程测试。

## 配置步骤

1. 安装官方 Aider，确认版本；在当前终端设置下面两个环境变量。
2. OPENAI_API_BASE 指向本站 /v1，OPENAI_API_KEY 使用本站密钥。
3. 把命令中的模型占位符替换为本站实际 ID，保留 openai/ 前缀；该前缀用于选择兼容供应商。
4. 在临时项目先验证短问答和一项小改动，确认修改差异后再用于正式项目。

## 配置值对照

| 配置项 | 填写内容 |
| --- | --- |
| OPENAI_API_BASE | https://u9ai.ai/v1 |
| API Key | YOUR_U9AI_API_KEY · 本站 API 密钥 |
| Model | YOUR_CHAT_MODEL_ID · 实际可用模型 ID |
| 最终文本请求端点 | https://u9ai.ai/v1/chat/completions |

```bash
export OPENAI_API_BASE="https://u9ai.ai/v1"
export OPENAI_API_KEY="YOUR_U9AI_API_KEY"
aider --model openai/YOUR_CHAT_MODEL_ID
```

```powershell
$env:OPENAI_API_BASE = "https://u9ai.ai/v1"
$env:OPENAI_API_KEY = "YOUR_U9AI_API_KEY"
aider --model openai/YOUR_CHAT_MODEL_ID
```

## 这个工具需要特别注意

未知模型可能触发规格提示，需填真实上下文及价格，不能编造。若配置额外弱模型、编辑模型或架构模式，应分别核对这些模型是否也已开通。

## 验收与交接

先按[快速开始](/zh-CN/docs/quickstart)执行只读 GET /v1/models，确认认证和目录。再分别验收短文本非流式请求、流式输出及所需的完整工具调用往返。生成测试可能扣费，请保留请求号并核对[消费分析](/zh-CN/docs/billing)。失败时在[工单](/zh-CN/support)提供客户端版本、模型 ID、端点、状态码和脱敏错误；超时任务不要盲目重提。

可将本 MD 直接交给开发者或 Agent 阅读，要求保留原配置、只替换实际可用模型，并明确报告未验证项。真实密钥不要写入共享 MD。

## 官方参考

[Aider](https://aider.chat/docs/llms/openai-compat.html)