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

Claude Desktop

Подключите приложение Claude к airaw через настройки провайдера.

В отличие от Claude Code, приложение не читает переменные окружения и settings.json: провайдер задаётся формой Configure Third-Party Inference. Форма действует на всё приложение; шаги ниже описывают вкладку Code.

1. Сохраните ключ

Ключ доступа вида sk-fp-… выдаётся один раз на странице активации. В примере YOUR_AIRAW_KEY — вставьте полный ключ.

2. Откройте форму настройки

Установите свежий Claude Desktop с claude.com/download (Windows .msix, macOS .dmg, Linux — .deb) и запустите его, не входя в аккаунт Anthropic.

Из строки меню на macOS или меню ☰ слева вверху экрана входа на Windows откройте Help → Troubleshooting → Enable Developer Mode. После перезапуска приложения откройте Developer → Configure Third-Party Inference….

3. Заполните подключение и модели

В секции Connection окна конфигурации задайте:

  • Inference provider: Gateway.
  • Gateway base URL: / — приложение само добавляет /v1/messages, не дописывайте /v1.
  • Gateway API key: YOUR_AIRAW_KEY.
  • Credential kind: Static API key.
  • Gateway auth scheme: Bearer.

В той же форме, в секции Models, перечислите модели шлюза — ключ inferenceModels; первая запись становится моделью по умолчанию:

{
        "inferenceModels": [
        { "name": "glm-5.3", "labelOverride": "GLM 5.3" },
        { "name": "deepseek-v4.1-flash", "labelOverride": "DeepSeek V4.1 Flash 1017" },
        { "name": "kimi-k3", "labelOverride": "Kimi K3" },
        { "name": "qwen3.8-max-0902", "labelOverride": "Qwen 3.8 Max" }
        ]
        }

Поле behavesAs не заполняйте — оно описывает модель Claude за псевдонимом, а у моделей шлюза её нет.

4. Примените и проверьте

Нажмите Apply Changes, затем Save & Restart: приложение перезапустится, и экран входа предложит запустить его с вашей конфигурацией. Откройте вкладку Code, выберите модель шлюза в списке под полем ввода и отправьте первый запрос.

Конфигурация сохраняется локально на этом устройстве; вернуться к обычному Claude можно, выбрав вход Anthropic на экране входа.

Какие функции доступны
  • Настройка Effort для моделей шлюза не показывается, а окно контекста считается равным 200 000 токенов — оба свойства привязаны к распознанным моделям Claude.
  • Режим разрешений Auto требует модели Claude: пользуйтесь Manual, Accept edits или Plan.
  • Облачные окружения Anthropic и Remote Control в third-party режиме недоступны.
Если не подключается
  • Плашка Gateway was unreachable: проверьте базу — адрес сайта со слэшем в конце, без /v1.
  • Форма открылась только для чтения: на устройстве уже лежит управляемая конфигурация (MDM), локально её не перекрыть.
  • После применения показывается обычный вход claude.ai: полностью закройте приложение и запустите снова — конфигурация читается только при старте.

Официальная справка: Deploy Claude Desktop on 3P with an LLM gateway, Models and effort levels и In-app configuration.