Windows 安装 Aider 并连接本地 llama.cpp 模型

原标题：Windows 安装 Aider 并连接本地 llama.cpp 模型教程

一、安装 Aider

方法一：PowerShell 一键安装（推荐）

以管理员身份打开 PowerShell：

powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"

安装完成后验证：

where aider

正常会显示类似：

C:\Users\你的用户名\.local\bin\aider.exe

查看版本：

aider --version

例如：

aider 0.86.2

---

二、配置环境变量

如果系统无法识别 aider 命令，需要添加环境变量。

打开 CMD：

setx PATH "%PATH%;C:\Users\你的用户名\.local\bin"

重新打开终端。

验证：

where aider

能够找到：

C:\Users\你的用户名\.local\bin\aider.exe

即可。

---

三、启动 llama.cpp API

Aider 无法直接读取 GGUF 文件。

必须先启动 llama.cpp Server。

示例：

llama-server ^
-m models\Qwen3.6.gguf ^
--host 127.0.0.1 ^
--port 8080

启动后访问：

http://127.0.0.1:8080/v1/models

如果返回模型信息，说明 API 正常。

---

四、测试模型接口

打开 CMD：

curl http://127.0.0.1:8080/v1/models

正常返回：

{
  "data":[
    {
      "id":"qwen"
    }
  ]
}

---

五、创建 Aider 启动脚本

新建：

start-aider.bat

内容：

@echo off
chcp 65001 >nul

echo Starting Aider...
echo.

set OPENAI_API_BASE=http://127.0.0.1:8080/v1
set OPENAI_API_KEY=dummy

"C:\Users\你的用户名\.local\bin\aider.exe" ^
 --model openai/qwen ^
 --no-show-model-warnings

pause

说明：

• OPENAI_API_BASE 指向 llama.cpp API
• OPENAI_API_KEY 随便填写即可
• openai/qwen 只是模型标签

---

六、首次启动

双击：

start-aider.bat

第一次运行可能提示：

No git repo found, create one to track aider's changes?

推荐输入：

Y

Aider 会自动执行：

git init

用于记录代码修改历史。

---

七、常见问题

1. aider is not recognized

原因：

环境变量未生效

解决：

直接使用完整路径：

"C:\Users\你的用户名\.local\bin\aider.exe"

---

2. Unknown context window size

提示：

Warning for openai/qwen

原因：

Aider 不认识自定义本地模型

不影响使用。

可添加：

--no-show-model-warnings

隐藏提示。

---

3. GitHub 超时

提示：

raw.githubusercontent.com timed out

原因：

Aider 拉取模型信息失败

不影响本地模型使用。

---

八、推荐配置

本地聊天：

OpenWebUI + llama.cpp

代码辅助：

Aider + Claude

本地代码实验：

Aider + llama.cpp + Qwen Coder

对于 RTX 4060 8G 用户，推荐优先使用专门的代码模型，而不是通用聊天模型。