Быстрый старт Codex CLI за 5 минут (2026)

Установите Codex CLI и подключите к QCode.cc за 5 минут: скрипт в один клик или ручная настройка config.toml и auth.json. Ключ тот же, что у Claude Code.

Нужен API-ключ? Зарегистрироваться →·Эндпоинты и Base URL →

⚡ Рекомендуем установку в один клик — curl -fsSL https://qcode.cc/install/codex.sh | bash (в Windows: irm https://qcode.cc/install/codex.ps1 | iex) поставит CLI, запишет конфигурацию ~/.codex и проверит связь. См. Скрипт установки в один клик. Если хотите настроить вручную — читайте дальше.

Если вы уже пользуетесь Claude Code, это руководство запустит у вас Codex CLI за 5 минут. Оба инструмента делят квоту тарифа QCode.cc и используют один и тот же API-ключ, так что после настройки можно свободно переключаться между ними.

Если аккаунта QCode.cc ещё нет, сначала выберите вариант и получите ключ (ключ используется одинаково при любом варианте).

Требования¶

Перед началом убедитесь, что окружение соответствует требованиям:

Примечание: песочница уровня ядра у Codex работает лучше всего на Linux. macOS и Windows WSL тоже полностью поддерживаются, хотя часть возможностей песочницы там может быть ограничена.

Шаг 1: Установка Codex CLI¶

Выберите один из способов:

Вариант A: глобальная установка через npm (рекомендуется)¶

npm install -g @openai/codex

# Пользователи из Китая могут ускорить установку через зеркало Taobao
npm install -g @openai/codex --registry=https://registry.npmmirror.com

Вариант B: Homebrew (macOS)¶

brew install --cask codex

Вариант C: сборка из исходников¶

git clone https://github.com/openai/codex.git
cd codex
cargo build --release
cp target/release/codex ~/.local/bin/

Проверьте установку:

codex --version
# выведет версию (доверяйте `codex --version` на своей машине, а не устаревшему числу из интернета)

Шаг 2: Настройка QCode.cc¶

2.1 Создайте каталог конфигурации¶

mkdir -p ~/.codex

2.2 Запишите config.toml¶

Создайте ~/.codex/config.toml:

model_provider = "qcode"
model = "gpt-6.1-sol"
model_reasoning_effort = "high"

[model_providers.qcode]
name = "qcode"
base_url = "https://api.qcode.cc/openai"
wire_api = "responses"
requires_openai_auth = true

Описание параметров:

2.3 Создайте auth.json¶

Создайте ~/.codex/auth.json:

{
  "OPENAI_API_KEY": "cr_your_key_here"
}

Замените cr_your_key_here на API-ключ из вашей консоли QCode.cc.

2.4 Задайте переменные окружения¶

Чтобы передавать ключ через переменную окружения, замените в [model_providers.qcode] строку requires_openai_auth = true на env_key = "QCODE_API_KEY" и экспортируйте эту переменную. Выберите только один из двух вариантов: в официальной документации сказано, что при requires_openai_auth = true Codex игнорирует env_key. Полная конфигурация для варианта с переменной окружения:

model_provider = "qcode"
model = "gpt-6.1-sol"
model_reasoning_effort = "high"

[model_providers.qcode]
name = "qcode"
base_url = "https://api.qcode.cc/openai"
wire_api = "responses"
env_key = "QCODE_API_KEY"

Затем задайте переменную окружения:

# Временно (только текущая сессия терминала)
export QCODE_API_KEY="cr_your_key_here"

# Постоянно (для Bash)
echo 'export QCODE_API_KEY="cr_your_key_here"' >> ~/.bashrc
source ~/.bashrc

# Постоянно (для Zsh)
echo 'export QCODE_API_KEY="cr_your_key_here"' >> ~/.zshrc
source ~/.zshrc

Подсказка: это тот же ключ, что и для Claude Code. Если вы уже пользуетесь Claude Code, ключ лежит в том же месте в консоли.

Шаг 3: Проверка настройки¶

Запустите простую задачу, чтобы проверить соединение:

codex "print hello world"

Если Codex нормально стартовал и вернул ответ, настройка выполнена успешно.

Чек-лист¶

• Codex запускается без ошибок
• Запросы к API идут через QCode.cc (нет сетевых таймаутов)
• Модель отвечает корректно (понимает ваши инструкции)

Если что-то не работает, перейдите в раздел Частые вопросы.

Шаг 4: Первая настоящая задача¶

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

cd /path/to/your/project

Пример 1: анализ структуры проекта¶

codex "Проанализируй структуру каталогов и технологический стек этого проекта и дай краткий обзор"

Пример 2: генерация кода¶

codex "Создай файл utils/date-formatter.ts со следующими возможностями:
  1. Форматирование даты в вид YYYY-MM-DD
  2. Подсчёт количества дней между двумя датами
  3. Определение, является ли дата рабочим днём
  4. Полные JSDoc-комментарии и модульные тесты для каждой функции"

Пример 3: массовые изменения¶

codex "Преобразуй все файлы .js в src/ в .ts и добавь аннотации типов"

Codex автономно выполнит задачу в песочнице, а затем покажет сводку изменений для проверки.

Права и песочница¶

Codex двумя параметрами управляет тем, что он может делать (--sandbox), и тем, когда он спрашивает вас (--ask-for-approval). Сведения ниже взяты из официальной документации OpenAI (по состоянию на 2026-10-15).

По умолчанию: рабочая область доступна для записи, подтверждение по запросу¶

codex "Рефакторинг модуля auth"

• В Git-репозитории эта предустановка действует без параметров: Codex читает файлы, правит их и запускает команды внутри рабочей области, а перед записью за её пределами или выходом в сеть спрашивает
• Подходит для: повседневной разработки (рекомендуемый вариант по умолчанию)

Только чтение: смотреть, но не менять¶

codex --sandbox read-only --ask-for-approval on-request "Проанализируй модуль auth и предложи рефакторинг"

• Песочница только для чтения -- файлы не изменяются
• Подходит для: изучения кода, оценки вариантов

Неинтерактивный режим и автоматизация¶

codex exec --sandbox workspace-write "Запусти тесты и исправь все падения"

• codex exec работает неинтерактивно и выводит результат в стандартный вывод (с --json — в формате JSONL)
• Песочница ограничена рабочей областью и не затрагивает систему за её пределами
• Подходит для: интеграции в CI/CD, пакетных задач

Значения по умолчанию можно задать и в config.toml: approval_policy = "on-request" и sandbox_mode = "workspace-write". Формы --suggest, --auto-edit и approval_mode из старых руководств в текущем официальном списке параметров отсутствуют; в случае сомнений ориентируйтесь на codex --help.

Справочник команд¶

Доступные модели¶

Через QCode.cc доступны следующие модели:

QCode сейчас не предоставляет gpt-6-luna / gpt-5.6-luna. Используйте другие модели GPT. QCode тарифицирует по токенам, цены по моделям указаны на qcode.cc/models.

В меню /model нет gpt-6.1-sol? При настройке, приведённой выше, меню /model в Codex показывает список моделей, встроенный в сам клиент, поэтому он зависит от версии Codex: gpt-6.1-sol появляется в меню начиная с Codex 0.160.0. Обновите Codex до последней версии (npm install -g @openai/codex@latest, для Homebrew — brew upgrade --cask codex). Можно и без обновления: model = "gpt-6.1-sol" в config.toml (или codex --model gpt-6.1-sol) не зависит от меню. И наоборот: в меню может появиться gpt-6-luna, но QCode её сейчас не предоставляет — при выборе вернётся ошибка.

Конфигурация проекта: AGENTS.md¶

Создайте в корне проекта файл AGENTS.md, чтобы задать поведение Codex в этом проекте — по аналогии с CLAUDE.md у Claude Code:

# AGENTS.md

- Использовать строгий режим TypeScript
- Стиль кода — ESLint + Prettier
- Фреймворк тестов: Vitest
- Перед коммитом выполнять `npm run lint && npm test`
- Файлы компонентов именовать в PascalCase

Подробнее о настройке — Руководство по AGENTS.md.

Совместное использование с Claude Code¶

Поскольку оба инструмента делят квоту QCode.cc, лучшая практика — использовать их вместе:

# Терминал 1: анализируем проблему в Claude Code
$ claude
> Где узкое место по производительности? Помоги разобрать подход.

# Терминал 2: массово выполняем в Codex
$ codex "По этому плану оптимизируй все запросы к базе в src/api/:
  1. Добавь кеширование запросов
  2. Устрани N+1 запросы
  3. Добавь комментарии с рекомендациями по индексам"

Больше схем совместной работы — в статье Codex vs Claude Code.

Следующие шаги¶

Настройка завершена — можно начинать работать с Codex. Рекомендуем прочитать:

• Руководство по AGENTS.md -- настроить поведение Codex в проекте
• Codex vs Claude Code -- понять различия и как их сочетать
• Настройка интеграции с Codex -- полный справочник по настройке (включая подробные шаги для Windows и других ОС)
• Приёмы работы в CLI -- приёмы повышения продуктивности

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

Q: Установка падает с npm ERR! EACCES¶

Причина: недостаточно прав на каталог глобальной установки npm.

Решение:

# Вариант A: через sudo (не рекомендуется на постоянной основе)
sudo npm install -g @openai/codex

# Вариант B: настроить npm на пользовательский каталог (рекомендуется)
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g @openai/codex

Q: Появляется API key not found или ошибка аутентификации¶

Что проверить:

1. Ключ в ~/.codex/auth.json начинается с cr_
2. Если используете вариант с переменной окружения, в провайдере должно быть env_key = "QCODE_API_KEY" (без requires_openai_auth = true), а переменная экспортирована: echo $QCODE_API_KEY
3. Ключ не истёк: проверьте в консоли QCode.cc
4. Синтаксис TOML и имя провайдера в config.toml указаны верно

Q: Таймаут соединения или сетевая ошибка¶

Что проверить:

1. base_url указан как https://api.qcode.cc/openai
2. Проверьте связь: curl -I https://api.qcode.cc

3. Если текущая точка доступа недоступна, попробуйте другую:

4. Азиатская точка доступа: https://asia.qcode.cc/openai

Q: Ключ для Codex тот же, что и для Claude Code?¶

Да. Оба используют один API-ключ QCode.cc и общую квоту. Отдельный ключ не нужен.

Q: Работает ли это в Windows?¶

Да, но мы рекомендуем WSL (Windows Subsystem for Linux). Нативная поддержка Windows тоже улучшается. Подробные шаги для Windows — в Настройке интеграции с Codex.

Enterprise →