Головна / Посібники / Використання Codex CLI з безкоштовними моделями

Використання Codex CLI з безкоштовними моделями

Codex CLI це агент для написання коду від OpenAI з відкритим кодом, який працює в терміналі. Він може використовувати власного провайдера моделей. Цей посібник підключає Codex CLI до безкоштовних моделей інших провайдерів через FreeLLMAPI. Codex працює з Responses API, а FreeLLMAPI обслуговує його на /v1/responses.

Код, назви моделей і мітки живого каталогу показано англійською.

Як це працює

Codex CLI надсилає запити у форматі OpenAI Responses. Документація Codex каже, що responses це єдине підтримуване значення wire_api. Тому провайдер для Codex має обслуговувати /v1/responses. FreeLLMAPI обслуговує цю кінцеву точку. Він перетворює кожен запит і надсилає його до безкоштовної моделі, наприклад Gemini, GPT-OSS, Qwen або GLM.

  • Ви отримуєте: агента Codex CLI, його інструменти і цикл редагування на безкоштовних моделях.
  • Ви не отримуєте: власні моделі GPT від OpenAI через ваш план ChatGPT. Запити надходять до безкоштовних провайдерів у вашому пулі FreeLLMAPI.
  • Обмеження: введення зображень на /v1/responses поки не підтримується. Використовуйте текстові промпти.

Крок 1: встановіть FreeLLMAPI і Codex CLI

Встановіть обидва

curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @openai/codex

Відкрийте http://localhost:3001. Додайте щонайменше два безкоштовні ключі провайдерів на сторінці Keys. Скопіюйте свій єдиний ключ з тієї самої сторінки. На macOS можна також встановити Codex командою brew install --cask codex.

Крок 2: підключіть Codex CLI

Команда налаштування додає провайдера в ~/.codex/config.toml. Спочатку вона створює резервну копію і об'єднує новий блок, тому ваші інші налаштування залишаються.

Одна команда

export FREELLMAPI_API_KEY=<unified-key>
npx freellmapi setup-codex --url http://localhost:3001 --dry-run
npx freellmapi setup-codex --url http://localhost:3001
codex

Команда записує ці налаштування зі значеннями з вашого живого каталогу. Ключа у файлі немає. Codex читає його зі змінної середовища FREELLMAPI_API_KEY, тому експортуйте цю змінну в кожній оболонці, де запускаєте Codex.

~/.codex/config.toml

model = "auto"
model_provider = "freellmapi"
model_context_window = 128000
model_auto_compact_token_limit = 115200
tool_output_token_limit = 20000

[model_providers.freellmapi]
name = "FreeLLMAPI"
base_url = "http://localhost:3001/v1"
wire_api = "responses"
env_key = "FREELLMAPI_API_KEY"
requires_openai_auth = false
КлючЩо робить
model_providerВибирає провайдера з model_providers. За замовчуванням це openai.
env_keyЗмінна середовища, яка містить ключ API провайдера
requires_openai_authfalse означає, що Codex не запитує вхід в OpenAI
model_context_windowТокени контексту активної моделі. Команда бере значення з вашого живого каталогу.
model_auto_compact_token_limitКількість токенів, з якої починається автоматичне стискання історії. Команда встановлює 90% вікна контексту.
tool_output_token_limitБюджет токенів для кожного виводу інструмента, який Codex зберігає в історії

Щоб тримати ключ поза файлами і поза профілем вашої оболонки, використовуйте лаунчер. Він запускає Codex з ключем лише у своєму середовищі:

Лаунчер без збереження

npx freellmapi launch-codex

Щоб переконатися, що запити надходять до шлюзу, запустіть npx freellmapi doctor. Команда перевіряє маршрутизований заголовок Authorization, каталог і живу перевірку. Потім журнал запитів на панелі керування показує кожен виклик Codex. Заголовок відповіді X-Routed-Via називає провайдера і модель, які відповіли. Якщо запит перейшов на резервний варіант, X-Fallback-Trail називає кожен невдалий перехід і причину.

Профілі: документація Codex каже, що Codex 0.134.0 і новіші більше не читають таблиці [profiles.NAME] з config.toml. Тепер профілі є окремими файлами, наприклад ~/.codex/NAME.config.toml. Використовуйте налаштування за замовчуванням, описані вище, з актуальною версією Codex.

Приберіть попередження про метадані моделі

Codex виводить «Model metadata for auto not found» під час кожного запуску. Codex не знає ідентифікаторів моделей шлюзу. Щоб дати йому справжні метадані, наприклад вікно контексту і підтримку зображень, додайте URL каталогу моделей до провайдера:

Додайте до [model_providers.freellmapi]

model_catalog_url = "http://localhost:3001/v1/codex/models"

Каталог зберігає системний промпт за замовчуванням і налаштування інструментів Codex. Змінюються лише попередження і вікно контексту.

Виберіть моделі для Codex CLI

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

Безкоштовні моделі для Codex CLI: виклик інструментів і контекст 128K+
МодельБезкоштовно наКонтекстБезкоштовні ліміти (найкращі)ІнструментиЗображення
GLM 5.3UnoRouter1M1 запитів/хв
1 req/min per model
ТакНі
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 запитів/хв
40 RPM
ТакТак
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaТакТак
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceТакНі
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditТакТак
Gemini 3.7 FlashGoogle AI Studio1M10 запитів/хв
20 запитів/добу
250,000 токенів/хв
~3M
ТакТак
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditТакТак
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 запитів/хв
50 запитів/добу
50 req/day account-wide (1,000 after a $10 purchase)
ТакТак
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 запитів/хв
50 запитів/добу
Shared rate limit
ТакНі
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 запитів/хв
250 запитів/добу
70,000 токенів/хв
~6M
ТакТак
Gemini 3.6 FlashGoogle AI Studio1M10 запитів/хв
20 запитів/добу
250,000 токенів/хв
~3M
ТакТак
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayТакТак

Показано 12 із 109 відповідних безкоштовних моделей. Переглянути всі моделі.

Дані в реальному часі з каталогу FreeLLMAPI (версія 2026.11.19, перевірено 2026-11-19). Безкоштовні ліміти часто змінюються. Каталог перевіряється щодня.

Залиште model = "auto", щоб маршрутизатор вибирав модель для кожного запиту. Щоб закріпити одну модель, запустіть npx freellmapi setup-codex --url http://localhost:3001 --model <id>. Можна також встановити model = "auto:smart" або model = "auto:fast" у config.toml.

Безкоштовні тарифи мають ліміти за хвилину і за добу. Коли провайдер надсилає помилку 429, FreeLLMAPI надсилає запит до наступної моделі в ланцюжку. Додайте ключі від чотирьох або більше провайдерів для довгих сесій Codex. Codex стискає свою історію, коли досягає model_auto_compact_token_limit. Менше значення надсилає менші запити, що допомагає на безкоштовних тарифах з низькими лімітами токенів за хвилину.

Усунення несправностей

ПроблемаПричинаРішення
Codex просить увійти через ChatGPTmodel_provider не встановлено, тому Codex використовує openaiВстановіть model_provider = "freellmapi"
401 «Invalid API key»FREELLMAPI_API_KEY не встановлено в цій оболонціЕкспортуйте змінну або використовуйте npx freellmapi launch-codex
«Model metadata for auto not found»Codex не знає ідентифікаторів моделей шлюзуДодайте model_catalog_url
Помилки з wire_api = "chat"Codex підтримує лише Responses APIВстановіть wire_api = "responses"
Налаштування профілю ігноруютьсяCodex 0.134.0 і новіші ігнорують таблиці [profiles.NAME]Використовуйте налаштування провайдера за замовчуванням або окремий файл профілю
«All models rate-limited after N attempts»Усі ключі досягли лімітуДодайте ключі від більшої кількості провайдерів або дочекайтеся охолодження
Використовуйте кожну з цих моделей через один ключ. FreeLLMAPI це маршрутизатор з відкритим кодом, який ви розгортаєте самі. Він об'єднує всі ці безкоштовні тарифи за однією кінцевою точкою, сумісною з OpenAI, і переходить до наступного, коли один з них досягає ліміту. Переглянути каталог або або почніть роботу.

Часті запитання

Чи можна використовувати Codex CLI безкоштовно?

Так. Codex CLI має відкритий код. Додайте FreeLLMAPI як власного провайдера моделей у config.toml. Шлюз надсилає кожен запит до безкоштовних тарифів провайдерів, тому вартість інференсу становить $0.

Чи може Codex CLI використовувати моделі інших провайдерів?

Так. Додайте блок [model_providers.] з base_url, env_key і wire_api = "responses", потім встановіть model_provider. Провайдер має обслуговувати Responses API.

Чи підтримує Codex CLI Chat Completions API?

Ні. Довідка з конфігурації Codex каже, що responses це єдине підтримуване значення wire_api. FreeLLMAPI обслуговує /v1/responses, тому він працює як провайдер для Codex.

Яка безкоштовна модель найкраща для Codex CLI?

Використовуйте модель з викликом інструментів і щонайменше 128K контексту. Таблиця на цій сторінці показує найсильніші безкоштовні моделі, які сьогодні відповідають обом правилам.

Як виправити «Model metadata for auto not found»?

Додайте model_catalog_url = "http://localhost:3001/v1/codex/models" до блоку провайдера в ~/.codex/config.toml. Тоді Codex читає справжні метадані для моделей шлюзу.

Схожі посібники

Джерела

Усі посібники · Переглянути всі безкоштовні моделі