GPT-6 Astra: настройка Codex и проверка Cursor, Cline и DSH
Настройте профиль Astra в Codex через Responses, проверьте поддержку Cursor, Cline и DSH и разберите ошибки ключа, модели и вызова инструментов.
Чтобы подключить GPT-6 Astra к Codex, согласуйте провайдера, идентификатор модели и протокол Responses. В Cursor сначала проверьте поддержку модели в своей версии приложения. Произвольный Base URL и название модели сами по себе не подтверждают, что агент сможет читать файлы, вызывать инструменты и продолжать работу после их ответа.
Обновлено 18 сентября 2026 года. Ниже — конфигурации по документации и порядок проверки. Платные запросы к Astra и полноценный запуск агента через Ofox в этой редакции не выполнялись.
С чего начать: аккаунт или собственный API-ключ?
| Способ подключения | Что проверить |
|---|---|
| Вход в Codex через ChatGPT | Нужная учётная запись, доступная модель и лимиты подписки |
| API OpenAI | Ключ OpenAI, https://api.openai.com/v1, модель gpt-6-astra |
| API Ofox | Ключ Ofox, https://api.ofox.run/v1, модель openai/gpt-6-astra |
Не смешивайте ключ одного провайдера с адресом другого. Пример ниже относится к API Ofox, а не к подключению подписки ChatGPT. Публичный список моделей Ofox содержит openai/gpt-6-astra; запись в каталоге не доказывает доступ конкретного ключа или совместимость всех функций клиента.
Codex CLI: настройте профиль Astra
- Проверьте установленную версию командой
codex --versionи обновите CLI, если используете старую сборку. Настройка CLI и обновление настольного приложения — разные действия. - Создайте пользовательский файл профиля
~/.codex/astra.config.tomlс примером ниже. Если файл уже существует, сначала сохраните его копию и измените нужные поля, не добавляя одинаковые таблицы повторно. Если задан собственныйCODEX_HOME, файлastra.config.tomlдолжен находиться рядом с егоconfig.toml. - Передайте ключ в переменной окружения
OFOX_API_KEYпроцессу, который запускает Codex. Не вставляйте секрет в TOML или репозиторий.
model = "openai/gpt-6-astra"
model_provider = "ofox"
model_reasoning_effort = "high"
[model_providers.ofox]
name = "Ofox"
base_url = "https://api.ofox.run/v1"
env_key = "OFOX_API_KEY"
wire_api = "responses"
В официальном справочнике Codex для wire_api указан только responses. Старый пример с wire_api = "chat" больше не подходит. env_key содержит имя переменной, а не сам ключ. В этом примере настройки находятся в отдельном пользовательском файле astra.config.toml, который накладывается на основной config.toml. Не переносите модель и провайдера под заголовок таблицы: первые три строки примера относятся к верхнему уровню.
Запустите профиль явно:
codex --profile astra
Сначала попросите прочитать один небольшой файл в тестовой копии проекта без изменений. Проверьте не только текст ответа, но и завершение вызова инструмента и продолжение после его результата. Затем переходите к небольшой правке с существующим тестом. Это предложенная проверка для вашей среды, а не заявление об успешном тесте вашего аккаунта.
Если профиль не выбирается, начните с имени профиля и расположения файла; параметры подробно разобраны в официальном разделе о профилях. Значение high в примере — отправная точка для сравнения, а не универсально лучший режим.
Cursor: сначала проверьте доступную интеграцию
В Cursor важно различать встроенную интеграцию и подключение собственного API-ключа. Документация Cursor описывает OpenAI BYOK для обычных чат-моделей без режима рассуждений (reasoning). Она не подтверждает запуск Astra через произвольный адрес шлюза.
- Откройте Settings → Models и посмотрите, предлагает ли ваша версия и учётная запись Astra.
- Если модель доступна через поддерживаемую интеграцию Cursor, используйте её настройки доступа и оплаты.
- Если настраиваете собственный ключ, сверяйте поддержку именно этого провайдера и режима с текущей документацией. Не считайте добавление названия модели успешной интеграцией.
- Отдельно проверьте чат, инструменты агента и нужные функции редактора. Успешный ответ в чате не доказывает работу Tab или всего агентного цикла.
Если документированного пути для Astra нет, сохраните работающую модель или используйте клиент с явно указанной поддержкой нужного протокола. Общий порядок подключения описан в руководстве по Cursor и Cline; условия Astra проверяйте отдельно.
Cline: проверьте протокол, а не только три поля
Cline документирует провайдера OpenAI Compatible с Base URL, ключом и Model ID. Для Ofox это https://api.ofox.run/v1, ваш ключ Ofox и openai/gpt-6-astra.
Для вызова инструментов Astra OpenAI требует Responses API. Поэтому текстовый ответ через Chat Completions ещё не подтверждает пригодность выбранного пути для агента. Проверьте поддержку Responses и продолжения после результата инструмента в установленной версии Cline. Не включайте произвольные флаги возможностей, чтобы скрыть несовместимость. Подробнее о базовых настройках — в руководстве Cline.
DeepSeek Harness: объявите маршрут Responses
Документация провайдеров DSH описывает пользовательские маршруты. Пример для $DSH_HOME/settings.yaml:
llm-pi-ai:
providers:
ofox:
apiKeyEnv: OFOX_API_KEY
api: openai-responses
baseURL: https://api.ofox.run/v1
models:
- id: openai/gpt-6-astra
apiKeyEnv ссылается на переменную окружения. Список models заменяет каталог данного маршрута: включите в него и другие модели, которые собираетесь выбирать. После изменения перезагрузите конфигурацию способом, предусмотренным вашей версией DSH, выберите маршрут и модель и проверьте полный цикл инструмента. Наличие openai-responses в документации DSH не доказывает совместимость каждого шлюза. Детали — в инструкции DSH.
Почему Astra не работает: проверяйте по слою ошибки
| Симптом | Что проверить первым |
|---|---|
| Ошибка чтения TOML или профиль не найден | Пользовательский файл, имя профиля, дубли таблиц и синтаксис |
| 401 / ошибка авторизации | Провайдер, адрес и наличие ключа в окружении запущенного процесса |
model_not_found | Точный ID, маршрут и доступ аккаунта; причина не обязательно в опечатке |
| Ошибка параметра reasoning | Допустимое значение в текущей документации модели; не копируйте старый режим none |
| Текст приходит, вызов инструмента не завершается | Поддержка Responses, история инструментов и потоковый ответ |
В DSH локальный UNKNOWN_MODEL | Объявлена ли модель в выбранном пользовательском маршруте |
Для разбора API-ошибок используйте отдельную инструкцию Astra. Сохраните версию клиента, профиль, время и текст ошибки; перед передачей журнала удалите ключи и содержимое приватных файлов.
Проверяйте стоимость по фактическому использованию и действующему тарифу выбранного провайдера. Старые суммы и сравнения бенчмарков не доказывают, сколько будет стоить ваша задача. Прежде чем назначить Astra моделью по умолчанию, сравните результат, повторы, время и расход на одинаковой небольшой задаче; сохраните возможность вернуться к прежнему профилю.
Часто задаваемые вопросы
- Как настроить Astra в Codex CLI?
- Добавьте пользовательский профиль с моделью openai/gpt-6-astra и провайдером Ofox, укажите wire_api = responses и передайте OFOX_API_KEY через окружение. Затем запустите codex --profile astra и проверьте цикл инструмента.
- Достаточно ли добавить Astra в Cursor?
- Нет. Проверьте доступную интеграцию в своей версии и аккаунте. Добавление имени модели или успешный чат не доказывает поддержку всех функций агента.
- Почему Astra возвращает model_not_found?
- Проверьте ID модели, адрес провайдера и доступ аккаунта. Ошибка не всегда означает опечатку; сначала установите, какой клиент и маршрут отправили запрос.
- Подтверждена ли работа этих конфигураций через платный API?
- Нет. В этой редакции использованы официальная документация и публичные метаданные. Реальную доступность, инструменты и потоковые ответы нужно проверить в своей среде.


