Aider

​

配置

​

1. 安装 Aider

python -m pip install aider-install && aider-install

uv tool install --force --python python3.12 --with pip aider-chat@latest

​

2. 配置模型

model: openai/glm-5.2
openai-api-base: https://api.siflow.cn/model-api/v1
openai-api-key: <Your API Key>

• 本文配置以 glm-5.2 模型为例。glm-5.2 等推理模型可能会在最终回复前输出 reasoning content，体感速度可能更慢。如果更看重速度，可以切换到非推理模型。
• 模型名称中的 openai/ 为固定前缀，使得请求走 Aider 的 OpenAI-compatible 集成。不存在 siflow_ 前缀的变体。
• 如果只想在当前会话中配置，也可以设置 OPENAI_API_BASE 和 OPENAI_API_KEY，然后运行 aider --model openai/glm-5.2。新的终端会话会丢失这些 export。
• 除了 ~/.aider.conf.yml，OPENAI_API_BASE 和 OPENAI_API_KEY 也可以放在 .env 文件中。Aider 会依次搜索 home 目录、git repo 根目录和当前目录；后查到的位置优先级更高。

cd <your-project>
aider

​

3. 清除“unknown model”告警

Warning for openai/glm-5.2: Unknown context window size and costs, using sane defaults. Did you mean openai/gpt-5.2?

{
  "openai/glm-5.2": {
    "max_tokens": 8192,
    "max_input_tokens": 131072,
    "max_output_tokens": 8192,
    "input_cost_per_token": 0,
    "output_cost_per_token": 0,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}

• litellm_provider 字段必须与模型名称中的前缀一致。Aider 会在 home 目录、git repo 根目录和当前目录中查找该文件；后查到的位置优先级更高。也可以显式传入 --model-metadata-file <path>。
• 请根据模型的实际上下文窗口调整 max_input_tokens。

​

验证

aider --model openai/glm-5.2 --message "say ok" --no-git --yes-always

​

其他模式

• One-shot：--message "<task>" 发送一条指令、应用结果并退出，适合脚本化任务。
• Browser UI：aider --browser 在浏览器中运行 Aider。该模式是 experimental。
• Watch mode：aider --watch-files 会监听 repo 中的 AI comments。例如，在文件中写入 // add a factorial() function ai!，Aider 会识别该请求。AI! 请求修改，AI? 用于提问。