// интеграция

Aider через teamToken

Aider не требует своего конфига: он читает обычные переменные OpenAI, а адрес берёт из той, что задаёт базовый URL. Настройка занимает две строки, а третья, с именем модели, и есть то место, где всё ломается.

Что это за инструмент

Aider это терминальный помощник, который правит файлы в репозитории и коммитит изменения. Провайдер задаётся переменными окружения, отдельного конфига под это заводить не нужно.

Две переменные и запуск

export OPENAI_API_BASE="https://api.teamtoken.store/v1"
export OPENAI_API_KEY="<ваш ключ teamToken>"

aider --model openai/gpt-5.3-codex

Переменные обычные, те же самые, что использует официальный клиент OpenAI. Меняется только адрес в первой из них.

Префикс openai/ обязателен

Имя модели передаётся как openai/gpt-5.3-codex, а не просто gpt-5.3-codex. Префикс говорит aider, каким протоколом идти к провайдеру.

Без него aider пытается разобрать имя сам, не находит знакомого совпадения и падает на этапе выбора провайдера. Запрос при этом не уходит вообще, так что искать причину в ключе, адресе или балансе бесполезно: до них дело не дошло.

Имя после префикса должно совпадать с каталогом дословно. Список отдаёт GET /v1/models, там имена без префикса, его добавляете вы сами.

Откуда взялся этот префикс

Aider не разговаривает с провайдерами сам: маршрутизацию он целиком делегирует библиотеке litellm, которая у него в прямых зависимостях. Отсюда и формат имени: openai/ это её способ сказать, каким протоколом идти, а не выдумка aider.

Побочное следствие, приятное для нас: на той же библиотеке построен и наш шлюз. Так что по обе стороны соединения работает один и тот же код, просто у вас он выбирает провайдера, а у нас принимает запрос.

Проверка перед запуском

Отделить проблему с ключом от проблемы с префиксом проще заранее, одним запросом.

curl https://api.teamtoken.store/v1/chat/completions \
  -H "Authorization: Bearer $TEAMTOKEN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"ping"}]}'

Если ответ пришёл, значит ключ, адрес и баланс в порядке, и когда aider всё равно падает, дело в имени модели. Если не пришёл, то до aider очередь ещё не дошла.

Какие модели брать

Под правку кода openai/gpt-5.3-codex, под разговор о задаче и планирование openai/gpt-5.6-sol, под мелкие правки openai/gpt-5.4-mini. Модель меняется флагом при запуске, ничего перенастраивать не надо.

Лимит трат на ключ

Aider работает по всему репозиторию и складывает файлы в контекст, поэтому расход зависит от размера проекта сильнее, чем от длины вашего вопроса. Ключ под него стоит завести отдельный и поставить потолок в кабинете.

Если не работает

Падает сразу при запуске
Почти всегда это отсутствующий префикс openai/ в имени модели. Запрос в таком случае не отправляется, ошибка происходит до сети.
Запрос уходит, но приходит отказ
Значит префикс на месте, а проблема дальше: проверьте переменную OPENAI_API_BASE, она должна оканчиваться на /v1.
Модель не найдена
Имя после префикса сверяется с каталогом. Возьмите его из GET /v1/models и не набирайте по памяти.
Работает ли из России
Эндпоинт открывается напрямую, пополнение картой, через СБП или криптой, от доллара.
Рядом
Codex CLIOpenCodeteamToken и LiteLLM
Получить ключ