Використання 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_auth | false означає, що 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 називає кожен невдалий перехід і причину.
[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 це агент. Він запускає команди оболонки і редагує файли через виклики інструментів. Використовуйте моделі з викликом інструментів і великим вікном контексту. Таблиця показує безкоштовні моделі, які сьогодні відповідають обом правилам.
| Модель | Безкоштовно на | Контекст | Безкоштовні ліміти (найкращі) | Інструменти | Зображення |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 запитів/хв 1 req/min per model | Так | Ні |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 запитів/хв 40 RPM | Так | Так |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Так | Так |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Так | Ні |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Так | Так |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 запитів/хв 20 запитів/добу 250,000 токенів/хв ~3M | Так | Так |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Так | Так |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 запитів/хв 50 запитів/добу 50 req/day account-wide (1,000 after a $10 purchase) | Так | Так |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 запитів/хв 50 запитів/добу Shared rate limit | Так | Ні |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 запитів/хв 250 запитів/добу 70,000 токенів/хв ~6M | Так | Так |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 запитів/хв 20 запитів/добу 250,000 токенів/хв ~3M | Так | Так |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 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 просить увійти через ChatGPT | model_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» | Усі ключі досягли ліміту | Додайте ключі від більшої кількості провайдерів або дочекайтеся охолодження |
Часті запитання
Чи можна використовувати Codex CLI безкоштовно?
Так. Codex CLI має відкритий код. Додайте FreeLLMAPI як власного провайдера моделей у config.toml. Шлюз надсилає кожен запит до безкоштовних тарифів провайдерів, тому вартість інференсу становить $0.
Чи може Codex CLI використовувати моделі інших провайдерів?
Так. Додайте блок [model_providers.
Чи підтримує 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 читає справжні метадані для моделей шлюзу.
Схожі посібники
- Як безкоштовно використовувати Claude Code
- Використання OpenCode з безкоштовним LLM API
- Aider з безкоштовним LLM API
- Найкращі безкоштовні API моделей для коду
- Чи є безкоштовний GPT API?
Джерела
- Codex docs: config reference (перевірено 20 November 2026)
- Codex docs: advanced config and profiles (перевірено 20 November 2026)
- Codex CLI repository (перевірено 20 November 2026)
- FreeLLMAPI docs: coding agents and Codex (перевірено 20 November 2026)
- FreeLLMAPI CLI generators (перевірено 20 November 2026)