Идентифицируемая история работы агента и связанное с ней состояние в Codex. Поток и тред — синонимы. Поток может включать несколько ходов выполнения и не обязательно отображается пользователю как переписка. ThreadId обозначает объект приложения, а не поток или процесс операционной системы.
Поток и тред в этом справочнике означают один объект. Он может использоваться в терминале, программном запуске или системе из нескольких агентов. Наличие потока не требует видимого диалога с человеком или обмена репликами между несколькими сторонами.
Зачем нужен отдельный идентификатор
Вы можете продолжить работу с сохранённой историей потока. ThreadManager умеет создавать и получать потоки. Новый субагент получает дочерний тред; при fork часть истории может наследоваться.
История и исполняемая сессия
Сохранённый поток может существовать, пока вычисления не идут. Загруженная сессия содержит состояние выполнения. Поэтому перечисление потоков, число активных агентов и число запросов к модели — разные показатели.
Проверка своей интеграции
Для обработки нескольких независимых заявок отдельные потоки позволяют не смешивать их истории. При этом изоляция данных и файлов требует собственных правил. Разные ThreadId не означают разные рабочие каталоги или права.
Как эти части соединяются, показано в разборе «Как Codex собирает запрос к LLM».
Где проверить в исходниках
Разбор от 15 ноября 2026 года, ревизия 727283cea5ba30e8cf8bbac6b68a03a4d91cf1b7. Пути ниже указаны от корня репозитория Codex. Они относятся к реализации клиента; внутренний код серверов OpenAI здесь не исследуется.
codex-rs/core/src/thread_manager.rs—start_thread. Создаёт поток и связанную сессию.codex-rs/exec/src/cli.rs—Command. CLI поддерживает продолжение и fork.
Практика: различить поток и ход
Найдите создание потока и команды продолжения.
Откройте терминал в корне локального репозитория Codex. Нужны Git и ripgrep (rg). Сначала сравните git rev-parse HEAD с ревизией выше. При другой версии найдите символы заново: структура и поведение могут отличаться.
rg -n 'pub async fn start_thread|pub async fn get_thread|spawn_child_thread' codex-rs/core/src/thread_manager.rs
rg -n 'Resume|Fork' codex-rs/exec/src/cli.rs
Что найти: Управление thread существует отдельно от run_turn.
Вопрос для проверки: Если отправить два сообщения в один поток, появятся ли обязательно два ThreadId?
Разобрать ответ
Нет. Один поток может содержать несколько ходов; новое сообщение может также направляться в текущий ход через механизм steering.