AITUNNEL ⚡ Claude Desktop — документация AITUNNEL

Claude Desktop говорит на протоколе Anthropic Messages — отдельный прокси не ставится. Приложение заточено под модели Anthropic (инструменты, thinking, форматирование). Другие модели из каталога могут появиться в пикере, но агентные задачи на них часто ломаются.

Зачем через AITUNNEL

Из России без VPN. Запросы идут на api.aitunnel.ru.
Оплата в рублях, бюджет на ключе, расход в панели.
Запасные модели и провайдер. Если Anthropic не ответил — fallback и выбор провайдера.
Нативный POST /v1/messages: thinking-блоки и tool use проходят как есть.

Как это работает

Gateway. В Claude Desktop выбираете бэкенд Gateway и base URL https://api.aitunnel.ru/. Приложение говорит своим протоколом. Локальный прокси не нужен.
Messages API. https://api.aitunnel.ru/v1/messages ведёт себя как Anthropic: маппинг имён, thinking, tool use.
Списание. Токены и reasoning — в рублях, usage.cost_rub в ответе. История ключа — статистика.

Что нужно

Claude Desktop последней версии. Входить в аккаунт Anthropic не обязательно.
Ключ AITUNNEL: создайте в панели ключей.

Настройка

Режим разработчика
Запустите Claude Desktop — логиниться не нужно. Help → Troubleshooting → Enable Developer Mode. В строке меню появится Developer.
Help → Troubleshooting → Enable Developer Mode
Панель Third-Party Inference
Developer → Configure Third-Party Inference…
Developer → Configure Third-Party Inference…
Учётные данные Gateway
Тип подключения — Gateway:
Поле Значение
Gateway base URL https://api.aitunnel.ru/
Gateway API key ключ AITUNNEL (sk-aitunnel-xxx)
Gateway auth scheme bearer
Credential kind Static API key
Gateway, base URL https://api.aitunnel.ru/, схема bearer, Static API key
Credential kind фиксирует источник ключа. Static API key — всегда тот ключ, который вы вставили, без запасного источника.
Поля OIDC оставьте пустыми
В новых сборках Claude Desktop в этой панели есть Sign-in session lifetime и поля Gateway SSO IdP (OIDC) (Client ID, Issuer URL, Authorization URL). AITUNNEL аутентифицирует Gateway статическим ключом, не через OIDC. OIDC нужен только шлюзам, которые сами являются OAuth-сервером или сидят за ним.
Нажмите Apply Changes (в старых сборках — Apply locally).
Base URL без /v1
Claude Desktop сам дописывает /v1/messages. Схема bearer — тот же Authorization: Bearer …, которым ходит Claude Code.
Перезапуск
Полностью закройте Claude Desktop и откройте снова. На стартовом экране выберите Continue with Gateway (в интерфейсе может быть «Local configuration»). Аккаунт Anthropic не нужен.
Модель
В пикере появятся модели, доступные через ключ. Берите Claude из каталога: claude-sonnet-4.6, claude-opus-4.8, claude-haiku-4.5. Слаг со слешем уходит в OpenRouter.

Поле	Значение
Gateway base URL	`https://api.aitunnel.ru/`
Gateway API key	ключ AITUNNEL (`sk-aitunnel-xxx`)
Gateway auth scheme	`bearer`
Credential kind	`Static API key`

Claude Code

Терминальный агент Anthropic — отдельное приложение. Если удобнее CLI: руководство по Claude Code — переменные окружения, слоты моделей, /fast, GitHub Action, statusline.

Устранение неполадок

Ошибки соединения. Gateway base URL ровно https://api.aitunnel.ru/, ключ живой, auth scheme — bearer.
В пикере нет моделей. На ключе есть баланс и, если задан белый список, в нём есть Claude. Проверьте баланс и ключ.
Нет «Continue with Gateway». Настройки применились локально, приложение полностью перезапущено (Quit, не просто закрыть окно).
«Access to this website is blocked by your network egress settings» у WebFetch. Claude Desktop по умолчанию песочит сетевой трафик инструментов — WebFetch не достучится до сайтов вне белого списка. Это касается и Cowork, и Claude Code внутри приложения. Developer → Configure Third-Party Inference… → Workspace restrictions, добавьте хосты в Allowed egress hosts.
Ошибки TLS у Claude Code внутри Claude Desktop. Песочница Claude Code изолирует сеть и может ломать TLS до шлюза. Ослабьте её в файле настроек и перезапустите приложение:
settings.json
```
{
  "sandbox": {
    "enableWeakerNetworkIsolation": true
  }
}
```
Файл выбирайте по ширине: ~/.claude/settings.json — все проекты, .claude/settings.json или .claude/settings.local.json в репозитории — только он. Изоляция слабеет для всего сетевого трафика агента, не только TLS до шлюза: берите самый узкий scope и уберите, когда почините.
Приватность. AITUNNEL не логирует исходный код промптов.