Codex CLI и CC Switch через Ofox: настройка с двумя протоколами
CC Switch настраивает Codex CLI и Claude Code для работы через Ofox из одного места. Им нужны разные base URL и форматы API — перепутать их — самая частая причина сбоя.
Codex CLI и Claude Code говорят на разных протоколах. CC Switch держит обе записи рядом, и это главная причина им пользоваться: вставить base URL от Claude Code во вкладку Codex или наоборот — ошибка, которую вручную допустить очень легко.
Два клиента, два протокола
| Codex CLI | Claude Code | |
|---|---|---|
| Протокол | OpenAI-совместимый | Нативный Anthropic |
| Base URL Ofox | https://api.ofox.io/v1 | https://api.ofox.io/anthropic |
| Формат API в CC Switch | OpenAI Compatible | Anthropic Messages (Native) |
| Поле авторизации | не применяется | ANTHROPIC_AUTH_TOKEN (Default) |
| Вкладка CC Switch | Codex | (страница управления провайдерами) |
Ни один URL не принимает завершающий слэш, и один ключ Ofox работает для обоих клиентов. Учтите, что таблица описывает клиент, а не модель: любая модель Claude в каталоге Ofox, включая Fable 5.1, принимает любой из двух протоколов.
Установка CC Switch
# macOS
brew install --cask cc-switch
# Debian / Ubuntu — download the .deb from Releases first
sudo dpkg -i <downloaded-file>.deb
# Fedora / RHEL
sudo rpm -i <downloaded-file>.rpm
# AppImage
chmod +x <downloaded-file>.AppImage && ./<downloaded-file>.AppImage
Для Windows есть установщик .msi, а для macOS на странице релизов лежит .dmg, если не хочется пользоваться Homebrew. Полное руководство по установке — в гайде по настройке CC Switch. Минимальные поддерживаемые версии: macOS 12, Windows 10 и Ubuntu 22.04 / Debian 11 / Fedora 34.
Добавляем провайдера для Codex CLI
Переключитесь на вкладку Codex сверху и нажмите кнопку + в правом верхнем углу.
| Поле | Значение |
|---|---|
| Provider Name | ofoxai-codex |
| Website URL | https://ofox.io |
| API Key | ваш ключ Ofox |
| Request URL | https://api.ofox.io/v1 |
| API Format | OpenAI Compatible |
| Write to Global Config | включено |
Если оставить «Write to Global Config» включённым, провайдер применится ко всем проектам, а не только к текущему. Добавьте провайдера и активируйте его в списке.
Добавляем провайдера для Claude Code
Тот же инструмент, но другая страница и другие значения.
| Поле | Значение |
|---|---|
| Provider Name | ofoxai-claude |
| Website URL | https://ofox.io |
| API Key | ваш ключ Ofox |
| Request URL | https://api.ofox.io/anthropic |
| API Format / Auth Field | Anthropic Messages (Native) / ANTHROPIC_AUTH_TOKEN (Default) |
| Model Configuration | оставить пустым |
| Write to Global Config | включено |
Оставьте Model Configuration пустым. Тогда используется модель Claude по умолчанию — это то, что вам нужно, если вы не закрепляете конкретную модель намеренно. Результат CC Switch записывает в ~/.claude/settings.json.
На этой странице есть два необязательных переключателя: «Hide AI Signature» и «Teammates Mode». Ни один из них не влияет на маршрутизацию или тарификацию.
Включаем запрос статистики
CC Switch умеет опрашивать Ofox о расходе и показывать цифры на своей панели. Нужно настроить четыре вещи: включить Enable Usage Query, вставить тот же API-ключ Ofox, указать эндпоинт запроса https://api.ofox.io/v1 и выбрать вариант Universal Template (通用模板), который документация Ofox рекомендует для наилучшей совместимости.
Два момента, о которых стоит знать:
- Он не расходует квоту API — используется отдельный API статистики, а не ваш бюджет вызовов.
- Цифры отстают от породивших их вызовов на несколько минут.
Если позже выключить эту функцию, обычные вызовы API не пострадают.
Конкретно про Fable 5.1
Fable 5.1 появился в каталоге Ofox 3 сентября 2026 года как anthropic/claude-fable-5.1. Ничего из описанного выше для него не меняется: те же два base URL, те же два формата API, тот же ключ. Единственное отличие — строка модели.
Эту настройку стоит сделать независимо от того, на какой модели вы остановитесь: она даёт рабочий путь с двумя протоколами, где смена модели сводится к замене строки. Помимо Fable 5.1, в каталоге есть anthropic/claude-fable-5, anthropic/claude-opus-5 и anthropic/claude-sonnet-5 по прейскурантным ценам Anthropic без наценки, и все четыре доступны по обоим протоколам с одним ключом.
Для Fable 5.1 это особенно важно, потому что единственное изменение его цены — чтение кэша, с $1 до $0.25. Принесёт ли оно вам хоть что-то, целиком зависит от доли попаданий в кэш, а выяснить её можно, прогнав реальную нагрузку через эту настройку и сняв цифру со своей статистики расхода. Таблица ставок и арифметика TTL — в справочнике по API.
Когда не подключается
Три типичные причины:
- Завершающий слэш в Request URL. Документация Ofox отдельно предупреждает об этом для обоих провайдеров.
- Неверный формат API для вкладки. Codex CLI с выбранным «Anthropic Messages (Native)» работать не будет, как и обратный вариант. Сначала проверяйте поле формата, потом ключ.
- Строка модели, которой нет в каталоге. Учтите, что идентификатор Fable 5.1 в Ofox —
anthropic/claude-fable-5.1, с точкой, а не с дефисом, хотя алиасanthropic/claude-fable-5-1тоже резолвится. Последнее слово за живым каталогом:GET /v1/modelsвозвращает ровно то, что можно вызвать.
Целевые платформы установки CC Switch, значения полей провайдеров, base URL и поведение запроса статистики сверены с документацией Ofox по интеграции 3 сентября 2026 года. Содержимое каталога проверено по живому эндпоинту /v1/models в тот же день.
Часто задаваемые вопросы
- Что такое CC Switch?
- Опенсорсный менеджер провайдеров с графическим интерфейсом. Он записывает конфигурационные файлы для Claude Code и Codex CLI, так что править JSON или переменные окружения вручную не нужно. Для Claude Code он пишет ~/.claude/settings.json. Работает на macOS 12+, Windows 10+ и Ubuntu 22.04+ / Debian 11+ / Fedora 34+.
- Codex CLI и Claude Code используют один и тот же base URL Ofox?
- Нет — и именно здесь настройка обычно ломается. Codex CLI — клиент протокола OpenAI, ему нужен https://api.ofox.io/v1 с форматом API OpenAI Compatible. Claude Code — клиент протокола Anthropic, ему нужен https://api.ofox.io/anthropic с форматом Anthropic Messages (Native). Ни один из URL не принимает завершающий слэш.
- Можно ли запускать Claude Fable 5.1 через эту настройку?
- Да, по состоянию на 3 сентября 2026 года. Fable 5.1 есть в каталоге Ofox как anthropic/claude-fable-5.1. В настройке ниже для него ничего не меняется — те же base URL, те же форматы API, тот же ключ. Отличается только строка модели.
- Расходует ли запрос статистики в CC Switch квоту API?
- Нет. Согласно документации Ofox по интеграции, он использует отдельный API статистики и не учитывается в лимитах вызовов. Цифры расхода обычно появляются в течение нескольких минут после вызовов, которые их породили.
- Можно ли держать в CC Switch несколько аккаунтов Ofox?
- Да. Можно добавить несколько записей провайдера Ofox с разными API-ключами и переключаться между ними из списка.


