Инструкция
Claude Desktop через SAMSA
Привычное приложение начнёт работать через SAMSA: интерфейс тот же, оплата — с вашего баланса в рублях. Настройка делается один раз.
Инструкция проверяется на живом подключении. Она составлена по документации шлюза, но пока не пройдена нами от начала до конца. Если что-то разошлось с тем, что вы видите на экране, — напишите нам, это ровно та обратная связь, которая нужна.
Что получится
Claude Desktop — то же приложение, которым вы пользовались, — начнёт работать через SAMSA. Интерфейс не изменится. Изменится то, откуда берутся ответы и чем они оплачиваются: запросы идут через наш шлюз, а списания — с вашего баланса в SAMSA, который пополняется рублями по счёту.
Отдельная подписка Anthropic для этого не нужна.
Что нужно заранее
Ключ вида sk-samsa-…
- Вы сотрудник компании — попросите ответственного за ИИ, он выпускает ключи в кабинете.
- Аккаунт ваш — кабинет → Ключи → создать.
Ключ показывается один раз, при создании. Мы храним только его хэш и восстановить потерянный ключ не можем — потерянный отзывают и выпускают новый. Скопируйте сразу.
Ненулевой баланс
На нулевом балансе список моделей загрузится, а первый же запрос вернёт ошибку оплаты.
Установленный Claude Desktop
Ссылки на загрузку — на странице Загрузки.
Настройка
В настройках Claude Desktop найдите подключение стороннего шлюза (совместимого API-провайдера) и заполните:
| Поле | Значение |
|---|---|
| Базовый адрес (base URL) | https://ai-router-dev.dev.0sk.ru/anthropic |
| Схема авторизации | x-api-key |
| Ключ | ваш sk-samsa-… |
| Автообнаружение моделей | включить |
| Ручной список моделей | оставить пустым |
Суффикс /anthropic обязателен
Это не деталь оформления: адрес без него не работает. У шлюза два входа под два протокола —
/anthropic/v1/… для Anthropic Messages API и /openai/v1/… для OpenAI
Chat Completions, а «общего» /v1/… в корне нет. Claude Desktop говорит на протоколе
Anthropic, поэтому ему нужен именно /anthropic.
Не задавайте ключ дважды
Если клиент отправит одновременно и x-api-key, и Authorization: Bearer
(или один и тот же заголовок дважды), шлюз ответит ошибкой авторизации и напишет, что ключ отсутствует.
Звучит парадоксально, но причина именно в этом: заполняйте одно поле.
Проверка
После сохранения откройте выбор модели: если автообнаружение сработало, в списке появятся модели SAMSA. Задайте любой короткий вопрос — ответ должен прийти обычным порядком.
Если хочется убедиться до настройки приложения, ключ проверяется одной командой в терминале. Она ничего не стоит и работает даже при нулевом балансе:
curl https://ai-router-dev.dev.0sk.ru/anthropic/v1/models -H "x-api-key: sk-samsa-..."В ответ придёт список доступных вам моделей.
Какие модели видны и почему не все
Claude Desktop показывает в списке только модели с «клодоподобными» именами. Поэтому доступны:
claude-fable-5,claude-opus-5,claude-sonnet-5,claude-haiku-4-5— линейка Claude;claude-opus-ds4proиclaude-haiku-ds4flash— модели DeepSeek под именами, которые Desktop соглашается показать. Заметно дешевле, для многих задач достаточно.
Остальные модели платформы — GPT, Gemini и прочие — работают по протоколу OpenAI, и Claude Desktop к ним обратиться не может. Это ограничение приложения, а не вашего доступа: те же модели доступны с тем же ключом из кода или из веб-чата.
Если выбрали модель DeepSeek: картинки и PDF в диалог приложить не получится, кеширование промпта не работает. Текстовая работа идёт как обычно.
Про деньги: чего не ждёшь
Заголовки чатов оплачиваются отдельно
Название беседы Desktop всегда генерирует моделью claude-haiku-4-5, независимо от того,
какую модель вы выбрали. Это отдельные небольшие списания: в длинном диалоге они незаметны,
но в расходе вы увидите их отдельной строкой.
Приложение периодически проверяет связь
Раз в 15–30 минут Desktop отправляет крошечный служебный запрос. Стоит копейки, но объясняет расход в те часы, когда вы ничего не спрашивали.
Самое дорогое — не ответы, а разогрев
Когда приложение передаёт длинный системный промпт и набор инструментов, он тарифицируется как входные токены, а при переключении на другую модель передаётся заново. На дешёвых моделях это незаметно; на самых дорогих один такой разогрев может стоить около доллара. Практический вывод: не прыгайте между моделями внутри одной длинной беседы без нужды.
Баланс общий на аккаунт, а не на ключ
Все ваши ключи тратят один кошелёк. Отдельного лимита внутри одного запроса нет — очень дорогой вызов может увести баланс в небольшой минус.
Если что-то не работает
| Что видно | Что произошло | Что делать |
|---|---|---|
| Ошибка авторизации, ключ «отсутствует» | Ключ не опознан либо отправлен двумя заголовками сразу | Проверьте, что ключ вставлен целиком и заполнено одно поле авторизации |
| Ошибка оплаты | Нулевой баланс или исчерпан месячный лимит | Пополнить баланс; сотруднику — обратиться к ответственному в компании |
| Доступ запрещён | Ключ на паузе, истёк, или эта модель ему не разрешена | К владельцу кабинета: он снимает паузу и меняет политику ключа |
| Модель не найдена | Опечатка в имени модели при ручном вводе | Оставьте список моделей пустым и включите автообнаружение |
| «Не поддерживается» при обращении к модели | Выбрана модель, которая живёт в протоколе OpenAI | Выберите модель из списка выше |
| Список моделей пуст | Чаще всего — адрес без суффикса /anthropic | Проверьте базовый адрес |
При обращении к нам приложите X-Request-Id — идентификатор запроса, который шлюз
возвращает в заголовках ответа. По нему мы находим, что именно произошло.
Писать: sergey@skripov.ru.
Дальше
- Тот же ключ работает в Claude Code.
- Тот же ключ и баланс работают в веб-чате.
- Из своего кода — по протоколу Anthropic или OpenAI: раздел для разработчиков.