本页内容

Aider

开源 CLI 工具 多模型

开源 AI 结对编程命令行工具,支持多种模型提供商(OpenAI、Anthropic、DeepSeek 等),与 Git 工作流深度集成。

安装方式

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 隔离在独立环境中运行。

官方地址