Codex CLI

Платформа: все

Причина: Codex CLI использует API Node.js, доступные только с версии 22. У большинства пользователей установлен Node.js 18 или 20 LTS.

npm warn EBADENGINE Unsupported engine {
  package: '@openai/codex@0.x.x',
  required: { node: '>= 22' },
  current: { node: 'v18.x.x' }
}

Решение:

1. Установите nvm (если ещё нет): curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
2. Установите Node.js 22: nvm install 22
3. Активируйте: nvm use 22
4. Проверьте: node -v (должно быть v22.x.x или выше)
5. Установите Codex заново: npm install -g @openai/codex

GitHub Issue #164

Платформа: Linux, macOS

Причина: npm пытается установить пакет в системную директорию, на которую у пользователя нет прав записи.

npm ERR! Error: EACCES: permission denied, mkdir '/usr/local/lib/node_modules/@openai'

Решение (вариант 1 -- sudo):

1. Установите с sudo: sudo npm install -g @openai/codex

Решение (вариант 2 -- настройка npm prefix, рекомендуется):

1. Создайте директорию: mkdir -p ~/.npm-global
2. Настройте npm: npm config set prefix '~/.npm-global'
3. Добавьте в PATH (в ~/.bashrc или ~/.zshrc): export PATH=~/.npm-global/bin:$PATH
4. Перезагрузите shell: source ~/.bashrc
5. Установите без sudo: npm install -g @openai/codex

GitHub Issue #1480

Платформа: macOS, Windows

Причина: Codex установлен через несколько пакетных менеджеров одновременно (npm + Homebrew, npm + winget). Запускается не та версия, странные ошибки.

$ which codex
/usr/local/bin/codex        # Homebrew
$ npm list -g @openai/codex
/Users/user/.nvm/.../codex  # npm (другая версия)

Решение:

1. Найдите все копии: which -a codex (macOS/Linux) или where codex (Windows)
2. Оставьте одну установку, удалите остальные:
   • Homebrew: brew uninstall codex
   • npm: npm uninstall -g @openai/codex
   • winget: winget uninstall OpenAI.Codex
3. Переустановите через один менеджер: npm install -g @openai/codex

GitHub Issues #5607, #16650

Платформа: macOS (Intel / x86_64)

Причина: Codex Desktop поставляется только как ARM-бинарник (Apple Silicon). 245 голосов за решение.

This application requires Apple Silicon (ARM64).
Your Mac has an Intel processor.

Решение:

1. Перейдите на страницу GitHub Releases
2. Скачайте файл codex-x86_64-apple-darwin.tar.gz
3. Распакуйте: tar xzf codex-x86_64-apple-darwin.tar.gz
4. Переместите в PATH: sudo mv codex /usr/local/bin/
5. Используйте CLI-версию вместо Desktop

GitHub Issue #10410

Платформа: все

Причина: одновременно установлена переменная OPENAI_API_KEY и выполнен вход через ChatGPT. Codex не может определить, какой способ авторизации использовать.

Error: 401 Unauthorized
Request failed with status code 401
Invalid authentication credentials

Решение:

1. Удалите файл авторизации: rm ~/.codex/auth.json
2. Уберите переменную из окружения: unset OPENAI_API_KEY
3. Удалите из ~/.bashrc / ~/.zshrc строку export OPENAI_API_KEY=...
4. Выберите один способ авторизации:
   • API-ключ: export OPENAI_API_KEY=sk-...
   • ChatGPT-логин: codex --login

GitHub Issues #5456, #3002

Платформа: все

Причина: Codex тратит токены на внутренние операции: compaction контекста, настройку sandbox, системные промпты. 476 комментариев в issue. Пользователь видит расход, не соответствующий объёму своих запросов.

Error: Rate limit exceeded or quota exhausted.
You've exceeded your current usage tier limits.

Решение:

1. Мониторьте расход в реальном времени: platform.openai.com/usage
2. Установите лимиты расхода в настройках аккаунта
3. Используйте более дешёвые модели для рутинных задач: codex --model gpt-4.1-mini
4. Сократите контекст: работайте в небольших директориях, не в корне монорепозитория

GitHub Issue #14593

Платформа: Windows

Причина: Windows-песочница Codex требует специфических привилегий и совместимого shell. 42 комментария в issue.

Error: Sandbox setup failed
Failed to create restricted process token
Cannot initialize sandbox environment

Решение:

1. Используйте cmd.exe как shell (не PowerShell): codex --shell cmd.exe
2. Или отключите песочницу (менее безопасно): codex --dangerously-auto-approve
3. Или используйте WSL2 (рекомендуется для Windows-разработчиков)

GitHub Issue #10601

Платформа: Windows

Причина: PowerShell пытается использовать криптопровайдер, который не работает в restricted token песочницы Codex.

Internal error 0x8009001d
at System.Security.Cryptography.ProtectedData.Protect()
PowerShell cannot start in sandbox mode

Решение:

1. Переключитесь на cmd.exe: codex --shell cmd.exe
2. Или добавьте в конфиг ~/.codex/config.json: {"shell": "cmd.exe"}
3. Перезапустите Codex

GitHub Issue #13917

Платформа: все

Причина: каждая команда требует явного подтверждения, даже после «Allow for session». 77 комментариев, 110 голосов.

? Allow this command? (y/n/allow for session)
> allow for session
...
? Allow this command? (y/n/allow for session)  # опять!

Решение:

1. Используйте режим suggest (только показывает команды, не выполняет): codex --approval-mode suggest
2. Или режим auto-edit (автоматически редактирует файлы, запрашивает подтверждение на выполнение): codex --approval-mode auto-edit
3. Для доверенных проектов: codex --dangerously-auto-approve (без подтверждений вообще)

GitHub Issue #2860

Платформа: Linux (Ubuntu 20.04, Debian 10 и старше)

Причина: Codex использует bubblewrap (bwrap) для песочницы. Старые версии не поддерживают нужные опции.

bwrap: Unknown option --argv0
Sandbox initialization failed: bubblewrap version too old

Решение:

1. Проверьте версию: bwrap --version
2. Обновите bubblewrap до 0.8+:
   • Ubuntu/Debian: sudo apt update && sudo apt install bubblewrap
   • Если в репозитории старая версия -- соберите из исходников или обновите дистрибутив
3. Проверьте: bwrap --version (должна быть 0.8.0 или новее)

GitHub Issue #15283

Платформа: Windows (WSL)

Причина: WSL1 не поддерживает seccomp и landlock, необходимые для песочницы Codex. WSL2 может работать, но с ограничениями.

Error: Sandbox is not supported in this environment
seccomp/landlock not available in WSL

Решение:

1. Отключите песочницу: codex --disable-sandbox
2. Или обновитесь до WSL2: wsl --set-version Ubuntu 2
3. Проверьте версию WSL: wsl -l -v

GitHub Issue #1039

Платформа: все

Причина: сетевые проблемы -- прокси, VPN, корпоративный firewall блокируют соединение с API OpenAI. 131 комментарий в issue.

⠋ Thinking...
(зависает на минуты без ответа)

# или
Error: Request timed out
ETIMEDOUT / ECONNREFUSED

Решение:

1. Проверьте доступность API: curl -I https://api.openai.com/v1/models
2. Если используете VPN -- попробуйте отключить или сменить сервер
3. Настройте прокси: export HTTPS_PROXY=http://proxy:port
4. Проверьте firewall: порт 443 должен быть открыт для api.openai.com
5. Из России: используйте VPN -- гайд по VPN

GitHub Issue #14048

Платформа: все

Причина: перегрузка серверов OpenAI или плановое обслуживание. Не зависит от пользователя.

Error: 503 Service Unavailable
The server is temporarily unable to handle the request

Решение:

1. Проверьте статус: status.openai.com
2. Подождите 5-10 минут и повторите запрос
3. Если проблема сохраняется -- попробуйте другую модель: codex --model gpt-4.1-mini

GitHub Issue #17068

Платформа: VS Code Remote SSH

Причина: расширение Codex для VS Code не полностью поддерживает Remote SSH -- не может инициализировать задачи на удалённой машине.

Failed to load tasks from extension 'openai.codex'
Extension host terminated unexpectedly

Решение:

1. Используйте CLI напрямую на удалённом сервере: ssh server && codex
2. Установите Codex CLI на удалённой машине: npm install -g @openai/codex
3. Запускайте через терминал VS Code, а не через расширение

GitHub Issue #2796

Платформа: Android (Termux)

Причина: Codex CLI не имеет ARM-бинарника для Android/Termux. Node.js в Termux работает, но нативные модули Codex не компилируются.

npm ERR! notsup Unsupported platform for @openai/codex
npm ERR! notsup Valid OS: linux, darwin, win32
npm ERR! notsup Actual OS/Arch: linux/aarch64 (termux)

Решение:

1. Codex CLI не поддерживает Termux -- используйте на десктопе или VPS
2. Альтернатива: арендуйте VPS и работайте через SSH -- гайд по VDS
3. Или используйте ChatGPT через браузер на мобильном

GitHub Issue #2951

Платформа: все

Причина: пользователь ищет «окно программы Codex» или «куда вставить команду». Codex CLI работает в терминале (командной строке), а не в графическом интерфейсе.

# Codex — это CLI-инструмент. Нужен терминал.
# Если вы не знаете, что это — вот как его открыть:

Решение:

1. Windows: нажмите Win+R, введите cmd, нажмите Enter
2. macOS: нажмите Cmd+Space, введите Terminal, нажмите Enter
3. Linux: нажмите Ctrl+Alt+T
4. Или установите Codex Desktop -- графическое приложение, не требующее терминала

Платформа: все

Причина: подписка ChatGPT Plus ($20/мес) и API OpenAI -- две отдельные системы оплаты. Plus не даёт доступ к API, а Codex CLI использует именно API.

Error: No API key found.
Set OPENAI_API_KEY or run `codex --login`

Решение:

1. Вариант 1 (для подписчиков ChatGPT): выполните codex --login -- это авторизует через ChatGPT-аккаунт
2. Вариант 2 (API-ключ): зайдите на platform.openai.com, создайте ключ, пополните баланс
3. Установите ключ: export OPENAI_API_KEY=sk-...

Платформа: Windows

Причина: при входе через «Sign in with ChatGPT» в Codex Desktop автоматически создаётся API-ключ. Списание идёт с API-баланса, а не с подписки Plus.

# На platform.openai.com/usage появляются списания,
# хотя вы не создавали API-ключ вручную

Решение:

1. Зайдите на platform.openai.com/api-keys
2. Найдите автоматически созданный ключ и удалите его
3. Установите лимит расхода в настройках
4. Используйте codex --login вместо API-ключа для работы через ChatGPT-подписку

Платформа: все

Причина: OpenAI не принимает карты российских банков. Платёж отклоняется на этапе привязки карты к API-аккаунту.

Your card was declined.
Try a different payment method.

Решение:

1. Используйте карту зарубежного банка: Kaspi (Казахстан), Wise (Великобритания), Pyypl (ОАЭ)
2. Или переключитесь на альтернативу, не требующую оплаты из-за рубежа:
   • Claude Code -- оплата через Anthropic
   • Gemini CLI -- бесплатно на Gemini API
3. Подробнее: гайд по VPN и оплате

Платформа: все

Причина: имя файла регистрозависимо (только AGENTS.md), максимальный размер 32KB. Глобальный ~/.codex/AGENTS.md не читается в v0.77+.

# Codex молча игнорирует файл, если:
# - имя написано иначе (agents.md, Agents.md)
# - файл больше 32KB
# - используется глобальный путь в новых версиях

Решение:

1. Проверьте точное имя: ls -la AGENTS.md
2. Проверьте размер: wc -c AGENTS.md (должен быть < 32768 байт)
3. Файл должен лежать в корне проекта (рядом с .git/)
4. Обновите Codex до последней версии: npm update -g @openai/codex

Платформа: все

Причина: в режиме full-auto Codex может выполнять git restore, rm и другие деструктивные команды. Зафиксировано удаление до 328,000 файлов (Issue #12277).

$ git status
deleted: src/components/Header.tsx
deleted: src/pages/index.tsx
deleted: package.json
... (328,000 files deleted)

Решение:

1. ВСЕГДА коммитьте изменения перед запуском Codex: git add -A && git commit -m "checkpoint"
2. Не используйте --dangerously-auto-approve без крайней необходимости
3. В AGENTS.md добавьте: Never run git restore, git checkout --, or rm -rf
4. Если файлы удалены: git checkout HEAD -- . для восстановления

GitHub Issue #12277

Платформа: все

Причина: файл .codexignore может игнорироваться из-за бага. Секреты (.env, ключи API) попадают в контекст модели.

# .codexignore содержит:
.env
secrets/
*.key

# Но Codex всё равно читает эти файлы

Решение:

1. Используйте .gitignore -- Codex уважает его надёжнее
2. Переместите секреты за пределы проекта (например, в /etc/secrets/)
3. Используйте переменные окружения вместо файлов с секретами
4. Проверьте, что .env добавлен в .gitignore

Платформа: Windows, VS Code

Причина: расширение Codex для VS Code может запускать CLI без правильной рабочей директории, из-за чего локальный config.toml не находится.

# config.toml в корне проекта не применяется
# Настройки модели, approval-mode игнорируются

Решение:

1. Продублируйте конфиг в глобальную директорию: cp config.toml ~/.codex/config.toml
2. Или используйте CLI напрямую в терминале VS Code (Ctrl+`)
3. Проверьте, что конфиг валиден: cat ~/.codex/config.toml

Платформа: все

Причина: Codex индексирует все файлы проекта для контекста. В больших проектах (node_modules, dist, билды) это приводит к огромному расходу токенов (10-50x) и задержкам.

⠋ Thinking...
# Зависает на 2-5 минут
# Расход: $5-15 за один запрос в монорепозитории

Решение:

1. Создайте .codexignore с исключениями: node_modules, dist, .next, build
2. Работайте из поддиректории, а не из корня монорепозитория
3. Используйте легковесную модель: codex --model gpt-4.1-mini
4. Сократите размер контекста -- удалите неиспользуемые зависимости

Платформа: все

Причина: корпоративный прокси подменяет SSL-сертификат (MITM), Codex не может проверить подлинность сервера OpenAI.

Error: unable to verify the first certificate
FetchError: request to https://api.openai.com failed
reason: unable to verify the first certificate

Решение:

1. Укажите корпоративный CA-сертификат: export CODEX_CA_CERTIFICATE=/path/to/ca.pem
2. Настройте прокси: export HTTPS_PROXY=http://proxy:port
3. Или (временно, небезопасно): export NODE_TLS_REJECT_UNAUTHORIZED=0
4. Обратитесь к IT-отделу за корневым сертификатом прокси

Платформа: все

Причина: режим full-auto (--dangerously-auto-approve) даёт Codex полные права на выполнение любых команд без подтверждения, включая деструктивные.

# Codex выполнил без подтверждения:
rm -rf src/
git reset --hard HEAD~5
# Результат: потеря кода

Решение:

1. НИКОГДА не используйте full-auto на production
2. Используйте auto-edit -- автоматически редактирует файлы, но спрашивает перед выполнением команд
3. Работайте в отдельной git-ветке: git checkout -b experiment
4. Если потеряли код: git reflog покажет историю для восстановления

Платформа: все

Причина: Codex установлен через несколько менеджеров пакетов (npm + Homebrew + winget). Обновляется одна копия, запускается другая.

Update available: 0.1.2 → 0.1.5
Run `npm update -g @openai/codex` to update
# После обновления сообщение не пропадает

Решение:

1. Найдите все копии: which -a codex (macOS/Linux) или where codex (Windows)
2. Удалите все копии через каждый менеджер пакетов
3. Очистите кэш: npm cache clean --force
4. Переустановите через один менеджер: npm install -g @openai/codex
5. Проверьте: codex --version

GitHub Issues #5607, #16650

Платформа: все

Причина: OpenAI периодически удаляет старые модели. Если в config.toml зафиксирована конкретная модель, Codex перестаёт работать после её удаления.

Error: Model 'gpt-4o' not found.
The model you specified does not exist or you do not have access.

Решение:

1. Уберите фиксированную модель из config.toml (Codex выберет актуальную автоматически)
2. Или замените на актуальную: codex --model o4-mini
3. Список доступных моделей: platform.openai.com/docs/models

Платформа: все

Причина: Codex читает AGENTS.md один раз при запуске сессии. Изменения в файле во время работы не подхватываются.

# Вы отредактировали AGENTS.md, но Codex
# продолжает работать по старым инструкциям

Решение:

1. Перезапустите сессию: нажмите Ctrl+C и запустите codex заново
2. Или используйте команду /read AGENTS.md внутри сессии для перечитывания
3. Совет: отлаживайте AGENTS.md перед длинной сессией

Платформа: все

Причина: песочница Codex блокирует сетевой доступ по умолчанию. Команды, требующие интернета (npm install, curl, pip install), не работают.

Network access restricted
Could not resolve host: registry.npmjs.org
curl: (6) Could not resolve host: api.example.com

Решение:

1. Подтвердите сетевой доступ, когда Codex спрашивает (в режиме suggest или auto-edit)
2. Установите зависимости до запуска Codex: npm install, затем codex
3. Или используйте --disable-sandbox для отключения ограничений (менее безопасно)
4. В AGENTS.md укажите: Install dependencies before running the project