PyCharm и Codex: как подключить и проверить работу в 2026

Codex можно использовать в PyCharm через JetBrains AI Assistant: откройте AI Chat, выберите Codex и начните в режиме чтения или планирования. Для долгих задач основной путь остаётся настольным приложением, а PyCharm удобен для короткого цикла: контекст, правка, diff и тест.

Три способа работать с Codex рядом с PyCharm

У связки PyCharm и Codex три формы. Выберите одну под свою задачу.

• Настольное приложение Codex подходит для длинных задач, нескольких параллельных веток работы и отдельного просмотра результата. Это основной вариант, если агенту нужно дать самостоятельную задачу на проект.
• Codex внутри AI Chat в PyCharm подходит для объяснения открытого файла, небольшой правки и проверки diff рядом с кодом.
• Codex CLI в терминале PyCharm подходит тем, кто хочет запускать агента из каталога проекта и явно управлять командами в терминале.

OpenAI указывает, что JetBrains IDE имеют собственную интеграцию: в них нужно открыть AI Chat и выбрать Codex. В той же официальной документации Codex для IDE настольное приложение описано как поверхность для координации проектов и долгих задач, а CLI как инструмент для работы из терминала. Подробно основной вариант разобран в статье про приложение Codex.

Правило выбора: PyCharm удобен для текущего файла и быстрого diff, настольное приложение для долгого цикла по проекту, терминал для ручного контроля каталога и команд.

Что подготовить до подключения

Сначала создайте безопасную точку возврата. Убедитесь, что проект запускается, и сохраните исходное состояние. При чужих незакоммиченных правках не разрешайте массовое форматирование или откат.

• Рабочий проект открыт как папка, а не как один отдельный файл.
• Есть Git-коммит, отдельная ветка или копия проекта для первого теста.
• Из проекта убраны реальные пароли, ключи API и выгрузки с персональными данными.
• Вы знаете одну команду проверки, например целевой тест или запуск небольшого сценария.
• У вас есть разрешённый способ входа в Codex и право использовать код проекта с выбранным сервисом.

Если Codex ещё не установлен ни в одной поверхности, сначала используйте общую инструкцию по установке. Не пытайтесь лечить вход в PyCharm переустановкой Python, виртуального окружения или зависимостей проекта: интеграция агента относится к AI Assistant и учётной записи, а не к интерпретатору Python.

По теме: Unity и Codex: настройка проекта, тесты и безопасные правки

Как подключить Codex в PyCharm

Актуальный путь проходит через JetBrains AI Assistant. JetBrains описывает Codex как стороннего агента OpenAI, который выбирается внутри AI Chat. Доступные способы активации зависят от вашей учётной записи: подписка JetBrains AI, ключ OpenAI или вход через ChatGPT. Точный порядок и текущие ограничения приведены в официальной справке JetBrains.

1. Обновите PyCharm и установите или включите плагин JetBrains AI Assistant через настройки плагинов.
2. Откройте AI Chat и завершите активацию одним из предложенных официальных способов. Не вставляйте секретный ключ в обычное сообщение чата.
3. В переключателе агента выберите Codex. Если пункта нет, сначала проверьте версию PyCharm, состояние AI Assistant и доступный способ авторизации.
4. Для первого знакомства выберите Read-only или Plan. Попросите перечислить файлы, которые относятся к маленькой задаче, без изменения кода.
5. Проверьте индикатор контекста. Активный файл и выделенный текст могут передаваться автоматически, остальные файлы прикладывайте явно через @.
6. После правильного плана переключитесь в Agent только для тестовой задачи, просмотрите запросы на действия и итоговый diff.
7. Запустите тест самостоятельно в PyCharm и сравните результат с тем, что сообщил агент.

Автоматический контекст включает открытый файл и выделение, но не весь проект. Связанный тест или конфигурацию укажите явно. JetBrains также предупреждает, что Codex сейчас не учитывает .aiignore, поэтому исключённые там файлы могут быть обработаны агентом. Не используйте этот файл как защиту секретов.

Безопасный первый тест в Python-проекте

Возьмите маленькую функцию и тест, которые легко прочитать целиком. Проверьте, что Codex видит контекст PyCharm, меняет только разрешённые файлы и даёт воспроизводимый тест.

Подходящая формулировка: «В функции нормализации имени строка из пробелов должна возвращать пустое значение. Сначала покажите план. Можно менять только src/names.py и tests/test_names.py. Добавьте один тест, запустите только его и перечислите изменённые файлы».

1. До запуска сохраните вывод git status --short или состояние панели Version Control.
2. Откройте src/names.py, выделите нужную функцию и попросите Codex объяснить текущий результат без правки.
3. Приложите через @ файл теста и повторите границы задачи.
4. Разрешите изменения, затем откройте Show Diff до окончательного принятия.
5. Запустите один тест штатной конфигурацией PyCharm или командой проекта.
6. Снова проверьте git status --short. Допустимы только два названных файла.
7. Откатите тестовые изменения через Rollback и убедитесь, что проект вернулся к исходному состоянию.

Успех подтверждают четыре признака: выбран Codex, контекст содержит нужные файлы, diff не выходит за границы, тест повторяется без агента. Сообщение «готово» ничего не подтверждает.

По теме: Codex SSH: как подключить удалённый сервер в 2026

Как выбрать режим доступа

В интеграции JetBrains есть Read-only, Agent и Agent full access. Read-only подходит для изучения кода и плана. Agent разрешает менять файлы внутри рабочего пространства и просит согласование для выхода за его пределы. Full access снимает большую часть ограничений и нужен редко. Описание режимов и механизма согласований есть в документации JetBrains Codex.

• Объяснить код, найти риск или составить план: Read-only.
• Исправить локальную функцию и тест в копии проекта: Agent.
• Установить системную программу, менять файлы вне проекта или управлять внешней системой: остановиться и отдельно оценить необходимость. Не включать full access по привычке.
• Рабочая база, платежи, публикация или удаление данных: агент может подготовить план, но внешнее действие должно иметь отдельное подтверждение и независимую проверку.

Диагностика по симптому

• Codex отсутствует в списке агентов: обновите PyCharm и AI Assistant, перезапустите IDE, затем проверьте способ активации в настройках AI Assistant.
• Вход проходит, но агент не видит нужный код: откройте файл, включите автоматический IDE context или прикрепите конкретный файл через @.
• Агент предлагает изменение, но ничего не происходит: проверьте, не ждёт ли AI Chat вашего разрешения, и не выбран ли Read-only.
• Изменено слишком много файлов: отклоните операцию, вернитесь к Plan, назовите допустимые пути и попросите отдельный diff для каждого шага.
• Команда теста падает только у агента: выполните её в терминале PyCharm из того же каталога, проверьте выбранное виртуальное окружение и зависимости.
• В чат попал лишний файл: отключите автоматический контекст, удалите вложение и начните новую сессию. Секреты после такой ошибки нужно считать раскрытыми и ротировать по правилам проекта.

Если проблема не относится к PyCharm, сверяйтесь с диагностикой Codex. Не меняйте одновременно плагин, способ входа, режим прав и зависимости Python: иначе невозможно понять, какой шаг исправил сбой.

По теме: Codex и Antigravity: сравнение и совместная работа

Когда Codex в PyCharm не подходит

Интеграция не подходит, если политика организации запрещает передавать код внешнему сервису, в проекте нет безопасной копии или результат нельзя проверить тестом и diff. Она также не заменяет ревью для миграции данных, публикации, финансовой операции или изменения прав доступа.

Для долгой автономной задачи удобнее отдельное настольное приложение. Для чисто терминального процесса можно использовать CLI из встроенного терминала PyCharm, который JetBrains открывает через View, Tool Windows, Terminal или Alt+F12, как указано в официальной документации PyCharm.

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

Есть ли отдельный официальный плагин Codex для PyCharm?

В PyCharm Codex подключается через JetBrains AI Assistant. После активации откройте AI Chat и выберите Codex как агента.

Нужно ли устанавливать Codex CLI для работы в AI Chat?

Нет, это отдельный способ работы. CLI нужен, если вы хотите запускать Codex в терминале, а не через интеграцию AI Chat.

Почему Codex видит только открытый файл?

Автоматический контекст ограничен активным файлом и выделением. Добавьте связанные файлы явно через @, не прикладывая весь проект без необходимости.

Можно ли сразу включить full access?

Для первой и обычной локальной задачи не следует. Начните с Read-only или Agent, проверьте границы на тестовом изменении и расширяйте права только под конкретное действие.