claudectx CLI
CLI на Go переключает профили Claude Code одной командой: настройки, CLAUDE.md и MCP-серверы меняются разом и с бэкапом.
- 144 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Утилита перезаписывает `settings.json` и `CLAUDE.md` и может перенести в профиль ключи и переменные окружения.
Установка
- Работает в
Ручная установка
brew install foxj77/tap/claudectxПервый вариант из README для macOS и Linux, заодно ставит автодополнения. Windows и ручная установка описаны в разделе Installation.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Утилита перезаписывает `settings.json` и `CLAUDE.md` и может перенести в профиль ключи и переменные окружения.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
claudectx хранит несколько конфигураций Claude Code как профили. Команда `claudectx work` переключает активные `settings.json`, `CLAUDE.md` и список MCP-серверов за секунду. Перед сменой делается резервная копия, а при сбое профиль откатывается. Команда `claudectx -` возвращает прежний профиль, а без аргументов открывается список для выбора стрелками. Отдельная команда `claudectx run work` запускает Claude Code с профилем только для текущего терминала и не трогает глобальные настройки: можно держать рабочую и личную сессии рядом. Профили выгружаются в JSON командами `export` и `import` и годятся для обмена в команде. Подходят и разные провайдеры API: Anthropic, Bedrock, OpenRouter и свои адреса.
Для кого. Фрилансерам и консультантам, которые держат рабочий, личный и клиентские наборы настроек Claude Code.
Подходит, если
- Утром работа на корпоративном ключе, вечером личный проект, и править `settings.json` вручную надоело.
- У клиента свои инструкции в `CLAUDE.md` и свой набор MCP-серверов.
- Хочется сравнить модели разных провайдеров, не ломая основную конфигурацию.
- Команде нужен один выверенный профиль, который можно раздать файлом JSON.
Не подходит, если
- Нужно разделить входы в учетную запись: авторизация не привязана к профилю.
- Профиль должен сузить разрешения: списки `allow` и `deny` при `run` объединяются с глобальными.
- Агент не Claude Code: утилита знает только его файлы.
Пример запроса к агенту
Создай профиль `client-acme` из текущих настроек, затем запусти Claude Code с ним в этом терминале через `claudectx run`.Ограничения
Вход в аккаунт не привязан к профилю: `claudectx run` использует тот логин Claude Code, который активен сейчас. В режиме `run` скалярные настройки профиля (модель, переменные, режим разрешений) перекрывают глобальные, но списки `allow` и `deny` объединяются, и профиль не сузит уже выданные разрешения. `CLAUDE.md` профиля добавляется к системному запросу, а глобальный `~/.claude/CLAUDE.md` остается активным. Глобальные MCP-серверы из `~/.claude.json` в такой сессии отключаются.
Как отключить. Удалите утилиту: `brew uninstall claudectx` или файл бинарного файла из `PATH`. Текущие `settings.json` и `CLAUDE.md` останутся активными, профили и резервные копии удалите вручную.
Частые вопросы
Чем `switch` отличается от `run`?
`claudectx work` меняет глобальные файлы Claude Code на все терминалы. `claudectx run work` применяет профиль только к одному запуску и ничего глобального не трогает.
Как передать флаги Claude?
Добавьте их после `--`: `claudectx run work -- --model opus`. Команду без запуска покажет `claudectx run work --dry-run`.
Можно ли поделиться профилем?
Да. `claudectx export work work-profile.json` выгружает профиль, а `claudectx import work-profile.json client-new` загружает его под другим именем. Ключи проверьте до отправки файла.
Есть ли проверка профиля?
Команда `claudectx health` валидирует настройки текущего профиля и сообщает о проблемах.
Что входит в профиль?
Настройки `settings.json`, инструкции `CLAUDE.md` и MCP-серверы. Профиль создается из текущих настроек командой `claudectx -n work`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCCS
CCS - Claude Codex Switch
CLI для переключения Claude Code между аккаунтами, провайдерами и локальными моделями без правки конфигов
CLI устанавливает инструкции Claude Code для проекта, заранее показывает изменения файлов и позволяет отменить установку.
Рабочие процессы для Claude Code: команды /do, /omo, /bmad-pilot и другие, а код пишут Codex, Gemini или OpenCode через codeagent-wrapper
Десктопное приложение для переключения провайдеров и управления MCP, промптами и скиллами Claude Code, Codex, Gemini CLI и других агентов
Среда для Claude Code, которая держит контекст между сессиями через хуки, леджеры и передачи, оркеструет агентов и экономит токены
Bridle хранит профили настроек Claude Code, OpenCode, Goose, Amp и Copilot CLI и ставит скиллы и MCP из GitHub в нужные папки.
Коротко о README
В Homebrew ставятся автодополнения оболочки. Бинарные файлы выпускаются для macOS, Linux и Windows на странице Releases.