Перемикання провайдера Claude Code: інструкція з CC Switch за 5 хвилин

Ця інструкція стосується CC Switch v4.0.26 (листопад 2026 року). У наступних випусках назви кнопок можуть змінитися; модель конфігурації залишається стабільною.

Щоб перемикати провайдерів у Claude Code, зазвичай потрібно редагувати файл ~/.claude/settings.json: базову URL-адресу, API-ключ і, іноді, модель. З одним провайдером це нескладно. З двома чи трьома — уже невелика робота з обслуговування, а збій можна й не помітити: застаріла змінна ANTHROPIC_*, експортована в оболонці, може перевизначити щойно відредагований файл.

CC Switch перетворює перемикання на картку, яку достатньо натиснути. Вбудований пресет AiHubMix заповнює ендпоінт, а вам залишається вставити API-ключ. Зазвичай Claude Code підхоплює зміни без перезапуску. У цій інструкції розглянемо повне налаштування, а потім пояснимо, що саме записує CC Switch, як уникнути пастки зі змінними середовища та коли достатньо прямого режиму.

Коротко: встановіть CC Switch, створіть ключ AIHubMix, виберіть пресет AiHubMix у розділі Claude Code, вставте ключ, додайте до провайдера ANTHROPIC_MODEL=claude-sonnet-5-5, натисніть Перемкнути і запустіть claude -p "1+1, output only the answer" --model claude-sonnet-5-5. Далі — докладний опис цих кроків.

Що таке CC Switch

CC Switch — це застосунок із відкритим кодом (MIT, Tauri + Rust + React) для керування конфігураціями провайдерів у Claude Code, Codex, Gemini CLI, OpenCode та інших інструментах для програмування. У ньому є понад 90 пресетів провайдерів, а також підтримка власних провайдерів.

Це більше, ніж просто перемикач ключів:

• Прямий режим перезаписує поля ключів у файлі конфігурації клієнта, після чого клієнт напряму взаємодіє з провайдером.
• Режим маршрутизації запускає локальний шлюз на 127.0.0.1:15721 із перетворенням форматів API, перемиканням у разі збою, перевірками працездатності та журналами запитів.
• Режим агрегування об’єднує моделі кількох провайдерів в один список /model.

Репозиторій і посібник користувача доступні за адресою github.com/farion1231/cc-switch. Єдині офіційні джерела для завантаження — ccswitch.io і сторінка GitHub Releases. Сайти, що вимагають оплати чи облікових даних, не є офіційними.

Перш ніж почати

Вам знадобляться три речі:

• Встановлений Claude Code, який запускається з термінала. Перевірте командою claude --version. Якщо його не встановлено, скористайтеся офіційним інсталятором: curl -fsSL https://claude.ai/install.sh | bash або npm i -g @anthropic-ai/claude-code з Node.js 22 чи новішої версії.
• Обліковий запис AIHubMix і API-ключ. Створіть ключ у консолі AIHubMix. Зазвичай він починається з sk-.
• Інсталятор CC Switch. Завантажте його з ccswitch.io або зі сторінки GitHub Releases.

Крок 1: встановіть CC Switch

Під час першого запуску CC Switch імпортує наявну конфігурацію Claude Code як провайдера з назвою default і додає офіційного провайдера. Початкова конфігурація не зникає — ви можете будь-коли перемкнутися назад.

Якщо Claude Code ще не встановлено, його можна встановити або оновити на сторінці Apps у CC Switch.

Крок 2: створіть API-ключ AIHubMix

Відкрийте сторінку API-ключів AIHubMix, створіть ключ і скопіюйте його.

Позначка-заповнювач AIHUBMIX_API_KEY у документації — це не справжній ключ. Якщо вставити її без змін, запит завершиться помилкою 401 invalid key: AIHUBMIX_API_KEY.

Крок 3: додайте AIHubMix до Claude Code

1. Виберіть Claude Code на лівій бічній панелі.
2. Натисніть кнопку + у верхньому правому куті.
3. Знайдіть AiHubMix через пошук або в категорії сторонніх платформ.
4. Назва й ендпоінт заповнюються автоматично: https://aihubmix.com. Вставте свій ключ у поле API Key.
5. Натисніть Додати.

Пресет зберігає дві змінні середовища:

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com"
  }
}

У пресеті модель не задано. У посібнику AIHubMix ANTHROPIC_MODEL вказано як основну змінну, тож додайте її до того самого блоку env, перш ніж перемикатися:

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  }
}

Якщо модель не вказати, Claude Code надсилатиме власний ідентифікатор моделі за замовчуванням, якого може не бути серед моделей, доступних в AIHubMix.

Варто знати про дві деталі.

Не додавайте /v1 до базової URL-адреси. Claude Code використовує протокол Anthropic Messages і сам формує шлях запиту. Правильна адреса — https://aihubmix.com; https://aihubmix.com/v1 — базова URL-адреса з підтримкою OpenAI для інших клієнтів, і Claude Code додав би до неї власний шлях /v1/messages.

У пресеті використовується ANTHROPIC_API_KEY, тоді як у власному посібнику AIHubMix для Claude Code використовується ANTHROPIC_AUTH_TOKEN. AIHubMix приймає обидва варіанти: ANTHROPIC_AUTH_TOKEN надсилає заголовок Bearer, а ANTHROPIC_API_KEY — x-api-key. Виберіть один. Не задавайте обидва з різними значеннями. Докладні відомості про налаштування AIHubMix, ідентифікатори моделей і довідку з помилок наведено в документації AIHubMix для Claude Code.

Якщо пресету немає — наприклад, у старішій версії або після видалення картки, — виберіть Custom Configuration і вставте наведений вище JSON. У менеджері ендпоінтів картки провайдера можна перевірити затримку; пресет також містить запасну URL-адресу https://api.aihubmix.com на випадок, якщо aihubmix.com не вдасться визначити.

Крок 4: перемкніться та перевірте

На вкладці Direct натисніть Перемкнути на картці AiHubMix. Після запису конфігурації на кнопці з’явиться напис Використовується.

Claude Code автоматично перезавантажує конфігурацію; зазвичай перезапуск не потрібен. Якщо поточний сеанс продовжує використовувати старого провайдера, завершіть його та запустіть знову.

Перевірте весь ланцюжок роботи:

claude -p "1+1, output only the answer" --model claude-sonnet-5-5

Відповідь 2 означає, що запит дійшов до AIHubMix. В інтерактивному сеансі в рядку Anthropic base URL команди /status має відображатися https://aihubmix.com.

Щоб швидко перемкнутися, скористайтеся системним треєм: клацніть правою кнопкою миші піктограму CC Switch, відкрийте підменю Claude Code і виберіть провайдера. У заголовку підменю показано активного провайдера й зведення щодо квоти.

Щоб повернутися до офіційного провайдера, перемкніться на Claude Official, перезапустіть Claude Code і пройдіть процес входу.

Що саме змінює перемикання

У прямому режимі CC Switch замінює лише поля підключення та сумісності у файлі ~/.claude/settings.json: ANTHROPIC_*, AWS_*, перемикачі протоколу, як-от CLAUDE_CODE_USE_BEDROCK, поля model і apiKeyHelper, а також деякі параметри сумісності для окремих провайдерів, як-от CLAUDE_CODE_DISABLE_ARTIFACT і контекстне вікно.

permissions, hooks, enabledPlugins, statusLine, конфігурація MCP, коментарі й усе інше, що ви додали, залишаються без змін. Повний перелік наведено в довідці щодо файлу конфігурації.

Перед першим перезаписом конфігурації інструмента CC Switch створює резервну копію оригіналу в ~/.cc-switch/backups/live-first-write/. Якщо JSON має неправильний формат, програма відмовляється записувати файл, повідомляє номер рядка й стовпця та залишає його без змін.

Пастка: застарілі змінні ANTHROPIC_*

Саме через цю проблему може здаватися, що CC Switch не спрацював.

Якщо ви раніше виконували інструкції з налаштування вручну й додали export ANTHROPIC_BASE_URL=... або export ANTHROPIC_AUTH_TOKEN=... до файлу ~/.zshrc чи ~/.bash_profile, ці змінні можуть перевизначати значення, записані CC Switch. Ви перемикаєте картку на AIHubMix, але запити й далі надсилаються на старий ендпоінт.

CC Switch виявляє конфлікт. Угорі вікна з’являється жовтий банер із повідомленням, що змінні середовища можуть перевизначити конфігурацію; у подробицях указано назву змінної, її значення та джерело. Функція Видалити вибране видаляє ці змінні, попередньо створивши резервну копію в ~/.cc-switch/backups/env-backup-<timestamp>.json.

Щоб перевірити вручну:

grep -n "ANTHROPIC" ~/.zshrc ~/.bash_profile 2>/dev/null

Закоментуйте застарілі команди export, потім виконайте source ~/.zshrc або відкрийте новий термінал. У документації AIHubMix рекомендується видалити глобальні змінні ANTHROPIC_*, якщо конфігурацією керує CC Switch. Повний порядок усунення конфліктів наведено в довідці щодо змінних середовища.

Псевдоніми моделей і перемикання

Якщо задано ANTHROPIC_MODEL, моделлю Claude Code за замовчуванням буде Sonnet 5.5. Щоб псевдоніми /model (opus, sonnet, haiku, fable) відповідали ідентифікаторам моделей AIHubMix, їх також потрібно зіставити. Додайте в env такі ключі:

Повна конфігурація провайдера матиме такий вигляд:

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-1"
  }
}

Пріоритет вибору моделі, від найвищого до найнижчого: /model <name> → claude --model <name> → ANTHROPIC_MODEL → поле model у файлі settings.json. Скопіюйте ідентифікатори моделей зі списку моделей AIHubMix; вони чутливі до регістру.

Коли використовувати маршрутизацію чи агрегування

Для AIHubMix типовим вибором має бути прямий режим. Його ендпоінт уже підтримує Anthropic Messages, тож перетворення протоколу не потрібне.

Використовуйте маршрутизацію, якщо потрібна черга для перемикання в разі збою або якщо потрібно під’єднати до Claude Code провайдера з форматом OpenAI. У режимі маршрутизації Claude Code спрямовує запити на http://127.0.0.1:15721, у конфігурації ключ замінюється на PROXY_MANAGED, а CC Switch підставляє справжній ключ. Застосунок має залишатися запущеним; після виходу з CC Switch відновлюється пряма конфігурація. Офіційні підписки Claude не працюють через маршрутизацію — для них використовуйте прямий режим.

Використовуйте агрегацію, якщо хочете бачити моделі кількох провайдерів в одному списку /model. Провайдер за замовчуванням обробляє запити без префікса; моделі інших провайдерів відображаються з префіксом ccs-. Агрегація не забезпечує автоматичне перемикання на резервний провайдер. Вона доступна лише для Claude Code і Codex, а офіційні підписки Claude не підтримуються в режимі агрегації. Для списку моделей із префіксом ccs- потрібна версія Claude Code 2.1.243 або новіша. Claude Code одразу підхоплює зміни списку моделей; Codex потрібно повністю перезапустити.

Що ще вміє CC Switch

• Використання: панель поєднує журнали маршрутизованих запитів із локальними журналами сеансів. Сеанси можна сканувати й без маршрутизації; їхня вартість розраховується за моделлю, зазначеною в журналі. Маршрутизовані запити журналюються окремо.
• MCP: єдина панель для MCP-серверів, синхронізована з вибраними вами застосунками.
• Skills: знаходьте, установлюйте й видаляйте навички в одному місці.
• Сеанси: шукайте, переглядайте, експортуйте й відновлюйте локальні сеанси.
• Проєкти: збережіть конфігурацію провайдера проєкту, MCP-сервери, навички й файли пам’яті як знімок, а потім перемикайте весь набір для кожного проєкту.

Дані зберігаються в ~/.cc-switch/, а в їхній основі лежить база даних SQLite. За замовчуванням автоматичні резервні копії зберігають 10 найновіших; також доступна синхронізація через WebDAV або сумісне із S3 сховище. База даних і експортовані резервні копії містять конфігурації провайдерів, зокрема ключі, тож вважайте їх секретними.

Усунення несправностей

Наведені нижче рядки помилок процитовано з документації AIHubMix для Claude Code.

Якщо симптоми не пов’язані з помилками:

• Екран входу або Not logged in: перевірте /status; у Settings → App config → Claude Code увімкніть Skip Claude Code first-run confirmation; перезапустіть програму й переконайтеся, що ключ указано.
• Перемикання не спрацьовує: можливо, проблема в застарілій змінній оболонки або кешованому сеансі; відкрийте новий термінал або перезапустіть Claude Code.
• Перевірка з’єднання на картці проходить, але запити не працюють: перевірка підтверджує доступність, а не дійсність ключа чи моделі; виконайте наскрізний тест командою claude -p.
• Хочете повернутися до офіційного провайдера: перемкніться на Claude Official, перезапустіть Claude Code і ввійдіть знову.

Якщо команда claude не знайдена в macOS, офіційний інсталятор зазвичай розміщує її в ~/.local/bin/claude. Додайте export PATH="$HOME/.local/bin:$PATH" до профілю оболонки й відкрийте новий термінал.

Контрольний список

• [ ] Установіть CC Switch із ccswitch.io або GitHub Releases.
• [ ] Створіть API-ключ у консолі AIHubMix.
• [ ] У Claude Code → + → AiHubMix → вставте ключ → Додати.
• [ ] Додайте ANTHROPIC_MODEL=claude-sonnet-5-5 до JSON конфігурації провайдера.
• [ ] Натисніть Перемкнути й переконайтеся, що на картці відображається Використовується.
• [ ] Видаліть застарілі змінні ANTHROPIC_* з профілю оболонки.
• [ ] Виконайте claude -p "1+1, output only the answer" --model claude-sonnet-5-5 і перевірте, чи виведено 2.

Якщо остання команда повертає 2, перемикання провайдера завершено. Залишається додати потрібні псевдоніми моделей і вирішити, чи потрібні вам маршрутизація або агрегація; більшості користувачів AIHubMix достатньо прямого режиму.

Поширені запитання

CC Switch безкоштовний?
Так. Це програмне забезпечення з відкритим кодом за ліцензією MIT. Ви платите лише провайдеру, чий API використовуєте.

Під час перемикання видаляються мої хуки, MCP-сервери або плагіни?
Ні. Пряме перемикання замінює ендпоінт, ключ, модель і деякі параметри, прив’язані до провайдера. Хуки, дозволи, MCP-сервери, плагіни й налаштування рядка стану залишаються у файлі.

CC Switch завантажує мій API-ключ?
Конфігурації провайдерів зберігаються локально у файлі ~/.cc-switch/cc-switch.db. Якщо ввімкнути синхронізацію через WebDAV або S3, вони синхронізуватимуться зі сховищем, яке ви контролюєте. Бази даних і резервні копії містять ключі, тож поводьтеся з ними як із секретними даними.

Потрібно, щоб CC Switch залишався запущеним?
У прямому режимі — ні. Для маршрутизації й агрегації застосунок має бути запущений; після виходу з CC Switch клієнт повертається до прямого режиму.

Можна одночасно використовувати Claude Official і AIHubMix?
У прямому режимі одночасно активний лише один провайдер. Агрегація дає змогу зібрати моделі кількох провайдерів в одному списку, але офіційна підписка Claude там не підтримується; щоб користуватися нею, поверніться до прямого режиму.

Працює у Windows?
Так. CC Switch підтримує Windows 10 і новіші версії; доступний інсталятор .msi або портативна збірка. Для Linux потрібні glibc 2.35+ і WebKitGTK 4.1.

Чому картка провайдера показує, що з’єднання працює, але Claude Code усе одно не запускається?
Перевірка з’єднання на картці визначає, чи доступний ендпоінт. Вона не перевіряє API-ключ або модель. Щоб протестувати весь шлях, виконайте наскрізну команду claude -p.

Джерела

• Репозиторій CC Switch
• Посібник користувача CC Switch: додавання провайдера
• Посібник користувача CC Switch: перемикання провайдера
• Посібник користувача CC Switch: файли конфігурації
• Документація AIHubMix: Claude Code