Codex CLI

Codex CLI — официальный консольный кодинг-агент OpenAI, в котором провайдеры моделей задаются через ~/.codex/config.toml. Направьте кастомного провайдера на aicentos — и модели, подключённые к aicentos, станут доступны в терминале.

Если удобнее управлять несколькими конфигурациями графически, можно воспользоваться CC Switch для переключения в один клик; в этой статье описана только ручная настройка.

ПодготовкаКопировать ссылку на якорь

Сначала создайте на странице «API Key» в консоли отдельный ключ для Codex CLI (рекомендуемое имя codex-cli — так проще отслеживать расход):

• Консоль: https://aicentos.com
• Создание ключа: https://aicentos.com/keys
• Пополнение при нехватке баланса: https://aicentos.com/wallet

Убедитесь, что Codex CLI установлен:

codex --version

Конфигурация для заполненияКопировать ссылку на якорь

Шаги настройкиКопировать ссылку на якорь

1. Задайте переменную окружения для API KeyКопировать ссылку на якорь

export AICENTOS_API_KEY="sk-ваш-API-ключ"

Для постоянного действия добавьте её в ~/.zshrc или ~/.bashrc, выполните source и проверьте через echo $AICENTOS_API_KEY.

2. Отредактируйте config.tomlКопировать ссылку на якорь

Добавьте в ~/.codex/config.toml:

model = "имя-вашей-модели"
model_provider = "aicentos"

[model_providers.aicentos]
name = "aicentos"
base_url = "https://aicentos.com/v1"
env_key = "AICENTOS_API_KEY"
wire_api = "responses"

Замените имя-вашей-модели на имя модели, указанное в «витрине моделей» в консоли, см. Поддерживаемые модели.

3. Запустите CodexКопировать ссылку на якорь

codex

Отправьте простой запрос и убедитесь, что провайдер работает.

ПроверкаКопировать ссылку на якорь

codex exec "Ответь одним предложением: сколько будет 1+1"

Если содержимое возвращается нормально, подключение выполнено. Ответ расходует немного средств; сверить это можно в журнале использования в консоли.

ПримечанияКопировать ссылку на якорь

• Base URL указывайте только до /v1, не дописывайте полный путь /v1/chat/completions.
• Поля base_url, env_key и подобные действуют только в пользовательском ~/.codex/config.toml. Файл .codex/config.toml внутри проекта игнорируется, при запуске может появляться предупреждение.
• В wire_api пишите responses — это соответствует интерфейсу Responses у aicentos. Официальная документация пока поддерживает только это значение; если ваша версия выдаёт unknown variant, CLI устарел — рекомендуется сначала обновить.
• openai, ollama, lmstudio — зарезервированные provider ID: нельзя перенаправить на сторонний шлюз, переписав base_url встроенного openai; нужно завести новое имя провайдера (в этой статье это aicentos).
• Порядок диагностики: совпадает ли имя модели с консолью → заканчивается ли Base URL на /v1 → видна ли переменная окружения в том терминале, где запущен codex → хватает ли баланса на аккаунте.

Полезные ссылкиКопировать ссылку на якорь

• Подключение Codex (способ через CC Switch)