⌘K

Aider

概述

Aider 可以连接 OpenAI 兼容接口. 将 Aider 的 OpenAI API Base URL 指向 Vtrix, 配置 Vtrix API Key, 再选择 Vtrix 模型 ID 即可.

环境要求

  • Python 3.9 及以上
  • Aider
  • Vtrix API Key, 在 设置 中创建
可选：使用 Vtrix Doctor

也可以先使用 Vtrix Doctor 检查本机 Base URL、API Key 和模型配置。已支持的工具，包括 OpenClaw 和 Hermes，可在确认后一键写入配置。

配置步骤

1

安装 Aider

• 使用安装脚本

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

• 或使用 pipx

python -m pip install pipx
pipx install aider-chat

安装完成后运行：

aider --version
2

配置 Vtrix Base URL

Aider 支持通过自己的 AIDER_OPENAI_API_* 环境变量读取 OpenAI 兼容配置. 这样不会覆盖你本机全局的 OpenAI 环境变量.

在 ~/.bashrc 或 ~/.zshrc 中加入：

export AIDER_OPENAI_API_KEY="YOUR_VTRIX_API_KEY"
export AIDER_OPENAI_API_BASE="https://cloud.vtrix.ai/llm"

修改后请重启终端, 或执行：

source ~/.zshrc
Base URL

Vtrix 的 OpenAI 兼容 Base URL 使用 https://cloud.vtrix.ai/llm. Aider 会在该 Base URL 下请求 chat completions 路径.

3

选择 Vtrix 模型

启动 Aider 时传入 Vtrix 模型 ID. 对 OpenAI 兼容自定义接口, 模型名前需要加 openai/ 前缀：

aider --model openai/gpt-5.5

如需切换模型, 只修改 openai/ 后面的模型 ID.

类型示例模型说明
高性能openai/gpt-5.5通用代码与推理能力较强
标准openai/gpt-5.4日常开发, 均衡
Qwenopenai/qwen3.7-max同样通过 Vtrix Base URL 路由
提示

在 模型页面 查看当前可用模型 ID. 请按页面展示的模型 ID 原样复制.

4

启动项目会话

进入项目目录并启动 Aider：

cd /path/to/your/project
aider --model openai/gpt-5.5

也可以执行一次性提示：

aider --model openai/gpt-5.5 --message "请用一句话总结当前项目"

如果 Aider 能正常回复, 说明请求已通过配置的 Base URL 到达 Vtrix. 也可在 Vtrix 设置 中查看账单或用量.

故障排查

报错：401 Unauthorized

原因： Vtrix API Key 未设置、设置错误, 或当前终端未加载环境变量.

处理：

echo $AIDER_OPENAI_API_KEY

如果为空, 请检查 ~/.zshrc 或 ~/.bashrc, 然后重新打开终端.

报错：model not found

原因： openai/ 后面的模型 ID 填写错误或当前不可用.

处理： 前往 模型页面 复制正确的模型 ID, 然后用 --model openai/<model-id> 重新启动 Aider.

请求仍然发往其他服务商

原因： 其他 Aider 或 OpenAI 环境变量可能覆盖了预期配置.

处理：

env | grep -E 'AIDER_OPENAI|OPENAI_API'

确认 AIDER_OPENAI_API_BASE 是 https://cloud.vtrix.ai/llm, 且 AIDER_OPENAI_API_KEY 是你的 Vtrix API Key.

请求超时

原因： 当前任务较大、网络不稳定, 或所选模型响应时间较长.

处理： 将任务拆成更小的步骤, 或从 Vtrix 模型列表中选择响应更快的模型.