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, потрібно вказати власного model_provider у конфігураційному файлі Codex та додати API Token у відповідну змінну середовища.

​
Крок 1: Встановлення змінної середовища

Рекомендується додати API Token у конфігураційний файл вашого Shell, наприклад ~/.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 збережений правильно, а також чи доступна змінна середовища:
Також можна переглянути історію запитів і баланс у 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, ліміт та пересилає запит до відповідного upstream-моделю.
  5. Після виконання платформа фіксує використання та списує відповідний ліміт.
Таким чином, ви користуєтеся оригінальним інтерфейсом Codex CLI, але з моделями Ace Data Cloud.

​
Налаштування моделей

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

​
Рівень довіри проєкту

Codex CLI підтримує налаштування різних рівнів довіри для проєктів, щоб контролювати, які дії агент може виконувати. Додайте в кінець ~/.codex/config.toml:
Пояснення:
  • trusted: агент має повні права, може виконувати команди та змінювати файли.
  • untrusted: агент має обмежені права, підходить для незнайомих проєктів.

​
Додаткова інформація