编程智能体每一轮都会重新发送代码库的大部分内容,所以按 token 计费的账单涨得很快。不限量套餐会话去掉了这个计量。下面的步骤参照 Aider 的 OpenAI 兼容配置说明。
1. 安装 Aider
python -m pip install aider-install
aider-install
2. 指向 BroadNet Inference
export OPENAI_API_BASE=https://inference.broadnet.ai/v1
export OPENAI_API_KEY='your-broadnet-plan-key'
在 Windows 上,使用 setx OPENAI_API_BASE https://inference.broadnet.ai/v1 和 setx OPENAI_API_KEY your-key,然后打开一个新终端。Aider 的文档要求在 setx 之后重启 shell。
base URL 末尾的 /v1 要保留。chat completions 路径由 Aider 自己加上。
3. 在你的代码库上启动
cd /path/to/your/project
aider --model openai/broadnet/deepseek-v4.1-flash
openai/ 前缀告诉 Aider 使用 OpenAI 兼容端点;后面的部分是 BroadNet 的模型 ID。Aider 会提示:“Unknown context window size and costs, using sane defaults.”(译文:上下文窗口大小和费用未知,使用合理的默认值。)对于不在其内置列表中的模型,这是正常现象。它的模型警告页面说这个警告通常可以忽略。
4. 可选:把模型信息告诉 Aider
想去掉警告并给模型留出思考空间,就在你的主目录或代码库根目录下添加两个文件。Aider 会从这两个位置中的任意一个读取它们,详见它的高级模型设置文档。
.aider.model.metadata.json:
{
"openai/broadnet/deepseek-v4.1-flash": {
"max_input_tokens": 1048576,
"litellm_provider": "openai",
"mode": "chat"
}
}
.aider.model.settings.yml:
- name: openai/broadnet/deepseek-v4.1-flash
edit_format: diff
extra_params:
max_tokens: 16000
对于未知模型,Aider 默认的编辑格式是 whole,会重新发送整个文件。diff 只发送改动的代码块。如果编辑应用失败,删掉 edit_format 这一行,回到 whole。
使用建议
- 一个 Aider 窗口对应一个会话。 如果同时运行两个 Aider 实例,请购买两个会话,否则它们会互相排队。
- 思考也消耗 token。 DeepSeek V4.1 Flash 在回答前会先思考,BroadNet 把这部分计入
max_tokens。为什么回答会是空的。 - 先试一小时。 Meteor 套餐一小时 $1,足够用一个真实任务来判断效果。
故障排查
- 401 Unauthorized。
OPENAI_API_KEY缺失、错误或已过期。检查运行 Aider 的 shell 里是否有这个变量;在 Windows 上,setx之后要打开新终端。 - 请求发到了 OpenAI 而不是 BroadNet。 当前 shell 没有设置
OPENAI_API_BASE,或者模型名缺少openai/前缀。运行echo $OPENAI_API_BASE检查。 - 找不到模型。
openai/后面的部分必须与broadnet/deepseek-v4.1-flash完全一致。套餐密钥只覆盖 DeepSeek V4.1 Flash;其他 BroadNet 模型需要按量付费密钥。 - 回复为空或被截断。 按上文所示,在
.aider.model.settings.yml中调高max_tokens。 - 编辑没有生效。 把
edit_format改回whole,或在命令行加上--edit-format whole。 - 回复慢或出现 429。 一个套餐会话同一时间只处理一个请求;第二个 Aider 窗口会排队。按量付费密钥每分钟允许 30 个请求,同时最多 4 个。参见错误码与重试。
更喜欢在 VS Code 里用智能体?请看 Cline 配置指南,或者阅读 Cline、Roo Code 与 Aider 对比。
