Qwen3-Coder 仓库实战Aider 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导读本指南以 Qwen3-Coder 开源仓库内附带的 aider 工具官方安装文档install.md为骨架系统讲解在本地、容器与云端开发环境中安装 aider 的全部途径。aider 是运行在终端里的 AI 结对编程工具能够直接在你的 Git 仓库中读取代码、生成修改并自动提交本仓库将其作为 Instruct 评测体系中 AI 编码能力验证的一环收录。读完本文你将掌握pip/pipx/docker三种主流安装方式、API Key 配置、可选功能网页抓取、语音编码的启用方法以及如何通过python -m aider解决命令找不到的常见问题。一分钟快速开始根据文档的快速上手指引见 get-started.md你只需要三条命令就能跑起来# 1. 安装 aider python -m pip install aider-chat # 2. 进入你的 Git 仓库 cd /to/your/git/repo # 3. 与 Claude 3.5 Sonnet 在你的仓库上结对编程 export ANTHROPIC_API_KEYyour-key-goes-here aider # 或者使用 GPT-4o export OPENAI_API_KEYyour-key-goes-here aider安装完成后aider 会读取当前 Git 仓库的全部代码你可以用自然语言提出修改需求它会生成 diff 并在你确认后自动提交。值得注意的是aider 的启动入口在仓库源码中也能找到印证main.py 通过from .main import main将main()暴露为命令行入口因此无论通过哪种方式安装最终都会走到 main.py 中的参数解析与交互循环。命令找不到怎么办部分环境中执行aider会报aider command not found错误详见 python-m-aider.md。这是因为 Python 的 Scripts 目录未加入 PATH。此时改用模块方式调用即可python -m aiderpython -m方式直接通过 Python 解释器加载main.py 入口不依赖可执行脚本的 PATH 配置是排查此类问题的首选后备方案。安装前的准备git 与 API Key在开始安装前请确认两个前提详见 完整安装指南1. git 已安装。aider 的核心工作流建立在 Git 之上——它每次修改前会检查仓库状态、生成 diff、并替你创建提交。请确保git --version可用。2. 拥有对应模型的 API Key。使用 OpenAI 的 GPT-4o / GPT-3.5 系列需要付费的 OpenAI API Key。注意它与 ChatGPT Plus 订阅是两回事——你是在以 API 方式按量付费调用模型而非使用订阅额度。使用 Anthropic 的 Claude 系列需要付费的 Anthropic API Key。API Key 可以在启动命令中临时指定也可以借助.env文件持久化见下文可选步骤。Mac / Linux / Windows 安装三者的安装步骤完全一致文档中给出了完全相同的命令差异仅在于你后续调用的是哪家模型# 安装 aider python -m pip install aider-chat # 使用 GPT-4o $ aider --4o --openai-api-key sk-xxx... # 使用 Claude 3.5 Sonnet $ aider --sonnet --anthropic-api-key sk-xxx...--4o与--sonnet是 aider 内置的模型快捷别名--openai-api-key/--anthropic-api-key则用于直接注入密钥适合不想设置环境变量的场景。如果同样遇到aider command not found请使用python -m aider作为替代。提示文档强烈建议在 Python 虚拟环境。虚拟环境可以隔离依赖避免污染系统 Pythonpipx 则面向只想装一次、全局可用的场景。关于其他 LLM 的支持aider 与 GPT-4o、Claude 3.5 Sonnet 配合效果最佳同时也能连接几乎任何 LLM见 works-best.md。在本仓库中aider 作为 Qwen3-Coder Instruct 评测的一环被集成说明该工具天然支持接入第三方模型服务端点如果你要接入自部署模型可在 aider 配置中指定自定义 API base 与模型名并参考仓库内 llms.md 的模型接入说明。用 pipx 安装彻底规避 Python 依赖冲突如果你用 aider 开发 Python 项目项目自身的依赖可能与 aider 产生冲突。例如当项目锁定somepackageX.Y.Z而 aider 需要U.W.V时python -m pip install会直接报错aider-chat 0.23.0 requires somepackageX.Y.Z, but you have somepackage U.W.V which is incompatible.解决方案是改用 pipx。pipx 会把 aider 装进独立于系统与项目的专用 Python 环境中从此你可以用 aider 处理任何 Python 项目即使依赖互相冲突也不受影响pipx install aider-chatpipx 在 Replit 上的特殊处理在 Replit 的 shell 中需要显式先装 pipx再用pipx run运行pip install pipx pipx run aider-chat ...normal aider args...注意在 Replit 上若用 pipx 安装后直接执行aider会因缺少libstdc.so.6库而崩溃必须使用pipx run形式。用 Docker 安装免环境依赖的隔离运行aider 提供两个官方镜像详见 docker.md镜像说明paulgauthier/aider核心版体积小适合快速上手paulgauthier/aider-full完整版预装全部可选扩展交互式帮助、浏览器 GUI、Playwright 网页抓取等核心镜像同样可以使用这些扩展功能但首次访问时需临时安装由于容器是临时的下次启动核心容器时需要重新安装。核心版启动docker pull paulgauthier/aider docker run -it --user $(id -u):$(id -g) --volume $(pwd):/app paulgauthier/aider --openai-api-key $OPENAI_API_KEY [...other aider args...]完整版启动docker pull paulgauthier/aider-full docker run -it --user $(id -u):$(id -g) --volume $(pwd):/app paulgauthier/aider-full --openai-api-key $OPENAI_API_KEY [...other aider args...]使用要点与限制必须在 Git 仓库根目录执行上述命令--volume $(pwd):/app将当前目录映射进容器只有身处仓库根目录aider 才能看到完整仓库与全部文件。容器内没有你的全局 git 配置请先补齐用户名与邮箱否则无法提交git config user.email youexample.com git config user.name Your Name/run命令在容器内执行在对话中使用/run运行 shell 命令时命令实际执行于容器内部而非你的本地环境对需要宿主机环境的测试可能不便。/voice语音命令受限容器内已预装libportaudio2但除非你将宿主机的音频设备透传给容器否则语音功能无法工作。在 GitHub Codespaces 中使用aider 可以直接在 GitHub Codespaces 内置的 Terminal 面板中使用详见 codespaces.md无需额外搭建环境。进入 Codespaces 后在终端中按前述快速开始的三步操作即可安装aider-chat、进入 Git 仓库目录、设置 API Key 后运行aider。Codespaces 本身已具备 git 与 Python 环境是免本地配置的快速体验途径。可选安装步骤让 aider 更强大以下步骤全部可选详见 optional.md按需启用即可。1. 用 .env 文件存储 API Key把 API Key 写入.env文件之后每次运行 aider 都会自动加载无需重复导出ANTHROPIC_API_KEYsk-xxx... OPENAI_API_KEYsk-xxx...具体格式与加载机制可参考仓库内的 config 文档 及其对应配置目录docs/config其中包含环境变量键名与配置文件语法的完整说明。2. 启用 Playwright 网页抓取aider 支持用/web url命令把网页加入对话工具会抓取并解析页面内容。默认使用httpx库抓取但它只能处理部分网页——有些站点显式屏蔽httpx类请求有些则依赖 JavaScript 渲染内容。要让绝大多数网页都能正常抓取请安装 Playwright 的 Chromium 浏览器及系统依赖playwright install --with-deps chromium3. 启用语音编码aider 支持通过/voice命令用语音编码详见 usage/voice底层依赖 PortAudio 库采集音频。PortAudio 完全可选安装方式因系统而异Windows无需安装Macbrew install portaudioLinuxsudo apt-get install libportaudio24. 集成到编辑器aider 已有社区插件集成到部分 IDE但插件未必同步最新版本官方建议的方式是在终端中与编辑器并排运行最新版 aider。已知集成情况包括NeoVim 插件、VS Code 插件且 aider 能自动检测是否运行在 VS Code 终端内并关闭彩色输出VS Code 终端对颜色支持不佳。5. 安装开发版想体验最新开发特性可直接从源码安装python -m pip install --upgrade githttps://github.com/paul-gauthier/aider.git如果已克隆 aider 仓库还可热加载本地副本适合自行开发 aider、让改动立即生效python -m pip install -e .本仓库内收录的 aider 即为开发版形态其版本号由 setuptools_scm 自动生成见version.py当前对应版本为0.55.1.dev59g2663233b0.55.1 开发分支第 59 次提交。安装完成后的下一步至此 aider 已就绪。如果你还需要深入了解对话交互与/run、/web、/voice等聊天命令可阅读 usage 目录 下的使用文档遇到模型连接、依赖或命令执行问题可对照 troubleshooting.md 排查。在本仓库的 Qwen3-Coder 评测体系里aider 正是通过这套安装与运行流程被用来驱动大模型在真实 Git 仓库中完成编码任务从而量化模型的代码修改与工具调用能力。【免费下载链接】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），仅供参考 Qwen3-Coder 仓库实战：Aider AI 结对编程工具的完整安装与配置指南
Qwen3-Coder 仓库实战Aider 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导读本指南以 Qwen3-Coder 开源仓库内附带的 aider 工具官方安装文档install.md为骨架系统讲解在本地、容器与云端开发环境中安装 aider 的全部途径。aider 是运行在终端里的 AI 结对编程工具能够直接在你的 Git 仓库中读取代码、生成修改并自动提交本仓库将其作为 Instruct 评测体系中 AI 编码能力验证的一环收录。读完本文你将掌握pip/pipx/docker三种主流安装方式、API Key 配置、可选功能网页抓取、语音编码的启用方法以及如何通过python -m aider解决命令找不到的常见问题。一分钟快速开始根据文档的快速上手指引见 get-started.md你只需要三条命令就能跑起来# 1. 安装 aider python -m pip install aider-chat # 2. 进入你的 Git 仓库 cd /to/your/git/repo # 3. 与 Claude 3.5 Sonnet 在你的仓库上结对编程 export ANTHROPIC_API_KEYyour-key-goes-here aider # 或者使用 GPT-4o export OPENAI_API_KEYyour-key-goes-here aider安装完成后aider 会读取当前 Git 仓库的全部代码你可以用自然语言提出修改需求它会生成 diff 并在你确认后自动提交。值得注意的是aider 的启动入口在仓库源码中也能找到印证main.py 通过from .main import main将main()暴露为命令行入口因此无论通过哪种方式安装最终都会走到 main.py 中的参数解析与交互循环。命令找不到怎么办部分环境中执行aider会报aider command not found错误详见 python-m-aider.md。这是因为 Python 的 Scripts 目录未加入 PATH。此时改用模块方式调用即可python -m aiderpython -m方式直接通过 Python 解释器加载main.py 入口不依赖可执行脚本的 PATH 配置是排查此类问题的首选后备方案。安装前的准备git 与 API Key在开始安装前请确认两个前提详见 完整安装指南1. git 已安装。aider 的核心工作流建立在 Git 之上——它每次修改前会检查仓库状态、生成 diff、并替你创建提交。请确保git --version可用。2. 拥有对应模型的 API Key。使用 OpenAI 的 GPT-4o / GPT-3.5 系列需要付费的 OpenAI API Key。注意它与 ChatGPT Plus 订阅是两回事——你是在以 API 方式按量付费调用模型而非使用订阅额度。使用 Anthropic 的 Claude 系列需要付费的 Anthropic API Key。API Key 可以在启动命令中临时指定也可以借助.env文件持久化见下文可选步骤。Mac / Linux / Windows 安装三者的安装步骤完全一致文档中给出了完全相同的命令差异仅在于你后续调用的是哪家模型# 安装 aider python -m pip install aider-chat # 使用 GPT-4o $ aider --4o --openai-api-key sk-xxx... # 使用 Claude 3.5 Sonnet $ aider --sonnet --anthropic-api-key sk-xxx...--4o与--sonnet是 aider 内置的模型快捷别名--openai-api-key/--anthropic-api-key则用于直接注入密钥适合不想设置环境变量的场景。如果同样遇到aider command not found请使用python -m aider作为替代。提示文档强烈建议在 Python 虚拟环境。虚拟环境可以隔离依赖避免污染系统 Pythonpipx 则面向只想装一次、全局可用的场景。关于其他 LLM 的支持aider 与 GPT-4o、Claude 3.5 Sonnet 配合效果最佳同时也能连接几乎任何 LLM见 works-best.md。在本仓库中aider 作为 Qwen3-Coder Instruct 评测的一环被集成说明该工具天然支持接入第三方模型服务端点如果你要接入自部署模型可在 aider 配置中指定自定义 API base 与模型名并参考仓库内 llms.md 的模型接入说明。用 pipx 安装彻底规避 Python 依赖冲突如果你用 aider 开发 Python 项目项目自身的依赖可能与 aider 产生冲突。例如当项目锁定somepackageX.Y.Z而 aider 需要U.W.V时python -m pip install会直接报错aider-chat 0.23.0 requires somepackageX.Y.Z, but you have somepackage U.W.V which is incompatible.解决方案是改用 pipx。pipx 会把 aider 装进独立于系统与项目的专用 Python 环境中从此你可以用 aider 处理任何 Python 项目即使依赖互相冲突也不受影响pipx install aider-chatpipx 在 Replit 上的特殊处理在 Replit 的 shell 中需要显式先装 pipx再用pipx run运行pip install pipx pipx run aider-chat ...normal aider args...注意在 Replit 上若用 pipx 安装后直接执行aider会因缺少libstdc.so.6库而崩溃必须使用pipx run形式。用 Docker 安装免环境依赖的隔离运行aider 提供两个官方镜像详见 docker.md镜像说明paulgauthier/aider核心版体积小适合快速上手paulgauthier/aider-full完整版预装全部可选扩展交互式帮助、浏览器 GUI、Playwright 网页抓取等核心镜像同样可以使用这些扩展功能但首次访问时需临时安装由于容器是临时的下次启动核心容器时需要重新安装。核心版启动docker pull paulgauthier/aider docker run -it --user $(id -u):$(id -g) --volume $(pwd):/app paulgauthier/aider --openai-api-key $OPENAI_API_KEY [...other aider args...]完整版启动docker pull paulgauthier/aider-full docker run -it --user $(id -u):$(id -g) --volume $(pwd):/app paulgauthier/aider-full --openai-api-key $OPENAI_API_KEY [...other aider args...]使用要点与限制必须在 Git 仓库根目录执行上述命令--volume $(pwd):/app将当前目录映射进容器只有身处仓库根目录aider 才能看到完整仓库与全部文件。容器内没有你的全局 git 配置请先补齐用户名与邮箱否则无法提交git config user.email youexample.com git config user.name Your Name/run命令在容器内执行在对话中使用/run运行 shell 命令时命令实际执行于容器内部而非你的本地环境对需要宿主机环境的测试可能不便。/voice语音命令受限容器内已预装libportaudio2但除非你将宿主机的音频设备透传给容器否则语音功能无法工作。在 GitHub Codespaces 中使用aider 可以直接在 GitHub Codespaces 内置的 Terminal 面板中使用详见 codespaces.md无需额外搭建环境。进入 Codespaces 后在终端中按前述快速开始的三步操作即可安装aider-chat、进入 Git 仓库目录、设置 API Key 后运行aider。Codespaces 本身已具备 git 与 Python 环境是免本地配置的快速体验途径。可选安装步骤让 aider 更强大以下步骤全部可选详见 optional.md按需启用即可。1. 用 .env 文件存储 API Key把 API Key 写入.env文件之后每次运行 aider 都会自动加载无需重复导出ANTHROPIC_API_KEYsk-xxx... OPENAI_API_KEYsk-xxx...具体格式与加载机制可参考仓库内的 config 文档 及其对应配置目录docs/config其中包含环境变量键名与配置文件语法的完整说明。2. 启用 Playwright 网页抓取aider 支持用/web url命令把网页加入对话工具会抓取并解析页面内容。默认使用httpx库抓取但它只能处理部分网页——有些站点显式屏蔽httpx类请求有些则依赖 JavaScript 渲染内容。要让绝大多数网页都能正常抓取请安装 Playwright 的 Chromium 浏览器及系统依赖playwright install --with-deps chromium3. 启用语音编码aider 支持通过/voice命令用语音编码详见 usage/voice底层依赖 PortAudio 库采集音频。PortAudio 完全可选安装方式因系统而异Windows无需安装Macbrew install portaudioLinuxsudo apt-get install libportaudio24. 集成到编辑器aider 已有社区插件集成到部分 IDE但插件未必同步最新版本官方建议的方式是在终端中与编辑器并排运行最新版 aider。已知集成情况包括NeoVim 插件、VS Code 插件且 aider 能自动检测是否运行在 VS Code 终端内并关闭彩色输出VS Code 终端对颜色支持不佳。5. 安装开发版想体验最新开发特性可直接从源码安装python -m pip install --upgrade githttps://github.com/paul-gauthier/aider.git如果已克隆 aider 仓库还可热加载本地副本适合自行开发 aider、让改动立即生效python -m pip install -e .本仓库内收录的 aider 即为开发版形态其版本号由 setuptools_scm 自动生成见version.py当前对应版本为0.55.1.dev59g2663233b0.55.1 开发分支第 59 次提交。安装完成后的下一步至此 aider 已就绪。如果你还需要深入了解对话交互与/run、/web、/voice等聊天命令可阅读 usage 目录 下的使用文档遇到模型连接、依赖或命令执行问题可对照 troubleshooting.md 排查。在本仓库的 Qwen3-Coder 评测体系里aider 正是通过这套安装与运行流程被用来驱动大模型在真实 Git 仓库中完成编码任务从而量化模型的代码修改与工具调用能力。【免费下载链接】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），仅供参考