Если вы ищете CC Switch Claude Code, у вас, вероятно, уже установлен помощник для кодинга. Проблема настройки уже более узкая: нужно, чтобы CC Switch записал правильную конфигурацию провайдера Claude Code, использовал правильный ключ Flatkey, указывал на правильный базовый URL, выбирал модели, к которым ваш ключ действительно имеет доступ, и проверял запрос в журналах использования.
Это руководство описывает практический путь маршрутизации CC Switch Claude Code с Flatkey и рабочим процессом NewAPI в один клик. Текущая документация NewAPI по CC Switch описывает импорт через deep link ccswitch:// со страницы токена New API. Пользователи Flatkey могут вручную использовать тот же интерфейс настройки CC Switch: добавить провайдера Claude Code, вставить API-ключ Flatkey, задать базовый URL шлюза Claude Code, получить список моделей, сохранить профиль и проверить маршрут.
Руководство текстовое. Оно не использует скриншоты приложения, потому что текущий поток интерфейса CC Switch и Flatkey следует сначала проверить по скриншотам перед публикацией пошаговых изображений.
Краткий ответ: Настройки CC Switch Claude Code для Flatkey
Для конфигурации CC Switch Claude Code на базе Flatkey создайте провайдера Claude Code в CC Switch и используйте роутер Flatkey в качестве шлюза. Для запросов Claude Code в стиле Anthropic Messages используйте корневой URL шлюза, а не путь OpenAI chat-completions.
| Поле или конфигурация CC Switch | Значение Flatkey | Что проверить |
|---|---|---|
| Приложение | Claude или Claude Code |
Не настраивайте приложение Codex или Gemini, если целевой вариант — Claude Code. |
| Вкладка провайдера | App-specific Provider для Claude Code или Universal Provider, если вы также синхронизируете Codex/Gemini |
Универсальные провайдеры требуют проверки после синхронизации, потому что каждое приложение может ожидать разную форму URL. |
| Имя | Flatkey Claude Code |
Используйте имя, которое позже будет понятно при переключении в трейе CC Switch. |
| API Key | Ваш ключ API Flatkey | Создайте его или скопируйте из панели управления Flatkey. Никогда не вставляйте реальный ключ в общие документы. |
| Базовый URL Claude Code | https://router.flatkey.ai |
Используйте это для ANTHROPIC_BASE_URL. Затем Claude Code обращается к путям вроде /v1/messages. |
| Совместимый с OpenAI базовый URL | https://router.flatkey.ai/v1 |
Используйте это для клиентов, совместимых с OpenAI, и проверок получения моделей, которые вызывают /v1/models. |
| Модели Main/Sonnet/Opus/Haiku | Идентификаторы моделей из результата fetch в CC Switch, консоли Flatkey или каталога цен | Используйте точные идентификаторы моделей. Не используйте маркетинговые названия или метки семейств моделей. |
| Проверка | Запустите короткий запрос Claude Code и проверьте журналы использования Flatkey | Настройка не завершена, пока запрос не появится в панели управления Flatkey. |
Если в форме CC Switch есть расширенный JSON-редактор, профиль Claude Code должен иметь примерно такую структуру. Используйте заглушку в документации; никогда не храните реальный ключ в репозитории.
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-fk-your-flatkey-key",
"ANTHROPIC_BASE_URL": "https://router.flatkey.ai",
"ANTHROPIC_MODEL": "your-claude-model-id"
}
}Claude Code также поддерживает ANTHROPIC_API_KEY. Используйте одну переменную аутентификации, а не обе, если только вы намеренно не понимаете приоритет. Для маршрутизации через шлюз в bearer-стиле ANTHROPIC_AUTH_TOKEN делает сопоставление явным, потому что Claude Code отправляет его как значение заголовка Authorization.
Где NewAPI вписывается в рабочий процесс CC Switch
В текущей документации NewAPI по CC Switch говорится, что консоль New API может добавить ярлык Chat Settings с помощью этого JSON:
{ "CC Switch": "ccswitch" }После этого страница управления токенами New API может показывать опцию CC Switch, которая запускает CC Switch через deep link ccswitch:// и открывает диалог импорта провайдера. В документации NewAPI поля этого диалога описываются как тип приложения, имя, основная модель и выбор моделей Haiku/Sonnet/Opus.
Для Flatkey используйте ту же концепцию, не утверждая, что импорт выполняется со страницы токенов NewAPI. Если ваш ключ — это ключ Flatkey, добавьте провайдера напрямую в CC Switch. Если ваш ключ находится в развертывании NewAPI, используйте одношаговый импорт NewAPI. Важное различие простое: CC Switch управляет локальной конфигурацией Claude Code, а Flatkey или NewAPI обрабатывает upstream-уровень маршрутизации.
Перед началом
Перед изменением провайдера CC Switch Claude Code подтвердите выполнение этих предварительных условий:
- CC Switch установлен на машине, где запускается Claude Code.
- Claude Code уже установлен и может нормально открываться.
- Вы можете войти в Flatkey и открыть панель управления.
- У вас есть API-ключ Flatkey для этой рабочей станции или разработчика.
- Вы знаете как минимум один ID модели Claude, доступный в вашем аккаунте Flatkey.
- Вы можете просмотреть журналы использования Flatkey после первого тестового запроса.
Не используйте общий production-ключ для первого теста. Создайте ограниченный ключ, названный по инструменту и владельцу, например cc-switch-lee или claude-code-devbox. Это сделает первый smoke-тест CC Switch Claude Code простым для аудита и легким для отзыва.
Шаг 1: Создайте или скопируйте API-ключ Flatkey
Откройте панель управления Flatkey и создайте ключ для использования Claude Code через CC Switch. Скопируйте его один раз и сохраните в своём менеджере паролей или в менеджере секретов команды.
Поле API Key в CC Switch должно содержать ключ Flatkey. Не вставляйте в этот профиль ключ Anthropic, OpenAI, Google или ключ, специфичный для провайдера, если только вы намеренно не настраиваете прямое подключение к этому провайдеру вместо Flatkey.
Для команд создавайте отдельные ключи по пользователю, устройству или среде. Один общий ключ технически может работать, но позже это усложняет проверку использования и отзыв доступа.
Шаг 2: Добавьте провайдера Claude Code в CC Switch
Откройте CC Switch и перейдите в раздел провайдера Claude Code. В руководстве пользователя CC Switch описаны два пути добавления: провайдеры для конкретного приложения для выбранного приложения и Universal Provider для общей конфигурации между Claude Code, Codex и Gemini.
Для первой настройки CC Switch Claude Code Flatkey начните с провайдера Claude Code для конкретного приложения:
- Откройте CC Switch.
- Выберите Claude или Claude Code в переключателе приложений.
- Нажмите кнопку +, чтобы добавить провайдера.
- Выберите пользовательский путь провайдера, если предустановки Flatkey нет.
- Установите имя провайдера как
Flatkey Claude Code. - Вставьте ваш API-ключ Flatkey.
- Установите базовый URL шлюза Claude Code как
https://router.flatkey.ai. - Выбирайте идентификаторы моделей для Main, Sonnet, Opus и Haiku только после подтверждения, что они доступны вашему аккаунту.
Если вы используете Universal Provider, заполните Name, API Key и Endpoint URL, затем отметьте приложения, которые хотите синхронизировать. После синхронизации проверьте сгенерированную конфигурацию Claude Code. Для Claude Code активная базовая должна быть https://router.flatkey.ai. Для конфигураций приложений, совместимых с OpenAI, обычно ожидаемый базовый URL — https://router.flatkey.ai/v1.
Шаг 3: Получите модели перед выбором Main, Sonnet, Opus и Haiku
CC Switch документирует действие Fetch Models рядом с полями моделей. Оно использует настроенный API-ключ для вызова совместимой с OpenAI конечной точки /v1/models, а затем позволяет выбрать возвращённые идентификаторы моделей из выпадающего списка.
Для этой статьи проверка Flatkey с датой 11 июня 2026 года вернула HTTP 200 с https://router.flatkey.ai/v1/models и ответ списка моделей для настроенного тестового ключа. Среди возвращённых примеров были идентификаторы моделей семейства Claude, такие как claude-sonnet-4-6, claude-sonnet-4-5, claude-opus-4-7 и claude-haiku-4-5. Рассматривайте эти примеры как актуальный снимок, а не как постоянную рекомендацию по модели.
Используйте это правило выбора модели:
- Main Model: выберите модель Claude, которую вы хотите использовать по умолчанию в Claude Code.
- Sonnet Model: выберите сбалансированную модель, которую ваша команда ожидает использовать для повседневного кодинга.
- Opus Model: выбирайте модель с более высокими возможностями только если это позволяет ваш бюджет и доступ.
- Haiku Model: выберите лёгкую модель для более быстрых или фоновых задач, если она доступна.
Если Fetch Models не работает, не угадывайте. Откройте консоль Flatkey или каталог тарифов, скопируйте один точный совместимый с Claude идентификатор модели и сначала протестируйте только эту модель.
Шаг 4: Сохраните, синхронизируйте и проверьте сгенерированную конфигурацию Claude Code
После того как вы сохраните провайдера, CC Switch запишет активную конфигурацию провайдера для Claude Code. Точный путь к файлу может различаться в зависимости от версии CC Switch и области приложения, но официальная документация настроек Claude Code подтверждает, что переменные окружения можно настраивать через settings.json в ключе env.
Проверьте, что сгенерированная конфигурация не содержит конфликтующих значений аутентификации. Чистый профиль Flatkey должен иметь один из следующих шаблонов:
# Стиль шлюза с bearer-токеном
ANTHROPIC_AUTH_TOKEN=sk-fk-your-flatkey-key
ANTHROPIC_BASE_URL=https://router.flatkey.aiили:
# Стиль API-ключа
ANTHROPIC_API_KEY=sk-fk-your-flatkey-key
ANTHROPIC_BASE_URL=https://router.flatkey.aiНе оставляйте старый прямой ключ Anthropic активным в вашей оболочке при тестировании нового профиля CC Switch Claude Code. Если оболочка по-прежнему экспортирует другой ANTHROPIC_API_KEY, это может усложнить устранение неполадок, поскольку активный процесс может использовать не тот профиль CC Switch, который, как вам кажется, он использует.
Шаг 5: Проверьте использование Claude Code и журналов Flatkey
Откройте новый терминал после включения провайдера Flatkey в CC Switch. Claude Code может поддерживать горячее переключение в некоторых сценариях CC Switch, но новый терминал устраняет путаницу состояния оболочки во время первого теста.
- Запустите Claude Code.
- Проверьте активную модель или статус в Claude Code.
- Отправьте короткий запрос, например попросите ответить одной короткой фразой.
- Откройте панель управления Flatkey.
- Проверьте журналы использования на время запроса, ID модели и имя ключа.
Настройка CC Switch Claude Code считается завершённой только тогда, когда все три уровня согласованы: CC Switch показывает провайдера Flatkey как активного, Claude Code использует ожидаемую модель/base URL, а журналы Flatkey показывают запрос.
Устранение неполадок CC Switch Claude Code с Flatkey
| Проблема | Вероятная причина | Исправление |
|---|---|---|
| Ошибка аутентификации | Ключ неверный, отключён, скопирован с пробелами или не является ключом Flatkey. | Создайте новый ключ в Flatkey, вставьте его снова и проверьте, что вы используете либо ANTHROPIC_AUTH_TOKEN, либо ANTHROPIC_API_KEY, а не конфликтующие значения. |
| 404 или неверный путь к endpoint | В URL указан неверный формат пути для Claude Code. | Для Claude Code используйте https://router.flatkey.ai. Для получения модели в формате OpenAI-compatible или других клиентов используйте https://router.flatkey.ai/v1. |
| Сбой Fetch Models | Ключ не может вызвать /v1/models, неверен base URL или endpoint временно недоступен. |
Используйте https://router.flatkey.ai/v1 для пути получения моделей, затем перейдите к точным ID моделей из консоли Flatkey. |
| Claude Code по-прежнему использует старого провайдера | Старый процесс терминала или экспорт shell переопределяет профиль CC Switch. | Откройте новый терминал, проверьте переменные окружения shell и убедитесь, что провайдер Flatkey включён в CC Switch. |
| Выбор модели работает, но запросы завершаются ошибкой | Выбранная модель указана в списке, но недоступна для вашего ключа, группы, баланса или текущей политики аккаунта. | Сначала протестируйте одну модель с подтверждённым доступом. Проверьте доступ к аккаунту Flatkey, баланс, квоты и журналы использования. |
| Поиск MCP tool меняет поведение | Claude Code рассматривает не относящиеся к первому лицу base URL как маршрутизацию через gateway. | Следуйте рекомендациям Claude Code по gateway, прежде чем включать расширенное поведение поиска инструментов через proxy. Не включайте флаги, специфичные для gateway, если только ваш gateway не пересылает требуемые блоки. |
Большинство сбоев CC Switch Claude Code сводятся к четырём полям: ключ, base URL, ID модели и активный профиль. Проверьте их, прежде чем перестраивать всю базу данных CC Switch.
CC Switch Vs A Claude Code Router
CC Switch и Claude Code router решают разные части рабочего процесса. CC Switch — это локальный менеджер конфигурации. Flatkey — это слой маршрутизации и доступа.
| Уровень | Что он делает | Чего он не делает |
|---|---|---|
| CC Switch | Хранит профили провайдеров, переключает конфигурации Claude Code/Codex/Gemini, управляет полями модели и может импортировать провайдеров через deep links. | Это не upstream-аккаунт модели, не биллинговая система и не роутер. |
| Claude Code | Запускает ассистента для кодинга и читает активные значения окружения/конфигурации. | Сам по себе он не управляет ключами вашей команды для нескольких провайдеров или биллингом. |
| Flatkey | Предоставляет один ключ, gateway endpoints, доступ к моделям, видимость использования, маршрутизацию и контроль биллинга для поддерживаемых моделей. | Он не заменяет локальный UI переключения профилей в CC Switch. |
Если вам нужен только один постоянный gateway-настройка, вы можете настроить Claude Code напрямую. Если вы переключаетесь между несколькими провайдерами, рабочими станциями или уровнями моделей, рабочий процесс CC Switch Claude Code дает более удобную панель управления. Если вы также переносите код приложения на gateway, прочитайте руководство по миграции API, совместимого с OpenAI. Если вы выбираете между прокси только для Claude и более широким gateway, прочитайте Claude API proxy vs router.
Рекомендуемое развертывание для команды
Для одного разработчика достаточно одного ключа Flatkey и одного провайдера CC Switch. Для команды настройку CC Switch Claude Code следует рассматривать как небольшое развертывание контроля доступа.
- Создавайте отдельный именованный ключ Flatkey для каждого разработчика, рабочей станции или окружения.
- Документируйте утверждённые идентификаторы моделей Claude и то, к какому уровню в CC Switch относится каждый из них.
- Используйте квоты до того, как приглашать больше пользователей в ту же схему маршрутизации.
- Проверяйте журналы использования после первого дня, а не только после неожиданности в счёте.
- Не публикуйте скриншоты в общедоступной документации, пока текущий интерфейс не будет подтверждён рецензентом.
- Используйте однокликовый импорт NewAPI только для ключей, управляемых в NewAPI; для ключей Flatkey используйте ручную настройку провайдера Flatkey.
FAQ
Что такое настройка CC Switch Claude Code?
CC Switch Claude Code — это профиль провайдера в CC Switch, который задаёт endpoint, ключ и настройки модели, которые должен использовать Claude Code. С Flatkey этот профиль указывает Claude Code на роутер Flatkey и использует ключ Flatkey.
Должен ли base URL Flatkey для Claude Code включать /v1?
Для ANTHROPIC_BASE_URL в Claude Code используйте https://router.flatkey.ai. Для совместимых с OpenAI клиентских приложений и проверок получения моделей, которые явно вызывают /v1/models, используйте https://router.flatkey.ai/v1.
Настраивает ли импорт NewAPI в один клик Flatkey автоматически?
Нет. Путь NewAPI one-click CC Switch задокументирован для страницы управления токенами New API. Для Flatkey добавьте провайдера вручную в CC Switch, если только Flatkey позже не опубликует специальную ссылку импорта ccswitch://.
Может ли CC Switch получать модели Flatkey?
Да, если настроенный ключ может получить доступ к совместимому с OpenAI списку моделей Flatkey. Проверка от 11 июня 2026 года для этой статьи вернула HTTP 200 с https://router.flatkey.ai/v1/models и ответ со списком моделей для настроенного тестового ключа.
Следует ли использовать ANTHROPIC_API_KEY или ANTHROPIC_AUTH_TOKEN?
В документации Claude Code указаны оба варианта. ANTHROPIC_API_KEY отправляется как заголовок API-ключа, а ANTHROPIC_AUTH_TOKEN отправляется через путь авторизации. Используйте один понятный способ для профиля Flatkey и не оставляйте оба значения заданными и разными.
Как понять, что настройка сработала?
Настройка сработала, когда CC Switch показывает провайдера Flatkey как активного, Claude Code использует ожидаемую модель, небольшой тестовый запрос проходит успешно, а запрос появляется в журналах использования Flatkey.
Final Check
Ваша настройка Flatkey для CC Switch Claude Code готова, когда этот чек-лист проходит:
- У CC Switch есть явно названный провайдер Flatkey под Claude Code.
- API-ключ — это ключ Flatkey из панели управления.
ANTHROPIC_BASE_URLуказывает наhttps://router.flatkey.ai.- Выбранные ID моделей — это точные ID, доступные вашему ключу.
- Получение моделей или ручной ввод модели выполняется успешно.
- Claude Code выполняет короткий тестовый запрос.
- В логах использования Flatkey отображается запрос.
Получите ключ, чтобы направлять Claude Code через Flatkey, а затем используйте CC Switch, чтобы локальный профиль провайдера было легко переключать, проверять и откатывать.
