Aider

Aider 是一款运行在终端的开源 AI 编程助手，支持多文件编辑、Git 集成，能够通过自然语言对话直接修改本地代码库。

准备工作

• 已开通云开发环境，获取环境ID cloudBase环境ID
• 在 AI 控制台中开启所需模型
• 在 AI 控制台中获取 Base URL 和 API Key

Base URLhttps://<ENV_ID>.api.tcloudbasegateway.com/v1/ai/cloudbase

配置步骤

Aider 支持通过环境变量或命令行参数配置自定义模型。CloudBase AI 兼容 OpenAI 协议，使用 openai 前缀即可接入。

配置字段对照表

环境变量	解释
OPENAI_API_BASE	大模型 Base URL，在 AI 控制台中获取
OPENAI_API_KEY	调用大模型 API Key，在 AI 控制台中获取

环境变量配置

1. 设置环境变量

Mac/Linux（当前终端窗口有效）

export OPENAI_API_BASE="https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase"
export OPENAI_API_KEY="eyJhbGciOiJSUzI1N..."

Windows CMD（当前终端窗口有效）

set OPENAI_API_BASE=https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase
set OPENAI_API_KEY=eyJhbGciOiJSUzI1N...

Windows PowerShell（当前终端窗口有效）

$env:OPENAI_API_BASE = "https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase"
$env:OPENAI_API_KEY = "eyJhbGciOiJSUzI1N..."

2. 启动 Aider，通过 --model 参数指定模型 ID

aider --model openai/hy3-preview

备注

模型 ID 需要加上 openai/ 前缀，表示通过 OpenAI 兼容协议调用。大模型 ID 在 AI 控制台 模型列表中获取。

命令行参数配置

如果不想设置环境变量，也可以直接通过命令行参数启动：

aider --model openai/hy3-preview \
  --openai-api-base "https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase" \
  --openai-api-key "eyJhbGciOiJSUzI1N..."

配置文件（永久生效）

1. 在项目根目录或用户主目录创建 .aider.conf.yml 文件

• 项目级配置（仅当前项目生效）

<项目根目录>/.aider.conf.yml

• 用户级配置（全局生效）

~/.aider.conf.yml

2. 写入以下配置

openai-api-base: https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase
openai-api-key: eyJhbGciOiJSUzI1N...
model: openai/hy3-preview

3. 之后在终端直接运行 aider 即可使用配置的模型

aider