Перейти к основному содержанию

Documentation Index

Fetch the complete documentation index at: https://docs.llmeasy.ru/llms.txt

Use this file to discover all available pages before exploring further.

После настройки LLMEasy Gateway в Claude Desktop следующие симптомы обычно не означают, что сам API Key недействителен:
  • Cowork mode не работает
  • Code mode показывает Claude Code process exited with code 1
  • Тот же API Key работает в Claude Code CLI из терминала
Обычно у этих проблем две разные причины: desktop Gateway auth scheme не соответствует группе API Key, или bundled Claude Code version внутри Claude Desktop еще не завершила обновление. Если Gateway еще не настроен, начните с использования LLMEasy API в Claude Desktop.

​
Сначала исправьте Cowork mode

Причина: Gateway auth scheme не соответствует группе API Key. В настройках Claude Desktop Gateway выберите auth scheme по группе API Key:
  • Если API Key относится к Claude group, установите Gateway auth scheme в x-api-key
  • Если API Key относится к Codex group, установите Gateway auth scheme в bearer
После выбора правильной scheme Claude Desktop автоматически получает доступные модели для этой группы. Если auth scheme неверная, Cowork mode может не пройти Gateway authentication.
1

Откройте настройки third-party inference

В macOS menu bar выберите Developer → Configure Third-Party Inference….
2

Измените auth scheme

Выберите Gateway auth scheme по группе API Key: x-api-key для Claude group и bearer для Codex group.
3

Сохраните config

Нажмите Apply locally, чтобы сохранить local Gateway config.
После этого Cowork mode обычно снова работает.

​
Затем исправьте ошибки выхода Code mode

Если Cowork работает, но Code mode, вкладка </>, все еще показывает Claude Code process exited with code 1, проверьте, не использует ли Claude Desktop старую bundled Claude Code version. Причина: Claude Desktop может скачивать новую Claude Code version в фоне. До завершения скачивания Code mode может fallback на старую установленную версию Claude Code. Эта старая версия может быть несовместима с third-party Gateway usage в Code mode, поэтому процесс сразу завершается. Как исправить:
1

Подождите завершения скачивания новой Claude Code version

Оставьте Claude Desktop открытым на некоторое время, чтобы background update Claude Code завершился.
2

Полностью закройте Claude Desktop

Используйте Cmd+Q, чтобы полностью закрыть приложение. Не закрывайте только окно.
3

Откройте снова и начните новую Code session

Откройте Claude Desktop снова, затем перейдите в Code mode и начните новую сессию.
Если logs показывают, что Claude Desktop fallback на старую версию Claude Code, например 2.1.111, пока новая версия, например 2.1.119, еще не готова, дождитесь завершения скачивания новой версии и затем перезапустите приложение.

​
Краткая памятка

СимптомЧастая причинаИсправление
Cowork mode не работаетGateway auth scheme не соответствует группе API KeyИспользуйте x-api-key для Claude group или bearer для Codex group, затем нажмите Apply locally
Code mode показывает Claude Code process exited with code 1Claude Desktop fallback на старую Claude Code versionДождитесь скачивания новой версии, полностью закройте через Cmd+Q, затем откройте снова