Aider 安装、API Key、Base URL 与自定义模型配置

要在 Aider 中使用 BetterToken，请准备 API Key，填写下表中的 Base URL，并从模型广场选择当前可用的 Model ID。

重点信息

字段	填写内容
API Key	BetterToken API Key
Base URL	`https://www.bettertoken.ai/v1`
Model	从模型广场复制的当前 Model ID

准备工作

已安装该工具的当前版本
BetterToken API Key：注册并获取
从模型广场复制的 Model ID

工具特定要求

已安装 Python

安装

安装 Aider

在终端中执行：

python -m pip install aider-install
aider-install

安装完成后，运行以下命令确认 Aider 可用：

aider --help

手动配置

字段	填写内容
API Key	BetterToken API Key
Base URL	`https://www.bettertoken.ai/v1`
Model	从模型广场复制的当前 Model ID

为当前终端配置 BetterToken

macOS / Linux
Windows PowerShell

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

cd /path/to/your/project
aider --model openai/YOUR_MODEL_ID

setx OPENAI_API_BASE "https://www.bettertoken.ai/v1"
setx OPENAI_API_KEY "YOUR_API_KEY"

执行 setx 后，请关闭并重新打开 PowerShell，再进入项目目录并运行：

aider --model openai/YOUR_MODEL_ID

将 YOUR_API_KEY 替换为你的 BetterToken API Key。YOUR_MODEL_ID 只是示例；请改为模型广场中当前可用的 受支持提供商的模型 ID，并保留 openai/ 前缀。

使用 .env 持久保存配置

如果不想每次打开终端都设置变量，可在项目 Git 根目录创建 .env：

OPENAI_API_BASE=https://www.bettertoken.ai/v1
OPENAI_API_KEY=YOUR_API_KEY
AIDER_MODEL=openai/YOUR_MODEL_ID

将 .env 加入 .gitignore，避免 API Key 被提交。之后进入项目目录并直接运行：

aider

需要为某个项目使用其他文件时，可显式指定：

aider --env-file ./aider-bettertoken.env

可选：使用 .aider.conf.yml

如果只想保存非敏感设置，可在用户目录或项目根目录创建 .aider.conf.yml：

model: openai/YOUR_MODEL_ID
openai-api-base: "https://www.bettertoken.ai/v1"

API Key 仍通过 OPENAI_API_KEY 环境变量提供，不要写入共享 YAML 文件。

验证连接

发送一条简短测试消息。工具正常返回内容，并且没有认证或 Model ID 错误，就说明连接成功。修改配置后请完全退出并重新启动工具。

切换模型

打开模型选择器，或修改配置中的 Model 字段。请填写模型广场中的完整 Model ID，然后重新启动当前会话。将启动命令中的模型替换为当前可用的 受支持提供商的模型 ID：

aider --model openai/YOUR_MODEL_ID

openai/ 前缀不能省略。API Key 与模型必须属于当前配置使用的接口。

常见错误

现象	处理方式
`401`、`Unauthorized` 或 `Invalid API key`	检查 `OPENAI_API_KEY`，确认使用的是 BetterToken API Key，且没有多余空格。
`model not found` 或模型不可用	从模型广场重新复制当前受支持提供商的模型 ID，并以 `openai/模型 ID` 格式传给 Aider。
请求地址错误或 `404`	确认 `OPENAI_API_BASE` 是 `https://www.bettertoken.ai/v1`，不要填写 `/chat/completions`。
在 Windows 设置后仍读取不到变量	`setx` 只对新打开的终端生效。关闭当前 PowerShell 后重新打开。
Aider 提示不认识模型	先检查模型 ID 和提供商。Aider 可能对新模型显示警告，但模型仍需使用模型广场中的当前 ID。

配置 FAQ

Aider 的 Base URL 应该填写哪个地址？ 填写 https://www.bettertoken.ai/v1。这是 BetterToken 的 OpenAI-compatible Base URL。 为什么模型名前要加 openai/？ Aider 用这个前缀识别 OpenAI-compatible 模型。省略前缀可能导致它使用错误的 provider。 可以把 API Key 写进 .aider.conf.yml 吗？ 不建议。优先使用环境变量或已加入 .gitignore 的 .env，避免 API Key 随项目文件泄露。

进阶配置

支持的提供商

提供商	状态
Claude	暂不支持
GPT	手动配置
Kimi	手动配置
GLM	手动配置

状态仅针对本页介绍的 BetterToken 接入方式。

配置方式说明

手动配置：填写 API Key、Base URL 和 Model。
不支持：当前没有经过验证的直接配置方式。

技术说明

协议、endpoint 与 provider 内部字段

本页配置使用 https://www.bettertoken.ai/v1。工具会自行拼接 OpenAI-compatible endpoint；除非具体字段明确要求，否则不要在 Base URL 后附加 /chat/completions 或 /responses。

开始使用

在 Coding Agent 接入

在 AI 应用平台接入

进阶

Aider 安装、API Key、Base URL 与自定义模型配置

重点信息

准备工作

工具特定要求

安装

安装 Aider

手动配置

为当前终端配置 BetterToken

使用 .env 持久保存配置

可选：使用 .aider.conf.yml

验证连接

切换模型

常见错误

配置 FAQ

进阶配置

支持的提供商

相关指南

技术说明

​重点信息

​准备工作

​工具特定要求

​安装

​安装 Aider

​手动配置

​为当前终端配置 BetterToken

​使用 .env 持久保存配置

​可选：使用 .aider.conf.yml

​验证连接

​切换模型

​常见错误

​配置 FAQ

​进阶配置

​支持的提供商

​相关指南

​技术说明

重点信息

准备工作

工具特定要求

安装

安装 Aider

手动配置

为当前终端配置 BetterToken

使用 .env 持久保存配置

可选：使用 .aider.conf.yml

验证连接

切换模型

常见错误

配置 FAQ

进阶配置

支持的提供商

相关指南

技术说明