Перейти к основному содержимому

Claude Desktop с OpenCheese

/ Документация API

← Быстрый старт с APIОткрыть как Markdown

Claude Desktop — графическое приложение Anthropic для Windows и macOS. К OpenCheese оно подключается через режим стороннего инференса, который настраивается не из терминала, а файлом конфигурации, импортируемым в самом приложении. Версии Claude Desktop для Linux нет: там используйте Claude Code.

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

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

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

02Включите режим разработчика

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

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

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

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

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

Войдите в панель 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-ключ хранится открытым текстом. Удалите скачанную копию, как только импорт завершится: у приложения остаётся своя.

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

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

  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/

05Проверьте, что всё работает

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

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

В сыре есть дырки. В вашей инфраструктуре их быть не должно.