跳到主要内容

Aider

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

准备工作​

codebuddy

配置步骤​

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..."
  1. 启动 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
  1. 写入以下配置
openai-api-base: https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase
openai-api-key: eyJhbGciOiJSUzI1N...
model: openai/hy3-preview
  1. 之后在终端直接运行 aider 即可使用配置的模型
aider