Подключить Claude Desktop#

Настройка Gateway#

1. Откройте Help → Troubleshooting → Enable Developer Mode, затем Developer → Configure Third-Party Inference. Если этих пунктов нет, обновите Claude Desktop или проверьте ограничения управляемой установки.
2. В разделе Connection выберите Gateway и вид учётных данных Static API key.
3. В Gateway base URL укажите https://simple-claw.ru — без /v1. Вставьте личный ключ Simple Claw в поле Gateway API key и выберите схему x-api-key.
4. Специальные Custom inference headers не нужны. Если ранее был добавлен X-SimpleClaw-Stream-Mode: buffered, его можно удалить: он принимается для совместимости, но больше не меняет выдачу ответа. Ключ сюда не вставляйте.

Не вставляйте ключ в URL, команду запуска или файл проекта. Указывайте его только в поле ключа Claude Desktop.

При stream:true текст поступает по мере получения, при stream:false — целиком после завершения. Короткий Test connection получает обычный JSON; старый header не меняет это поведение.

Выбор модели#

В разделе Models добавьте точный публичный ID выбранной модели из каталога Simple Claw с протоколом messages. Если Desktop не заполнил список автоматически, добавьте ID вручную.

Для первого подключения можно выбрать claude-haiku-4-5, если она включена в каталоге и доступна вашему ключу:

1. Model ID — claude-haiku-4-5; Display name можно оставить пустым или задать удобное название.
2. Tier alias — haiku, чтобы служебный выбор этого семейства использовал добавленную модель.
3. Offer 1M-context variant и Only show the 1M option выключите. У Haiku 4.5 окно 200 тысяч токенов, она не поддерживает 1M.

Для этой начальной настройки оставьте выключенным и общий параметр Use 1M wherever it’s available. Не включайте 1M для другой модели, пока её окно и поддержка этого режима в Simple Claw не подтверждены. Флаги Desktop не включают разрешение длинного контекста на API-ключе.

Проверка#

1. Нажмите Test connection. Успех выглядит как 1-token completion in … ms · via static key.
2. Нажмите Apply Changes внизу окна: эта кнопка применяет конфигурацию на вашем компьютере и перезапускает Desktop. Один успешный тест ещё не применяет настройки. Этот шаг описан в официальной инструкции применения настроек.
3. После перезапуска откройте новый чат, выберите добавленную модель и отправьте Ответь одним словом: OK. После ответа проверьте запрос и расход в кабинете Simple Claw.

Если подключение не работает с Haiku 4.5: сначала выключите в записи модели Offer 1M-context variant и Only show the 1M option, затем проверьте соединение и примените настройки через Apply Changes. В подтверждённом случае после выключения этих двух флагов прошёл Test connection, однако обычный чат потребовал отдельного исправления серверной совместимости. Для Haiku оставляйте флаги выключенными: её окно — 200 тысяч токенов.

В Claude Desktop 2.31226.1 кнопка Test connection отправляет модели короткое сообщение . с max_tokens: 1 и ждёт только 8 секунд. Сообщение Gateway was unreachable: The operation was aborted due to timeout означает, что проверка не дождалась ответа; само по себе оно не доказывает неверный ключ или адрес. Параметр Stream idle timeout не увеличивает ожидание этой проверки.

При таймауте сначала проверьте историю запросов и расход: запрос мог завершиться уже после ошибки Desktop. Затем повторите проверку один раз. Если она снова не проходит, проверьте адрес без /v1, схему x-api-key, действующий ключ и точный ID модели; передайте поддержке время проверки, модель и текст ошибки без API-ключа. Не запускайте серию повторов: проверочные запросы могут расходовать рубли.

Test connection проходит, а чат завершается ошибкой? Обычный чат и Cowork отправляют больше системных инструкций, инструментов и блоков, чем проверка. Если видите UPSTREAM_USAGE_UNCERTAIN или повторяющиеся 503, проверьте состояние запроса в кабинете и передайте поддержке requestId, модель и ошибку без ключа. Ошибка 400 о ролях сообщений требует серверной версии, которая принимает текстовые system/developer инструкции в любом месте истории. Если сервер ещё не обновлён, одни настройки Desktop не исправят его отказ.

Режим Cowork полностью не проверен. Сообщение «Этот тип Anthropic content-блока пока не поддерживается» означает отказ в содержимом запроса, а не неверный ключ. Не повторяйте его автоматически: передайте поддержке текст ошибки и режим Desktop, без ключа и приватного содержимого. Отключение флагов 1M устраняет ошибочную настройку окна Haiku, но не обеспечивает совместимость всех запросов Desktop.

Если Haiku отвечает, а с Sonnet 5 появляется «Системные инструкции в messages допустимы только перед диалогом», это ограничение старой версии шлюза. Desktop может добавлять системную инструкцию после пользовательского сообщения. Исправленная версия принимает текстовые инструкции в любом месте истории и сохраняет их порядок; эта ошибка требует обновления сервера, а не замены ключа или адреса.

Начните с текста в новом чате. Изображения поддерживаются в user и tool_result через image source base64 (PNG/JPEG/WebP до 3 МиБ) или публичный HTTPS URL; до 8 картинок на запрос, JSON до 5 МиБ. Документы и thinking blocks пока не поддерживаются. Успех короткого теста не подтверждает работу всех возможностей Desktop.

Автоматическое кэширование доступно для поддерживающих его моделей. Кэшированные токены учитываются по соответствующей ставке. Настройки cache_control из клиента сейчас не передаются поставщику. Попадание каждого запроса в кэш и конкретный срок хранения не гарантируются.