# Fx

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

Language: ru

> Использование aicentos в Fx — добавление кастомного подключения модели через пользовательский settings.json

Fx — кодинг-агент от Vercel Labs: единый нативный бинарник, написанный на Zig, без привязки к модели. Кастомные подключения моделей задаются в пользовательском `~/.fx/settings.json` — направьте base URL на aicentos.

**Сразу отметим частую ловушку:** `.fx.json` в корне проекта — это другое: он намеренно не допускает большинство полей (включая модель), чтобы склонированный репозиторий не мог подменить вашу модель или эндпоинт. **Кастомный эндпоинт обязательно пишите в `~/.fx/settings.json`** — в `.fx.json` он не сработает.

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

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

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

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

```bash
curl -fsSL https://fx.sh/setup.sh | bash
fx --version
```

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

| Поле              | Значение                                  |
| ----------------- | ----------------------------------------- |
| Файл конфигурации | `~/.fx/settings.json`                     |
| Base URL          | `https://aicentos.com/v1`                 |
| API Key           | ключ, созданный в консоли                 |
| Модель            | имя модели из «витрины моделей» в консоли |

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

### 1. Отредактируйте пользовательские настройки

В `~/.fx/settings.json` зарегистрируйте подключение в формате «кастомного подключения модели». Структуру полей объекта подключения сверяйте с официальной документацией:

* Вход в документацию: [https://fx.sh/docs](https://fx.sh/docs)
* README: [https://github.com/vercel-labs/fx](https://github.com/vercel-labs/fx)

Адрес API в подключении укажите:

```
https://aicentos.com/v1
```

API Key — тот, что создан в консоли; имена моделей — по «витрине моделей» в консоли.

### 2. Укажите использование этого подключения

Fx позволяет задать провайдера и модель при запуске:

```bash
fx provider local FX_MODEL=gpt-4o fx ask "Ответь одним предложением: сколько будет 1+1"
```

Можно и через переменную окружения:

```bash
export FX_MODEL="gpt-4o"
```

### 3. Подтвердите текущего провайдера

Fx запоминает выбор по провайдеру: при следующем запуске продолжит использоваться провайдер, выбранный в прошлый раз.

## Проверка

Сначала проверьте связность нейтральным промптом без побочных эффектов:

```bash
fx ask "Ответь одним предложением: сколько будет 1+1"
```

Если ответ возвращается нормально, подключение выполнено. При ошибке аутентификации в первую очередь проверьте, есть ли `/v1` в base URL и нет ли лишних пробелов в API Key.

## Примечания

* **Не трогайте `.fx.json`**. В файле уровня проекта разрешены только отдельные поля вроде `provider_order` и `provider_strict`; поля `model` там нет, и для настройки кастомного эндпоинта он не предназначен.
* `provider_order` / `provider_strict` — параметры маршрутизации Vercel AI Gateway, **действуют только на запросы к Gateway; кастомные подключения моделей их игнорируют**, так что переключить апстрим с их помощью не выйдет.
* Официальная поддержка кастомных подключений моделей в Fx ещё развивается; в ранних версиях может понадобиться свежая сборка, чтобы распознать настройки. После обновления сначала выполните тестовую команду выше и только потом переходите к реальной работе.
* Скрипт бинарной установки тянет файлы из сети — перед выполнением самостоятельно убедитесь в доверии к источнику.

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

* Страница проекта: [https://github.com/vercel-labs/fx](https://github.com/vercel-labs/fx)