Руководство по настройке

Руководство по настройке провайдера

Инструкции по настройке и устранению неполадок по инструментам.

CC-Switch Claude Code

На этой странице объясняется только одно: добавление или выбор провайдера в CC Switch с последующим применением к Claude Code. Это не руководство по прямой настройке Claude Code; если вы хотите вручную изменить файл конфигурации Claude Code, обратитесь к разделу «Конфигурация Claude Code CLI».

О чем эта страница

Назначение CC Switch — помочь вам централизованно управлять провайдерами и синхронизировать конфигурации с целевыми инструментами. Для Claude Code уделите особое внимание проверке протокола Claude / Anthropic, ключа (Key) и названия модели. Не используйте напрямую адрес, совместимый с OpenAI, в качестве адреса Claude, если только провайдер прямо не заявляет о поддержке Claude Code.

Что проверить перед началом

Параметр для проверкиКак проверитьЗачем это нужно
Claude Code запускаетсяУбедитесь в терминале или клиенте, что Claude Code открывается штатноCC Switch отвечает только за переключение конфигураций, но не занимается установкой Claude Code
Провайдер поддерживает Claude CodeВ панели управления или документации есть упоминания Claude / Anthropic / Claude CodeПровайдеры, предоставляющие интерфейсы только под OpenAI, могут быть несовместимы с Claude Code
Ключ и название модели действительныВ панели управления видны токены, ключи, списки моделей или инструкции по доступным моделямНеверно указанное название модели сразу приведет к ошибке model not found
Сначала изменяйте только один целевой инструментДля начала выберите только Claude CodeТак проще определить, где именно возникла проблема при диагностике

Как заполнять поля

ПараметрКак заполнятьВажно для новичков
Provider NameУкажите понятное и легко узнаваемое имяНапример, 'Основной провайдер Claude', не пишите просто цифры
Target Tool / PresetВыберите Claude Code или связанный с Claude пресетНе выбирайте Codex, OpenAI или Gemini
Base URLСкопируйте ссылку на API, указанную в панели провайдера для Claude / AnthropicНе у всех провайдеров Base URL совпадает с адресом для OpenAI
API KeyСкопируйте ключ целиком, как он был сгенерирован в панели управленияЕго также часто называют токеном, Key, секретным ключом
Model NameВ точности скопируйте название модели Claude, поддерживаемое панелью управленияНе сокращайте вручную и не путайте отображаемое имя с идентификатором модели
Если в панели провайдера разделены различные протоколы, Claude Code использует группу Claude / Anthropic. Заполнять адрес по стандарту OpenAI следует только в том случае, если в панели явно сказано: «Claude Code использует совместимый с OpenAI адрес».

Применение к Claude Code

  1. Откройте CC Switch и перейдите в раздел управления провайдерами (Provider).
  2. Добавьте нового провайдера или выберите уже созданную конфигурацию.
  3. Выберите пресеты, относящиеся к целевому инструменту Claude Code.
  4. Последовательно заполните имя провайдера (Provider name), Base URL, API Key и название модели.
  5. После сохранения нажмите Apply / Switch, чтобы применить текущего провайдера к Claude Code.
  6. Если появится подсказка о необходимости перезапустить терминал или целевой инструмент, закройте текущую сессию Claude Code и откройте ее заново.

Проверка работоспособности

Для теста сначала отправьте предельно короткий запрос, не открывая реальный проект. Если ответ пришел корректно, значит ключ, Base URL, имя модели и синхронизация с целевым инструментом настроены правильно.

Минимальный тест Claude Code
claude "Please reply only: CC-Switch Claude Code is active"
Если тест не удался, проверьте настройки в следующем порядке: правильно ли выбран целевой инструмент, соответствует ли Base URL протоколу Claude / Anthropic, полностью ли скопирован ключ и в точности ли совпадает имя модели с данными из панели провайдера.