Подключение Coding Agent

OpenHands CLI: установка, API Key и настройка Base URL

Установите OpenHands CLI через uv, задайте API Key BetterToken, Base URL и модель. Включите приоритет переменных окружения и проверьте запрос без интерфейса.

Подключите OpenHands CLI к BetterToken через переменные окружения. В тестах на macOS с моделью GPT OpenHands CLI 1.16.0 выполнил текстовые запросы без интерфейса и вызовы инструментов для чтения файлов через /v1/responses.

Ключевые параметры

Поле	Значение
API Key	API Key BetterToken в `LLM_API_KEY`
Base URL	`https://bettertoken.ai/v1` в `LLM_BASE_URL`
Model	`openai/YOUR_MODEL_ID` в `LLM_MODEL`
Переопределение настроек	`--override-with-envs`

Подготовка

uv и Python 3.12 или новее
API Key BetterToken: зарегистрироваться и получить
Model ID из каталога моделей

Установка

Используйте имя пакета и команду из официальной инструкции по установке:

uv tool install openhands --python 3.12
openhands --version

Ручная настройка

Замените YOUR_API_KEY и YOUR_MODEL_ID. Сохраните префикс openai/ в LLM_MODEL:

export LLM_MODEL="openai/YOUR_MODEL_ID"
export LLM_API_KEY="YOUR_API_KEY"
export LLM_BASE_URL="https://bettertoken.ai/v1"

При запуске OpenHands передайте --override-with-envs, чтобы эти переменные имели приоритет над сохранёнными настройками. Переопределение действует только для текущего запуска и не сохраняет значения в конфигурации.

Проверка подключения

openhands --headless --json --override-with-envs -t "Reply with only: OK"

Убедитесь, что итоговый ответ в выводе JSONL — OK. Чтобы отдельно проверить доступ к файлам, запустите OpenHands из каталога проекта и попросите прочитать известный вам файл. Сверьте и результат инструмента, и итоговый ответ.

Смена модели

Укажите в LLM_MODEL префикс openai/ и другой точный Model ID. Повторите запуск с --override-with-envs.

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

Симптом	Что проверить
Настройки из окружения не применяются	Добавьте `--override-with-envs` в команду.
Ошибка авторизации	Проверьте `LLM_API_KEY` в терминале, из которого запускаете OpenHands.
Неверный адрес API	Укажите `https://bettertoken.ai/v1` в `LLM_BASE_URL` без `/responses` и `/chat/completions`.
Модель не найдена	Сохраните префикс `openai/` и точно скопируйте остальную часть `LLM_MODEL` из каталога моделей.

См. также

Технические детали

OpenHands CLI 1.16.0 отправлял тестовые текстовые запросы и запросы на чтение файлов на /v1/responses. Оставьте /v1 в конце Base URL: путь запроса добавляет клиент.