Инструкция
Claude Code через SAMSA
Терминальный клиент работает через SAMSA без доработок: достаточно задать четыре переменные окружения.
Инструкция проверяется на живом подключении. Она составлена по документации шлюза, но пока не пройдена нами от начала до конца. Если что-то разошлось с тем, что вы видите на экране, — напишите нам, это ровно та обратная связь, которая нужна.
Что получится
Claude Code — тот же инструмент в терминале, с теми же командами и тем же поведением. Меняется только то, куда он ходит за ответами: запросы идут через SAMSA, а списания — с вашего баланса в рублях. Отдельная подписка Anthropic не нужна.
Что нужно заранее
- Ключ вида
sk-samsa-…— сотруднику его выпускает ответственный за ИИ, владельцу аккаунта — кабинет → Ключи. Показывается один раз. - Ненулевой баланс: на нулевом первый же запрос вернёт ошибку оплаты.
- Установленный Claude Code — см. Загрузки.
Настройка
Задайте четыре переменные окружения — этого достаточно, никаких других правок не требуется:
export ANTHROPIC_BASE_URL=https://ai-router-dev.dev.0sk.ru/anthropic
export ANTHROPIC_API_KEY=sk-samsa-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_SMALL_FAST_MODEL=claude-haiku-4-5Чтобы переменные не пропадали после закрытия терминала, добавьте их в свой профиль оболочки — ~/.zshrc или ~/.bashrc.
Суффикс /anthropic обязателен. У шлюза два входа под два протокола, и «общего» адреса в корне нет. Claude Code говорит на протоколе Anthropic — значит, адрес заканчивается на /anthropic.
Работа на DeepSeek
Если нужен вариант заметно дешевле, поменяйте только имена моделей — адрес и ключ остаются теми же:
export ANTHROPIC_MODEL=deepseek-v4-pro
export ANTHROPIC_SMALL_FAST_MODEL=deepseek-v4-flashУчтите: у моделей DeepSeek по этому протоколу не работает кеширование промпта, а изображения и PDF не поддерживаются. Для текстовой работы с кодом это чаще всего не мешает.
Проверка
Ключ и адрес проверяются одной командой, ещё до запуска клиента. Она ничего не стоит:
curl https://ai-router-dev.dev.0sk.ru/anthropic/v1/models -H "x-api-key: sk-samsa-..."Если пришёл список моделей — можно запускать Claude Code обычным способом.
Про деньги: чего не ждёшь
Основная статья расхода у Claude Code — не ответы, а разогрев кеша промпта. Системный промпт с набором инструментов занимает десятки тысяч токенов, тарифицируется как входные токены и записывается заново при переключении модели. На дешёвых моделях это незаметно, на самых дорогих один разогрев стоит около доллара.
Практический вывод: не прыгайте между моделями внутри одной сессии без необходимости, а для рутины держите модель попроще — она задаётся отдельной переменной и используется для мелких служебных задач.
Баланс общий на аккаунт: все ваши ключи тратят один кошелёк, отдельного лимита внутри запроса нет.
Если что-то не работает
| Симптом | Причина и что делать |
|---|---|
| Ошибка авторизации | Ключ скопирован не полностью либо задан ещё и другой способ авторизации. Оставьте только переменные из инструкции |
| Ошибка оплаты | Нулевой баланс или исчерпан месячный лимит ключа |
| Модель не найдена | Опечатка в имени модели. Сверьтесь со списком, который вернул запрос моделей |
| Ответ «не поддерживается» | Запрошена модель из зоны OpenAI. Claude Code работает только с моделями зоны Anthropic |
| Клиент не видит сервер | Чаще всего адрес указан без суффикса зоны |
При обращении приложите X-Request-Id из ответа шлюза — по нему мы находим,
что произошло. Писать: sergey@skripov.ru.
Дальше
- Тот же ключ работает в Claude Desktop.
- Тот же баланс — в веб-чате.
- Полное описание шлюза — Router / API.