# Codex CLI

Источник: https://docs.aicentos.com/ru/clients/codex-cli

Language: ru

> Использование aicentos в Codex CLI — ручная настройка model_providers в config.toml

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

Если удобнее управлять несколькими конфигурациями графически, можно воспользоваться [CC Switch](https://docs.aicentos.com/ru/clients/cc-switch) для переключения в один клик; в этой статье описана только ручная настройка.

## Подготовка

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

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

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

```bash
codex --version
```

## Конфигурация для заполнения

| Поле                             | Значение                                  |
| -------------------------------- | ----------------------------------------- |
| Provider ID                      | `aicentos`                                |
| Название провайдера              | `aicentos`                                |
| Переменная окружения для API Key | `AICENTOS_API_KEY`                        |
| Base URL                         | `https://aicentos.com/v1`                 |
| Модель                           | имя модели из «витрины моделей» в консоли |

## Шаги настройки

### 1. Задайте переменную окружения для API Key

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

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

### 2. Отредактируйте config.toml

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

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

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

Замените `имя-вашей-модели` на имя модели, указанное в «витрине моделей» в консоли, см. [Поддерживаемые модели](https://docs.aicentos.com/ru/billing/models-list).

### 3. Запустите Codex

```bash
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](https://docs.aicentos.com/ru/api/chat/openai/responses) у aicentos. Официальная документация пока поддерживает только это значение; если ваша версия выдаёт `unknown variant`, CLI устарел — рекомендуется сначала обновить.
* `openai`, `ollama`, `lmstudio` — зарезервированные provider ID: **нельзя** перенаправить на сторонний шлюз, переписав base\_url встроенного `openai`; нужно завести новое имя провайдера (в этой статье это `aicentos`).
* Порядок диагностики: совпадает ли имя модели с консолью → заканчивается ли Base URL на `/v1` → видна ли переменная окружения **в том терминале, где запущен codex** → хватает ли баланса на аккаунте.

## Полезные ссылки

* [Подключение Codex (способ через CC Switch)](https://docs.aicentos.com/ru/clients/codex)