Codex CLI в России — настройка и установка без VPN

Codex CLI — официальный open-source кодинг-агент OpenAI, который запускается прямо в терминале и работает с локальной кодовой базой. Из России подключиться к нему стандартным способом нельзя: вход через ChatGPT и оплата по OpenAI API-ключу требуют VPN и зарубежной карты. AITUNNEL решает обе проблемы: один ключ sk-aitunnel-, российский домен api.aitunnel.ru, оплата рублями — и Codex CLI получает доступ к семейству gpt-5-codex, моделям Claude, Gemini, Qwen, Kimi и десяткам других через единый OpenAI-совместимый эндпоинт.

Что умеет Codex CLI

Codex CLI — не чат-бот, а агент: он не просто отвечает текстом, а сам читает файлы, запускает команды и применяет изменения в коде. Из коробки:

• Редактирует файлы — вносит правки, добавляет новые модули, выполняет рефакторинг
• Запускает shell-команды — тесты, линтеры, билды, миграции
• Анализирует кодовую базу — понимает структуру проекта, импорты, зависимости
• Работает с git — коммиты, ветки, разрешение конфликтов
• Поддерживает MCP-серверы — расширяет возможности через Model Context Protocol
• Web-поиск — встроенный поиск с кешированием результатов
• Профили и кастомные провайдеры — переключение между моделями и средами через config.toml
• Sandbox и approval-policies — гибкий контроль над тем, что агент может делать без подтверждения

В отличие от обычного чат-режима, Codex CLI отслеживает контекст всей сессии, держит историю изменений и может откатить правки через встроенную функцию undo.

Зачем подключать Codex CLI через AITUNNEL

OpenAI требует логин в ChatGPT или OpenAI API-ключ — оба варианта недоступны из России без VPN и зарубежной карты. AITUNNEL предоставляет OpenAI-совместимый API на домене api.aitunnel.ru, который Codex CLI воспринимает как кастомного провайдера через секцию [model_providers.*] в config.toml.

• Без VPN — запросы идут через российский домен, без обходов
• Без аккаунта OpenAI — регистрация на AITUNNEL по email/Telegram за минуту
• Оплата в рублях — пополнение от 399₽, карты МИР и СБП
• Один ключ — все модели — Codex-семейство, Claude Sonnet/Opus 4.5, Gemini, Qwen и др.
• Failover между провайдерами — если upstream недоступен, запрос уходит к резервному
• Прозрачность расходов — каждый запрос виден в панели активности
• Для бизнеса — закрывающие документы, договор, акты, счета-фактуры

Лучшие модели для Codex CLI через AITUNNEL: gpt-5.3-codex (свежайшая модель Codex-семейства), gpt-5.2-codex, gpt-5.1-codex-max (расширенный контекст для крупных кодовых баз). Codex CLI оптимизирован именно под Codex-семейство моделей — у них сильное агентное поведение и tool calling. При желании можно подключить и Claude Sonnet 4.5 или GPT-5.2 Pro.

Установка Codex CLI

Поддерживаются macOS, Linux и Windows. Требуется Node.js 18+ для установки через npm; через Homebrew или нативные бинарники Node не нужен.

Через npm (универсально)

npm install -g @openai/codex

Через Homebrew (macOS, Linux)

brew install --cask codex

Нативные бинарники с GitHub Releases

Скачайте архив для вашей платформы со страницы GitHub Releases:

• macOS Apple Silicon: codex-aarch64-apple-darwin.tar.gz
• macOS Intel: codex-x86_64-apple-darwin.tar.gz
• Linux x86_64: codex-x86_64-unknown-linux-musl.tar.gz
• Linux ARM64: codex-aarch64-unknown-linux-musl.tar.gz

После распаковки переименуйте файл в codex и положите в PATH.

Проверка установки

codex --version

Подключение к AITUNNEL: пошаговый гайд

Codex CLI читает конфигурацию из ~/.codex/config.toml и подхватывает API-ключ из переменной окружения, имя которой задаётся в провайдере.

Шаг 1: Получите API-ключ AITUNNEL

1. Зарегистрируйтесь на aitunnel.ru (нужен только email или Telegram)
2. Пополните баланс на любую сумму от 399₽
3. Перейдите в раздел Ключи и создайте новый
4. Скопируйте ключ — он начинается с sk-aitunnel-

Шаг 2: Создайте `~/.codex/config.toml`

model_provider = "aitunnel"
model_reasoning_effort = "high"
model = "gpt-5.3-codex"

[model_providers.aitunnel]
name = "aitunnel"

base_url = "https://api.aitunnel.ru/v1"
env_key = "AITUNNEL_API_KEY"

Шаг 3: Экспортируйте ключ в окружение

Добавьте в ~/.zshrc, ~/.bashrc или ~/.config/fish/config.fish:

export AITUNNEL_API_KEY="sk-aitunnel-xxx"

Перезагрузите оболочку (source ~/.zshrc) или откройте новый терминал.

Шаг 4: Запустите сессию

cd /path/to/your/project
codex

Codex откроет интерактивный TUI, считает AGENTS.md (если есть) и будет готов принимать команды. Все запросы пойдут через AITUNNEL — отслеживайте их в панели активности.

Профили: несколько моделей в одном конфиге

Codex поддерживает профили — преднастройки, которые активируются флагом --profile. Удобно держать отдельный профиль под быстрые правки, под крупные рефакторинги и под альтернативную модель.

model_provider = "aitunnel"
model = "gpt-5.3-codex"

[model_providers.aitunnel]
name = "aitunnel"
base_url = "https://api.aitunnel.ru/v1"
env_key = "AITUNNEL_API_KEY"

[profiles.fast]
model_provider = "aitunnel"
model = "gpt-5.1-codex-mini"
model_reasoning_effort = "low"

[profiles.max]
model_provider = "aitunnel"
model = "gpt-5.1-codex-max"
model_reasoning_effort = "xhigh"

[profiles.claude]
model_provider = "aitunnel"
model = "claude-sonnet-4-5"

Запуск с конкретным профилем:

codex --profile fast       # для быстрых правок
codex --profile max        # для сложных задач
codex --profile claude     # альтернативная модель

Sandbox и approval-policies

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

Уровни песочницы

sandbox_mode = "workspace-write"

Политика подтверждений

approval_policy = "on-request"

Доверие проектам

Codex применяет проектный .codex/config.toml только если проект помечен как доверенный:

[projects."/Users/me/work/my-project"]
trust_level = "trusted"

[projects."/Users/me/sandbox/untrusted-project"]
trust_level = "untrusted"

Доверенные проекты получают свои хуки, правила и MCP-серверы; недоверенные ограничиваются глобальным конфигом.

Файл инструкций `AGENTS.md`

Codex автоматически подгружает в системный промпт файлы AGENTS.md, CODEX.md или CLAUDE.md из корня проекта. Это аналог QWEN.md или .cursor/rules — место, где вы описываете правила проекта, чтобы агент следовал им без напоминания.

Пример AGENTS.md:

# Проект: интернет-магазин на Next.js

## Стек
- Next.js 15 (App Router), TypeScript 5.5+
- PostgreSQL + Prisma, тесты на Vitest

## Правила
- Серверные компоненты по умолчанию, `"use client"` только когда нужна интерактивность
- Любая SQL-логика — через Prisma, без сырых запросов
- Покрывать тестами всё, что лежит в `src/lib/`
- Никаких `any` — типы выводить из Zod-схем

## Запрещено
- Коммитить `.env*` и любые секреты
- Менять схему БД без миграций

Полезные CLI-флаги

codex                                # интерактивная сессия
codex --profile max                  # запуск с профилем
codex -c model="claude-sonnet-4-5"   # одноразовое переопределение
codex --search                       # включить web-поиск (live)
codex --enable codex_hooks           # включить feature flag

Команды внутри сессии

Сценарии использования

Рефакторинг крупных модулей

> Преобразуй все колбэки в async/await в src/api/, не ломая внешний интерфейс.
  После каждого файла запускай pnpm test и откатывай, если упали тесты.

gpt-5.1-codex-max отлично справляется с большими рефакторингами благодаря 400K токенов контекста.

Генерация тестов

> Покрой src/services/UserService.ts vitest-тестами.
  Используй фикстуры из tests/fixtures/users.ts. Цель — 90% покрытие.

Миграция стека

> Обнови проект с Next.js 14 на Next.js 15. Учти breaking changes
  в App Router и обнови сигнатуры async params в src/app/.

Отладка по логам

> Прочитай logs/error.log за последний час, найди источник ошибки
  500 на /api/payments и предложи фикс с тестом.

Code review перед коммитом

> Проверь staged-изменения (`git diff --cached`) на security-уязвимости
  и нарушения правил из AGENTS.md. Если что найдёшь — отправь правки.

Headless-режим

Codex CLI умеет работать без интерактивного UI — удобно для CI/CD и автоматизации:

codex -c model="gpt-5.3-codex" --approval-mode never \
  "Сгенерируй CHANGELOG.md по коммитам с последнего тега"

Сравнение с другими AI CLI

Стоимость и оптимизация расходов

Codex-модели тарифицируются по токенам входа и выхода. Через AITUNNEL стоимость отображается в рублях в реальном времени, без скрытых наценок.

Способы снизить расходы:

• Используйте профиль fast для рутины — gpt-5.1-codex-mini в 3-5 раз дешевле max-версий
• Сжимайте историю — /compact урезает старые сообщения, не теряя контекст
• Кешируйте префиксы — AITUNNEL поддерживает prompt caching, повторные системные промпты тарифицируются дешевле
• Снижайте model_reasoning_effort для простых задач — low тратит заметно меньше токенов на reasoning
• Sandbox read-only для разведки — пока агент только смотрит, не нужно тратить токены на пробные правки

Часто задаваемые вопросы

Нужен ли VPN или прокси?

Нет. AITUNNEL работает на российском домене api.aitunnel.ru. Никакие сторонние инструменты не нужны — только config.toml с AITUNNEL как кастомным провайдером.

Можно ли использовать аккаунт ChatGPT через AITUNNEL?

Нет, AITUNNEL — отдельный API-провайдер, не зависящий от ChatGPT. Вместо логина через OAuth используется обычный API-ключ sk-aitunnel-.

Какая модель лучше для типичного рабочего проекта?

gpt-5.3-codex или gpt-5.2-codex — это базовый рабочий выбор. Для очень больших кодовых баз (>200K токенов в одном запросе) — gpt-5.1-codex-max с расширенным контекстом. Для быстрых однострочных правок — gpt-5.1-codex-mini.

Можно ли сменить модель посреди сессии?

Да: команда /model внутри сессии или флаг --profile при следующем запуске. AITUNNEL не привязан к одной модели — баланс общий, ключ один.

Что делать при ошибке 401 / 403?

Проверьте, что AITUNNEL_API_KEY экспортирован в текущей оболочке (echo $AITUNNEL_API_KEY), что ключ активен в личном кабинете и баланс положительный. После правки ~/.zshrc обязательно перезапустите терминал.

Как Codex CLI определяет, какие команды можно запускать без подтверждения?

Через approval_policy и sandbox_mode в config.toml. Связку approval_policy = "on-request" + sandbox_mode = "workspace-write" рекомендуем по умолчанию: чтение свободное, запись только в проект, опасные команды требуют подтверждения.

Почему не показывается мой кастомный провайдер в Codex Desktop?

В Codex Desktop до недавнего времени UI-переключатель моделей не отображался для кастомных провайдеров. В CLI всё работает корректно: запустите codex и используйте /model. На последних версиях Desktop проблему починили.

Дополнительные ресурсы

• Codex CLI на GitHub — исходники, релизы, баг-трекер
• Документация Codex (developers.openai.com) — официальный гайд
• Расширенная конфигурация Codex — профили, MCP, custom providers
• Гайд интеграции Codex CLI с AITUNNEL — пошаговая документация
• Каталог моделей AITUNNEL — актуальные ID и цены
• Личный кабинет AITUNNEL — баланс, ключи, активность