# Модели в установке компании / Company model configuration

Дата решения: 04.10.2026. Один инстанс обслуживает одну компанию. Все четыре роли
могут использовать отдельные модели, но основной вариант — GPT-6 Astra с effort medium.
Сервис поддерживает API-ключ и вход в ChatGPT через Codex. Новые вызовы Claude запрещены.
Провайдер получает тексты заявок и контекст зависимостей; установка в своей сети не делает
модель локальной. Решение о допустимости передачи этих данных принимает компания.

## API key

Обычный `compose.production.yaml` использует адаптер `api`. В `.env.production` задайте
`DECONFLICTOR_AGENT_MODEL=openai:gpt-6-astra`, `DECONFLICTOR_AGENT_EFFORT=medium` и свой
`OPENAI_API_KEY`. Для совместимого шлюза — `DECONFLICTOR_API_OPENAI_BASE_URL` с HTTPS URL.
Доступность конкретной модели определяется аккаунтом и шлюзом. Сервис проверяет настройки
при запуске без обращения к модели; доступ провайдера подтверждается первой заявкой.

The ordinary production Compose file uses the `api` adapter. Configure an explicit
`provider:model-id`, the chosen provider key and effort. The API token protecting Deconflictor
is separate from the model provider key. Keep both out of source control and logs.

## Codex subscription

`compose.codex.yaml` добавляет в приложение нативный Codex **0.159.0**. Образ не содержит
Docker CLI или сокет Docker. Процесс работает от UID 10001, корневая файловая система
доступна только для чтения. Постоянный том `codex-home` доступен для записи: Codex должен
обновлять токены входа. Не переносите в этот том личные конфиги, плагины или проекты.

Сначала выполните общую подготовку каталога и `.env.production` из
[инструкции установки](company-deployment.md). Затем выставьте:

```dotenv
DECONFLICTOR_LLM_ADAPTER=codex_cli
DECONFLICTOR_AGENT_MODEL=gpt-6-astra
DECONFLICTOR_AGENT_EFFORT=medium
OPENAI_API_KEY=
```

Для Codex у модели нет префикса `openai:`. Это относится и к переменным конкретных ролей
`DECONFLICTOR_INTAKE_MODEL`, `DECONFLICTOR_JUDGE_MODEL`, `DECONFLICTOR_CHALLENGER_MODEL`,
`DECONFLICTOR_CHAIR_MODEL`. Для каждой есть отдельный `*_EFFORT`.

```bash
docker compose --env-file .env.production -f compose.production.yaml -f compose.codex.yaml \
  build app codex-auth
docker compose --env-file .env.production -f compose.production.yaml -f compose.codex.yaml \
  run --rm --no-deps codex-auth
# Откройте напечатанный URL и подтвердите код входа своим аккаунтом ChatGPT.
docker compose --env-file .env.production -f compose.production.yaml -f compose.codex.yaml \
  up --build -d --wait
```

Device login может потребовать разрешения администратора ChatGPT workspace. Вход выполняет
администратор компании; приложение не хранит пароль ChatGPT. Проверить или удалить вход:

```bash
docker compose --env-file .env.production -f compose.production.yaml -f compose.codex.yaml \
  run --rm --no-deps codex-auth python -m deconflictor.api.codex status
# Перед logout остановите app, чтобы не прервать обновление токена активного запроса.
docker compose --env-file .env.production -f compose.production.yaml -f compose.codex.yaml \
  stop app
docker compose --env-file .env.production -f compose.production.yaml -f compose.codex.yaml \
  run --rm --no-deps codex-auth python -m deconflictor.api.codex logout
```

Startup проверяет версию CLI, запись в том и локальный тип входа ChatGPT. Эти команды
не вызывают модель. Просроченный или отозванный вход обнаружится при запросе; повторите
device login и запустите `app`. Исчерпание подписки не переключает приложение на платный API.

При запросах Codex получает только разрешённые переменные окружения: пути, locale, доверенные
CA и proxy. API-ключи, пароль БД и токен Deconflictor ему не передаются. Каждый вызов идёт
в новом временном каталоге с read-only sandbox, без инструментов, плагинов и пользовательского
конфига. Принудительно используется вход ChatGPT и файловое хранилище учётных данных.
Заявки и решения хранятся в БД; файлов записей ответов для eval этот режим не создаёт.

The Codex override uses a pinned native CLI inside the application container. Set
`DECONFLICTOR_AGENT_MODEL=gpt-6-astra`, without a provider prefix, and `medium` effort.
Run the manual `codex-auth` service once, approve the device code in ChatGPT, then start the
stack with both Compose files. Always include both files when operating this deployment.
The auth helper receives no application or provider credentials. `status` and `logout` commands
are shown above; stop `app` before replacing or removing its login.

The service checks local login and write access at startup, never by making a model request.
Its CLI uses ChatGPT authentication only, read-only sandboxing, an empty working directory,
disabled tools and no user configuration. A quota or revoked-login error does not fall back
to a paid API. Preserve the `codex-home` volume across upgrades. It contains refresh tokens:
exclude it from ordinary logs and artifacts, encrypt any backup, and protect access like a
password. Re-authentication is usually safer than copying authentication files between hosts.

Ограничения первой версии: один процесс приложения; вход Codex относится к одному аккаунту,
а не к пользователям веб-интерфейса. Квота общая с другими задачами этого аккаунта.
`DECONFLICTOR_LLM_EXEC_PREFIX` для company Codex запрещён: CLI запускается внутри контейнера
приложения. Для собственной CA смонтируйте PEM-файл read-only и задайте `SSL_CERT_FILE`;
для proxy явно передайте соответствующие переменные в контейнер. Не отключайте проверку TLS.

Sources checked for the implementation: OpenAI [authentication](https://learn.chatgpt.com/docs/auth)
and [non-interactive mode](https://learn.chatgpt.com/docs/non-interactive-mode).

The owner's private mini installation has a separate, explicitly enabled
[operator transport](private-mini-models.md). This does not change the ordinary company
image or grant it Docker access. The route reuses the existing VPN container and refuses
arbitrary prefixes or a local CLI fallback.
