Aider
Aider 是一个运行在终端里的 AI 结对编程工具。它适合在 Git 项目中针对指定文件进行修改、解释、调试和重构,并通过 diff 展示改动。
对于使用 Xikapi 的用户,Aider 可以通过 OpenAI 兼容环境变量接入 https://xikapi.com/v1。模型名需要使用 openai/模型名 的形式传给 Aider。
Aider 有什么用
| 场景 | Aider 可以做什么 |
|---|---|
| 小范围修复 | 指定 1 到 3 个文件,让 Aider 直接修改 |
| 终端开发 | 不离开命令行完成问答、改代码、看 diff |
| Git 工作流 | 基于当前仓库理解上下文,便于复查和回滚 |
| 测试补充 | 让 Aider 修改代码并运行测试命令 |
| 文档更新 | 让 Aider 同步 README、配置说明、注释 |
| 脚本化任务 | 配合 shell 管道、CI 或远程服务器使用 |
Aider 的优势是轻量、直接、适合终端用户。它不依赖编辑器插件,也不需要复杂 UI。
文档入口
适合哪些人
- 经常在终端里开发的用户。
- 想让 AI 聚焦少量文件做精确修改的开发者。
- 习惯 Git diff / commit 工作流的团队。
- 在服务器、WSL、SSH 环境中开发的人。
如果你希望在编辑器里点击使用,优先看 Cline 或 Continue。
推荐接入顺序
- 完成 安装指南。
- 按 配置 Xikapi 模型 设置环境变量。
- 在 Git 仓库中添加少量文件。
- 先做只读解释,再执行修改。
- 用
/diff、/undo和测试命令控制风险。
参考链接
新手验收清单
开始前
- 从 Xikapi 控制台复制 API Key 和一个当前可用的模型 ID;不要猜测或照抄其他工具页的模型名。
- 先完成 1 分钟首次调用,确认 Key、模型和网络本身可用。
- 打开本工具的“配置 Xikapi 模型”页面。字段名称可能不同,但必须以该页规定的 provider、地址和模型格式为准。
配置完成的标志
- 使用纯文本测试消息或最小任务得到正常回复。
- 没有
401、403、404或model not found。 - 再单独打开流式输出、图片、工具调用、知识库或自动化等高级能力;不要一次全开。
密钥、版本与求助
- API Key 只放在工具的私密设置、环境变量或服务端 Secret 中;不要导出、提交或截图完整 Key。
- 工具版本不同会改变字段名称和界面位置。遇到差异时,优先查看本页末尾的官方文档,再参考本工具的报错页。
- 求助时提供工具版本、模型 ID、状态码和已打码错误文本;完整 Key、Token、Cookie 和私人资料不应发送。