Подключение инструментов: когда нужен /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_URLClaude 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.

