GPT-6 Astra: настройка Codex и проверка Cursor, Cline и DSH

Настройте профиль Astra в Codex через Responses, проверьте поддержку Cursor, Cline и DSH и разберите ошибки ключа, модели и вызова инструментов.

Одной линией нарисованы две сетевые вилки, кабели которых идут к трём розеткам разной формы — на светлой бумажной карточке поверх песочного фона, сбоку сплошной сине-серый круг, снизу заголовок антиквой GPT-6 Astra Setup

Чтобы подключить 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

  1. Проверьте установленную версию командой codex --version и обновите CLI, если используете старую сборку. Настройка CLI и обновление настольного приложения — разные действия.
  2. Создайте пользовательский файл профиля ~/.codex/astra.config.toml с примером ниже. Если файл уже существует, сначала сохраните его копию и измените нужные поля, не добавляя одинаковые таблицы повторно. Если задан собственный CODEX_HOME, файл astra.config.toml должен находиться рядом с его config.toml.
  3. Передайте ключ в переменной окружения 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 через произвольный адрес шлюза.

  1. Откройте Settings → Models и посмотрите, предлагает ли ваша версия и учётная запись Astra.
  2. Если модель доступна через поддерживаемую интеграцию Cursor, используйте её настройки доступа и оплаты.
  3. Если настраиваете собственный ключ, сверяйте поддержку именно этого провайдера и режима с текущей документацией. Не считайте добавление названия модели успешной интеграцией.
  4. Отдельно проверьте чат, инструменты агента и нужные функции редактора. Успешный ответ в чате не доказывает работу 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?
Нет. В этой редакции использованы официальная документация и публичные метаданные. Реальную доступность, инструменты и потоковые ответы нужно проверить в своей среде.