Aider 接入 kkaiapi

最后更新:

使用 OPENAI_API_BASE、OPENAI_API_KEY 与 openai/模型ID 启动 Aider,核对主弱模型路由、元数据、diff 与测试结果。

用 openai/ 前缀固定兼容路由

在启动 Aider 的终端设置 OPENAI_API_BASE 和 OPENAI_API_KEY;openai/ 是 Aider 的 provider 前缀,发给 KK 的模型 ID 是前缀后的部分。密钥从环境安全注入,不写入仓库。

配置项值
协议OpenAI Chat Completions
Base URLhttps://api.kkaiapi.com/v1
模型 IDclaude-sonnet-5-5
凭据从当前工具进程的安全配置读取

起步命令或客户端示例

配置完成后用一个短任务核对实际模型 ID 与 KK 调用记录,再单独验证工具往返、图片输入等所需能力。聊天成功只能证明该聊天路径可用。

export OPENAI_API_BASE="https://api.kkaiapi.com/v1"
# 先在当前进程安全设置 OPENAI_API_KEY,再启动
aider --model openai/claude-sonnet-5-5

核对实际生效的工具路径

给一个文件执行一次修改并运行已有测试,检查 diff。弱模型与 architect 编辑模型若单独配置,也需使用正确前缀和兼容端点。未知窗口或零费用提示说明本地元数据缺失,不能据此认定无限窗口或免费。

配置依据与能力验证

配置完成后用一个短任务核对实际模型 ID 与 KK 调用记录,再单独验证工具往返、图片输入等所需能力。聊天成功只能证明该聊天路径可用。

配置字段依据aider 官方说明;工具界面可能随版本变化,所需能力应在已安装版本中核对。

常见问题

为什么 API 请求成功,工具仍不能完成任务?

继续核对工具实际选择的 provider、模型、能力声明和运行进程的网络出口;工具调用、文件编辑和图片入口应分别验证。