返回博客

工具与集成指南

用于你自己的 API 密钥的 Aider 配置文件：.aider.conf.yml 和 Windows setx

将你自己的 API 密钥和基础 URL 保存在 .aider.conf.yml 中，正确处理加载顺序并避免 Windows setx 陷阱，并附有会话成本估算。

作者：CheapTokens Team发布于 3 分钟阅读

带有将 Aider 连接到 OpenAI 兼容 API 的命令的终端
本页内容
  1. Windows：setx 和新终端
  2. 哪种编辑用哪个模型
  3. 运行第一次编辑
  4. 不再重复输入：.aider.conf.yml
  5. 一次会话的成本
  6. 如果它不工作

两个变量 OPENAI_API_BASE 和 OPENAI_API_KEY，再加上像 openai/<model id> 这样的模型参数，就足以让 Aider 指向 CheapTokens。分步基础操作（安装、首次请求、401/404/400/402）见 How to connect Aider to CheapTokens；本页涵盖该指南未涉及的内容：Windows 上的 setx、配置文件及其加载顺序，以及一次会话的成本估算。

来源：Aider 关于 OpenAI 兼容 API 的文档（页面检查于 2026 年 10 月 26 日；文档未显示日期或版本，当天 PyPI 上最新的 aider-chat 是 0.86.2）。

Windows：setx 和新终端#

在 Mac 和 Linux 上，你 export 这两个变量。在 Windows（PowerShell 或 cmd）上使用 setx：

bat
setx OPENAI_API_BASE https://api.cheaptokens.dev/v1
setx OPENAI_API_KEY <your CheapTokens key>

在 Windows 上有一个陷阱。setx 为将来的会话写入变量，而不是你当前正在输入的会话，因此在启动 Aider 之前，请关闭终端并打开一个新终端。如果你设置了变量但 Aider 仍然要求提供密钥，这通常是原因。

哪种编辑用哪个模型#

模型参数是 openai/ 加上完整 id，因此对于 CheapTokens 它有两个斜杠：

bash
cd your-git-repo
aider --model openai/MiniMaxAI/MiniMax-M2.7

MiniMax-M2.7 具有 180K 上下文，最多可回答 8,192 个 token，适合回答保持简短的小型和中等编辑。如果你的编辑返回为长 diff，另一个值得尝试的模型是 DeepSeek-V4-Flash：每次回答最多 32,768 个 token，380K 上下文，且全天统一价格。

bash
aider --model openai/deepseek-ai/DeepSeek-V4-Flash-0731

从 CheapTokens 文档 或 定价 上的模型列表复制完整 id。

运行第一次编辑#

Aider 在 git 仓库内工作，因此请在一个仓库中启动。添加一个文件并提出一个小请求：

text
> /add app.py
> Add a --verbose flag that prints each file before it is processed

当 Aider 以对文件的编辑作为回答时，说明密钥、基础 URL 和模型 id 都正确。

错误的模型 id 与可用的完整 id 并列，然后是第一次编辑
错误 id 与完整 id，以及第一次请求

不再重复输入：.aider.conf.yml#

Aider 会从你的主目录读取 .aider.conf.yml，然后是 git 仓库根目录，然后是当前目录，后面的文件优先。因此全局文件可以保存密钥和基础地址，而仓库文件可以选择模型。如果你只想要一个特定文件而不加载其他文件，aider --config <file> 只加载那一个。

主目录文件（示例，请填入你自己的密钥）：

yaml
openai-api-base: https://api.cheaptokens.dev/v1
openai-api-key: <your CheapTokens key>
model: openai/MiniMaxAI/MiniMax-M2.7

现在仅 aider 就能以正确的端点和模型启动。如果你将文件提交到仓库，请去掉密钥，将其保留在环境变量或 .env 文件中；密钥行仅供你自己的主目录使用。

对于 Aider 不认识的模型，文档描述了一个 model-settings-file（.aider.model.settings.yml），你可以在其中指定其设置。

一次会话的成本#

Aider 会在每条消息中重新发送你添加的文件和聊天历史，因此输入 token 的增长速度快于输出。假设一个约 20 条消息的工作会话发送 400,000 个输入 token 并返回 40,000 个输出 token（这是示例假设；请代入你自己的数字）。在 MiniMax-M2.7 上，这是 $0.026，并且输入和输出合计后，总成本比 OpenRouter 更便宜。下表将同一会话在我们的各个模型上运行：

模型 费用 OpenRouter
GLM-5.3-Flash $0.0096 $0.0196
DeepSeek-V4-Flash $0.01 $0.0253
MiniMax-M2.7 $0.026 $0.168

总计 400,000 个输入 token 和 40,000 个输出 token。每 100 万 token 的价格为当前价格，会随我们的资费一同变动；OpenRouter 列显示相同工作负载的参考价格。

如何保持输入侧较小（只读文件、/drop、仓库地图大小）在 How much does Aider cost 中有所介绍。当前价格始终在 定价页面 上。

如果它不工作#

  • Aider 要求提供 API 密钥或与错误的服务通信。 变量对该进程不可见。在 Windows 上，setx 后重启终端；在 Mac 和 Linux 上，在同一 shell 中运行 echo $OPENAI_API_BASE。
  • 你的配置似乎被忽略。 记住顺序：主目录、仓库根目录、当前目录。离你更近的文件会覆盖全局文件。
  • 模型未找到、404 或身份验证错误。 这些在 How to connect Aider to CheapTokens 中有所介绍。

相同的 OpenAI 兼容地址在其他工具中也可用；如果你还使用编辑器代理，请参阅 connecting OpenCode 或 where to plug in your own API key 的概述。

标签: