在 Coding Agent 接入

Aider 安装与 API 配置

安装 Aider，配置 BetterToken Base URL 和 API Key，选择模型并排查常见错误。

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

重点信息

已有账号？登录并充值，然后在控制台创建 API Key。

在终端中执行：

python -m pip install aider-install
aider-install

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

aider --help

export OPENAI_API_BASE="https://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://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/ 前缀。

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

OPENAI_API_BASE=https://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：

model: openai/YOUR_MODEL_ID
openai-api-base: "https://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://bettertoken.ai/v1`，不要填写 `/chat/completions`。
在 Windows 设置后仍读取不到变量	`setx` 只对新打开的终端生效。关闭当前 PowerShell 后重新打开。
Aider 提示不认识模型	先检查模型 ID 和 Base URL。Aider 可能对新模型显示警告，但模型仍需使用模型广场中的当前 ID。