安装和使用 Aider
Aider 是一个用于终端的 AI 配对编程工具。AI-School 建议在与学生一起编码时使用 Aider，因为该工具的工作方式更明确，且比许多其他编码代理更少具备代理性。
学生在编程时会得到帮助，但仍可以清楚看到哪些文件被修改。
更多信息请参阅 Aider 官网 Aider-网站 和 Aider 官方文档。
安装
要使用 Aider，首先需要安装 Python。通过 python.org 或如 Homebrew 这样的包管理器安装 Python 3。
随后检查 Python 是否可用。
macOS 和 Linux
python3 --version
在 macOS 和许多 Linux 安装中，Python 3 的命令叫做 python3，而不是 python。因此在此手册中请始终使用 python3。
Windows
py --version
在 Windows 上通常用 py 启动 Python。
安装 Aider
根据 Aider 安装文档 的推荐安装方式，是通过 aider-install。
macOS 和 Linux
python3 -m pip install aider-install
aider-install
在 macOS 和 Linux 上也可以通过安装脚本安装 Aider：
curl -LsSf https://aider.chat/install.sh | sh
在 Windows 上可以通过 PowerShell：
py -m pip install aider-install
aider-install
或者使用安装脚本：
powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"
Aider 最适合在一个是 git 仓库的目录中使用。因此也请安装 git，最好让学生在带版本控制的项目文件夹中工作。
连接到 Coding
Aider 可以与 OpenAI 兼容的 API 一起工作。请使用 Coding 端点和 AI-School 的 API 密钥。
macOS 和 Linux
export OPENAI_API_BASE="https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1"
export OPENAI_API_KEY="你的-api-密钥"
Windows
setx OPENAI_API_BASE "https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1"
setx OPENAI_API_KEY "你的-api-密钥"
随后关闭终端并重新打开一个新的终端，以便 Windows 使用新变量。
启动 Aider
进入你的项目目录：
cd 路径/到/你的/项目
使用一个允许的模型启动 Aider。对于学生，建议使用 gpt-5.6-luna。
aider --model openai/gpt-5.6-luna
对于高级用户，可以选择更强的模型：
aider --model openai/gpt-5.6-terra
使用文件
在 Aider 中可以将文件添加到上下文：
/add src/main.py
随后请求帮助，例如：
你能解释为什么这个函数不起作用吗？
或：
把错误信息对用户说得更清楚。
常用命令
| 命令 | 含义 |
|---|---|
/add 文件 | 将一个文件添加到聊天中 |
/ask | 提问而不直接修改代码 |
/code | 请求 Aider 修改代码 |
/diff | 查看修改内容 |
/undo | 撤销上一次 AI 的修改 |
/exit | 退出 Aider |
给课堂的建议
请让学生使用 Aider 作为编程帮助，而不是自动解题机器。
合适的任务示例包括：
- “解释这个错误信息的含义。”
- “我现在应该研究哪一步？”
- “帮我把这个函数缩短。”
- “检查我的解法是否有逻辑问题。”
对初学者不太合适的例子：
- “把整份作业都做完。”
- “构建整个应用程序。”
- “全部自动解决。”
