🧠 AI Codex Coding Assistant

Что такое встроенный Codex-режим в EyeAuras, чем он отличается от обычного AI Assistant, что такое threads и что он умеет уже сейчас

Ранний альфа-функционал. Уже вполне практичный, но runtime, auth-сценарии и часть tooling еще активно дорабатываются. На текущий момент самый надежный путь для Codex - OpenAI-профиль в режиме API Key. Это может быть как прямой OpenAI, так и профиль EyeAuras Gateway / AiGateway.

Что это такое

Codex в EyeAuras - это отдельный режим вкладки AI для сложных технических задач.

Если обычный AI Assistant удобнее воспринимать как быстрый встроенный чат и справочник, то Codex ближе к формату "дай задачу, дай контекст и дай ассистенту спокойно поработать".

Именно поэтому Codex лучше подходит для сценариев вроде:

разобраться, почему не компилируется текущий скрипт
помочь отредактировать код в EyePad
разложить по шагам сложную automation-задачу
помочь со структурой дерева, макроса или мини-приложения

Для простых вопросов по wiki и настройкам обычный AI Assistant часто проще, быстрее и дешевле.

Start Codex Session

Чем он отличается от обычного `AI Assistant`

обычный AI Assistant лучше подходит для быстрых вопросов, поиска по wiki и общего in-app chat
Codex сильнее именно на программировании, разборе проблем и нетривиальных задачах
Codex работает через отдельные threads, а не как один непрерывный чат
Codex глубже опирается на текущий рабочий контекст EyePad и tools EyeAuras
у Codex сейчас более строгая схема подключения: лучше всего использовать OpenAI-профиль в режиме API Key, будь то прямой OpenAI или EyeAuras Gateway

Когда стоит выбирать `Codex`

Используйте Codex, если задача похожа на одну из этих:

почему этот Script.csx не работает
помоги переписать текущий код аккуратнее
разбери ошибку и предложи минимальный фикс
помоги спроектировать логику ауры, дерева или макроса
сравни несколько вариантов решения и предложи лучший

Если же вам нужен просто справочный ответ вроде "где эта настройка" или "какая функция за что отвечает", обычно лучше начать с AI Assistant.

Как начать

Codex живет в той же вкладке AI, что и обычный AI Assistant.

Базовая схема такая:

Откройте вкладку AI.
Переключите режим Chat -> Codex.
Выберите подходящий OpenAI-профиль.
Оставьте режим аутентификации API Key.
Убедитесь, что справа статус готовности зеленый.
Нажмите Start Codex.
После запуска нажмите New Thread.

Под подходящим OpenAI-профилем здесь может пониматься:

обычный прямой OpenAI
EyeAuras Gateway / AiGateway

Если вы еще не настраивали профили, Endpoint, API Key или Show Settings, сначала лучше открыть общую статью:

AI Assistant внутри EyeAuras

Важно: для Codex текущая интеграция строже, чем у обычного AI Assistant, но не настолько, как было бы сказать "только прямой OpenAI". Практически это означает:

Codex нормально работает через обычный OpenAI
Codex может работать через EyeAuras Gateway / AiGateway
а вот Ollama и другие отдельные схемы подключения здесь уже не универсальный сценарий
режим ChatGPT Login сейчас стоит воспринимать именно как сценарий для прямого OpenAI, а не для gateway-endpoint'ов

Agent Guidance и MCP

В AI-настройках есть отдельный раздел Agent Guidance.

Это особенно полезно, если вы работаете не только со встроенным Codex, но и с внешними AI coding tools: Codex, Claude Code, Cursor и т.п.

ELI5:

Agent Guidance - это правила и указатель на актуальный EyeAuras-контекст
guidance-pack - переносимая папка с инструкциями, wiki snapshot и metadata
AGENTS.md - entry point внутри этой папки, а не файл, который EyeAuras вставляет в ваш проект
MCP - локальный мостик, через который агент может точечно спросить EyeAuras о текущем состоянии программы, окнах или доступных объектах/символах

Встроенный Codex внутри EyeAuras уже получает docs context через свою интеграцию. Agent Guidance нужен в первую очередь для внешних агентов и проектов, которые вы открываете вне EyeAuras: экспортированный workspace, C# проект рядом с .csproj, отдельная папка со скриптами и т.п.

Практически это выглядит так:

В EyeAuras откройте AI -> Show Settings -> Agent Guidance.
Нажмите Rebuild, если хотите обновить guidance pack.
Нажмите Add to C# Project или Add to Solution, чтобы скопировать pack в generated/ai рядом с выбранным .csproj или C# проектом из .sln.
Откройте проект во внешнем агенте.
Передайте агенту папку generated/ai или попросите начать с generated/ai/AGENTS.md.

Для простых вопросов это не обязательно. Но для задач вроде "почини скрипт", "разберись с API", "собери мини-приложение" или "проверь проект" guidance сильно повышает шанс, что агент пойдет читать правильные документы, а не будет сочинять общие ответы про C#.

Что такое `thread`

Проще всего думать так:

Thread - это отдельная рабочая задача со своей историей, своим контекстом и своим состоянием.

Например:

один thread может быть про диагностику текущего скрипта
второй thread - про новую идею для дерева поведения
третий thread - про рефакторинг куска кода

У каждого thread'а своя память разговора. Это удобно, потому что разные задачи не смешиваются в одну большую кашу.

Кроме того, у thread'ов есть и служебная часть:

имя или preview
история сообщений
текущий статус
выбранная модель
уровень reasoning
возможность позже открыть thread снова или отправить его в архив

Codex Threads

Можно ли держать несколько `threads` одновременно

Да.

Это как раз одна из сильных сторон текущей интеграции: можно запустить один thread, вернуться к списку, открыть другой и продолжить работать уже там.

При этом возврат в список не останавливает первый thread автоматически. Полная остановка происходит только если вы явно нажимаете Stop Codex или полностью перезапускаете runtime.

Как это работает внутри EyeAuras

В ELI5-виде схема такая:

Start Codex поднимает отдельный runtime внутри EyeAuras.
New Thread создает новую рабочую ветку для конкретной задачи.
Перед каждым новым запросом EyeAuras обновляет контекст: профиль, docs knowledge base, текущую рабочую среду и доступные tools.
Если вы работаете через EyePad, Codex видит текущий активный workspace, а не какой-то абстрактный "кусок текста".
Каждый thread живет своей жизнью: у него своя история, свой статус и свои настройки модели.

Из-за этого Codex ощущается не как просто "еще одно окно ChatGPT", а как более рабочий технический ассистент внутри самой программы.

Что уже умеет сейчас

На данный момент про интеграцию уже можно честно сказать следующее:

есть отдельный режим Codex внутри вкладки AI
есть запуск и остановка runtime через Start Codex / Stop Codex
есть список threads, их повторное открытие и архивирование
можно держать несколько threads параллельно и переключаться между ними
для активного thread можно менять модель и уровень reasoning
если включена Docs Knowledge Base, Codex тоже может опираться на wiki и локальную docs-базу
в сценариях EyePad он видит текущий workspace и лучше понимает, с чем именно сейчас работает пользователь
в текущей интеграции он уже умеет помогать с живыми scripting-сценариями, а не только отвечать "общими словами про C#"
для внешних AI coding tools можно подготовить переносимый Agent Guidance pack

Самый практический момент здесь такой: Codex уже можно использовать не только как справочник, но и как ассистента по текущему открытому скрипту.

Как лучше ставить задачи

Чтобы Codex был полезнее, лучше держаться нескольких простых правил:

одна задача = один thread
сразу пишите желаемый результат, а не только проблему
если речь о коде, лучше уточнять, что работать нужно с текущей вкладкой EyePad
если нужен аккуратный фикс, так и пишите: найди причину и предложи минимальное исправление
если задача большая, лучше просить сначала план, а потом реализацию

Хорошие примеры старта:

Разберись, почему текущий Script.csx не компилируется
Посмотри на текущую вкладку EyePad и предложи минимальный рефакторинг
Объясни, что здесь не так, и предложи самый простой рабочий вариант
Помоги спроектировать логику для этой ауры по шагам

Что пока важно иметь в виду

это все еще альфа, и интеграция продолжает быстро меняться
на текущий момент реальный основной сценарий для Codex - OpenAI-профиль через API Key, включая и прямой OpenAI, и EyeAuras Gateway
если в интерфейсе виден режим ChatGPT Login, это еще не значит, что он уже полноценно подключен в вашей сборке
контекст обычного Chat и контекст Codex между собой автоматически не переносятся
для простых FAQ-вопросов Codex часто просто избыточен, обычный AI Assistant для этого обычно лучше

Частые вопросы

Нужен ли для `Codex` отдельный AI-профиль

Не обязательно отдельный, но нужен совместимый.

Проще всего воспринимать это так: Codex использует ту же общую систему профилей, что и обычный AI Assistant, но на практике сейчас лучше держаться OpenAI-профиля в режиме API Key.

Это может быть:

прямой OpenAI
EyeAuras Gateway / AiGateway

Работает ли `Codex` через `EyeAuras Gateway`

Да, это нормальный сценарий.

Правильнее формулировать так:

Codex работает с OpenAI-профилями
такой профиль может смотреть как на прямой OpenAI, так и на EyeAuras Gateway / AiGateway
основной рабочий режим здесь все равно API Key
а вот ChatGPT Login сейчас стоит воспринимать именно как отдельный direct-OpenAI сценарий

быстрый ответ по документации
простой вопрос по настройке
справка по wiki
легкая помощь без глубокой технической проработки

Для таких вещей лучше начать с AI Assistant, а Codex оставлять для более тяжелых задач.