claude-gpt задуман как локальный мост между Claude Code и доступными пользователю моделями GPT. Запрос создается в привычной оболочке Claude Code, проходит через локальный шлюз и обрабатывается инфраструктурой OpenAI через существующую среду Codex. Пользователь сохраняет организацию чатов, MCP, плагины и настройки Claude Code, но получает возможность выбирать GPT в качестве модели.
Мост запускает шлюз вместе с рабочей сессией, поэтому отдельный сервер не требуется поднимать вручную перед каждым обращением. claude-gpt при этом не запускает GPT на компьютере и не превращает подписку OpenAI в API-кредит. Он связывает два клиента и повторно использует доступный Codex механизм авторизации.
Точные требования к учетной записи, поддерживаемые операционные системы, команды установки и параметры VSCode нужно сверять с README и кодом конкретной версии claude-gpt. Предоставленных материалов недостаточно, чтобы безопасно опубликовать команды, пути и конфигурацию без риска придумать несуществующие поля. Ниже разобраны подтвержденная архитектурная идея, порядок проверки и ограничения такого подхода.
Что дает интеграция GPT в Claude Code
Интеграция рассчитана на разработчиков, у которых Claude Code уже служит основной рабочей средой. Вместо переноса проектов и диалогов в другой клиент они подключают GPT через промежуточный локальный процесс.
Заявленная схема дает четыре практических результата:
- запросы можно направлять доступным GPT-моделям;
- история и организация рабочих сессий остаются в Claude Code;
- MCP и плагины продолжают подключаться на стороне Claude Code;
- локальный шлюз запускается автоматически вместе с рабочим процессом.
Фактический набор моделей зависит от учетной записи и текущих ограничений OpenAI. Формулировка «без API-ключа» означает отсутствие ручного ввода ключа OpenAI API в настройки моста. Она не означает бесплатный API-доступ или совместимость с любой подпиской.
Почему одного расширения Codex оказалось недостаточно
Исходная проблема возникла при сравнении Claude Code с расширением Codex. Работу с GPT можно было перенести в Codex, но автора не устроили организация чатов и импорт истории. Полная смена клиента потребовала бы перестроить уже сложившийся процесс.
claude-gpt решает задачу на уровне интеграции. Claude Code остается интерфейсом и агентской оболочкой, а GPT подключается как вычислительная модель через локальный переводчик. Похожий принцип разделения обязанностей используется в автоматизированном цикле между Claude и Codex, который разобран в материале "https://ai-manual.ru/article/avtomatizatsiya-tsikla-napisaniya-i-revyu-koda-mezhdu-claude-i-codex-razbor-skill-podhoda/"об автоматизации написания и ревью кода.
Что хотелось сохранить от Claude Code
Требования автора были связаны с повседневной работой, а не с абстрактным сравнением качества моделей. Сохранить требовалось историю и структуру диалогов, подключенные MCP-серверы, плагины Claude Code и существующие настройки среды.
Эти компоненты находятся вокруг модели. Поэтому замена маршрута запроса теоретически позволяет оставить клиентскую часть без миграции. Совместимость каждого плагина и вызова инструмента все равно зависит от того, насколько точно мост переводит сообщения и ответы между форматами Claude Code и Codex.
Почему перенос рабочего процесса в другой клиент не всегда решает задачу
Смена клиента затрагивает больше, чем поле ввода. Разработчику приходится переносить контекст проекта, заново подключать инструменты, привыкать к другой организации сессий и проверять поведение агента на типовых задачах.
Для нового проекта такая цена может быть приемлемой. При накопленной истории и настроенных MCP-серверах локальный мост выглядит практичнее. Универсального победителя здесь нет: критерии выбора Claude Code и Codex зависят от типа задачи, длины сессии и нужного уровня автономности. Эти различия собраны в "https://ai-manual.ru/article/claude-code-i-codex-kak-vyibrat-coding-agent-pod-zadachu-v-2026-godu/"практической матрице выбора coding agent.
Как устроен мост claude-gpt на Rust
В архитектуре участвуют Claude Code, исполняемый файл claude-gpt, локальный шлюз, среда Codex и сервисы OpenAI. claude-gpt работает как адаптер протоколов и жизненного цикла. Собственной модели внутри него нет.
Путь запроса от Claude Code до GPT и обратно
- Пользователь отправляет сообщение в Claude Code.
- Claude Code передает запрос настроенному локальному процессу.
- claude-gpt преобразует запрос в форму, которую может обработать доступный механизм Codex.
- Codex направляет обращение выбранной GPT-модели с учетом текущей авторизации пользователя.
- Ответ возвращается в локальный шлюз.
- Мост преобразует результат в совместимый формат и отдает его Claude Code.
- Claude Code показывает ответ в существующей рабочей сессии и при необходимости координирует инструменты.
Это концептуальная схема. Точные форматы сообщений, транспорт и адрес локального процесса нужно брать из исходного кода используемой версии. Без проверки репозитория нельзя утверждать, что мост предоставляет HTTP-интерфейс определенного формата или слушает конкретный порт.
Зачем здесь Rust
Rust используется для сборки локального исполняемого процесса, который можно запускать вместе с Claude Code и завершать после рабочей сессии. Такой формат подходит для небольшого шлюза, которому требуется управлять дочерними процессами, конфигурацией и обменом сообщениями.
Показателей скорости, потребления памяти или сравнительных тестов в предоставленных данных нет. Поэтому выбор Rust следует оценивать по формату поставки и архитектуре проекта, а не по неподтвержденным заявлениям о производительности.
Автоматический запуск и завершение локального шлюза
Главное удобство claude-gpt связано с управлением процессом. Шлюз должен подниматься при обращении Claude Code, работать в пределах сессии и завершаться вместе с ней. Пользователю не приходится держать отдельный терминал и помнить команду запуска сервера.
Перед публикацией инструкции следует проверить три сценария: повторный запуск, уже занятый локальный порт и аварийное завершение клиента. Если документация не описывает их, поведение нужно устанавливать по коду или воспроизводимому тесту.
Как подписка OpenAI используется без API-ключа
Мост опирается на существующую авторизацию Codex. Пользователь сначала входит в учетную запись через поддерживаемый Codex механизм, после чего claude-gpt обращается к доступной среде без отдельного API-ключа в своей конфигурации.
Это не означает, что подписка OpenAI предоставляет универсальные API-кредиты. Подписка, сессия Codex и OpenAI API остаются разными каналами доступа с отдельными правилами, лимитами и условиями использования.
Чем этот сценарий отличается от OpenAI API
| Критерий | Сессия Codex через мост | Прямой OpenAI API |
|---|---|---|
| Авторизация | Используется доступная локальная сессия Codex | Приложение обычно передает отдельный API-ключ |
| Доступные модели | Определяются учетной записью и средой Codex | Определяются API-проектом и его доступом |
| Лимиты | Зависят от подписки и правил Codex | Учитываются по условиям API |
| Стабильность интеграции | Зависит от совместимости неофициального моста | Опирается на официальный программный интерфейс |
Перед использованием нужно проверить, допускают ли текущие условия OpenAI выбранный способ доступа. Совместимость может измениться после обновления Codex или механизма авторизации.
Где находятся учетные данные и что не следует передавать мосту
Учетные данные должны оставаться в локальном хранилище, которым пользуется Codex. Мосту не требуется передавать пароль, публиковать токен или добавлять секрет в репозиторий проекта, если архитектура соответствует заявленному сценарию.
До запуска проверьте, к каким файлам обращается бинарный файл, какие переменные окружения читает и что записывает в журналы. Не публикуйте файлы сессии, токены, диагностические дампы и конфигурацию авторизации. Перед отправкой лога удалите заголовки запросов, содержимое рабочих файлов и другие секреты.
Модели GPT и лимиты контекста в claude-gpt
Заявленная логика claude-gpt предусматривает получение актуального списка GPT-моделей из Codex. Такой подход избавляет от жестко заданного перечня, который быстро устарел бы после изменений сервиса.
Как обновляется список доступных GPT-моделей
Мост запрашивает список через доступный механизм Codex и передает его в Claude Code. Пользователь видит модели, разрешенные конкретной учетной записи. Две учетные записи могут получить разный набор.
Неизвестны подтвержденные момент обновления, схема кэширования и реакция на исчезнувшую модель. Эти детали нужно проверять в актуальной версии claude-gpt. Если список пуст, первым тестом должен стать просмотр моделей непосредственно в Codex под той же учетной записью.
Что происходит, когда история не помещается в контекст
В контекст входят системные инструкции, история диалога, текущий запрос, описания инструментов и результаты их вызовов. Длинная сессия может превысить доступное контекстное окно выбранной GPT-модели.
Предоставленные материалы не подтверждают, обрезает ли claude-gpt историю, резервирует ли место под ответ или возвращает ошибку. Для диагностики можно создать новый чат, сократить входные материалы и повторить запрос. Это позволит отделить проблему размера контекста от ошибки авторизации или запуска шлюза.
Установка и настройка claude-gpt в VSCode
Воспроизводимая установка требует документации и исходного кода конкретного релиза. Без них нельзя безопасно привести команды сборки, имя бинарного файла, путь к настройке и фрагмент JSON. Ошибка в одном поле может привести к запуску другого процесса или к раскрытию учетных данных.
Предварительные требования
По заявленной архитектуре потребуются:
- рабочая установка Claude Code;
- установленный и авторизованный Codex;
- учетная запись OpenAI с доступом к нужным GPT-моделям;
- VSCode, если интеграция настраивается через его пользовательские или рабочие параметры;
- Rust toolchain при сборке claude-gpt из исходников.
Не подтверждены минимальные версии компонентов и список поддерживаемых операционных систем. Проверять их нужно перед загрузкой бинарного файла. Пользователям Linux может пригодиться отдельный разбор "https://ai-manual.ru/article/chatgpt-dlya-linux-ofitsialnoe-prilozhenie---ustanovka-vozmozhnosti-i-sravnenie-s-claude/"экосистемы ChatGPT и Codex в Linux, но совместимость claude-gpt он сам по себе не гарантирует.
Установка готового файла или сборка из исходников
Готовый бинарный файл сокращает число шагов, но требует проверки происхождения, версии и контрольной суммы, если проект ее публикует. Бинарник должен соответствовать операционной системе и архитектуре процессора.
Сборка из исходников дает возможность изучить зависимости и поведение программы. Перед сборкой проверьте манифест Rust, скрипты установки, сетевые обращения и работу с локальными файлами. Команды нельзя восстанавливать по догадке: используйте инструкции выбранной версии проекта.
Подключение моста через настройки VSCode
Сделайте резервную копию пользовательских настроек VSCode. Затем добавьте подтвержденный разработчиком параметр запуска claude-gpt и укажите абсолютный путь к бинарному файлу. Относительный путь может вычисляться от другой рабочей директории и привести к ошибке запуска.
Проверьте область настройки. Глобальная конфигурация действует во всех проектах, рабочая хранится рядом с конкретным проектом и может попасть в систему контроля версий. Не помещайте токены и файлы сессии в настройки рабочей области.
Первый запуск и проверка подключения
- Убедитесь, что бинарный файл существует и имеет право на запуск.
- Проверьте авторизацию и список моделей внутри Codex.
- Откройте Claude Code и посмотрите, запустился ли процесс claude-gpt.
- Проверьте появление доступных GPT-моделей.
- Отправьте короткий запрос без MCP и больших вложений.
- Сопоставьте выбранную модель с записью в журнале, если мост ведет безопасный диагностический лог.
- После базового теста проверьте один вызов инструмента и длинную рабочую сессию.
Критерий успеха состоит из трех признаков: шлюз запущен, список моделей получен, ответ вернулся в текущий чат Claude Code без ручного старта сервера.
Что остается от Claude Code: история, MCP и плагины
Claude Code продолжает управлять интерфейсом, сессиями и подключенными инструментами. claude-gpt меняет маршрут к модели, поэтому история чатов, MCP плагины Claude Code и конфигурация клиента могут оставаться на месте.
История чатов и существующие рабочие сессии
История хранится и организуется клиентом Claude Code, поэтому отдельный импорт в Codex не нужен. Это закрывает исходную проблему автора с переносом рабочего процесса.
Полную совместимость старых сессий нельзя обещать без проверки. В истории могут находиться сообщения, служебные блоки или результаты инструментов, которые мост не умеет преобразовывать. Начинать проверку разумно с нового короткого чата, затем открыть копию существующей рабочей сессии.
MCP и плагины Claude Code при работе с GPT
MCP-серверы и плагины подключаются к Claude Code. Модель получает описания инструментов, запрашивает их вызов, а клиент выполняет действие и возвращает результат в диалог.
Риск появляется на границе форматов. Мост должен корректно передавать tool calls, аргументы, ошибки и ответы инструментов. Пока это не проверено по коду или тестам, совместимость сложных MCP-сценариев следует считать ограниченной. Сначала протестируйте инструмент только для чтения, затем операции с файлами в отдельном тестовом проекте.
Диагностика: если шлюз или модели не появились
Проверяйте цепочку последовательно. Такой порядок быстрее отделяет проблему VSCode от авторизации Codex или ограничений учетной записи.
Claude Code не запускает claude-gpt
- Проверьте абсолютный путь к бинарному файлу.
- Убедитесь, что файл исполняемый и подходит архитектуре системы.
- Проверьте синтаксис измененного файла настроек VSCode.
- Исключите конфликт глобальных и рабочих настроек.
- Запустите бинарный файл отдельно, только если проект документирует такой режим.
- Проверьте, не блокирует ли запуск система защиты или политика рабочей станции.
Codex не возвращает список моделей
- Откройте Codex под той же учетной записью.
- Проверьте, действует ли локальная сессия авторизации.
- Убедитесь, что модели доступны непосредственно в Codex.
- Просмотрите журналы claude-gpt после удаления секретов.
- Повторите проверку без VPN, прокси или корпоративного фильтра, если правила организации это разрешают.
Пустой список не доказывает неисправность Claude Code. Причиной может оказаться учетная запись, истекшая сессия или изменение интерфейса Codex.
Контекст обрезается или запрос завершается ошибкой
- Создайте новый чат с одним коротким сообщением.
- Уберите крупные вложения и результаты инструментов.
- Смените модель через штатный список, если доступно несколько вариантов.
- Проверьте сообщения шлюза о размере запроса.
- Сравните поведение обычного сообщения и вызова MCP-инструмента.
Новый чат служит диагностическим тестом. Он не исправляет несовместимость форматов и не увеличивает лимит контекстного окна.
Ограничения и риски такого подхода
claude-gpt добавляет промежуточный слой между двумя быстро меняющимися продуктами. Он упрощает повседневный запуск, но повышает число компонентов, которые могут нарушить совместимость.
Зависимость от обновлений Claude Code, Codex и OpenAI
Интеграция зависит от механизма авторизации, списка моделей, форматов запросов, инструментальных вызовов и параметров запуска клиента. Изменение любого контракта может потребовать обновления моста.
После обновления Claude Code или Codex сначала проверяйте короткий запрос без инструментов. Затем тестируйте модельный список, длинный контекст и MCP. Для рабочей среды полезно фиксировать версии компонентов, если их лицензии и способы установки это позволяют.
Безопасность локального шлюза
Локальный процесс потенциально получает доступ к содержимому запросов, рабочим файлам и данным авторизации Codex. Перед запуском проверьте:
- на каком адресе слушает шлюз;
- доступен ли порт за пределами локального компьютера;
- что программа пишет в журналы;
- какие права имеет процесс;
- откуда получен бинарный файл;
- совпадает ли исходный код с опубликованным релизом;
- какая лицензия регулирует использование проекта.
Для первого запуска используйте тестовый репозиторий без секретов. Не подключайте запись в критичные каталоги до изучения поведения инструмента.
Кому claude-gpt подходит, а кому лучше выбрать другой вариант
Мост подходит пользователям с настроенным Claude Code, которым нужны доступные GPT-модели без переноса истории, MCP и плагинов в новый клиент. Наибольшую пользу получают разработчики с уже сложившимся агентским процессом.
Codex без моста разумнее выбрать, если его организация сессий устраивает и миграция не создает затрат. Прямой OpenAI API подходит системам, которым нужен официальный программный контракт, отдельное управление ключами и предсказуемая серверная интеграция. От claude-gpt лучше отказаться, если политика безопасности запрещает неофициальные локальные шлюзы или доступ стороннего бинарного файла к рабочим проектам.
Итог: когда мост оправдывает дополнительный слой
claude-gpt оправдан, когда Claude Code уже стал центром разработки, а GPT требуется подключить без смены клиентской оболочки. Инструмент сохраняет привычную организацию сессий и должен автоматически управлять локальным шлюзом, используя доступную авторизацию Codex вместо вручную введенного API-ключа.
Перед установкой проверьте документацию выбранной версии, совместимость учетной записи, происхождение бинарного файла, сетевое поведение и действующие условия OpenAI. Затем проведите три теста: короткий запрос, длинный чат и вызов MCP-инструмента. Такой порядок показывает реальную совместимость быстрее, чем перенос рабочего проекта целиком.