Skip to main content
Codex CLI — это локальный программный агент с открытым исходным кодом от OpenAI, который работает в вашем терминале. Он может читать код, изменять файлы, выполнять команды, объяснять ошибки и помогать в выполнении повседневных задач разработки. Codex CLI поддерживает настройку поставщиков моделей. Вы можете использовать его через совместимый прокси OpenAI Responses от Ace Data Cloud без необходимости отдельной подписки на официальный аккаунт OpenAI. После настройки Codex CLI будет отправлять запросы на https://api.acedata.cloud/v1.

​
Процесс регистрации

Чтобы использовать Codex CLI, сначала перейдите в Ace Data Cloud консоль и получите ваш API Token для дальнейшего использования. Если вы ещё не вошли в систему или не зарегистрированы, вас автоматически перенаправит на страницу входа, где можно зарегистрироваться и войти. После входа вы вернётесь на текущую страницу. При первом запросе предоставляется бесплатный лимит, чтобы вы могли бесплатно опробовать сервис Codex CLI.

​
Установка Codex CLI

Codex CLI поддерживает macOS, Linux, Windows и WSL. Вы можете установить его через npm или Homebrew (только для macOS).

​
Установка через npm (рекомендуется)

Если у вас установлен Node.js, можно установить напрямую через npm. Требуется Node.js версии 18 или выше.

​
Установка через Homebrew (macOS)

Пользователи macOS могут установить через Homebrew:

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

После установки откройте терминал заново и проверьте доступность команды:
Если появится сообщение command not found, скорее всего, текущий терминал ещё не загрузил обновлённый PATH. Закройте и откройте терминал снова или проверьте настройки PATH, указанные в выводе установки.

​
Настройка Codex CLI

По умолчанию Codex CLI пытается подключиться к официальному сервису OpenAI. Чтобы использовать Ace Data Cloud, необходимо в конфигурационном файле Codex указать кастомного model_provider и поместить API Token в соответствующую переменную окружения.

​
Шаг 1: Установка переменной окружения

Рекомендуется добавить API Token в конфигурационный файл вашей оболочки, например ~/.zshrc, ~/.bashrc или ~/.bash_profile:
Замените {token} на ваш скопированный API Token из консоли Ace Data Cloud. После этого откройте терминал заново или выполните команду source для немедленного применения:

​
Шаг 2: Редактирование конфигурационного файла Codex

Codex CLI использует глобальный конфигурационный файл ~/.codex/config.toml. Если файла нет, создайте его:
Добавьте в ~/.codex/config.toml следующий контент:
Описание полей:

​
Очистка кеша официального входа OpenAI

Если вы ранее входили в Codex CLI через официальный аккаунт OpenAI, локально мог сохраниться статус входа (обычно в ~/.codex/auth.json). Перед переключением на Ace Data Cloud рекомендуется очистить старый вход:
Если команда codex logout недоступна, можно удалить кеш вручную:
Если вы никогда не входили в официальный аккаунт OpenAI, этот шаг можно пропустить.

​
Запуск сессии

Перейдите в каталог вашего проекта и запустите Codex CLI:
После появления интерфейса Codex можно вводить запросы, например:

​
Проверка конфигурации

В интерфейсе Codex CLI можно проверить текущую модель и поставщика:
Вы должны увидеть, что модель принадлежит поставщику acedatacloud, например:
Если поставщик отличается от acedatacloud, значит конфигурация не применена. Проверьте, сохранён ли файл ~/.codex/config.toml и доступна ли переменная окружения ACEDATACLOUD_API_KEY в текущем терминале:
Также вы можете проверить историю запросов и информацию о расходах в Ace Data Cloud консоли - История использования и остаток лимита в Ace Data Cloud консоли - Список приложений.

​
Принцип работы

Codex CLI изначально использует протокол OpenAI Responses API. Ace Data Cloud предоставляет совместимый прокси по адресу https://api.acedata.cloud/v1/responses, поэтому Codex CLI не требует локального прокси или дополнительных плагинов. Рабочий процесс:
  1. Codex CLI читает model_provider из ~/.codex/config.toml и загружает соответствующий блок [model_providers.acedatacloud].
  2. Codex CLI получает API Token из переменной окружения, указанной в env_key (ACEDATACLOUD_API_KEY).
  3. Запросы по протоколу wire_api = "responses" отправляются на base_url + /responses, то есть https://api.acedata.cloud/v1/responses.
  4. Ace Data Cloud проверяет API Token, лимиты и перенаправляет запросы на доступные каналы моделей.
  5. После выполнения запроса платформа фиксирует использование и списывает соответствующий лимит.
Таким образом, вы продолжаете использовать оригинальную команду codex и родной интерфейс Codex CLI, меняя только базовый сервис модели на Ace Data Cloud.

​
Настройка модели

Параметр model в ~/.codex/config.toml определяет модель по умолчанию. OpenAI Responses сервис Ace Data Cloud поддерживает несколько моделей, наиболее популярные: Для временного переключения модели можно указать параметр при запуске:
Или изменить поле model в ~/.codex/config.toml и перезапустить Codex CLI. Полный список моделей доступен в документации Ace Data Cloud OpenAI сервиса.

​
Уровни доверия проекта

Codex CLI позволяет задавать разные уровни доверия для проектов, чтобы контролировать, какие действия агент может выполнять. Добавьте в конец ~/.codex/config.toml:
Описание уровней:
  • trusted: агент имеет полный доступ, может выполнять команды и изменять файлы.
  • untrusted: агент имеет ограниченные права, подходит для незнакомых проектов.

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