Aider

Aider

终端中的 AI 结对编程,原生 Git 提交

用 TokenMix CLI 接入

官方 TokenMix CLI 一条命令即可完成接入,无需手动配置环境变量:

npx tokenmix aider

自动处理登录、API 地址和密钥。如果你偏好手动配置,完整步骤见下方。


简介

Aider 将你的终端变成 AI 结对编程工具。描述你想要的内容,Aider 编辑代码库中的相关文件,然后自动用描述性消息提交到 Git。这种 Git 优先的方式意味着你始终可以查看 AI 做了什么、对比差异或回滚。通过将 Aider 指向 TokenMix,可使用 claude-opus-4.8deepseek-v4-pro 等顶级模型。

前提条件

配置步骤

1. 安装 Aider

pip install aider-chat

验证:

aider --version

2. 设置环境变量

Aider 使用 OPENAI_API_BASEOPENAI_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 即可切换模型,无需重启。