Что такое интерфейс командной строки Кодекса?
Codex CLI — это агент кодирования OpenAI для работы с репозиториями, редактирования файлов, запуска команд и выполнения задач разработки с терминала.
В этом руководстве объясняется, как настроить интерфейс командной строки Codex с помощью специального поставщика API TokenHub. Он сохраняет рабочий процесс Кодекса, одновременно централизуя ключи API, совместимые модели, журналы запросов и использование токенов в TokenHub. Пользовательские поставщики Кодекса используют API ответов OpenAI, а не обычные завершения чата, поэтому при выборе модели необходимо учитывать ответы, потоковую передачу и поведение вызовов инструментов. Проверьте поставщика в непроизводственном репозитории, начните с задач проверки и объяснения и только затем разрешите редактирование или команды оболочки.
Codex может направлять запросы к моделям через совместимый API-шлюз TokenHub OpenAI compatible. Используйте официальный способ установки, затем замените только API key, Base URL и model ID.
Endpoint TokenHub для этого руководства: https://us-api.tokenhub.com/v1/responses.
Когда использовать
Начните с небольшого репозитория или тестового проекта. Сначала попросите инструмент читать файлы, объяснять код или составлять план, затем включайте правки.
Установите или откройте инструмент
Следуйте официальной документации Codex для установки или запуска. Если интерфейс изменился, ориентируйтесь на актуальную документацию.
Для CLI-инструментов сначала убедитесь, что исполняемый файл доступен, и только потом добавляйте учетные данные TokenHub:
codex --versionПодготовьте учетные данные TokenHub
Создайте TokenHub API key и выберите подходящую модель в списке моделей TokenHub.
export TOKENHUB_API_KEY="sk-..."Храните ключ в локальном shell, секретном хранилище IDE или защищенном поле API key инструмента. Не коммитьте ключ в репозиторий.
Настройте провайдера TokenHub
В настройках Models, Providers, API Keys или OpenAI Compatible укажите следующие значения.
Значения provider
| Поле | Значение |
|---|---|
| Провайдер | OpenAI Compatible или Custom |
| Base URL | https://us-api.tokenhub.com/v1 |
| API Key | Значение TOKENHUB_API_KEY |
| Модель | gpt-4.1 или другой model ID TokenHub |
Расположение настроек
| Поле | Значение |
|---|---|
| User config | ~/.codex/config.toml |
| Provider section | model_providers.tokenhub |
| Secret source | env_key = "TOKENHUB_API_KEY" |
model = "gpt-4.1"
model_provider = "tokenhub"
[model_providers.tokenhub]
name = "TokenHub"
base_url = "__API_BASE_URL__/v1"
env_key = "TOKENHUB_API_KEY"
wire_api = "responses"Codex uses the Responses wire API for this provider, so choose a TokenHub model that supports https://us-api.tokenhub.com/v1/responses.
Если установленная версия записывает немного другую schema, сначала используйте интерактивную настройку, затем сохраните те же значения TokenHub: Base URL, API key и model ID.
Если инструмент разделяет chat, edit, apply и fast models, для первого теста используйте одну и ту же модель TokenHub. После проверки разделите их по стоимости, задержке и силе рассуждения.
Временные переменные только для диагностики
Используйте временные переменные только для проверки ключа, сети и имени модели. После проверки перенесите те же значения в постоянную конфигурацию выше.
export TOKENHUB_API_KEY="sk-..."Проверьте подключение
Сначала используйте read-only prompt, чтобы убедиться, что модель читает контекст и не меняет файлы. Потом проверяйте редактирование и agent tasks.
Прочитай README проекта и кратко опиши его в трех предложениях. Не изменяй файлы.После успешного prompt проверьте в логах TokenHub имя модели, endpoint, расход tokens и billing group.
Устранение неполадок
| Симптом | Что сделать |
|---|---|
| 401 или ошибка аутентификации | Проверьте, что TOKENHUB_API_KEY действителен и сохранен в том же terminal, IDE или профиле клиента. |
| 404 или модель не найдена | Используйте model ID, который есть в рабочей области TokenHub и подходит выбранному протоколу. |
| Неверный endpoint | Оставьте Base URL точно как указано выше. OpenAI-compatible tools обычно требуют /v1; Claude-compatible tools обычно нет. |
| Таймаут запроса | Проверьте сеть до https://us-api.tokenhub.com, proxy settings и allowlist рабочей области. |
| Инструмент использует другую модель | Проверьте все поля chat, edit, apply, fast и autocomplete. |
Как выбрать модель
Часто задаваемые вопросы по пользовательскому API Codex CLI
Почему для базового URL-адреса Кодекса требуется /v1?
Кодекс добавляет путь ответов к поставщику base_url, поэтому поставщик TokenHub должен использовать корень API, за которым следует /v1.
Могу ли я изменить Wire_api на Chat_Completions?
Сохраните Wire_api = «ответы» для текущего пользовательского поставщика Кодекса. Если модель не поддерживает ответы, выберите другую модель вместо использования значения непроверенного протокола.
Почему Кодекс по-прежнему сообщает об отсутствующем ключе API?
Убедитесь, что env_key в config.toml точно соответствует TOKENHUB_API_KEY, и запустите Codex с нового терминала, содержащего эту переменную.
Чем интерфейс командной строки Codex отличается от Claude Code?
Оба являются агентами кодирования, но протоколы их пользовательских поставщиков различаются: Кодекс использует ответы OpenAI, а Claude Code использует антропные сообщения. Сравните рабочий процесс, надежность инструментов, контекст, задержку и стоимость.
Как через TokenHub выставляется счет за использование Кодекса?
TokenHub выставляет счета за ввод, вывод и применимое использование кэша выбранной модели. Единой цены модели Codex CLI не существует, поэтому перед использованием проверьте страницу сведений о текущей модели.
Источники
Эта настройка основана на TokenHub и официальной документации; последняя проверка: 2026-09-04。