Aider运行参数配置备忘

个人兴趣会利用AI写作开发小工具,我不准备使用私有的AI编程工具,如codex、claude这些,最后选中了aider。有一些模型参数,程序设置在每个项目里面是基本固化的,我记录下来,防止自己忘记。顺便加一点自己的技巧记录,防止时间长了,也忘掉了。

模型配置

  1. 模型API-key

    GEMINI_API_KEY=xxxx
    # 可以到google ai studio获取
    
  2. 模型API地址

    google官方网址不可用,而且在CN地区,服务本就不提供,所以我搭建了个人的vps中转,那么就需要中转网址。

    我的中转是原样转发google官方请求的,直接使用google自有协议,而不是openai兼容协议。

    GEMINI_API_BASE=https://代理地址/v1beta
    # 这里必须指定v1beta版本,我的中转是原样转发的,因此代理地址就是代替官方的https://generativelanguage.googleapis.com,需要补完路径v1beta
    
  3. 主模型(强模型)

    强模型主要用于编写核心代码。

    AIDER_MODEL=gemini/gemini-2.5-pro
    # 还是用2.5吧,3.1太贵了
    # 话说,2.5也挺贵的
    
  4. 弱模型 主要用于写commit message、总结上下文等后台任务。

    AIDER_WEAK_MODEL=gemini/gemini-3-flash-preview
    

env配置文件

总结一下,完整的配置如下。

# 1. 设置 Gemini 的 API Key (必填)
GEMINI_API_KEY=xxxxx

# 2. 设置 Gemini 的自定义基础 URL (如果你用了代理,必填)
# 注意:URL 结尾通常不需要加具体的版本号或路径,具体取决于你的代理商说明
GEMINI_API_BASE=https://xxxxx/v1beta

# 强模型 (主模型,用于编写核心代码)
# 你可以用 gemini-1.5-pro 或者你之前用的 preview 版本
AIDER_MODEL=gemini/gemini-2.5-pro

# 弱模型 (用于写 commit message、总结上下文等后台任务)
AIDER_WEAK_MODEL=gemini/gemini-3-flash-preview

这个文件以.env命名后放在项目根目录下,也就是aider的启动目录下,aider就可以自动读取到。相应的,aider启动时就不需要带上相关的参数了。

还有最后一点,由于env配置的敏感性,一定要在gitignore中忽略掉.env文件。如果有提交过,一定要做彻底的清理,防止敏感信息泄漏。

aider使用

聊天内常用命令

/ask/architect以及/code可以在不同的聊天模式中切换

/clear可以清除上下文,降低对话的token数量。一旦一部分任务完成就建立执行一次

/drop/add可以删除或者添加附在聊天中的文件,因此不用的文件就drop掉,需要用的时候再add进来,可以节省token

/model 模型名称可以在聊天中动态切换模型。

使用技巧

模型难免有犯错的地方,除了可以在聊天中使用undo命令外,还需要善用git命令,常见的方式是结合git log --oneline查看提交列表,git reset --hard [commit id]来回退。

我还建议在回退前,先临时保存git log --oneline,防止自己回退的版本不对,无法方便找回回退之后的版本的问题。

最后,不要当甩手掌柜,AI是个很好很专业的执行者,但是需要用户来把握大方向与小方向,尤其要避免AI犯错。

因此,对于AI的输出,一定要起到审核与确认的作用,及时纠正,及时中止错误的操作。

内容声明与版权协议

  • 版权协议:本文采用 CC BY-NC-SA 4.0(署名-非商业性使用-相同方式共享) 协议进行许可。转载、演绎请务必保留作者署名及原文链接,且不得用于商业目的。
  • AI 辅助说明:本博客部分内容(如排版设计、个别局部、特定对话片段等)可能由 AI(LLM大语言模型)辅助生成。作者在此明确声明:本人对文章的核心框架、思想立论与最终呈现拥有绝对主导权与最终解释权。
  • 观点免责:文中明示的由 AI 生成的特定文本、对话输出,仅作为理性探讨以及观点展示,不代表本人真实立场、价值观或事实背书。对于因 AI 幻觉造成的客观事实偏差,请读者审慎甄别。
  • 认知时效性:文章仅代表作者在撰写当下的认知状态与情绪切片。随着个人心智迭代与客观事物发展,作者观点可能发生演变。欢迎基于理性的交流与批评。