
Aider
终端中的 AI 结对编程,原生 Git 提交
用 TokenMix CLI 接入
官方 TokenMix CLI 一条命令即可完成接入,无需手动配置环境变量:
npx tokenmix aider
自动处理登录、API 地址和密钥。如果你偏好手动配置,完整步骤见下方。
简介
Aider 将你的终端变成 AI 结对编程工具。描述你想要的内容,Aider 编辑代码库中的相关文件,然后自动用描述性消息提交到 Git。这种 Git 优先的方式意味着你始终可以查看 AI 做了什么、对比差异或回滚。通过将 Aider 指向 TokenMix,可使用 claude-opus-4.8、deepseek-v4-pro 等顶级模型。
前提条件
- Python 3.9 或更高版本 — 运行
python3 --version确认 - 已安装 Git 并有一个 Git 仓库
- TokenMix 账号及以
sk-tm-开头的 API Key → 在 tokenmix.ai 注册 → 控制台 → API Keys
配置步骤
1. 安装 Aider
pip install aider-chat
验证:
aider --version
2. 设置环境变量
Aider 使用 OPENAI_API_BASE 和 OPENAI_API_KEY 连接 OpenAI 兼容端点。将其添加到 Shell 配置文件(~/.zshrc 或 ~/.bashrc):
export OPENAI_API_BASE="https://api.tokenmix.ai/v1"
export OPENAI_API_KEY="sk-tm-你的密钥"
重新加载 Shell:
source ~/.zshrc
3. 用 TokenMix 模型启动 Aider
进入你的 Git 仓库,以 openai/ 前缀启动 Aider:
cd ~/你的项目
aider --model openai/claude-opus-4.8
使用 DeepSeek:
aider --model openai/deepseek-v4-pro
4. 给 Aider 布置任务
在 Aider 提示符下描述你想要的内容:
为注册接口添加输入验证——邮箱格式检查和最小密码长度 8 位。
Aider 编辑文件,显示差异,并在提交前请求确认。
验证
Aider 完成修改后,运行:
git log --oneline -3
你应该看到一个由 Aider 提交的、带有描述性消息的新提交。变更完全被追踪,可以用 git revert 回滚。
常见问题
Q: 为什么要给模型名加 openai/ 前缀?
openai/ 前缀告诉 Aider 使用 OpenAI 兼容 API 格式(通过 OPENAI_API_BASE 路由)。没有它,Aider 会尝试使用错误端点的原生 Anthropic 或 OpenAI SDK。
Q: 可以不让 Aider 每次都自动提交吗?
可以。传入 --no-auto-commits 禁用自动提交。Aider 仍会编辑文件;满意时手动提交。
Q: 如何在会话中途切换模型?
在 Aider 提示符下输入 /model openai/deepseek-v4-pro 即可切换模型,无需重启。