> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Использование APIMart в Codex CLI

> Подробное руководство по настройке и использованию API-сервиса APIMart в Codex CLI, позволяющее получить доступ к нескольким AI-моделям для помощи в программировании с простой конфигурацией.

## Введение

Codex CLI — это open-source терминальный кодинг-агент OpenAI, который может читать и писать файлы, выполнять команды, исправлять баги и выполнять полные задачи кодирования прямо из командной строки.
Подключившись через APIMart, вы можете свободно использовать в Codex CLI несколько моделей — включая GPT и Claude — с более гибким и конкурентным ценообразованием.

## Предварительные требования

Перед началом убедитесь, что у вас есть:

1. **Установленный Node.js**
   Скачайте и установите с [сайта Node.js](https://nodejs.org/) (рекомендуется последняя LTS, v20 или новее), чтобы установить Codex CLI через npm

2. **Получен API-ключ APIMart**
   Войдите в [консоль APIMart](https://apimart.ai/keys) для получения API-ключа (начинается с `sk-`)

<Note>**Совет:** если у вас ещё нет аккаунта APIMart, сначала зарегистрируйтесь на [APIMart](https://apimart.ai) и получите API-ключ.</Note>

## Шаг 1: Установите Codex CLI

Выберите любой из следующих способов установки:

<Tabs>
  <Tab title="npm (рекомендуется)">
    Глобальная установка через npm — работает на всех ОС:

    ```bash theme={null}
    npm install -g @openai/codex
    ```

    <Note>При проблемах с правами добавьте `sudo` (macOS / Linux).</Note>
  </Tab>

  <Tab title="Homebrew (macOS)">
    Пользователи macOS также могут установить через Homebrew:

    ```bash theme={null}
    brew install codex
    ```
  </Tab>
</Tabs>

### Проверка установки

После установки выполните следующую команду для подтверждения:

```bash theme={null}
codex --version
```

Если выводится номер версии, установка прошла успешно.

## Шаг 2: Настройте API APIMart

Codex CLI управляет провайдерами моделей через файлы конфигурации в директории `~/.codex/`. Всё, что нужно — добавить кастомного провайдера, указывающего на APIMart.

### 2.1 Найдите директорию конфигурации

* **macOS / Linux:** `~/.codex/`
* **Windows:** `C:\Users\<username>\.codex\`

<Note>Если директории не существует, выполните `codex` в терминале, затем нажмите `Ctrl + C` для выхода — она будет создана автоматически.</Note>

### 2.2 Настройте API-ключ

В директории конфигурации создайте или отредактируйте файл `auth.json` и впишите ваш ключ APIMart:

```json theme={null}
{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxx"
}
```

| Поле             | Описание                                  |
| ---------------- | ----------------------------------------- |
| `OPENAI_API_KEY` | Ваш API-ключ APIMart (начинается с `sk-`) |

### 2.3 Настройте провайдера модели

В директории конфигурации создайте или отредактируйте файл `config.toml` и добавьте провайдера APIMart:

```toml theme={null}
# Default model
model = "gpt-5.5"
# Default provider — matches [model_providers.apimart] below
model_provider = "apimart"

# APIMart provider configuration
[model_providers.apimart]
name = "APIMart"
base_url = "https://api.apimart.ai/v1"
wire_api = "responses"
requires_openai_auth = true
```

| Поле                   | Описание                                                                   |
| ---------------------- | -------------------------------------------------------------------------- |
| `model`                | ID модели по умолчанию — выберите из списка моделей ниже                   |
| `model_provider`       | Провайдер по умолчанию — должен совпадать с ID в `[model_providers.xxx]`   |
| `name`                 | Отображаемое имя провайдера — можно настроить                              |
| `base_url`             | OpenAI-совместимый URL APIMart — фиксированный `https://api.apimart.ai/v1` |
| `wire_api`             | Wire-протокол — последние версии Codex требуют `responses` (Responses API) |
| `requires_openai_auth` | Установите `true`, чтобы аутентифицироваться с ключом из `auth.json`       |

После сохранения обоих файлов перезапустите Codex CLI, чтобы изменения вступили в силу.

<Warning>Убедитесь, что `auth.json` — валидный JSON, а `config.toml` — валидный TOML. Не используйте полноширинные / умные кавычки, иначе конфигурация не применится.</Warning>

## Шаг 3: Начните работу

### Проверьте конфигурацию

В любой директории проекта выполните следующую команду для подтверждения, что всё подключено:

```bash theme={null}
codex "Introduce yourself in one sentence"
```

Если получите ответ ИИ, конфигурация работает. При экране входа или ошибках `401` / `403` см. раздел FAQ ниже.

### Интерактивный режим

Выполните `codex` напрямую, чтобы войти в интерактивный UI — идеально для полных задач кодинга:

```bash theme={null}
codex
```

Внутри опишите, что нужно, на естественном языке, например:

```
Create an Express.js server with a JSON-returning health check endpoint
```

Codex проанализирует ваш проект, сгенерирует код, выполнит команды и попросит подтверждения перед чувствительными операциями.

### Режимы одобрения

При первом запуске Codex попросит выбрать уровень одобрения:

| Режим           | Описание                                                                             |
| --------------- | ------------------------------------------------------------------------------------ |
| **Read Only**   | Разрешено только чтение файлов — любая модификация или команда требует подтверждения |
| **Auto**        | Может читать/писать файлы и выполнять команды в рабочей директории (рекомендуется)   |
| **Full Access** | Выполняет любую операцию без подтверждения — используйте с осторожностью             |

Мы рекомендуем начинать с режима **Auto**. В интерактивном UI введите `/approvals`, чтобы изменить его в любой момент.

### Переключение моделей

В интерактивном UI введите `/model` для быстрого переключения или измените поле `model` в `config.toml` и перезапустите.

## Поддерживаемые модели

Для Codex CLI рекомендуются следующие модели серии GPT-5:

| ID модели       | Сильные стороны                             | Рекомендуемые сценарии                    |
| --------------- | ------------------------------------------- | ----------------------------------------- |
| `gpt-5.5`       | Последний флагман, лучшие навыки кода       | Первый выбор для Codex, сложная инженерия |
| `gpt-5.4`       | Флагман предыдущего поколения, очень мощный | Сложный код, проектирование архитектуры   |
| `gpt-5.4-mini`  | Лёгкая, быстрая, выгодная                   | Повседневный кодинг, быстрая итерация     |
| `gpt-5.3-codex` | Модель кода, оптимизированная для Codex     | Агентные задачи кодинга                   |
| `gpt-5.2`       | Стабильная и сбалансированная               | Рутинные задачи кодинга                   |

<Tip>
  **Советы по выбору модели:** Указанная серия GPT-5 лучше всего сочетается с Codex CLI. Для лучшего опыта предпочтите `gpt-5.5`; `gpt-5.3-codex` специально оптимизирован для агентных сценариев кодинга Codex.
</Tip>

## Распространённые команды

Часто используемые команды и горячие клавиши Codex CLI:

| Команда                 | Описание                               |
| ----------------------- | -------------------------------------- |
| `codex`                 | Войти в интерактивный UI               |
| `codex "task"`          | Начать с начальной инструкцией         |
| `codex exec "task"`     | Неинтерактивный режим — запуск и выход |
| `codex --model gpt-5.4` | Запуск с указанной моделью             |
| `codex --version`       | Показать номер версии                  |
| `/model`                | Переключить модель в интерактивном UI  |
| `/approvals`            | Изменить режим одобрения в UI          |
| `Ctrl + C`              | Выйти из интерактивного UI             |

## Часто задаваемые вопросы

### Q1: После запуска появляется экран входа в ChatGPT?

Если после запуска видите «Sign in with ChatGPT» или похожее, конфигурация не вступила в силу.

**Шаги устранения:**

1. Убедитесь, что и `config.toml`, и `auth.json` находятся в `~/.codex/`
2. Проверьте, что `model_provider` в `config.toml` установлен на `apimart`
3. Проверьте, что `auth.json` — валидный JSON, а ключ заполнен полностью

### Q2: Ошибки 401 / 403?

| Код ошибки         | Значение                                | Решение                                                              |
| ------------------ | --------------------------------------- | -------------------------------------------------------------------- |
| `401 Unauthorized` | Отсутствует или недействителен API-ключ | Проверьте ключ в `auth.json` — должен начинаться с `sk-`             |
| `403 Forbidden`    | Недостаточно прав или истёкший ключ     | Перейдите в [консоль](https://apimart.ai/keys), чтобы проверить ключ |

Также убедитесь, что `base_url` установлен на `https://api.apimart.ai/v1`, а не на официальный URL OpenAI.

### Q3: Не удалось подключиться?

1. Проверьте сетевое подключение
2. Убедитесь, что `base_url` в `config.toml` корректен
3. Если вы за прокси, убедитесь, что он разрешает доступ к `api.apimart.ai`

### Q4: `wire_api = "chat"` больше не поддерживается?

Последние версии Codex CLI (0.84.0 и новее) удалили протокол `chat`. Обновите `wire_api` в `config.toml` до `responses`:

```toml theme={null}
wire_api = "responses"
```

APIMart поддерживает Responses API — после изменения просто перезапустите Codex.

### Q5: Вызовы инструментов или запуски не работают?

Убедитесь, что `wire_api` в `config.toml` установлен на `responses`. Если всё ещё возникают проблемы совместимости, переключитесь на рекомендуемую модель серии GPT-5 (например, `gpt-5.5`, `gpt-5.3-codex`) — они надёжнее сочетаются с Codex CLI.

### Q6: Использовать переменные окружения вместо auth.json?

Также можно настроить ключ через переменную окружения. Измените блок провайдера в `config.toml` на:

```toml theme={null}
[model_providers.apimart]
name = "APIMart"
base_url = "https://api.apimart.ai/v1"
wire_api = "responses"
env_key = "APIMART_API_KEY"
```

Затем установите переменную окружения `APIMART_API_KEY` равной вашему ключу APIMart. В этой настройке `auth.json` больше не требуется.

### Q7: Как переключать модели?

Два способа:

1. **В интерактивном UI**: введите `/model` для переключения
2. **Редактировать конфиг**: измените поле `model` в `config.toml` и перезапустите Codex CLI

### Q8: Как проверить использование и биллинг?

Войдите в [консоль APIMart](https://apimart.ai/overview), чтобы посмотреть статистику API-вызовов, детали потребления токенов и тенденции расходов.

## Поддержка и помощь

Если у вас возникнут проблемы при использовании Codex CLI:

* 📚 [Документация APIMart](https://docs.apimart.ai)
* 💬 [Сообщество Discord](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @APIMart\_](https://x.com/APIMart_)
* 📧 Техническая поддержка: [zhihong@apimart.ai](mailto:zhihong@apimart.ai)

***

<Card title="Начните с APIMart" icon="rocket" href="https://apimart.ai">
  Зарегистрируйтесь в APIMart прямо сейчас, получите API-ключ и испытайте мультимодельного ассистента программиста в Codex CLI!
</Card>