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

Как исправить "Метаданные модели для auto не найдены"?

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

Похожие руководства

Источники

Все руководства · Смотреть все бесплатные модели