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 при каждом запуске выводит "Метаданные модели для auto не найдены". Codex не знает ID моделей шлюза. Чтобы передать ему настоящие метаданные, например окно контекста и поддержку изображений, добавьте 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 |
"Метаданные модели для auto не найдены" | Codex не знает ID моделей шлюза | Добавьте model_catalog_url |
Ошибки при wire_api = "chat" | Codex поддерживает только Responses API | Задайте wire_api = "responses" |
| Настройки профиля игнорируются | Codex 0.134.0 и новее игнорирует таблицы [profiles.NAME] | Используйте настройку провайдера по умолчанию или отдельный файл профиля |
| "Все модели достигли лимита после N попыток" | Все ключи достигли лимита | Добавьте ключи от большего числа провайдеров или дождитесь окончания пауз |
Часто задаваемые вопросы
Можно ли использовать 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. Таблица на этой странице показывает самые сильные бесплатные модели, которые сегодня соответствуют обоим условиям.
Как исправить "Метаданные модели для auto не найдены"?
Добавьте 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)