Aider
开源
CLI 工具
多模型
开源 AI 结对编程命令行工具,支持多种模型提供商(OpenAI、Anthropic、DeepSeek 等),与 Git 工作流深度集成。
安装方式
推荐
专用安装器
官方推荐使用专用安装器,可确保 Aider 运行在独立的 Python 环境中,避免依赖冲突。
python -m pip install aider-install aider-install
pipx(隔离环境)
pipx install aider-chat
直接 pip 安装
python -m pip install -U --upgrade-strategy only-if-needed aider-chat
Homebrew(macOS)
brew install aider
Homebrew 版本有时会落后上游 1-2 周。
环境变量配置
Aider 兼容 OpenAI 协议的模型通过 OPENAI_API_BASE 和 OPENAI_API_KEY 两个环境变量指向 API 地址与密钥。统一使用中转地址 https://ai.kedang.net/v1,将下方的 <你的 API Key> 替换为实际密钥。
临时配置(仅当前会话)
关闭终端后失效,适合临时测试。
macOS / Linux
export OPENAI_API_BASE="https://ai.kedang.net/v1" export OPENAI_API_KEY="<你的 API Key>"
Windows(PowerShell)
$env:OPENAI_API_BASE="https://ai.kedang.net/v1" $env:OPENAI_API_KEY="<你的 API Key>"
永久配置
写入 Shell 配置文件或系统环境变量,新开终端后自动生效。
macOS / Linux
编辑 Shell 配置文件
在 ~/.zshrc 或 ~/.bashrc 末尾追加:
export OPENAI_API_BASE="https://ai.kedang.net/v1" export OPENAI_API_KEY="<你的 API Key>"
保存后执行 source ~/.zshrc(按实际文件替换)使其立即生效。
Windows
系统环境变量
「系统属性」→「环境变量」→「用户变量」中新建:
变量名
OPENAI_API_BASE
变量值
https://ai.kedang.net/v1
变量名
OPENAI_API_KEY
变量值
<你的 API Key>
保存后需要重新打开终端 / PowerShell 窗口才会生效。
若使用 Claude 模型,改用 ANTHROPIC_API_KEY 并在启动时加 --model 指定模型名;Aider 本身不支持 Anthropic 专用的 base URL 覆盖,可通过上面的 OpenAI 兼容中转地址接入。
开始使用
cd /path/to/your/project aider
故障排除
提示 "aider command not found"
可以尝试用 python -m aider 运行,或确认 Python 的 Scripts / bin 目录已加入 PATH。
依赖冲突
改用专用安装器 aider-install 或 pipx,两者都会将 Aider 隔离在独立环境中运行。