Aider 接入各类 LLM 完全指南主推模型、免费与本地模型的连接与模型选择【免费下载链接】aideraider is AI pair programming in your terminal项目地址: https://gitcode.com/GitHub_Trending/ai/aiderAider 是一款运行在终端里的 AI 结对编程工具它本身并不自带大模型而是通过各家的 API 或本地推理服务来驱动编码。本文将围绕 Aider 官方文档中的“Connecting to LLMs”枢纽页展开系统讲解官方主推的云端旗舰模型、免费模型与本地模型的接入方式并结合仓库源码说明模型命名、别名与元数据管理机制帮助你为终端结对编程选对并连对模型。Aider 的模型连接机制概览Aider 支持与绝大多数主流大模型连接。只要该模型满足两个条件即可模型能够通过某个 API 服务提供者被访问云端 SaaS API 或本地推理服务均可模型足够“擅长修改代码”也就是能稳定返回规范的code edits代码编辑结果。从仓库目录结构看官方文档把所有与“模型连接”相关的指南集中放在aider/website/docs/llms/下如anthropic.md、gemini.md、deepseek.md、openai.md、openrouter.md、ollama.md、openai-compat.md、azure.md、bedrock.md、vertex.md、xai.md等而llms.md则是这一整块内容的总览枢纽页用于回答“Aider 到底能连哪些模型、应该选哪些模型”。接入一个模型通常只需三步安装 Aider官方文档统一给出的安装命令为python -m pip install aider-install aider-install配置该提供商的 API Key及必要的端点环境变量通过环境变量或--api-key PROVIDERKEY命令行开关注入在代码仓库目录中启动 Aider并用--model provider/model指定要使用的模型Aider 也支持使用--list-models查询可用的模型列表。官方推荐的首选模型擅长“改代码”的模型Aider 官方在llms.md中明确列出了表现最佳、最适合代码编辑任务的四组模型读者可按需跳转到对应接入文档Gemini 2.5 ProDeepSeek R1 与 V3Claude 3.7 SonnetOpenAI o3、o4-mini 与 GPT-4.1注意上述名单来自文档推荐快照。模型的版本与可用性会持续演进Aider 源码中内置的别名与默认模型也可能随版本更新详见下文“模型别名”一节动手前建议用aider --list-models 前缀/确认当前账号可用的具体模型。接入 Gemini在 Gemini 接入文档 中官方给出的流程是先设置 API Key再在代码目录启动export GEMINI_API_KEYkey # Mac/Linux setx GEMINI_API_KEY key # Windows执行 setx 后需重启 shell随后进入你的代码仓库cd /to/your/project aider --model gemini # 官方文档提供的 Gemini 快捷方式 aider --model gemini-exp # Gemini 2.5 Pro Exp可免费使用有限额 aider --list-models gemini/ # 列出 Gemini 提供的全部可用模型接入 DeepSeekDeepSeek 的 Chat V3 模型曾在 Aider 的代码编辑基准测试中拿到最高分见 deepseek.md。接入时设置export DEEPSEEK_API_KEYkey # Mac/Linux setx DEEPSEEK_API_KEY key # Windows执行 setx 后需重启 shell然后在代码目录使用cd /to/your/project aider --model deepseek/deepseek-chat # DeepSeek Chat V3仓库中还有r1deepseek/deepseek-reasoner、deepseekdeepseek/deepseek-chat等内置别名可直接使用例如aider --model deepseek见 models.py 中的MODEL_ALIASES定义。接入 Anthropic ClaudeAnthropic 的接入支持两种方式设置ANTHROPIC_API_KEY环境变量或使用--anthropic-api-key命令行开关见 anthropic.mdexport ANTHROPIC_API_KEYkey # Mac/Linux setx ANTHROPIC_API_KEY key # Windows执行 setx 后需重启 shell启动方式cd /to/your/project aider # 配置了 Key 后Aider 默认使用 Claude 系列模型 aider --list-models anthropic/ # 列出 Anthropic 可用模型 aider --model 任意其他型号 # 例如 aider --model claude-3-opus-20240229官方文档同时提示Anthropic 的速率限制rate limits很低如果并发或配额受限可通过 OpenRouter 或 Google Vertex AI 访问 Anthropic 模型以获得更宽松的速率限制。此外Anthropic 官方文档中还展示了如何通过.aider.model.settings.yml配置 Claude 3.7 Sonnet 的 thinking tokens思考预算例如在模型设置文件中写入- name: anthropic/claude-3-7-sonnet-20250219 edit_format: diff weak_model_name: anthropic/claude-3-5-haiku-20241022 use_repo_map: true examples_as_sys_msg: true use_temperature: false extra_params: extra_headers: anthropic-beta: prompt-caching-2024-07-31,pdfs-2024-09-25,output-128k-2025-02-19 max_tokens: 64000 thinking: type: enabled budget_tokens: 32000 # 调整此值可改变思考 token 目标数量 cache_control: true editor_model_name: anthropic/claude-3-7-sonnet-20250219 editor_edit_format: editor-diff接入 OpenAIOpenAI 模型的 Key 可通过OPENAI_API_KEY环境变量或--api-key openaikey开关提供见 openai.mdexport OPENAI_API_KEYkey # Mac/Linux setx OPENAI_API_KEY key # Windows执行 setx 后需重启 shell启动示例cd /to/your/project aider --model o3-mini aider --model o1-mini aider --model gpt-4o aider --model gpt-4-0125-preview # 任何 OpenAI 模型均可通过 --model 指定 aider --list-models openai/ # 列出 OpenAI 可用模型OpenAI 的诸多“推理模型”reasoning models对流式输出和 temperature 参数有限制有的还支持不同档位的 reasoning effort。Aider 在官方各主流 API 通道下已为这些模型做好了适配并提供--reasoning-effort参数如果通过其他中转服务使用时遇到 temperature 或 system prompt 相关报错可参考 推理模型配置文档。免费模型接入路径llms.md指出Aider 可以与一批免费的 API 提供方协作OpenRouter 免费模型OpenRouter 提供大量可免费调用的模型每日用量有限额。接入文档见 openrouter.md做法是export OPENROUTER_API_KEYkey cd /to/your/project aider --model openrouter/provider/model aider --list-models openrouter/OpenRouter 同一模型往往由多家上游供应商托管文档还介绍了两种控制供应商选择的方式一是在 OpenRouter 账户设置中“忽略”某些供应商二是在.aider.model.settings.yml中通过extra_params.extra_body.provider配置 provider routing例如order、allow_fallbacks、data_collection、require_parameters等。Gemini 2.5 Pro ExpGoogle 的 Gemini 2.5 Pro Exp 实验版本可免费使用带用量限制实测与 Aider 协作表现很好用法即上文aider --model gemini-exp。本地模型接入路径本地模型意味着数据不出机器适合离线或隐私敏感场景。llms.md指出本地接入主要有两条路使用 Ollama或使用任何提供OpenAI 兼容 API的本地推理服务。通过 Ollama 接入本地模型在 ollama.md 中官方给出的流程是export OLLAMA_API_BASEhttp://127.0.0.1:11434 # Mac/Linux通常为默认地址 setx OLLAMA_API_BASE http://127.0.0.1:11434 # Windows执行 setx 后重启 shell然后拉取模型、启动 Ollama 服务端并进入代码仓库ollama pull model # 启动 ollama 服务端并把上下文窗口调到 8k token OLLAMA_CONTEXT_LENGTH8192 ollama serve # 另开一个终端窗口 cd /to/your/project aider --model ollama_chat/model官方明确建议使用ollama_chat/前缀而非ollama/。如果 Ollama 需要 API Key可额外设置OLLAMA_API_KEY。关于上下文窗口文档给出了一条关键的排错知识Ollama 默认上下文窗口只有 2k token对 Aider 来说太小而且它会“静默”丢弃超出窗口的内容——很多用户甚至没有意识到大部分上下文已被丢弃。为此 Aider 的默认行为是把每个请求所需上下文加上用于回复的 8k token 作为 Ollama 上下文窗口大小确保数据不被静默裁剪。如果你希望改用固定大小的上下文窗口可以通过.aider.model.settings.yml配置num_ctx例如- name: ollama/qwen2.5-coder:32b-instruct-fp16 extra_params: num_ctx: 65536通过 OpenAI 兼容 API 接入任意模型只要本地服务或其他服务暴露了 OpenAI 兼容的/v1/chat/completions风格端点Aider 就能连接见 openai-compat.md。接入时把端点配置到OPENAI_API_BASE并在模型名前加openai/前缀export OPENAI_API_BASEendpoint export OPENAI_API_KEYkey cd /to/your/project aider --model openai/model-nameWindows 下对应写法是setx OPENAI_API_BASE endpoint、setx OPENAI_API_KEY key且执行 setx 后需重启 shell。此外模型元数据上下文长度、价格等可通过--model-metadata-file默认.aider.model.metadata.json为“未知模型”补充见 args.py。模型的能力门槛为什么必须“擅长返回代码编辑”llms.md特别提醒用户务必选用有能力的模型。判断依据是 Aider 的 LLM 排行榜编辑基准等数据见aider/website/_data/下的 YAML 文件。典型故障现象是模型确实在“说话/返回代码”但 Aider 却始终无法把改动写入文件并提交。官方解释是这通常不是连接问题而是模型没有能力规范地返回 “code edits”——Aider 依赖模型以特定编辑格式给出代码修改模型越弱越容易在这一步出错。文档给出的经验阈值是弱于 GPT-3.5 的模型很可能无法顺畅配合 Aider 工作。若接入的是 Aider 尚未见过的模型官方文档建议阅读 模型警告说明ollama.md、openai-compat.md等均引用了该说明了解未知名模型在工作时可能产生的告警及其含义。源码视角模型命名、别名与元数据解析从源码看Aider 的模型连接体系主要由三块组成理解它们有助于排查“模型连不上/行为不对”类问题。1. 命名规则与内置别名models.pyAider 用provider/model的命名风格区分不同提供商的同名模型例如deepseek/deepseek-chat、openrouter/anthropic/claude-3.7-sonnet。不带前缀的裸名如gpt-4o、o3-mini则走默认 OpenAI 通道。同时 models.py 里定义了MODEL_ALIASES内置别名映射例如4/4o/4-turbo→ GPT 系列sonnet/haiku/opus→ Claude 系列deepseek→deepseek/deepseek-chatr1→deepseek/deepseek-reasonergemini/gemini-2.5-pro/gemini-3-pro-preview/gemini-exp→ Gemini 系列flash/flash-lite→ Gemini Flash 系列quasar/optimus/grok3等 → 各平台新模型因此直接用aider --model deepseek、aider --model sonnet即可命中对应模型。注意别名与模型版本的绑定会随版本迭代而变化以MODEL_ALIASES及aider --list-models的实际输出为准。别名的优先级为命令行--alias.aider.conf.yml中alias配置 内置别名详见 model-aliases.md。2. 模型参数与内置偏好资源文件中的model-settings.ymlAider 把各模型的默认行为是否使用 repo map、默认 edit format、温度、弱模型搭配等记录在包内资源中。在源码中通过ModelSettings数据类models.py读取并加载资源文件其核心字段包括字段含义edit_format该模型使用的编辑格式如whole、diff、editor-diffweak_model_name作为“弱模型”回退使用的伴生模型use_repo_map是否使用仓库地图repo mapextra_params透传给底层请求的额外参数如num_ctx、thinking、extra_headerscache_control是否启用 prompt 缓存控制use_temperature是否/以何值设置温度参数accepts_settings该模型接受哪些设置项用户侧同名覆盖文件默认是.aider.model.settings.yml--model-settings-file参数可改见 args.pyollama.md、anthropic.md、openrouter.md中的 YAML 示例都属于这类高级配置完整字段解释见 高级模型设置文档。3. 模型元数据缓存与查询命令Aider 会维护一份模型元数据库上下文窗口、token 价格等信息来规划上下文与成本ModelInfoManagermodels.py 起从 LiteLLM 维护的模型价格/上下文数据库拉取数据并按24 小时 TTL缓存在本机~/.aider/caches/model_prices_and_context_window.json对 OpenRouter 模型还会优先查询本地缓存的开源模型数据库。这让aider --list-models 部分名称命令源码位于 commands.py 的cmd_models能够给出可用的匹配模型也让未知模型也能获得基本元数据。模型选择、配置与日常排错建议综合官方文档与源码可以总结出以下可操作建议连接前先确认三件事对应的 API Key 环境变量是否正确命名遵循PROVIDER_API_KEY也可用--api-key PROVIDERKEY统一注入见 args.py自定义端点OPENAI_API_BASE、OLLAMA_API_BASE是否正确模型名/别名是否写对。选择模型时参考排行榜与--list-models先看 排行榜文档再用aider --list-models prefix/确认可用型号避免使用明显弱于 GPT-3.5 的模型否则会陷入“模型在回复、Aider 却无法落盘/提交”的经典陷阱。本地模型优先把上下文窗口调大牢记 Ollama 默认 2k 且静默丢上下文的风险让 Aider 自动按请求动态设定窗口或通过.aider.model.settings.yml的num_ctx固定大窗口。重视速率限制与供应商选择Anthropic 官方通道速率限制较低时可改走 OpenRouter 或 VertexOpenRouter 多供应商场景下可用 provider routing 精细控制路由。遇到未知名模型的告警先读警告文档对 Aider 不熟悉的模型官方会在运行时给出 模型警告推理模型的 temperature/system prompt 报错则优先检查 reasoning 配置。进一步阅读更多服务商接入Azure、Bedrock、Vertex、xAI、Groq、Cohere、LM Studio、GitHub Models 等见 llms 目录下的各页面模型别名速查表、高级模型设置配置总览 与 命令行参数参考网络、模型与 Key 相关故障排查见 troubleshooting【免费下载链接】aideraider is AI pair programming in your terminal项目地址: https://gitcode.com/GitHub_Trending/ai/aider创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Aider 接入各类 LLM 完全指南：主推模型、免费与本地模型的连接与模型选择
Aider 接入各类 LLM 完全指南主推模型、免费与本地模型的连接与模型选择【免费下载链接】aideraider is AI pair programming in your terminal项目地址: https://gitcode.com/GitHub_Trending/ai/aiderAider 是一款运行在终端里的 AI 结对编程工具它本身并不自带大模型而是通过各家的 API 或本地推理服务来驱动编码。本文将围绕 Aider 官方文档中的“Connecting to LLMs”枢纽页展开系统讲解官方主推的云端旗舰模型、免费模型与本地模型的接入方式并结合仓库源码说明模型命名、别名与元数据管理机制帮助你为终端结对编程选对并连对模型。Aider 的模型连接机制概览Aider 支持与绝大多数主流大模型连接。只要该模型满足两个条件即可模型能够通过某个 API 服务提供者被访问云端 SaaS API 或本地推理服务均可模型足够“擅长修改代码”也就是能稳定返回规范的code edits代码编辑结果。从仓库目录结构看官方文档把所有与“模型连接”相关的指南集中放在aider/website/docs/llms/下如anthropic.md、gemini.md、deepseek.md、openai.md、openrouter.md、ollama.md、openai-compat.md、azure.md、bedrock.md、vertex.md、xai.md等而llms.md则是这一整块内容的总览枢纽页用于回答“Aider 到底能连哪些模型、应该选哪些模型”。接入一个模型通常只需三步安装 Aider官方文档统一给出的安装命令为python -m pip install aider-install aider-install配置该提供商的 API Key及必要的端点环境变量通过环境变量或--api-key PROVIDERKEY命令行开关注入在代码仓库目录中启动 Aider并用--model provider/model指定要使用的模型Aider 也支持使用--list-models查询可用的模型列表。官方推荐的首选模型擅长“改代码”的模型Aider 官方在llms.md中明确列出了表现最佳、最适合代码编辑任务的四组模型读者可按需跳转到对应接入文档Gemini 2.5 ProDeepSeek R1 与 V3Claude 3.7 SonnetOpenAI o3、o4-mini 与 GPT-4.1注意上述名单来自文档推荐快照。模型的版本与可用性会持续演进Aider 源码中内置的别名与默认模型也可能随版本更新详见下文“模型别名”一节动手前建议用aider --list-models 前缀/确认当前账号可用的具体模型。接入 Gemini在 Gemini 接入文档 中官方给出的流程是先设置 API Key再在代码目录启动export GEMINI_API_KEYkey # Mac/Linux setx GEMINI_API_KEY key # Windows执行 setx 后需重启 shell随后进入你的代码仓库cd /to/your/project aider --model gemini # 官方文档提供的 Gemini 快捷方式 aider --model gemini-exp # Gemini 2.5 Pro Exp可免费使用有限额 aider --list-models gemini/ # 列出 Gemini 提供的全部可用模型接入 DeepSeekDeepSeek 的 Chat V3 模型曾在 Aider 的代码编辑基准测试中拿到最高分见 deepseek.md。接入时设置export DEEPSEEK_API_KEYkey # Mac/Linux setx DEEPSEEK_API_KEY key # Windows执行 setx 后需重启 shell然后在代码目录使用cd /to/your/project aider --model deepseek/deepseek-chat # DeepSeek Chat V3仓库中还有r1deepseek/deepseek-reasoner、deepseekdeepseek/deepseek-chat等内置别名可直接使用例如aider --model deepseek见 models.py 中的MODEL_ALIASES定义。接入 Anthropic ClaudeAnthropic 的接入支持两种方式设置ANTHROPIC_API_KEY环境变量或使用--anthropic-api-key命令行开关见 anthropic.mdexport ANTHROPIC_API_KEYkey # Mac/Linux setx ANTHROPIC_API_KEY key # Windows执行 setx 后需重启 shell启动方式cd /to/your/project aider # 配置了 Key 后Aider 默认使用 Claude 系列模型 aider --list-models anthropic/ # 列出 Anthropic 可用模型 aider --model 任意其他型号 # 例如 aider --model claude-3-opus-20240229官方文档同时提示Anthropic 的速率限制rate limits很低如果并发或配额受限可通过 OpenRouter 或 Google Vertex AI 访问 Anthropic 模型以获得更宽松的速率限制。此外Anthropic 官方文档中还展示了如何通过.aider.model.settings.yml配置 Claude 3.7 Sonnet 的 thinking tokens思考预算例如在模型设置文件中写入- name: anthropic/claude-3-7-sonnet-20250219 edit_format: diff weak_model_name: anthropic/claude-3-5-haiku-20241022 use_repo_map: true examples_as_sys_msg: true use_temperature: false extra_params: extra_headers: anthropic-beta: prompt-caching-2024-07-31,pdfs-2024-09-25,output-128k-2025-02-19 max_tokens: 64000 thinking: type: enabled budget_tokens: 32000 # 调整此值可改变思考 token 目标数量 cache_control: true editor_model_name: anthropic/claude-3-7-sonnet-20250219 editor_edit_format: editor-diff接入 OpenAIOpenAI 模型的 Key 可通过OPENAI_API_KEY环境变量或--api-key openaikey开关提供见 openai.mdexport OPENAI_API_KEYkey # Mac/Linux setx OPENAI_API_KEY key # Windows执行 setx 后需重启 shell启动示例cd /to/your/project aider --model o3-mini aider --model o1-mini aider --model gpt-4o aider --model gpt-4-0125-preview # 任何 OpenAI 模型均可通过 --model 指定 aider --list-models openai/ # 列出 OpenAI 可用模型OpenAI 的诸多“推理模型”reasoning models对流式输出和 temperature 参数有限制有的还支持不同档位的 reasoning effort。Aider 在官方各主流 API 通道下已为这些模型做好了适配并提供--reasoning-effort参数如果通过其他中转服务使用时遇到 temperature 或 system prompt 相关报错可参考 推理模型配置文档。免费模型接入路径llms.md指出Aider 可以与一批免费的 API 提供方协作OpenRouter 免费模型OpenRouter 提供大量可免费调用的模型每日用量有限额。接入文档见 openrouter.md做法是export OPENROUTER_API_KEYkey cd /to/your/project aider --model openrouter/provider/model aider --list-models openrouter/OpenRouter 同一模型往往由多家上游供应商托管文档还介绍了两种控制供应商选择的方式一是在 OpenRouter 账户设置中“忽略”某些供应商二是在.aider.model.settings.yml中通过extra_params.extra_body.provider配置 provider routing例如order、allow_fallbacks、data_collection、require_parameters等。Gemini 2.5 Pro ExpGoogle 的 Gemini 2.5 Pro Exp 实验版本可免费使用带用量限制实测与 Aider 协作表现很好用法即上文aider --model gemini-exp。本地模型接入路径本地模型意味着数据不出机器适合离线或隐私敏感场景。llms.md指出本地接入主要有两条路使用 Ollama或使用任何提供OpenAI 兼容 API的本地推理服务。通过 Ollama 接入本地模型在 ollama.md 中官方给出的流程是export OLLAMA_API_BASEhttp://127.0.0.1:11434 # Mac/Linux通常为默认地址 setx OLLAMA_API_BASE http://127.0.0.1:11434 # Windows执行 setx 后重启 shell然后拉取模型、启动 Ollama 服务端并进入代码仓库ollama pull model # 启动 ollama 服务端并把上下文窗口调到 8k token OLLAMA_CONTEXT_LENGTH8192 ollama serve # 另开一个终端窗口 cd /to/your/project aider --model ollama_chat/model官方明确建议使用ollama_chat/前缀而非ollama/。如果 Ollama 需要 API Key可额外设置OLLAMA_API_KEY。关于上下文窗口文档给出了一条关键的排错知识Ollama 默认上下文窗口只有 2k token对 Aider 来说太小而且它会“静默”丢弃超出窗口的内容——很多用户甚至没有意识到大部分上下文已被丢弃。为此 Aider 的默认行为是把每个请求所需上下文加上用于回复的 8k token 作为 Ollama 上下文窗口大小确保数据不被静默裁剪。如果你希望改用固定大小的上下文窗口可以通过.aider.model.settings.yml配置num_ctx例如- name: ollama/qwen2.5-coder:32b-instruct-fp16 extra_params: num_ctx: 65536通过 OpenAI 兼容 API 接入任意模型只要本地服务或其他服务暴露了 OpenAI 兼容的/v1/chat/completions风格端点Aider 就能连接见 openai-compat.md。接入时把端点配置到OPENAI_API_BASE并在模型名前加openai/前缀export OPENAI_API_BASEendpoint export OPENAI_API_KEYkey cd /to/your/project aider --model openai/model-nameWindows 下对应写法是setx OPENAI_API_BASE endpoint、setx OPENAI_API_KEY key且执行 setx 后需重启 shell。此外模型元数据上下文长度、价格等可通过--model-metadata-file默认.aider.model.metadata.json为“未知模型”补充见 args.py。模型的能力门槛为什么必须“擅长返回代码编辑”llms.md特别提醒用户务必选用有能力的模型。判断依据是 Aider 的 LLM 排行榜编辑基准等数据见aider/website/_data/下的 YAML 文件。典型故障现象是模型确实在“说话/返回代码”但 Aider 却始终无法把改动写入文件并提交。官方解释是这通常不是连接问题而是模型没有能力规范地返回 “code edits”——Aider 依赖模型以特定编辑格式给出代码修改模型越弱越容易在这一步出错。文档给出的经验阈值是弱于 GPT-3.5 的模型很可能无法顺畅配合 Aider 工作。若接入的是 Aider 尚未见过的模型官方文档建议阅读 模型警告说明ollama.md、openai-compat.md等均引用了该说明了解未知名模型在工作时可能产生的告警及其含义。源码视角模型命名、别名与元数据解析从源码看Aider 的模型连接体系主要由三块组成理解它们有助于排查“模型连不上/行为不对”类问题。1. 命名规则与内置别名models.pyAider 用provider/model的命名风格区分不同提供商的同名模型例如deepseek/deepseek-chat、openrouter/anthropic/claude-3.7-sonnet。不带前缀的裸名如gpt-4o、o3-mini则走默认 OpenAI 通道。同时 models.py 里定义了MODEL_ALIASES内置别名映射例如4/4o/4-turbo→ GPT 系列sonnet/haiku/opus→ Claude 系列deepseek→deepseek/deepseek-chatr1→deepseek/deepseek-reasonergemini/gemini-2.5-pro/gemini-3-pro-preview/gemini-exp→ Gemini 系列flash/flash-lite→ Gemini Flash 系列quasar/optimus/grok3等 → 各平台新模型因此直接用aider --model deepseek、aider --model sonnet即可命中对应模型。注意别名与模型版本的绑定会随版本迭代而变化以MODEL_ALIASES及aider --list-models的实际输出为准。别名的优先级为命令行--alias.aider.conf.yml中alias配置 内置别名详见 model-aliases.md。2. 模型参数与内置偏好资源文件中的model-settings.ymlAider 把各模型的默认行为是否使用 repo map、默认 edit format、温度、弱模型搭配等记录在包内资源中。在源码中通过ModelSettings数据类models.py读取并加载资源文件其核心字段包括字段含义edit_format该模型使用的编辑格式如whole、diff、editor-diffweak_model_name作为“弱模型”回退使用的伴生模型use_repo_map是否使用仓库地图repo mapextra_params透传给底层请求的额外参数如num_ctx、thinking、extra_headerscache_control是否启用 prompt 缓存控制use_temperature是否/以何值设置温度参数accepts_settings该模型接受哪些设置项用户侧同名覆盖文件默认是.aider.model.settings.yml--model-settings-file参数可改见 args.pyollama.md、anthropic.md、openrouter.md中的 YAML 示例都属于这类高级配置完整字段解释见 高级模型设置文档。3. 模型元数据缓存与查询命令Aider 会维护一份模型元数据库上下文窗口、token 价格等信息来规划上下文与成本ModelInfoManagermodels.py 起从 LiteLLM 维护的模型价格/上下文数据库拉取数据并按24 小时 TTL缓存在本机~/.aider/caches/model_prices_and_context_window.json对 OpenRouter 模型还会优先查询本地缓存的开源模型数据库。这让aider --list-models 部分名称命令源码位于 commands.py 的cmd_models能够给出可用的匹配模型也让未知模型也能获得基本元数据。模型选择、配置与日常排错建议综合官方文档与源码可以总结出以下可操作建议连接前先确认三件事对应的 API Key 环境变量是否正确命名遵循PROVIDER_API_KEY也可用--api-key PROVIDERKEY统一注入见 args.py自定义端点OPENAI_API_BASE、OLLAMA_API_BASE是否正确模型名/别名是否写对。选择模型时参考排行榜与--list-models先看 排行榜文档再用aider --list-models prefix/确认可用型号避免使用明显弱于 GPT-3.5 的模型否则会陷入“模型在回复、Aider 却无法落盘/提交”的经典陷阱。本地模型优先把上下文窗口调大牢记 Ollama 默认 2k 且静默丢上下文的风险让 Aider 自动按请求动态设定窗口或通过.aider.model.settings.yml的num_ctx固定大窗口。重视速率限制与供应商选择Anthropic 官方通道速率限制较低时可改走 OpenRouter 或 VertexOpenRouter 多供应商场景下可用 provider routing 精细控制路由。遇到未知名模型的告警先读警告文档对 Aider 不熟悉的模型官方会在运行时给出 模型警告推理模型的 temperature/system prompt 报错则优先检查 reasoning 配置。进一步阅读更多服务商接入Azure、Bedrock、Vertex、xAI、Groq、Cohere、LM Studio、GitHub Models 等见 llms 目录下的各页面模型别名速查表、高级模型设置配置总览 与 命令行参数参考网络、模型与 Key 相关故障排查见 troubleshooting【免费下载链接】aideraider is AI pair programming in your terminal项目地址: https://gitcode.com/GitHub_Trending/ai/aider创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考