Qwen3-Coder 配套 Aider 指南连接各大 LLM 实现 AI 结对编程【免费下载链接】Qwen3-CoderQwen3-Coder is the code version of Qwen3, the large language model series developed by Qwen team.项目地址: https://gitcode.com/GitHub_Trending/co/Qwen3-CoderAider 是一款面向 AI 结对编程的命令行工具其核心能力是与任意主流大语言模型对接在终端里完成读代码—改代码—自动提交的完整闭环。本指南以当前仓库内 Aider 的官方文档 llms.md 为主体结合 args.py、llm.py、models.py 等源码与docs/llms/目录下各提供商子文档系统讲解如何为 Aider 配置 OpenAI、Anthropic、DeepSeek、Gemini、Groq、Cohere 等云模型以及 Ollama、OpenAI 兼容接口等本地模型。读完本文你将掌握 Aider 全部主流模型的接入方式、命令行快捷键与排查模型能力不足的通用思路。Aider 为什么能连接几乎所有 LLMAider 本身不直接实现各家厂商的 HTTP 接口而是通过 Python 生态中成熟的litellm库统一接入数百个模型提供商。这一点可以从 llm.py 的源码得到印证aider/llm.py中通过LazyLiteLLM类对litellm做了延迟导入注释明确说明import litellm需要约 1.5 秒因此推迟到真正使用时才加载并设置了LITELLM_MODE PRODUCTION、drop_params True等全局参数这意味着只要一个模型能通过 litellm 访问无论来自官方 API、代理网关还是本地服务Aider 就能以统一的--model 模型名方式使用它。因此接入模型的路径可以概括为三条官方托管模型OpenAI、Anthropic、DeepSeek、Google 等设置对应的 API Key 环境变量后直接使用免费 API 提供商Gemini、Groq、Cohere 等零成本体验代码编辑能力本地模型通过 Ollama 或任何 OpenAI 兼容 API 服务如 vLLM、LocalAI 等加载私有模型。Aider 官方还维护了一份针对代码编辑能力的模型排行榜见 leaderboards/index.md用于判断哪些模型最适合结对编程。最佳模型官方推荐的代码编辑主力Aider 在文档中明确推荐四款擅长编辑代码的模型GPT-4o、Claude 3.5 Sonnet、Claude 3 Opus 与 DeepSeek Coder V2。它们均经过 Aider 的代码编辑基准测试验证并内置了命令行快捷键。OpenAIGPT-4o 与 GPT 系列OpenAI 模型的接入需要OPENAI_API_KEY环境变量或使用--openai-api-key命令行开关。官方文档 openai.md 给出了完整流程python -m pip install aider-chat export OPENAI_API_KEYkey # Mac/Linux setx OPENAI_API_KEY key # Windows执行 setx 后需重启 shell # Aider 默认使用 gpt-4o等价于 --4o aider # GPT-4 Turbo (1106) aider --4-turbo # GPT-3.5 Turbo aider --35-turbo # 列出 OpenAI 可用模型 aider --list-models openai/在 args.py 的源码中可以看到这些快捷键的落地实现--4o被映射为gpt-4o-2024-08-06--4-turbo、--35-turbo均有对应的具体模型 ID。若需使用特定版本的模型如gpt-4-0125-preview直接用aider --model 模型名即可覆盖默认值。AnthropicClaude 3.5 Sonnet 与 OpusAnthropic 模型需要ANTHROPIC_API_KEY环境变量或--anthropic-api-key开关。文档 anthropic.md 的流程如下python -m pip install aider-chat export ANTHROPIC_API_KEYkey # Mac/Linux setx ANTHROPIC_API_KEY key # Windows # Aider 默认使用 Claude 3.5 Sonnet等价于 --sonnet aider # Claude 3 Opus aider --opus # 列出 Anthropic 可用模型 aider --list-models anthropic/同样在 args.py 中可以确认--sonnet映射到claude-3-5-sonnet-20240620--opus映射到claude-3-opus-20240229。需要特别提醒Anthropic 官方的速率限制rate limit较低。如果你需要更宽松的调用额度官方文档建议改走 OpenRouter 或 Google Vertex AI见 vertex.md来访问同款 Claude 模型。DeepSeek基准测试高分选手DeepSeek Coder V2 在 Aider 的代码编辑基准测试中拿到了高分接入方式见 deepseek.mdpython -m pip install aider-chat export DEEPSEEK_API_KEYkey # Mac/Linux setx DEEPSEEK_API_KEY key # Windows # 使用 DeepSeek Coder V2 aider --deepseek在 args.py 中--deepseek被映射为deepseek/deepseek-coder——注意这个带deepseek/前缀的模型名它正是 litellm 的提供商命名规范说明 DeepSeek 也是经由 litellm 接入的。免费模型零成本体验 AI 结对编程Aider 文档列出了三个提供免费API 的提供商适合低成本试用或教学场景。Google Gemini 1.5 ProGemini 1.5 Pro 是文档中提到的功能最强的免费模型代码编辑能力与 GPT-3.5 相当。接入方式见 gemini.mdpython -m pip install aider-chat export GEMINI_API_KEYkey # Mac/Linux setx GEMINI_API_KEY key # Windows aider --model gemini/gemini-1.5-pro-latest # 列出 Gemini 可用模型 aider --list-models gemini/Groq 托管的 Llama 3 70BGroq 对其托管的模型提供免费 API其中 Llama 3 70B 的代码编辑表现与 GPT-3.5 相当。见 groq.mdpython -m pip install aider-chat export GROQ_API_KEYkey # Mac/Linux setx GROQ_API_KEY key # Windows aider --model groq/llama3-70b-8192 # 列出 Groq 可用模型 aider --list-models groq/Cohere Command-RCohere 同样提供免费 API但其 Command-R 模型在 Aider 中只能充当非常基础的编码助手文档原话为very basiccoding assistant。见 cohere.mdpython -m pip install aider-chat export COHERE_API_KEYkey # Mac/Linux setx COHERE_API_KEY key # Windows aider --model command-r-plus # 列出 Cohere 可用模型 aider --list-models cohere_chat/本地模型Ollama 与 OpenAI 兼容 API通过 Ollama 使用本地模型Ollama 是目前最流行的本地模型运行方式之一。官方文档 ollama.md 给出的流程包含三个步骤拉取模型、启动服务、连接 Aider# 拉取模型 ollama pull model # 启动 ollama 服务 ollama serve # 另开一个终端窗口... python -m pip install aider-chat export OLLAMA_API_BASEhttp://127.0.0.1:11434 # Mac/Linux setx OLLAMA_API_BASE http://127.0.0.1:11434 # Windowssetx 后重启 shell aider --model ollama/model文档特别指出llama3:70b与 Aider 配合良好完整示例为ollama pull llama3:70b ollama serve # 在另一个终端窗口... export OLLAMA_API_BASEhttp://127.0.0.1:11434 aider --model ollama/llama3:70bOLLAMA_API_BASE默认指向本地 11434 端口如果你在别的机器或端口上启动了 Ollama 服务修改该环境变量即可。任意 OpenAI 兼容 API任何提供 OpenAI 兼容接口的 LLM 服务都可以接入 Aider方式见 openai-compat.mdpython -m pip install aider-chat # Mac/Linux: export OPENAI_API_BASEendpoint export OPENAI_API_KEYkey # Windows: setx OPENAI_API_BASE endpoint setx OPENAI_API_KEY key # ... 执行 setx 后重启 shell # 模型名加上 openai/ 前缀 aider --model openai/model-name这套方案让 Aider 可以对接 vLLM、LocalAI、本地推理网关等自建服务是数据不出内网场景下的常用接入路径。其他数百种模型litellm 与 --list-models除了上述官方推荐与免费/本地方案Aider 借助 litellm 还能访问数百个其他模型。文档 other.md 给出了探索方式使用aider --list-models 名称片段模糊搜索。如果传入的名称不是已知模型的精确匹配Aider 会返回候选列表。文档中的示例输出节选$ aider --list-models turbo Aider v0.29.3-dev Models which match turbo: - gpt-4-turbo-preview (openai/gpt-4-turbo-preview) - gpt-4-turbo (openai/gpt-4-turbo) - gpt-4-turbo-2024-04-09 (openai/gpt-4-turbo-2024-04-09) - gpt-3.5-turbo (openai/gpt-3.5-turbo) - ...这一功能在源码层面由 models.py 的fuzzy_match_models与print_matching_models实现同时register_models/register_litellm_models负责在启动时加载内置模型清单与 litellm 模型元数据。常见 API Key 环境变量一览由于模型接入统一走 litellm不同提供商所需的密钥也遵循统一的*_API_KEY命名规范。other.md中整理的主要变量包括环境变量对应提供商OPENAI_API_KEYOpenAIANTHROPIC_API_KEYAnthropicDEEPSEEK_API_KEYDeepSeekGEMINI_API_KEYGoogle GeminiGROQ_API_KEYGroqCOHERE_API_KEY/CO_API_KEYCohereOLLAMA_API_BASE/OLLAMA_API_KEYOllamaOPENROUTER_API_KEY/OR_API_KEYOpenRouterMISTRAL_API_KEYMistralAZURE_OPENAI_API_KEY/AZURE_API_KEYMicrosoft AzureREPLICATE_API_KEY、TOGETHER_API_KEY、FIREWORKS_API_KEY等对应聚合/推理平台完整清单可直接查阅 other.md 中的Other API key variables一节。需要说明的是该清单由脚本从 litellm 源码自动提取生成具体每个变量的适用场景仍以 litellm 官方文档为准。模型能力不足时怎么办理解 Aider 的编辑机制Aider 对模型有一个硬性要求模型必须能够正确返回代码编辑结果。文档在Use a capable model一节中给出了重要提示Aider 可能无法与能力较弱的模型良好协作。如果你看到模型返回了代码但 Aider 却无法编辑文件并提交更改……这通常是因为该模型无法正确返回代码编辑。弱于 GPT 3.5 的模型在使用 Aider 时可能会出现问题。这一现象的本质在于 Aider 的协作架构它并不是简单地把整个文件重写一遍而是要求模型以特定的编辑格式如 editblock、diff 等输出修改片段再由本地代码解析后精准应用到文件中。从源码结构看base_coder.py 中的get_edits/apply_edits、以及 editblock_coder.py 对模型输出的解析与容错匹配都依赖模型对编辑指令的理解能力。能力不足的模型常常返回自然语言描述或残缺代码块导致解析失败。因此选择模型时的核心建议是优先参考 Aider 的模型排行榜见 leaderboards/index.md它直接反映各模型在真实代码编辑任务上的表现避开弱于 GPT-3.5 的模型尤其是那些只聊天、不会按格式输出编辑的模型关注模型警告当使用 Aider 不熟悉的模型时启动阶段会打印警告信息详见 warnings.md用于提示该模型可能存在的兼容性风险。小结按场景选择接入方式追求最佳编辑效果优先 GPT-4oaider默认或--4o、Claude 3.5 Sonnet--sonnet、Claude 3 Opus--opus、DeepSeek Coder V2--deepseek零成本试用Gemini 1.5 Pro、Groq 上的 Llama 3 70B以及定位基础助手的 Cohere Command-R本地/私有化部署OLLAMA_API_BASE--model ollama/model或OPENAI_API_BASE--model openai/model-name对接任意 OpenAI 兼容服务长尾模型探索aider --list-models 关键词模糊匹配再通过--model指定。所有方案共用一个统一入口--model 模型名底层由 litellm 完成协议适配只要模型具备输出代码编辑格式的能力Aider 就能自动完成文件的修改与 Git 提交。结合本仓库 qwencoder-eval/instruct/aider/aider 目录下的完整源码与文档你可以进一步研究各编辑格式见 editing-format.md与 配置文档搭建完全适配自己工作流的 AI 结对编程环境。【免费下载链接】Qwen3-CoderQwen3-Coder is the code version of Qwen3, the large language model series developed by Qwen team.项目地址: https://gitcode.com/GitHub_Trending/co/Qwen3-Coder创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考