Aider 接入

Aider 支持通过 OpenAI-compatible 环境变量使用 Lumoswitch。建议先在单独的测试仓库验证模型和流式输出。

设置环境变量

export OPENAI_API_KEY="your-lumoswitch-access-key"
export OPENAI_API_BASE="https://your-gateway.example.com/v1"

OPENAI_API_BASE 应以 /v1 结尾，不要附加 /chat/completions。

启动 Aider

进入目标代码仓库后运行：

aider --model "your-public-model-name"

首次验证时可让 Aider 解释一个小文件，确认读取上下文和生成回复均正常，再执行代码修改。

持久化配置

可将环境变量放入仅本机可读的 shell 配置或密钥管理工具。不要把 Access Key 写进项目内的 .env 并提交到 Git。

常见问题

• Aider 把模型识别为未知模型：仍可尝试使用对外模型名称；若客户端强制校验模型元数据，请选择兼容模式。
• 401：确认 OPENAI_API_KEY 使用 Lumoswitch Access Key。
• 404：检查 OPENAI_API_BASE 是否遗漏或重复 /v1。
• 上下文或参数不兼容：先使用最小提示测试，并移除客户端自动添加的厂商专有参数。