Использование CC-Switch-CLI
CC-Switch-CLI — это консольная утилита для переключения провайдеров, подходящая для серверов без графического интерфейса, SSH-окружений или для тех, кому нужно быстро переключать провайдеров между Claude Code, Codex, Gemini CLI, OpenCode и OpenClaw.
Кому это подходит
Если вы обычный пользователь настольного ПК, отдайте предпочтение графическому интерфейсу CC Switch. Если вы привыкли работать в терминале или вам нужно пакетно управлять конфигурациями, используйте данную страницу. В блоках кода ниже приведены только сами команды, а пояснения вынесены наружу, чтобы они не скопировались случайно вместе с кодом.
Установка и запуск
Пользователи macOS и Linux могут следовать официальной документации и использовать скрипт установки или архив из Releases; пользователям Windows рекомендуется скачать соответствующий архив из Releases и запустить программу из папки после распаковки.
curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash cc-switch.\cc-switch.exeЕсли просто ввести cc-switch, откроется интерактивный интерфейс, что удобно для новичков для ознакомления с меню. Приведённые ниже команды подходят, когда вы уже точно знаете нужное действие и хотите выполнить его напрямую.
Проверка окружения
| Что проверить | Как посмотреть | Зачем |
|---|---|---|
| Установлен ли CC Switch или CLI-версия | Терминал распознаёт соответствующую команду | Без установки любая команда настройки завершится с ошибкой. |
| Установлен ли целевой CLI | Claude Code, Codex и Gemini CLI запускаются по отдельности | CC-Switch-CLI не устанавливает целевые инструменты за вас |
| Полнота данных провайдера | Подготовьте Base URL, API Key и название модели | В командной строке нет графических подсказок, пропуск любого поля приведёт к ошибке. |
| Сначала проверьте в тестовой директории | Не переключайте сразу массово в рабочих проектах | Так проще откатить изменения при неверной конфигурации |
cc-switch env tools cc-switch env check cc-switch provider current cc-switch --app codex provider currentКоманды для управления провайдерами
Provider — это профиль настроек провайдера. Перед добавлением провайдера подготовьте Base URL, API Key и название модели из личного кабинета провайдера. При редактировании или переключении сначала уточните номер (ID) с помощью команды списка.
cc-switch provider list cc-switch provider add cc-switch provider edit <id> cc-switch provider fetch-models <id>cc-switch provider switch <id> cc-switch provider stream-check <id> cc-switch provider fetch-models <id><id> необходимо заменить на номер (ID), полученный из cc-switch provider list. Не выполняйте команду с буквальным <id>.Управление по приложениям
Если вы хотите просмотреть конфигурацию конкретного инструмента, добавьте флаг --app. Это удобно для раздельной диагностики Claude Code, Codex и Gemini CLI.
cc-switch --app claude provider list cc-switch --app codex provider list cc-switch --app gemini provider list cc-switch --app opencode provider list cc-switch --app openclaw provider listcc-switch --app claude provider current cc-switch --app codex provider current cc-switch --app gemini provider currentУбедившись, что целевое приложение и текущий провайдер определены корректно, выполните переключение. После переключения перезапустите терминал и отправьте короткий тестовый запрос через целевой инструмент.
claude "Please reply only: Claude Code is active" codex "Please reply only: Codex is active" gemini "Please reply only: Gemini is active"Синхронизация MCP
MCP требуется далеко не всем новичкам. Настраивайте его только в том случае, если вы уже используете MCP в Claude Code, Codex или Gemini CLI и вам нужна синхронизация между инструментами. Для первого раза рекомендуется зайти в TUI-меню и изучить раздел MCP, не копируя напрямую сложные команды из старых руководств.
cc-switch cc-switch --app codexПорядок настройки
- Сначала определите целевой инструмент: Claude Code, Codex, Gemini CLI или другой CLI.
- Подготовьте Base URL, API Key и название модели из личного кабинета провайдера.
- Добавьте или выберите провайдера в CC-Switch-CLI.
- Примените провайдера к целевому инструменту.
- Перезапустите терминал и выполните минимальный тестовый запрос в целевом CLI.
- Убедившись в успехе, примените этого же провайдера к остальным целевым инструментам при необходимости.
| Сценарий | Рекомендации |
|---|---|
| Использование на локальном ПК | Лучше использовать графический интерфейс CC Switch: поля и статусы в нём нагляднее |
| Удалённый сервер / SSH | Используйте CC-Switch-CLI, предварительно проверив актуальные команды для текущей версии |
| Пакетное переключение конфигураций | Сначала проверьте работоспособность в тестовом проекте, затем применяйте в рабочих |
| Несколько пользователей на одной машине | Не записывайте свой ключ в общую конфигурацию; сначала проверьте область видимости конфигурационного файла |
Устранение неполадок для начинающих
| Проблема | Что проверить в первую очередь | Решение |
|---|---|---|
| Команда не найдена (Command not found) | Установлена ли утилита и добавлена ли она в PATH | Перезапустите терминал или обратитесь к официальной инструкции, чтобы уточнить путь установки |
| Целевой инструмент не изменился после переключения | Перезапущен ли терминал и выбран ли правильный целевой инструмент | Закройте текущее окно терминала, откройте его заново и повторите тест |
| 401 / Unauthorized | Полностью ли скопирован ключ и не истёк ли срок его действия | Скопируйте ключ заново, убедившись в отсутствии лишних пробелов |
| model not found (модель не найдена) | Скопировано ли название модели в точности из личного кабинета | Укажите точное название из списка моделей провайдера |