个人兴趣会利用AI写作开发小工具,我不准备使用私有的AI编程工具,如codex、claude这些,最后选中了aider。有一些模型参数,程序设置在每个项目里面是基本固化的,我记录下来,防止自己忘记。顺便加一点自己的技巧记录,防止时间长了,也忘掉了。
模型配置
-
模型API-key
GEMINI_API_KEY=xxxx # 可以到google ai studio获取 -
模型API地址
google官方网址不可用,而且在CN地区,服务本就不提供,所以我搭建了个人的vps中转,那么就需要中转网址。
我的中转是原样转发google官方请求的,直接使用google自有协议,而不是openai兼容协议。
GEMINI_API_BASE=https://代理地址/v1beta # 这里必须指定v1beta版本,我的中转是原样转发的,因此代理地址就是代替官方的https://generativelanguage.googleapis.com,需要补完路径v1beta -
主模型(强模型)
强模型主要用于编写核心代码。
AIDER_MODEL=gemini/gemini-2.5-pro # 还是用2.5吧,3.1太贵了 # 话说,2.5也挺贵的 -
弱模型 主要用于写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的输出,一定要起到审核与确认的作用,及时纠正,及时中止错误的操作。