Aider 接入

在终端中使用 AI 进行结对编程，自动完成代码编写、测试和 Git 提交，通过 OpenAI 兼容接口接入 Calgine Tokens。

Aider 是一款终端 AI 结对编程工具，可直接在本地代码库中完成代码修改并自动生成 Git 提交。

前置准备

1. 前往 Calgine Tokens 控制台 注册账号。
2. 进入 工作台 → API 令牌，点击「添加令牌」，创建成功后复制 API Key（以 sk- 开头）。

配置项	值
OPENAI_API_BASE	https://api.calgine.com.cn/v1
OPENAI_API_KEY	您在控制台创建的 API 令牌

安装

pip install aider-chat

或使用 pipx（推荐，避免依赖冲突）：

pipx install aider-chat

配置与启动

方式一：环境变量（推荐，永久生效）

macOS / Linux (zsh)

echo 'export OPENAI_API_KEY="sk-your-token"' >> ~/.zshrc
echo 'export OPENAI_API_BASE="https://api.calgine.com.cn/v1"' >> ~/.zshrc
source ~/.zshrc

macOS / Linux (bash)

echo 'export OPENAI_API_KEY="sk-your-token"' >> ~/.bashrc
echo 'export OPENAI_API_BASE="https://api.calgine.com.cn/v1"' >> ~/.bashrc
source ~/.bashrc

Windows (PowerShell)

[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-your-token", "User")
[Environment]::SetEnvironmentVariable("OPENAI_API_BASE", "https://api.calgine.com.cn/v1", "User")

设置环境变量后，进入项目目录启动：

cd your-project
aider --model gpt-4o

方式二：命令行参数（单次使用）

aider \
  --openai-api-key sk-your-token \
  --openai-api-base https://api.calgine.com.cn/v1 \
  --model gpt-4o

使用 Anthropic 模型

# 设置环境变量
export ANTHROPIC_API_KEY="sk-your-token"
export ANTHROPIC_BASE_URL="https://api.calgine.com.cn/anthropic"

# 启动
aider --model claude-opus-4-5-20251101

使用 .aider.conf.yml 配置文件

在项目根目录创建 .aider.conf.yml，避免每次手动传参：

openai-api-key: sk-your-token
openai-api-base: https://api.calgine.com.cn/v1
model: gpt-4o

验证配置

启动 Aider 后，在交互界面输入一个简单指令（例如「添加一个 hello world 函数」），Aider 能正常修改文件并生成提交即表示配置成功。

常用命令

命令	说明
/add <文件>	将文件加入当前编辑上下文
/drop <文件>	从上下文中移除文件
/diff	查看当前会话产生的所有代码变更
/undo	撤销最近一次 AI 做出的 Git 提交
/commit	提交当前变更
/model <模型名>	切换模型
/exit	退出 Aider

推荐模型

场景	推荐模型
通用编程	gpt-4o
复杂重构	claude-opus-4-5-20251101
快速迭代	gpt-4o-mini

提示

Aider 默认会将所有修改自动提交到 Git，建议在干净的 Git 状态下使用，方便通过 /undo 回滚。

下一步

• Claude Code：另一款终端 AI 编程工具
• 速率限制：了解平台的调用频率限制