Aider

Aider 是面向 Git 仓库的终端结对编程工具，可通过 OpenAI Compatible Base URL 使用猫咖啡 API。

安装

macOS / Linux

curl -LsSf https://aider.chat/install.sh | sh

Windows PowerShell

powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"

pipx

pipx install aider-chat

检查安装：

aider --version

环境变量配置

macOS / Linux / WSL

export AIDER_OPENAI_API_KEY="sk-你的令牌"
export AIDER_OPENAI_API_BASE="https://coffeecatbox.cc/v1"
export AIDER_MODEL="openai/控制台中的模型 ID"

Windows PowerShell

$env:AIDER_OPENAI_API_KEY="sk-你的令牌"
$env:AIDER_OPENAI_API_BASE="https://coffeecatbox.cc/v1"
$env:AIDER_MODEL="openai/控制台中的模型 ID"

启动：

cd /path/to/git-project
aider

单次命令配置

aider \
  --model "openai/控制台中的模型 ID" \
  --openai-api-base "https://coffeecatbox.cc/v1" \
  --openai-api-key "$NEWAPI_API_KEY"

.aider.conf.yml

也可在用户目录或 Git 项目中创建：

model: openai/控制台中的模型 ID
openai-api-base: https://coffeecatbox.cc/v1
openai-api-key: sk-你的令牌
dark-mode: true
auto-commits: false

项目配置不要放密钥

项目里的 .aider.conf.yml 可能被提交。推荐只在其中保存模型与 Base URL，把密钥放环境变量或用户级配置。

使用建议

• 先在干净 Git 工作区中使用；
• 首次使用可设置 auto-commits: false，自行审查改动；
• 未知模型出现元数据警告时，先确认上下文与编辑格式；
• 推理模型可配合 --reasoning-effort high，前提是模型支持该参数。

常见问题

Unknown model

Aider 不认识模型元数据时仍可能工作。确认模型 ID 正确，并按需提供模型 metadata 或选择兼容模型。

请求发往官方 OpenAI

说明 Base URL 未生效。运行 aider --verbose 检查解析后的配置来源。

修改质量差

Aider 对模型的代码能力和编辑格式较敏感。换用编程模型，并尝试 architect 模式或不同 edit format。