Aider

终端 AI 编程助手,支持 git 集成、多模型切换,可与 Aider 对话式地编辑代码并自动提交 git commit。

环境变量OpenAI

安装

terminal
python -m pip install aider-install && aider-install

推荐使用 aider-install 安装(自动处理虚拟环境和依赖)。也可直接 pip install aider-chat。

配置步骤

  1. 1

    安装 Aider

    推荐使用 aider-install 安装脚本(自动创建虚拟环境并安装依赖)。需要 Python 3.10+。

    terminal
    # 推荐:使用 aider-install(自动创建虚拟环境)
    python -m pip install aider-install && aider-install
    
    # 备选:直接 pip 安装
    pip install aider-chat
  2. 2

    配置环境变量

    将以下环境变量添加到你的 shell 配置文件(~/.bashrc、~/.zshrc 等)中。

    ~/.zshrc
    export OPENAI_API_KEY="sk-your-api-key"
    export OPENAI_API_BASE="https://api.example.com/v1"
  3. 3

    使配置生效

    terminal
    source ~/.zshrc
  4. 4

    启动 Aider

    在 git 项目目录下运行 aider,使用 --model 参数指定模型。模型名需加 openai/ 前缀。

    terminal
    # 进入 git 项目目录
    cd /path/to/your/project
    
    # 启动(使用 DeepSeek V3.2)
    aider --model openai/deepseek-v3.2
    
    # 也可以使用 Claude Sonnet 4
    aider --model openai/claude-sonnet-4-20250514

    模型名称必须加 openai/ 前缀。未知模型会显示警告但不影响使用。

  5. 5

    (可选)使用配置文件

    也可以通过 .aider.conf.yml 配置文件替代环境变量,放在项目根目录或 ~/.aider.conf.yml。

    .aider.conf.yml
    # .aider.conf.yml
    openai-api-key: sk-your-api-key
    openai-api-base: https://api.example.com/v1
    model: openai/deepseek-v3.2

注意事项

  • 模型名称必须加 openai/ 前缀
  • 也支持 .aider.conf.yml 配置文件
  • 未知模型会显示警告但不影响使用