1. Aider 是什么为什么值得折腾一次Aider 是一个跑在终端里的 AI 编程助手。你可以把它理解成「住在命令行里的结对程序员」它读得懂你当前项目的文件能直接帮你改代码、新建文件、跑 Git 提交改完还会问你要不要确认。它不像网页版对话那样需要你复制粘贴代码来回倒腾而是直接在项目目录里动手。它适合谁三类人最合适一是刚学编程、想有个随时能问的助手二是手上有老项目、想批量改代码但懒得一个个文件点开的人三是习惯键盘操作、不想离开终端的人。Windows、macOS、Linux 三端都能装核心依赖只有一个 Python 环境。但小白第一次装 Aider卡点往往不在 Aider 本身而在三件事Python 装没装对、API Key 怎么配、配置文件写在哪。尤其是 Key 这一块很多人手里有好几家的 KeyDeepSeek 一个、OpenAI 一个、Claude 一个每个工具都要单独配一遍换台电脑又得重来。这篇教程的思路是用 TaoToken 的统一 Key 把 Aider 的接入收敛成一套配置三端共用同一个地址和同一个 Key配置文件骨架直接复制就能用。下面按「装 Python → 装 Aider → 配统一 Key → 验证请求」的顺序走每一步都给三端命令最后给三端各一条验证命令确认 Aider 真的能发出请求。2. 前置准备Python 环境与 TaoToken 统一 Key2.1 先确认 Python 版本Aider 要求 Python 3.8 以上实测建议 3.10 或更高兼容性更稳。打开终端Windows 按Win R输入cmd回车macOS 按Cmd 空格搜「终端」Linux 直接开你常用的 shell。python --version如果输出Python 3.10.x这类结果说明已经装好跳到 2.3。如果提示「不是内部或外部命令」或者版本低于 3.8按下面装。2.2 三端安装 PythonWindows 去 python.org 下载安装包安装界面最下方一定要勾选Add Python to PATH这一步漏了后面pip和aider命令全都找不到。装完关掉终端重新开一个。macOS 用 Homebrew 最省事brew install python没装 Homebrew 的话先去 brew.sh 复制那行安装命令跑一遍。LinuxDebian/Ubuntu 系sudo apt update sudo apt install -y python3 python3-pip python3-venv装完统一再跑一次python --version确认。2.3 拿到 TaoToken 统一 KeyTaoToken 的作用是把多家模型的调用收敛到一个入口你只需要一个 API 地址加一个 Key就能在 Aider 里切换不同模型不用为每个模型单独配环境变量。对小白来说最大的好处是配置文件只写一份三端通用。先去官网注册账号https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content登录后进控制台创建 API Keyhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteKey 一般以sk-开头复制下来先存到记事本后面配置要用。想先看看有哪些模型可用可以去模型对话页面试一条https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite注意Key 只显示一次关掉页面就看不到了务必先存好。不要把它写进会提交到 Git 的文件里。3. 安装 Aider 并写入统一配置3.1 安装 Aider三端命令一致用 pip 装python -m pip install aider-chatmacOS/Linux 如果python指向的是 Python 2把命令里的python换成python3。看到Successfully installed aider-chat-x.x.x就成功了。装完验证一下aider --version如果提示aider 不是内部或外部命令先关掉终端重开还不行就用完整调用方式python -m aider --version能出版本号说明包装好了只是 PATH 没刷新。3.2 配置文件写在哪Aider 支持全局配置和项目级配置。全局配置放在用户目录三端路径不同系统全局配置路径WindowsC:\Users\你的用户名\.aider.conf.ymlmacOS~/.aider.conf.ymlLinux~/.aider.conf.yml项目级配置放在项目根目录文件名.aider.conf.yml只对当前项目生效。建议把 Key 和模型地址放全局把项目相关的设置放项目级。3.3 可复制的 config.toml / settings 骨架Aider 主配置用 YAML但很多人也习惯用.env管环境变量。下面给两份骨架按需选一份。方案一.aider.conf.yml推荐三端通用# ~/.aider.conf.yml openai-api-base: https://taotoken.net/api openai-api-key: sk-你的TaoToken_Key model: openai/deepseek-chat weak-model: openai/deepseek-chat auto-commits: true dark-mode: true这里的关键是openai-api-base指向 TaoToken 的 API 地址Aider 会把它当成 OpenAI 兼容接口来调用。model里的openai/前缀是告诉 Aider 走 OpenAI 兼容协议后面跟具体模型名。方案二.env 环境变量如果你不想把 Key 写进 YAML可以用环境变量。Windowssetx OPENAI_API_BASE https://taotoken.net/api setx OPENAI_API_KEY sk-你的TaoToken_KeymacOS / Linux 写进~/.zshrc或~/.bashrcexport OPENAI_API_BASEhttps://taotoken.net/api export OPENAI_API_KEYsk-你的TaoToken_Key改完执行source ~/.zshrc生效。Windows 的setx必须关掉终端重开才生效这点很多人踩坑。注意API 地址统一用https://taotoken.net/api不要多加斜杠或路径后缀Aider 会自己拼接。3.4 项目级配置补充在具体项目根目录建一个.aider.conf.yml可以覆盖全局设置比如指定只读哪些文件read: - CONVENTIONS.md - README.md auto-lint: true这样每次在这个项目里启动 Aider都会自动把约定文档读进上下文不用每次手动/add。4. 三端验证确认 Aider 能正常发起请求配置写完必须验证一次否则后面报错你分不清是 Key 问题还是网络问题。4.1 Windows 验证关掉所有终端重新开一个 cmd进入任意项目目录cd D:\your-project aider --model openai/deepseek-chat --message 用一句话说明这个项目是做什么的--message参数让 Aider 执行一次就退出适合脚本化验证。如果看到模型返回了内容说明请求通了。4.2 macOS 验证cd ~/your-project aider --model openai/deepseek-chat --message 列出当前目录下的文件4.3 Linux 验证cd ~/your-project aider --model openai/deepseek-chat --message 打印当前时间三端验证成功的标志是一样的终端里出现模型回复的文本没有AuthenticationError或Connection error。如果成功你会看到类似这样的输出Aider v0.x.x Model: openai/deepseek-chat with diff edit format Git repo: .git 当前目录下有 README.md、src、tests 三个条目看到后面跟着模型的实际回复就说明 TaoToken 统一 Key 已经打通Aider 能正常发起请求了。5. 本篇常见报错排查5.1aider命令找不到九成是 PATH 没刷新。Windows 用户装 Python 时没勾 Add to PATH 也会这样。先关终端重开不行就用python -m aider代替aider。macOS/Linux 检查which python3和pip3 show aider-chat是否指向同一个 Python。5.2AuthenticationError: Incorrect API key按顺序查三件事Key 有没有复制完整sk-开头别带空格openai-api-base是不是写成了https://taotoken.net/apiWindows 用户setx之后有没有重开终端。如果用的是.aider.conf.yml确认文件编码是 UTF-8别用记事本存成带 BOM 的格式。5.3Connection error或请求超时先确认网络能访问https://taotoken.net/api用 curl 测一下curl -I https://taotoken.net/api返回 200 或 401 都说明地址可达401 是因为没带 Key。如果 curl 都连不上检查本机 DNS 或防火墙设置。公司网络有时会拦非标准端口换个网络试试。5.4 模型名写错导致Model not foundAider 里的模型名要带协议前缀。走 TaoToken 统一入口时格式是openai/模型名比如openai/deepseek-chat。如果你直接写deepseek/deepseek-chatAider 会去找 DeepSeek 官方地址而不是走你配的openai-api-base。这是最容易搞混的一点。5.5 配置文件不生效Aider 读取配置有优先级命令行参数 项目级.aider.conf.yml 全局~/.aider.conf.yml 环境变量。如果你在全局配了 Key项目里又写了个空的.aider.conf.yml可能覆盖掉。排查时用aider --show-settings看实际生效的配置。6. 后续怎么用模型切换与长期编码验证通过后日常使用就简单了。想换模型直接改--model参数aider --model openai/deepseek-reasoner推理模型思考更深入适合复杂逻辑但速度慢一些。日常改代码用openai/deepseek-chat就够。如果你打算长期用 Aider 做项目开发或者接 Agent 工作流建议了解一下 Coding Plan它把常用模型的调用额度打包比单次按量更划算https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite接入文档在这里遇到配置细节可以对照查https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewriteKey 管理在控制台https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite最后提醒一句.aider.chat.history.md会记录你在项目里的对话存在项目根目录不想留就手动删。API Key 存在~/.aider.conf.yml这个文件别分享给别人也别提交到 Git。装完先跑一次第 4 节的验证命令确认请求通了再开始正式写代码能省掉后面一堆「到底是 Key 问题还是代码问题」的纠结。