# Claude Desktop с OpenCheese

> Claude Desktop на OpenCheese в режиме стороннего инференса: режим разработчика, сгенерированный OpenCheese.json, его импорт и что проверить после.
>
> Веб-страница: https://opencheese.dev/ru/docs/claude-desktop/ · Все страницы документации: https://opencheese.dev/ru/docs.md

Claude Desktop — графическое приложение Anthropic для Windows и macOS. К OpenCheese оно
подключается через режим стороннего инференса, который настраивается не из терминала, а файлом
конфигурации, импортируемым в самом приложении. Версии Claude Desktop для Linux нет: там
используйте [Claude Code](https://opencheese.dev/ru/docs/claude-code.md).

## 1. Установите приложение, но не входите в аккаунт

Скачайте Claude Desktop на странице [claude.com/download](https://claude.com/download): нужна
Windows 10 сборки 19041 или новее (установщик `.msix`) либо macOS 14 Sonoma или новее (`.dmg`).

Откройте приложение и остановитесь на экране входа. Не выполняйте вход и не создавайте аккаунт
Anthropic: режим стороннего инференса заменяет этот вход, а если сначала войти в аккаунт,
ваши запросы пойдут в Anthropic, а не в OpenCheese.

## 2. Включите режим разработчика

Окно конфигурации скрыто, пока не включён режим разработчика. В меню приложения (в Windows это
кнопка меню в левом верхнем углу экрана входа):

1. Откройте **Help**.
2. Откройте **Troubleshooting**.
3. Нажмите **Enable Developer Mode**.

Рядом с **Help** появится меню **Developer**. Откройте его, нажмите **Configure Third-Party
Inference…** и оставьте это окно открытым.

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

## 3. Скачайте конфигурацию

Войдите в панель OpenCheese, откройте страницу **Настройка**, перейдите на вкладку **Claude Code**
и переключитесь на **Claude Desktop**, выберите API-ключ и подтвердите пароль, затем скачайте
`OpenCheese.json`. Приложение называет конфигурацию по имени файла, поэтому оставьте это имя, если
не хотите назвать конфигурацию иначе.

Файл выглядит так:

```json
{
  "$schemaVersion": 2,
  "inference": {
    "provider": "gateway",
    "baseUrl": "https://api.opencheese.dev",
    "credential": {
      "kind": "static",
      "apiKey": "YOUR_OPENCHEESE_API_KEY"
    }
  },
  "models": {
    "prefer1mContext": true,
    "pricing": {
      "enabled": true
    }
  }
}
```

- `baseUrl` не должен заканчиваться на `/v1`: приложение само добавляет `/v1/models` и
  `/v1/messages`.
- Список моделей не нужен: при каждом запуске приложение получает из `/v1/models` модели,
  входящие в ваш тариф.
- В файле ваш API-ключ хранится открытым текстом. Удалите скачанную копию, как только импорт
  завершится: у приложения остаётся своя.

## 4. Импортируйте файл и перезапустите приложение

Вернитесь в окно конфигурации:

1. Откройте список конфигураций в правом верхнем углу.
2. Нажмите **Import configuration…** и выберите скачанный файл.
3. Убедитесь, что в разделе **Connection** указано **Gateway**, а базовый URL и API-ключ
   заполнены.
4. Нажмите **Apply Changes**, затем **Apply locally**. Приложение сохранит конфигурацию и
   перезапустится.

Импортированные конфигурации хранятся здесь:

| Система | Папка |
| --- | --- |
| Windows | `%LOCALAPPDATA%\Claude-3p\configLibrary\` |
| macOS | `~/Library/Application Support/Claude-3p/configLibrary/` |

## 5. Проверьте, что всё работает

- После перезапуска экран входа предложит развёртывание OpenCheese вместо аккаунта Anthropic.
  Выберите его.
- В списке моделей появятся модели Claude из вашего тарифа. Если список пуст, приложению не
  удалось связаться с OpenCheese при запуске.
- Приложение читает конфигурацию один раз при запуске. Если что-то выглядит устаревшим, полностью
  закройте приложение и откройте снова: просто закрыть окно недостаточно.
- Чтобы увидеть, какие настройки прочитало приложение, воспользуйтесь **Help → Troubleshooting →
  Copy Managed Configuration Report** (секреты в отчёте скрыты).

Расход отображается в панели на странице **Транзакции**, по одной сессии на разговор.