Подключение Codex CLI

Сложность ⌨️ Средний уровень (требуется командная строка / терминал)　|　Формат API OpenAI / Responses　|　base_url https://byesu.com/v1

Данные подключения

Адрес APIhttps://byesu.com/v1

Ключ APIsk-xxxxxxxxСоздать в консоли →

Модельgpt-5.5

Формат API OpenAI совместимо · имена моделей — по консоли

Codex — это официальный помощник OpenAI для программирования в командной строке. По умолчанию он подключается к OpenAI, нам нужно лишь направить его на Byesu и указать ваш Key, после чего им можно пользоваться.

Перед началом

Сначала зайдите в Консоль → Токены и создайте API Key (подробнее в Быстром старте). Везде, где ниже встречается sk-xxxx, замените его на ваш собственный Key.

Шаг 1: установка Codex

Если ещё не установлен, выберите любой способ:

npm (кроссплатформенно)

npm install -g @openai/codex

Homebrew (macOS)

brew install codex

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

codex --version

Шаг 2: настройка (один из двух способов)

Способ первый: скрипт в одно действие (самый быстрый, рекомендуется)

Адрес API мы уже прописали в скрипте за вас — после запуска вам нужно лишь вставить ваш API Key (sk-xxxx), и он автоматически настроит ~/.codex/config.toml и auth.json (включая обязательные параметры wire_api=responses, disable_response_storage — о них можно не беспокоиться). После настройки сразу переходите к Шагу 3.

Windows

iex (irm 'https://docs.byesu.com/setup/codex.ps1')

macOS / Linux

curl -fsSL https://docs.byesu.com/setup/codex.sh | bash

Способ второй: ручная настройка

Настройки Codex находятся в каталоге ~/.codex/, нужны два файла.

① ~/.codex/config.toml — задаёт модель и точку подключения:

model = "gpt-5.5"                  # самая новая и мощная; можно указать любое другое имя модели из консоли
model_provider = "byesu"
model_reasoning_effort = "high"    # интенсивность рассуждений: minimal / low / medium / high
disable_response_storage = true    # ★ обязательно при подключении к стороннему шлюзу, иначе возможны ошибки

[model_providers.byesu]
name = "byesu"
base_url = "https://byesu.com/v1"
wire_api = "responses"             # ★ обязательно responses, Codex использует /v1/responses

② ~/.codex/auth.json — хранит ваш Key:

{
  "OPENAI_API_KEY": "sk-ваш-токен"
}

🤔 Не знаете, как создать эти два файла? (нажмите, чтобы открыть)

Windows: в каталоге C:\Users\ваше_имя_пользователя\.codex\ создайте с помощью «Блокнота» по отдельности файлы config.toml и auth.json (при сохранении в поле «Тип файла» выберите «Все файлы»; если папки .codex нет, создайте её вручную через адресную строку).

macOS / Linux: в терминале выполните mkdir -p ~/.codex && open -e ~/.codex/config.toml (в Linux замените open -e на nano), с auth.json поступите аналогично.

Четыре места, где чаще всего ошибаются

1. wire_api обязательно должен быть responses (а не chat), иначе будет ошибка 404 / неверный интерфейс.
2. base_url заканчивается на /v1, не добавляйте лишнее /responses.
3. Не забудьте про disable_response_storage = true, иначе при подключении к шлюзу может возникнуть ошибка.
4. Имя поля в auth.json — именно OPENAI_API_KEY (даже если вы указываете токен Byesu).

Шаг 3: запуск и проверка

Зайдите в любой каталог проекта и запустите:

codex

Затем попросите его сделать что-нибудь простое, например введите «перечисли файлы в текущем каталоге». Если он нормально отвечает — подключение работает ✅

Полезные советы

Регулировка интенсивности рассуждений

model_reasoning_effort управляет тем, «как долго думает» модель:

• minimal / low: быстро, экономно, подходит для простых изменений
• medium: сбалансированный вариант по умолчанию
• high: сложный рефакторинг, трудные задачи; максимальное качество, но медленнее и дороже

Смена модели

Просто измените строку model в config.toml, указав любое доступное в консоли имя модели. Если нужна версия, специально оптимизированная для Codex, можно указать gpt-5.3-codex-spark.

Застряли?

Сверьтесь с разделом Частые ошибки и решения, вот несколько самых распространённых:

• Ошибка 401 / invalid token → Key в auth.json указан неверно или файл лежит не в том месте (подробнее)
• Ошибка недостаточно средств → пополните баланс в консоли (подробнее)
• Ошибка нет доступных каналов → эта модель не входит в вашу группу, выберите другую модель (подробнее)