ДокументацияЧитать блог
ДокументацияДля пользователей моделей

Подключение инструментов: когда нужен /v1

Разберитесь в Base URL, ключе, модели и протоколе, затем проверьте соединение.

Три обязательные настройки

НастройкаЗначение
Base URL / адрес APIЛокальный адрес работающего User Client с путём нужного протокола
API key / tokenЛокальный ключ User Client
МодельДоступный для этого ключа идентификатор модели

Адрес и ключ должны принадлежать одному Client. Адрес сайта, ключ платформы и ключ провайдера — другие данные.

Примеры адресов

Для корня http://127.0.0.1:18000:

  • Base URL OpenAI SDK обычно http://127.0.0.1:18000/v1; SDK добавляет Chat Completions или Responses.
  • ANTHROPIC_BASE_URL Claude Code обычно содержит корень, а запрос идёт на /v1/messages.
  • Прямой HTTP использует полный адрес, например http://127.0.0.1:18000/v1/responses.

Не дублируйте /v1/v1. Полный адрес Responses не подходит как Base URL SDK, если инструмент прямо этого не требует. Копируйте реальный порт Client.

Локальный адрес можно посмотреть и скопировать вверху страницы локальных ключей.

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

Просмотр конфигурации помогает проверить и скопировать настройки. Импорт Agent в Desktop предварительно показывает файлы, создаёт резервную копию и применяет поддерживаемые настройки. Для CC Switch требуется установленная программа.

Выберите в инструменте совместимого с OpenAI либо Anthropic провайдера согласно формату запроса. Преобразование протокола не меняет требования инструмента к чтению ответа.

Минимальная HTTP-проверка

Замените оба обозначения своей доступной моделью и локальным ключом:

curl http://127.0.0.1:18000/v1/responses \
  -H "Authorization: Bearer YOUR_LOCAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_AVAILABLE_MODEL","input":"Reply only OK","stream":false}'

В PowerShell можно использовать curl.exe; переносы Bash не подходят каждому Shell. Новичку достаточно отправить короткое сообщение из настроенного инструмента.

Найдите запрос в истории. Для кодирующего Agent дополнительно проверьте выполнение инструмента. Далее: Codex, Claude Code, другие Agents.