GetRouter文档
  • 简体中文

    • Aider

    Aider 是终端中的 pair-programming 工具，可通过 OpenAI-compatible endpoint 使用 GetRouter。

    配置状态
    • 推荐协议： OpenAI Chat Completions
    • 配置格式核对： 2026-07-15（Aider 官方 OpenAI-compatible 文档）
    • 运行验证： 待验证

    1. 安装

    推荐使用 pipx 隔离安装：

    pipx install aider-chat
aider --version

    2. 配置环境变量

    export OPENAI_API_KEY="YOUR_API_KEY"
export OPENAI_API_BASE="https://getrouter.ai/v1"

    如果你的 Aider 版本优先读取 .env 或模型特定变量，请以该版本官方文档为准，并确保 .env 不会提交到 Git。

    3. 启动

    aider --model openai/MODEL_ID

    openai/ 告诉 Aider 使用 OpenAI 兼容 adapter，后面的 MODEL_ID 必须与 GetRouter 模型目录一致。

    最终请求路径： POST https://getrouter.ai/v1/chat/completions

    4. 验证

    先在临时 Git 仓库中让 Aider 解释一个文件，不修改代码。随后测试一个很小的改动并检查 diff 和 commit。

    常见问题

    现象处理
    找不到模型检查 openai/MODEL_ID 前缀和模型 ID
    请求发往 OpenAI 官方域名当前进程没有读取 OPENAI_API_BASE
    404检查 Base URL 是否包含且只包含一个 /v1
    自动修改不可靠选择更适合代码与 Tool Calling 的模型，并降低单次任务范围

    Aider 会操作代码并可能创建 Git commit。首次使用新模型时务必检查 diff，不要在包含未备份重要改动的仓库直接试验。