Codex CLI: свій ключ замість підписки

Codex — не підказник у редакторі, а самостійний виконавець. Ви формулюєте задачу словами, він сам вирішує, які файли прочитати, які команди виконати і що змінити. У його розпорядженні близько десятка інструментів: запуск команд, читання файлів, ведення плану робіт, запит уточнення у користувача, створення дочірніх агентів під підзадачі.

Два режими роботи. Інтерактивний — codex без аргументів, діалог у терміналі з показом кожного кроку. Неінтерактивний — codex exec «задача», разовий прогін до результату: зручно в скриптах та CI.

Безпека вбудована: за замовчуванням агент працює в пісочниці та запитує підтвердження перед змінами. Рівень контролю задається в конфігурації — від «запитувати все» до повністю автономного прогону з правом запису в робочий каталог.

Ще одна особливість — стан діалогу. Codex не просить сервер нічого запам'ятовувати: він тримає всю стрічку у себе і відправляє її цілком з кожним ходом. Для вас це означає, що листування не осідає на стороні провайдера моделі, а зміна endpoint не ламає розпочату сесію.

Відмінність від Claude Code та інших термінальних агентів — саме протокол. Codex спілкується з моделлю через Responses API, де листування описується не плоским списком повідомлень, а стрічкою елементів: текст, виклик інструменту, результат виклику, блок міркувань. Інструменту це дає суворішу модель діалогу, а вам — необхідність мати endpoint, який цей протокол розуміє.

Codex зберігає налаштування в ~/.codex/config.toml. Свій провайдер описується блоком [model_providers.*], і ключове поле тут — wire_api: без нього Codex спробує говорити на Chat Completions і не збере агентний цикл.

# ~/.codex/config.toml
model_provider = "joingonka"
model = "deepseek-ai/DeepSeek-V4-Flash-0731"

[model_providers.joingonka]
name = "JoinGonka Gateway"
base_url = "https://gate.joingonka.ai/v1"
env_key = "JOINGONKA_API_KEY"
wire_api = "responses"

Ключ у файл не пишеться: env_key називає змінну оточення, з якої Codex його візьме. Ім'я змінної своє, не OPENAI_API_KEY — так налаштування не перехоплює ваші інші інструменти, що працюють з OpenAI.

export JOINGONKA_API_KEY=jg-ваш-ключ

Поле model задає модель за замовчуванням, а model_provider — який з описаних блоків використовувати. Обидва перевизначаються в момент запуску, тому один конфіг спокійно обслуговує кілька провайдерів: робочий, експериментальний та запасний.

Ключ видається в особистому кабінеті після реєстрації, там же видно баланс і витрати. Якщо віддаєте перевагу не чіпати загальний конфіг, той самий блок можна передати разово через -c: codex -c model_provider=joingonka …. А щоб тримати кілька незалежних конфігурацій, вкажіть каталог налаштувань змінною CODEX_HOME.

Найшвидший спосіб переконатися, що зв'язка працює, — разовий прогін:

codex exec "Відповісти одним рядком: скільки буде 17*3?"

У шапці відповіді Codex друкує, з ким він працює: model, provider: joingonka, режим пісочниці та ідентифікатор сесії. Якщо там ваш провайдер і внизу прийшла відповідь — з'єднання живе.

Далі варто перевірити головне, заради чого Codex і ставлять, — роботу з файлами. Покладіть у каталог невеликий файл з очевидною помилкою і попросіть її знайти:

codex exec "Прочитай calc.py і скажи однією фразою, чи є помилка."

Агент має сам викликати інструмент читання, відкрити файл і відповісти по суті — із зазначенням рядка. Якщо це сталося, повний агентний цикл (запит → виклик інструменту → результат → відповідь) через шлюз збирається коректно.

Якщо щось пішло не так, діагноз зазвичай читається прямо з повідомлення:

Перший запит у сесії може зайняти кілька секунд: Codex відправляє великий системний промпт і опис усіх своїх інструментів, а вузлу мережі потрібно прийняти завдання. Наступні відповіді приходять швидше.

Усі моделі мережі доступні за однією ціною, тому вибір — про поведінку, а не про бюджет. Нижче результат живого прогону одного й того ж завдання (читання файлу та пошук помилки в ньому) через Codex на кожній із моделей.

Рекомендація за замовчуванням — DeepSeek V4 Flash: агентна робота швидко впирається в обсяг контексту, а 380K токенів дають можливість тримати в голові багато файлів одразу. Якщо хочеться гранично коротких відповідей — беріть Kimi K2.6. Модель змінюється одним рядком model у конфігу або прапором -c model=… без редагування файлу.

Актуальний список моделей мережі завжди віддає GET https://gate.joingonka.ai/v1/models.

Агентні інструменти витрачають токени інакше, ніж чат: до кожної вашої фрази Codex додає системний промпт і опис усіх інструментів, а потім веде багатокроковий діалог з моделлю. У живому прогоні просте завдання «прочитай файл і знайди помилку» обійшлося приблизно в 18-20 тисяч токенів. Це нормальна плата за автономність, і саме тому ціна за токен вирішує.

Через JoinGonka Gateway токени коштують $0.0047 за мільйон на вході та $0.014 за мільйон на виході — ціна однакова для всіх моделей мережі і підставляється на цій сторінці з живого джерела.

Для порівняння — як влаштовані платні варіанти у самого Codex та у сусідів по ніші:

Оплата йде за фактичні витрати, без місячної підписки і без квот на кількість запитів: немає п'ятигодинних вікон, ліміту «промптів» і множників у пікові години. Баланс поповнюється криптовалютою, залишок і витрати по днях видно в особистому кабінеті. Детальний розбір економіки — у статті про найдешевший API.

Історію діалогу тримає сам Codex. Він відправляє її повністю з кожним запитом і не просить сервер нічого запам'ятовувати — а ми листування не зберігаємо. Ваш код і промпти не залишаються на шлюзі після відповіді.

Веб-пошук працює. Codex оголошує інструмент пошуку в кожному запиті, і шлюз його приймає: пошук виконується на нашій стороні, результати підмішуються у відповідь моделі.

Інструменти — власні, не хмарні. Codex виконує команди та читає файли локально, у вас на машині, тому доступ до проєкту не залежить від провайдера моделі.

Пісочниця. На Linux Codex використовує bubblewrap для ізоляції запущених команд. Якщо його немає в системі, Codex попередить і візьме вбудовану копію — на роботу це не впливає, але пакет зручніше встановити штатним менеджером.

Якщо потрібна робота з картинками — скріншот інтерфейсу, схема на фото — використовуйте для таких завдань інструмент з моделлю, що вміє зір: у мережі Gonka моделі текстові. Для коду, команд і файлів це обмеженням не є.

Інші термінальні агенти, якщо Codex не підійшов: швидкий старт по API показує, як підключити будь-який сумісний інструмент за пару хвилин.