Aider 接入猫云
Aider 可连接 OpenAI 兼容接口；本页采用 Chat Completions 路径，不代表任意模型都适合代码编辑。1 本站尚未逐个工具链验收；以下是按官方文档整理的配置指南，不是实测通过声明。
1. 准备与安装
先在猫云创建密钥，核对余额、分组权限和模型广场中的完整模型 ID。按官方安装页安装 Aider，已有安装可跳过；不要为了安装修改系统 Python。2 备份已有 .aider.conf.yml 和环境设置，保留无关配置，在测试项目中启动。
2. 最小配置
Linux/macOS Bash 示例；占位符必须替换，密钥不加 Bearer ：
export OPENAI_API_BASE="https://api.nekocloud.vip/v1"
export OPENAI_API_KEY="REPLACE_WITH_API_KEY"
cd /path/to/project
aider --model openai/REPLACE_WITH_MODEL_ID| 字段 | 含义 |
|---|---|
OPENAI_API_BASE | 猫云 OpenAI 基础地址，保留 /v1 |
OPENAI_API_KEY | 实际猫云密钥 |
--model | openai/ 为客户端路由前缀，后接完整模型 ID |
上述变量和前缀来自官方兼容接口指南，不要改成其他客户端的变量名。1 Windows 请在用户环境变量中配置同名项并重开终端。
3. 选择模型与重载
会话内可用 /model openai/REPLACE_WITH_MODEL_ID 切换主模型；/models 是客户端模型搜索，不保证猫云权限或实时库存。3 环境变化后退出并从同一终端重新启动。遇到未知模型警告，先核对 ID 和官方说明；不要虚构上下文长度、价格或能力参数。若启用 weak/editor 等辅助模型，也分别确认其路由和授权。
4. 验证闭环与安全
以下测试会产生模型调用费用，请自行确认后再做：先发送一句简短问候，核对响应和实际选中模型；随后输入 /read-only README.md，用 /ask 要求总结文件并引用原句，不编辑、不执行 Shell。3 Aider 的这条路径验证文件读取与问答，不等于验证 OpenAI tool_calls。检查文件未变，再在猫云用量记录中核对时间、模型和 token；/tokens 仅表示当前上下文，不是账单。3
真实 Key 不要写进 Git、截图或聊天；上面的明文命令仅演示，实际可用 Bash 隐藏输入再导出变量。401 先查密钥和进程环境，404 查地址与模型，400 查协议参数；停止重复重试，并脱敏后排查。