Aider 接入指引 (终端 AI 结对编程)

Aider 是一款广受好评的终端命令行 AI 结对编程神器。它直接在本地 Git 仓库中运行，能够自动分析工程文件关系、跨文件编辑代码，并在每次修改后自动生成结构规范的 Git Commit。

通过 GWLLM，您可以使用 claude-sonnet-5-5、gpt-6-sol 等旗舰代码模型驱动 Aider，让终端编码效率提升数倍。

---

安装 Aider

推荐使用 Python 的 pip 或 pipx 进行安装：

# 使用 pip 全局安装
python -m pip install aider-chat

# 或使用 pipx 隔离环境运行（推荐）
pipx install aider-chat

---

配置与启动

Aider 原生支持 OpenAI 兼容网关。在任意 Git 仓库目录下，配置环境变量并启动即可：

1. 推荐启动命令（搭配 Claude Sonnet 5.5）

export OPENAI_API_BASE="https://gwllm.com/v1"
export OPENAI_API_KEY="sk-您的GWLLM令牌"

# 注意：Aider 使用 `OPENAI_API_BASE`，与 OpenAI SDK 的 `OPENAI_BASE_URL` 不同，不要混用

# 启动 aider，指定通过 OpenAI 协议请求
aider --model openai/claude-sonnet-5-5

2. 高性价比方案（搭配 GPT-6 Sol）

export OPENAI_API_BASE="https://gwllm.com/v1"
export OPENAI_API_KEY="sk-您的GWLLM令牌"

# 启动并使用 gpt-6-sol
aider --model openai/gpt-6-sol

---

配置文件永久保存（可选）

如果您希望每次进入项目无需重复配置环境变量，可以在用户主目录下创建 ~/.aider.conf.yml 文件：

openai-api-base: https://gwllm.com/v1
openai-api-key: sk-您的GWLLM令牌
model: openai/claude-sonnet-5-5
auto-commits: true

保存后，后续在任意 Git 项目下只需敲击 aider 命令即可直接进入会话。

---

常用命令与交互技巧

• /add <文件路径>：将指定文件加入本次编辑的上下文；
• /drop <文件路径>：将文件移出上下文，节省 Token 消耗；
• /undo：撤销上一步 AI 所做的代码改动与自动 Git 提交；
• /diff：查看 AI 当前准备修改的代码差异；
• /tokens：查看当前上下文消耗的 Token 总量。