Начало работы
Установите ccmux на компьютер, на котором будут работать ваши агенты. После настройки создайте проект и прикрепите его к первому сеансу.
Требования
- macOS, Linux или Windows через WSL2 (см. Руководство по Windows на GitHub — родной Windows отслеживается как открытое TODO)
- Один из: Homebrew (macOS / Linuxbrew), curl + оболочка POSIX или Go 1.26+ для пути из исходного кода.
tmuxиgit. Homebrew устанавливает зависимости времени выполнения; сценарий загрузки устанавливает только двоичные файлы ccmux. Бегиccmux setupдля проверки зависимостей или используйтеmake bootstrapпри сборке из исходного кода.
Установить
Выберите сценарий загрузки или Homebrew. Используйте исходную сборку, если хотите разработать сам ccmux.
Скачать скрипт
curl -fsSL https://ccmux.ai/install | sh
ccmux setup
Скрипт устанавливает последние версии двоичных файлов в ~/.local/bin/. Добавьте этот каталог в PATH вашей оболочки, если установщик предложит вам это сделать. Вы можете проверьте сценарий установки перед его запуском.
Мастер установки проверяет зависимости, помогает настроить CLI вашего агента и устанавливает фоновый демон. Прежде чем начать сеанс, войдите в систему выбранного агента. Для удаленного доступа также подключите свои устройства к Tailscale.
Homebrew
brew trust --tap skzv/tap
brew install skzv/tap/ccmux
ccmux setup
Доверяйте крану один раз для каждой машины. Homebrew устанавливает ccmux и его упакованные зависимости, включая tmux, Mosh и ripgrep.
Альтернатива: из источника
mkdir -p ~/Projects && cd ~/Projects
git clone https://github.com/skzv/ccmux.git
cd ccmux && make bootstrap
make bootstrap проверяет вашу цепочку сборки и предлагает установить все недостающее, а затем включается в цепочку make setup. Используйте это, если хотите отслеживать main или взломать сам ccmux.
Вы можете позже повторно запустить мастер настройки, чтобы просмотреть конфигурацию.
Первый запуск
ccmux
TUI запускается с первым туром. Пресса ? на любом экране для полной раскладки клавиш.
Привязки клавиш
| Ключ | Действие |
|---|---|
1–7 |
Переключение экранов (сеансы, проекты, разговоры, заметки, агенты, настройки, сеть) |
Enter |
Прикрепить к выбранному сеансу |
? |
Контекстная справка |
T |
Повторный запуск первого тура |
j / k или ↑ / ↓ |
Навигация по спискам |
x |
Уничтожить выбранный сеанс |
Ваш первый проект
В TUI: нажмите 2 для проектов, затем n , чтобы открыть форму нового проекта. Введите имя, выберите агента (Claude / Codex / Antigravity / Cursor / pi / Grok) и нажмите Enter. ccmux создает каталог под projects.root и немедленно запускает сеанс агента.
Из оболочки:
ccmux new my-app
Создает каталог и загружает сеанс с агентом по умолчанию. TUI автоматически открывается на главном экране, где вы можете прикрепить его с помощью Enter.
См. Учебное пособие 1 для полного прохождения.
Следующие шаги
- Управление несколькими сеансами и отсоединиться, не останавливая агента.
- Подключайтесь с телефона или добавить еще одну машину.
- Подключите клиент MCP для проверки сеансов вашего агента.
- Если установка не удалась, запустите
ccmux doctorи следуйте инструкциям руководство по техническому обслуживанию.
Помогите улучшить ccmux
Нашли ошибку, непонятную инструкцию или неудачный перевод? Мы рады любым улучшениям. Создайте issue или отправьте pull request.
Обнаружили ошибку или что-то устарело? Отредактируйте эту страницу на GitHub..