跳到正文
funcoding.ai
← Aider

Aider · 自定义模型

Aider 配置自定义模型:OpenAI 兼容接口、Ollama 与配置文件

用 OPENAI_API_BASE 接入任意兼容服务,用 OLLAMA_API_BASE 连接本地模型,并通过 .aider.conf.yml 和 .aider.model.settings.yml 保存配置。

1 分钟读完

接入 OpenAI 兼容接口

设置接口地址和 Key,然后在模型名前加 openai/ 前缀:

Terminal window
export OPENAI_API_BASE=https://你的服务地址/v1
export OPENAI_API_KEY=<你的 Key>
aider --model openai/<模型名>

Windows 用 setx 设置环境变量:

Terminal window
setx OPENAI_API_BASE https://你的服务地址/v1
setx OPENAI_API_KEY <你的 Key>

连接 Ollama 本地模型

Terminal window
export OLLAMA_API_BASE=http://127.0.0.1:11434
aider --model ollama_chat/<模型名>

Ollama 默认的上下文窗口只有 2k tokens,对 Aider 来说太小了,务必按下面的方法调大。

模型参数:.aider.model.settings.yml

在项目根目录或用户主目录创建 .aider.model.settings.yml,为模型设置编辑格式和额外参数:

.aider.model.settings.yml
- name: ollama/deepseek-v3
edit_format: diff
extra_params:
num_ctx: 8192

保存常用配置:.aider.conf.yml

不想每次都输入一长串参数,可以写进 .aider.conf.yml:

.aider.conf.yml
model: openai/<模型名>
openai-api-base: https://你的服务地址/v1

API Key 建议放在环境变量或 .env 文件里,不要提交到 Git。

选择模型的建议

Aider 让模型直接输出编辑内容(diff 等格式),对模型遵循格式的能力要求较高。效果不理想时可以:

  • 换用在 Aider 排行榜上表现好的模型
  • 在 .aider.model.settings.yml 里调整 edit_format(如 whole、diff)