⌘ IDE и клиенты

Aider

Парный программист в терминале Aider через TKBK: OPENAI_API_BASE https://api.tkbk.online/v1, модели openai/… (Claude и GPT), файл .aider.conf.yml, работа с git.

Обновлено ⏱ 6 мин
#aider#cli#openai#git#pair programming

Aider — терминальный парный программист: правит файлы и сам делает git-коммиты. Он работает с OpenAI-совместимым API, а TKBK отдаёт в этом формате и Claude, и GPT — поэтому хватает одного адреса. Ключ — того семейства, чью модель вы запускаете: Claude — ключ Claude, GPT — ключ GPT.

✓
Что получится
Aider правит код и коммитит изменения на claude-sonnet-5, gpt-6.1-sol или любой другой модели каталога через шлюз TKBK.

#Требования

  • Python 3.10+ и Aider (python -m pip install aider-install → aider-install).
  • Git-репозиторий (Aider коммитит правки).
  • Ключ cr_xxx и баланс.

#Запуск через флаги

Разовый запуск
aider \
  --openai-api-base "https://api.tkbk.online/v1" \
  --openai-api-key "cr_ваш_ключ" \
  --model "openai/claude-sonnet-5"

#Через переменные окружения

macOS / Linux
export OPENAI_API_BASE="https://api.tkbk.online/v1"
export OPENAI_API_KEY="cr_ваш_ключ"
aider --model openai/claude-sonnet-5
Windows (новое окно после setx)
setx OPENAI_API_BASE "https://api.tkbk.online/v1"
setx OPENAI_API_KEY "cr_ваш_ключ"
aider --model openai/gpt-6.1-sol

#Файл конфигурации .aider.conf.yml

Чтобы не повторять флаги, положите .aider.conf.yml в корень проекта или в домашнюю папку.

.aider.conf.yml
openai-api-base: https://api.tkbk.online/v1
openai-api-key: cr_ваш_ключ
model: openai/claude-sonnet-5
# дешёвая модель для служебных шагов (сообщения коммитов, сжатие истории)
weak-model: openai/claude-haiku-4-5
ПараметрЗначение
--openai-api-basehttps://api.tkbk.online/v1
--openai-api-keycr_xxx
--modelopenai/claude-sonnet-5, openai/claude-opus-5-5 или openai/gpt-6.1-sol
--weak-modelopenai/claude-haiku-4-5 или openai/deepseek-v4.1-flash
⚠
Грабли
Aider построен на LiteLLM, поэтому модель указывают с префиксом openai/: openai/claude-sonnet-5, а не claude-sonnet-5. Без префикса LiteLLM попытается угадать провайдера и уйдёт мимо адреса TKBK. Модели Claude здесь идут через формат Chat Completions — шлюз сам переводит запрос.

#Частые ошибки

СимптомПричинаРешение
404в адресе нет /v1OPENAI_API_BASE=https://api.tkbk.online/v1
LLM Provider NOT providedнет префикса openai/укажите --model openai/<id>
401ключ не подхватился после setxоткройте новое окно терминала

Проверка: запустите Aider в git-репозитории, добавьте файл командой /add и попросите внести правку. Если Aider покажет дифф и сделает коммит — интеграция работает.

Не помогло?

Напишите в Telegram — поможем с настройкой и подберём тариф. Или вернитесь ко всем разделам документации.