Codex App Server - это протокольный слой, поверх которого строят собственные клиенты. Если SDK даёт готовый интерфейс для языка, то App Server - это уровень ниже: сам протокол, к которому можно подключиться из чего угодно. Он доступен через JSONL поверх stdio, WebSocket и Unix-сокет. Важная оговорка с самого начала: документация помечает команду как экспериментальную, поэтому сгенерированный клиент должен быть version-aware - учитывать версию протокола, а не полагаться на её неизменность.

Транспорты App Server покрывают разные сценарии подключения. Полезно один раз увидеть их рядом. Ниже - запуск с JSONL поверх stdio по умолчанию, локальный WebSocket на 127.0.0.1 и Unix-сокет. stdio удобен для дочернего процесса, Unix-сокет - для локального межпроцессного взаимодействия, WebSocket - для сетевого клиента. Выбор транспорта - это выбор того, как клиент подключается, и у каждого своя область применения и своя граница безопасности.

WebSocket-транспорт открывает сеть, и здесь проходит серьёзная граница риска. Нелокальный WebSocket-listener без аутентификации - это открытая дверь: кто угодно, дотянувшийся до порта, получает доступ к выполнению. Локальный слушатель на 127.0.0.1 ограничен машиной, но нелокальный требует защиты обязательно. Это не деталь конфигурации, а вопрос того, кто вообще может подключиться к вашему App Server и, через него, выполнять действия.

Полезно один раз увидеть защищённый запуск для удалённых клиентов. Ниже - WebSocket с --ws-auth capability-token и --ws-token-file, указывающим на файл с токеном в защищённом пути. Связка проста: слушатель требует токен, токен лежит в файле с ограниченным доступом, а не в командной строке или логе. Для любого нелокального клиента это минимум: без аутентификации нелокальный listener поднимать нельзя, а токен держат там, откуда его не утащат.

Жизненный цикл клиента - это то, что отличает игрушечный прототип от production-клиента. Полезно понимать его целиком. Production-клиент обязан корректно обрабатывать инициализацию, создание и возобновление thread, старт и отмену turn, потоковые items, approvals и вызовы инструментов. Каждый из этих этапов - не опциональная деталь, а часть контракта: клиент, который не умеет отменить turn или обработать approval, будет вести себя непредсказуемо ровно тогда, когда это важнее всего.