Учебный материал

Песочница для учеников · проект пилота

Дата проверки источников: 13 октября 2026 г. Статус: личный шаблон подготовлен, ручной облачный запуск наблюдался; полный пилот отложен. Управляемая платформа, gateway и раздача платных ключей не реализованы. Основной маршрут текущей подготовки — teacher/ai-route.md; альтернативы ниже — исследование.

Три варианта

Сравнение хостинга и пример бюджета: Codespaces, Daytona, свой сервер с Coder и E2B. Тарифы проверены 13 октября 2026; окончательный вариант пилота ещё не выбран.

Дополнительные варианты для потока до 10 учеников: Northflank, Cloudflare, Replit, локальная и браузерная лаборатория. Расчёты отделены от стоимости разработки и ещё не проверены на действующем потоке.

Вариант	Как ученик работает	Плюсы	Что потребуется
1. Быстрый пилот	Личный учебный проект на компьютере, отдельный ограниченный ключ и совместимый агент	Меньше инфраструктуры; проверяем расход и методику	Помощь с установкой, настройки разрешений; отдельной серверной изоляции здесь нет
2. Управляемая облачная среда	Вход в курс → личный sandbox с файлами, агентом и preview	Единый старт; собственные машины учеников проще поддерживать	Провайдер исполнения, интерфейс/редактор, управление сессией, проверка прав и сохранение файлов
3. Своя учебная платформа и gateway	Тот же интерфейс с централизованной политикой моделей, квот и сессий	Максимальная управляемость	Разработка, совместимость API, журнал расходов, поддержка изоляции и постоянное сопровождение

Порядок: проверить методику и расходы вариантом 1 на небольшой группе; затем сделать вариант 2, если нужен вход из браузера. Gateway из варианта 3 добавлять по измеренной необходимости. Один чат с ключом не даёт ученику рабочую среду для изменения, запуска и проверки кода.

Предлагаемая схема варианта 2

flowchart LR
  U[Ученик] --> L[Вход в курс]
  L --> C[Проверка владельца пространства]
  C --> S[Личный sandbox: файлы, агент, запуск]
  S --> K[Индивидуальный ключ с лимитом]
  K --> P[Провайдер модели]
  S --> V[Закрытый preview приложения]
  S --> E[Экспорт проекта]
  A[Админ курса] --> C
  A --> K
  A --> B[Расход и отзыв доступа]

В качестве управляемого исполнения можно оценить E2B. У него описаны жизненный цикл и сохранение/возобновление sandbox; редактор, вход ученика и интерфейс preview нужно реализовать или интегрировать отдельно. Это не готовая LMS. Перед остановкой среды сохранять проект; стоимость compute и хранения сверить по выбранному плану. Жизненный цикл, сохранение состояния.

Ключи и бюджет

Соответствие student_id → workspace_id → key_id хранит сервер курса. Master/management-ключ — только в административном хранилище; в учебную среду попадает максимум индивидуальный ограниченный ключ.
На ключе задаём общий лимит на весь пилот и срок действия/отзыва. Если используется ежедневный reset, это уже другой бюджет; для пробных $10 reset отключить.
Для администратором созданных ключей использовать лимит самого ключа или прямую привязку guardrail: расходы не становятся расходами ученика лишь потому, что он использует ключ админа.
Набор допустимых моделей и поставщиков ограничивать политикой провайдера либо серверным gateway. Выпадающий список в редакторе сам по себе не препятствует использованию другой модели.
Учёт BYOK, условия отдельных guardrails и доступность настроек на выбранном тарифе проверяем отдельно. На пилоте предпочтительнее одна понятная схема оплаты без смешения BYOK и кредитов.
Начать с одного запроса агента одновременно на ученика и ограниченного ответа/числа шагов; проверить приостановку новых запросов у границы лимита и фактическое завершение уже запущенных.

OpenRouter: ограничения и атрибуция расходов. Лимит модели не является лимитом аренды sandbox. Простой индикатор «осталось $10» не заменяет проверенный механизм остановки.

Изоляция и рабочий интерфейс

В шаблоне добавлены настройки безопасности: ограниченная выдача файлов, отключённая автоматическая передача env в клиент, подтверждение команд агента, проверка части секретов при commit и Private назначения перед push. Эти настройки изменяемы владельцем среды. HTTPS и шифрование Codespaces secrets защищают разные участки; активная среда и выбранный AI-провайдер получают необходимые данные расшифрованными. Чтобы скрыть оплачиваемый ключ от ученика, требуется отдельный серверный gateway; его пока нет.

В среде ученика: только его учебные файлы, непривилегированный процесс, ограниченные ресурсы, аутентифицированный preview и возможность скачать проект. Общие каталоги других учеников, административные ключи, Docker socket и доступ к внутренним системам преподавателя не доступны. Сетевые ограничения проверяются технически, а не только записью в правилах агента.

В кабинете показываем шаблон задания, подключённый инструмент, доступную модель, подтверждённый расход с временем обновления, срок доступа, кнопки остановки и экспорта. Данные расхода могут приходить с задержкой — интерфейс отражает это, не обещает мгновенный баланс.

Остановка агента, пауза compute и отзыв ключа — разные операции. После закрытия доступа сохраняем/выгружаем проект, отключаем ключ и останавливаем активное исполнение по согласованным условиям хранения.

Claude Code и Codex

Codex поддерживает API-ключи для локальных клиентов; cloud имеет свои требования к входу. Пользовательский провайдер Codex должен поддерживать Responses API. Claude Code поддерживает gateway соответствующего формата; маршрутизация Claude Code на не-Claude модели не поддерживается Anthropic. Поэтому не обещаем «один ключ для всех агентов». Вход Codex, конфигурация, Claude Code.

Смета без неподтверждённых тарифов

Бюджет пилота = число учеников × пробный лимит модели + compute sandbox + хранение + комиссии поставщика + сопровождение.

Для пяти учеников верхний плановый объём кредитов — $50. Это сумма выделения, не обещание стоимости всего пилота. Тарифы инфраструктуры, минимальное пополнение и комиссии нужно получить перед покупкой. Автопополнение не включаем в пилот.

Условия готовности пилота

Два ученика не видят файлы, preview и ключи друг друга; попытки обхода URL проверены.
Один учебный проект проходит путь «задача → изменение → запуск → проверка → экспорт».
Подтверждены фактическое списание, достижение лимита, параллельные запросы и отзыв одного ключа без влияния на других учеников.
Политика моделей соблюдается при прямом запросе к провайдеру, а не только в интерфейсе.
Пауза/возобновление не теряет проект; закрытие вкладки не оставляет бесконтрольную работу.
Согласованы допустимая выдача ключей/доступа по условиям поставщика, тариф, регион и обработка учебных данных.

Эти условия сейчас не проверены в работающей инфраструктуре. Следующий конкретный шаг — выбрать режим пилота и провайдера, затем подготовить технический шаблон без ключей; подключение реальных платных ресурсов выполняется отдельно.

Текущий маршрут подготовки

Основной вариант первого потока — личный Codespaces и OpenCode, Copilot с чтением инструкции — резерв. Комплект преподавателя, доступ и сдача, условия и цены. Живой пилот с одним новичком проводится позже по решению владельца. Варианты хостинга и $10 выше — исследования/предложения; не включены автоматически в оплату.