CLI 工具

Aider

终端结对编程工具接入 VisionCoder：一条环境变量搞定，模型名必须带 openai/ 前缀

Aider 是终端里的结对编程工具，直接改你仓库里的文件并自动 git commit。它底层用 LiteLLM 调模型，只要给一个 OpenAI 兼容端点就能跑 —— 两条环境变量，不用改 Aider 任何代码。

前提

在 API Key 管理创建 API Key
已装 Python 3.10+
在 Git 仓库里使用（Aider 的改动都通过 git commit 落地，非仓库目录会警告）

安装 Aider

python -m pip install aider-install
aider-install

它会用独立的 Python 环境装 Aider，不污染你当前项目的依赖。

uv tool install --force --python python3.12 aider-chat@latest

pipx install aider-chat

检查：

aider --version

配置

方式一：环境变量（临时试用）

export OPENAI_API_BASE="https://coder.api.visioncoder.cn/v1"
export OPENAI_API_KEY="YOUR_API_KEY"

aider --model openai/gpt-5.4

$env:OPENAI_API_BASE = "https://coder.api.visioncoder.cn/v1"
$env:OPENAI_API_KEY  = "YOUR_API_KEY"

aider --model openai/gpt-5.4

set OPENAI_API_BASE=https://coder.api.visioncoder.cn/v1
set OPENAI_API_KEY=YOUR_API_KEY

aider --model openai/gpt-5.4

方式二：配置文件（长期使用）

在用户主目录建 ~/.aider.conf.yml（对所有项目生效），或者在项目根目录建同名文件（只对该项目生效）：

openai-api-base: https://coder.api.visioncoder.cn/v1
openai-api-key: YOUR_API_KEY
model: openai/gpt-5.4
# 生成 commit message、给文件排序这类杂活用便宜模型，省钱且更快
weak-model: openai/gpt-5.4-mini

配好之后直接敲 aider 就行，不用再带 --model。

模型名前缀这件事，必须说清楚

Aider 的模型名要写成 openai/gpt-5.4，不能只写 gpt-5.4。

这里的 openai/ 前缀说的是「用 OpenAI 协议去调」，不是「这是 OpenAI 家的模型」。所以走 VisionCoder 时，Claude、DeepSeek、Qwen 这些全都要带 openai/ 前缀：

想用的模型	Aider 里要写
GPT-5.4（日常）	`openai/gpt-5.4`
GPT-5.5（最强推理）	`openai/gpt-5.5`
GPT-5.3 Codex Spark（长会话）	`openai/gpt-5.3-codex-spark`
Claude Sonnet 5	`openai/claude-sonnet-5`
Claude Opus 5	`openai/claude-opus-5`
DeepSeek v4 Pro	`openai/deepseek-v4-pro`

写成 anthropic/claude-sonnet-5 会让 Aider 去连 Anthropic 官方域名，那是连不上的。

完整模型列表：curl https://coder.api.visioncoder.cn/v1/models

验证

在任意 Git 仓库里：

aider --model openai/gpt-5.4

进入后敲 /models 能看到当前模型，随便让它改点东西，比如：

把 README 里的安装步骤改成三步

它会展示 diff、等你确认、然后自动 commit。

故障排查

报 model not found / LiteLLM 提示不认识这个模型

十有八九是模型名少了 openai/ 前缀。Aider 拿不到前缀时会去猜供应商，猜错就连不上。

另外确认 ID 本身没写错：curl https://coder.api.visioncoder.cn/v1/models。

Aider 警告「模型未知，token 上限可能不准」

VisionCoder 上的模型 ID 不在 LiteLLM 内置的价目表里，所以 Aider 不知道它的上下文长度和价格，会给个警告 —— 不影响使用。

嫌烦可以加 --no-show-model-warnings，或者在配置文件里写死：

no-show-model-warnings: true

401 / 403

OPENAI_API_BASE 必须带 /v1 后缀
Key 是不是完整复制的（前后有没有带空格）
如果之前配过 OpenAI 官方，检查有没有残留的 OPENAI_API_BASE 覆盖了你的设置：echo $OPENAI_API_BASE

改动没有自动 commit

Aider 只在 Git 仓库里工作。当前目录不是仓库就先 git init，或者用 --no-auto-commits 关掉自动提交、自己管。

加群 & 客服