CC Switch CLI: установка и переключение на сервере
CC Switch CLI — консольная версия, которую поддерживает сообщество; это не официальный продукт CC Switch. В официальном README сказано, что сам CC Switch выпускается только как десктопное приложение с графическим интерфейсом, а для серверов, SSH-сессий и машин без рабочего стола рекомендуется этот CLI. Это форк CC Switch, который отдельный автор выпускает самостоятельно. Установка, переключение и общий каталог данных описаны по README проекта CLI, поля для подключения QCode — по документации QCode.
Обновлено 2026-10-20
Подключите этот инструмент к эндпоинту QCode — один ключ для Claude, GPT и китайских моделей.
- Оплата по токенам — актуальные цены на /models
- Оплата через СБП, российскими картами, картами Visa / Mastercard / AMEX или криптовалютой
- Самообслуживание: после пополнения тариф активируется мгновенно
Что это, как поставить, как переключать, каталог данных, поля для QCode
не официальный продукт CC Switch
Это форк CC Switch, который отдельный автор выпускает самостоятельно; официальным продуктом CC Switch он не является. Для серверов, SSH-сессий и машин без рабочего стола его рекомендует официальный README.
два способа установки
В README этого проекта указан быстрый способ установки: curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash, программа попадает в ~/.local/bin; там же описан вариант с Homebrew — brew install cc-switch-cli.
список и переключение
Основные команды из README этого проекта: cc-switch открывает полноэкранный терминальный интерфейс; cc-switch provider list показывает сохранённые записи; cc-switch provider switch (id) переключает; cc-switch use (id) — сокращение для этой команды; инструмент выбирается ключом --app, по умолчанию это claude: cc-switch --app codex provider list.
каталог данных, общий с десктопной версией
В документации QCode сказано, что этот CLI по умолчанию использует общий с десктопной версией каталог ~/.cc-switch; поддерживаемая им версия базы данных иногда отстаёт от десктопной версии, поэтому при сообщении о слишком новой версии базы CLI нужно обновить или дождаться обновления.
Когда нужен консольный вариант
На серверах, в SSH-сессиях и контейнерах, где нет рабочего стола, десктопное приложение не запустить, и здесь пригодится консольная версия. В README самого проекта сказано, что доступны полноэкранный терминальный интерфейс и командная строка, которую можно встраивать в скрипты.
Рекомендация официального README и последняя версия
В разделе вопросов официального README CC Switch о консольной или headless-версии рекомендован CC Switch CLI, который поддерживает сообщество. Последний релиз этого CLI — v5.11.2, опубликован 16.10.2026.
Хронология
Вышел релиз десктопной версии CC Switch v4.0.12; на странице документации QCode сказано, что разделы про загрузку и командную строку сверены с README и Releases на 2026-10-15.
Дата обновления страницы документации QCode о CC Switch: там сказано, что официальной консольной версии нет, для серверов и SSH рекомендован CLI от сообщества, а каталог ~/.cc-switch используется по умолчанию.
Проект CLI от сообщества выпустил v5.11.2; на странице релиза указаны tag v5.11.2 и время публикации 2026-10-16T13:51:51Z. На странице документации QCode при проверке 2026-10-15 был записан v5.11.1.
Что подтверждено источниками, а что нет
Есть источник
① В официальном README сказано, что CC Switch выпускается только как десктопное приложение с графическим интерфейсом. ② Для серверов, SSH-сессий и машин без рабочего стола рекомендован поддерживаемый сообществом CC Switch CLI; согласно README проекта CLI и документации QCode, это форк CC Switch, который отдельный автор выпускает самостоятельно, и он не является официальным продуктом CC Switch. ③ В README проекта указаны два способа установки: скрипт установки и Homebrew. ④ Базовые команды охватывают запуск полноэкранного терминального интерфейса, список записей, переключение, сокращённую форму переключения, выбор инструмента через --app и запуск одного сеанса с указанной записью. ⑤ По умолчанию каталог ~/.cc-switch используется совместно с десктопной версией, основные данные лежат в ~/.cc-switch/cc-switch.db, а CC_SWITCH_CONFIG_DIR переносит каталог в другое место. ⑥ Поля для QCode взяты из документации QCode: для Claude — ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN, для Codex — Base URL и API Key.
Чего нет ни в официальной документации, ни в проекте
① Официального сравнения возможностей консольной версии и десктопного приложения нет, и в документации QCode сказано, что CLI от сообщества не проверялся по функциям. ② В README проекта не описано, как версия базы данных CLI соотносится с версией десктопного приложения. ③ Ни с той, ни с другой стороны не указано, при каких именно условиях появляется сообщение «database version is too new». ④ Нигде не указано, какие зависимости нужны этому CLI в образе контейнера.
Консольная версия и десктопное приложение
Десктопное приложение (официальное)
На странице документации QCode методами установки десктопной версии названы установочные пакеты для каждой системы и команды пакетных менеджеров; в итоге вы получаете приложение с графическим интерфейсом.
Консольная версия (форк от сообщества)
Проект из сообщества даёт и полноэкранный терминальный интерфейс, и командную строку, которую можно встраивать в скрипты; при расхождении версий CLI сообщает, что версия базы данных слишком новая.
Установка, переключение и проверка на сервере
① Установка: выполните curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash из README проекта (файл попадает в ~/.local/bin) либо используйте Homebrew: brew install cc-switch-cli. ② Добавление записи: cc-switch provider add, поля заполняются по документации QCode. ③ Переключение: cc-switch provider switch (id) (сокращённо cc-switch use (id)); чтобы применить запись только к одному запуску, используйте cc-switch start claude (id) — в README сказано, что это влияет лишь на сеанс, запущенный этой командой, тогда как provider switch и use по-прежнему меняют общую запись. ④ Каталог данных и обновления: основные данные лежат в ~/.cc-switch/cc-switch.db, путь меняется через CC_SWITCH_CONFIG_DIR (в README сказано, что данные из ~/.cc-switch автоматически не переносятся); в README сказано, что установку через Homebrew обновляют командой brew upgrade cc-switch-cli.
На QCode
Согласно документации QCode о CC Switch: для Claude укажите ANTHROPIC_BASE_URL https://api.qcode.cc/api и ANTHROPIC_AUTH_TOKEN (ключ, начинающийся с cr_), для Codex — Base URL https://api.qcode.cc/openai и API Key; CC Switch записывает конфигурацию в ~/.claude/settings.json и ~/.codex/config.toml. QCode списывает по токенам, цены по моделям указаны на qcode.cc/models. Чтобы Claude Code или Codex постоянно работали на сервере, возьмите облачные серверы QCode: машина стоит за границей, на ней установлены Claude Code / Codex, а модели вызываются вашим ключом QCode; ИИ-сервис и облачные серверы используют один баланс. У облачных серверов сейчас есть только китайский и английский интерфейсы (qcode.cc/en/cloud).
Частые вопросы
Есть ли у CC Switch официальная консольная версия?
Нет. В официальном README сказано, что CC Switch выпускается только как десктопное приложение с графическим интерфейсом; для серверов, SSH-сессий и машин без рабочего стола там рекомендуют поддерживаемый сообществом CC Switch CLI (по README проекта CLI и документации QCode, он не является официальным продуктом CC Switch).
Как поставить на сервере?
В README проекта указаны два способа: Homebrew — brew install cc-switch-cli, либо curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash, который ставит программу в ~/.local/bin. В README описан и ручной вариант: скачать архив под вашу систему и положить его в PATH; для Linux это статическая сборка musl.
Как переключиться на другую запись?
Базовые команды из README проекта: cc-switch provider list показывает сохранённые записи, cc-switch provider switch (id) переключает, cc-switch use (id) — сокращённая форма, cc-switch --app codex provider list выбирает инструмент через --app (по умолчанию claude). Чтобы применить запись только к одному запуску, выполните cc-switch start claude (id).
Что делать, если появляется «database version is too new»?
В FAQ официального README и в документации QCode сказано, что этот CLI по умолчанию делит каталог ~/.cc-switch с десктопной версией и что поддерживаемая им версия базы данных иногда отстаёт от десктопной версии; при таком сообщении CLI нужно обновить или дождаться обновления.
Какие поля заполнять для QCode?
По документации QCode о CC Switch: для Claude в ANTHROPIC_BASE_URL указывают https://api.qcode.cc/api, а в ANTHROPIC_AUTH_TOKEN — ключ, начинающийся с cr_; для Codex в Base URL указывают https://api.qcode.cc/openai, а в API Key — тот же ключ. CC Switch записывает это в ~/.claude/settings.json и ~/.codex/config.toml. Названия полей взяты из документации QCode, которая описывает десктопное приложение и сообщает, что CLI от сообщества не проверялся по функциям; при запуске cc-switch provider add ориентируйтесь на запросы, которые действительно появляются.
Есть ли в npm пакет с именем cc-switch-cli?
Да, но это не тот же проект, что в README: у пакета с таким именем в реестре npm указан сопровождающий jacob.shi, последняя версия — 1.0.1, публикация — 2026-04-26. Проект, на который ссылается официальный README, — это бинарный файл на Rust, команда называется cc-switch, и в его README нет установки через npm. Ставьте версию из Homebrew или установочным скриптом, как описано в README.
Источники
README и releases/latest проекта CC Switch CLI от сообщества (tag v5.11.2, публикация 2026-10-16, получено и проверено 2026-10-20); страница документации QCode о CC Switch (обновлена 2026-10-15, проверена 2026-10-20); метаданные одноимённого пакета npm в реестре (проверены 2026-10-20).
Подключите Claude Code к QCode на своём сервере
Списание по токенам; цены по моделям указаны на qcode.cc/models.
Похожие материалы
Разовые пакеты для Claude Code: без подписки, 7–90 дней
Разовая квота на 7–90 дней, без подписки; новые пакеты добавляются к тому же ключу.
CC Switch: переключение API в Claude Code и Codex
Как десктопное приложение переключает API между Claude Code и Codex, какие поля настраиваются и что проверять, если переключение не сработало.
CC Switch 4.0: агрегация, ссылки и CLI (окт. 2026)
4.0 разделяет прямые подключения, маршрутизацию и агрегацию на три вкладки и отмечает, что в официальном README нет консольной версии.
Оплата криптовалютой
Девять монет, 56 сетей, нулевая комиссия платформы за кредиты AI-кодинга.
Содержимое страницы сверено 2026-10-20 с README и release проекта CC Switch CLI от сообщества и с документацией QCode; проект поддерживается сообществом и выпускается самостоятельно, поэтому версии и функции могут меняться — перед установкой прочитайте его README. Поля настройки QCode взяты из документации QCode, а список доступных моделей приведён на /models.