시작하기

에이전트를 실행할 머신에 ccmux를 설치합니다. 설정 후 프로젝트를 생성하고 첫 번째 세션에 연결합니다.

요구사항

macOS, Linux 또는 WSL2를 통한 Windows (참조 Windows 가이드 on GitHub — 네이티브 Windows는 공개 TODO로 추적됩니다.
다음 중 하나: Homebrew(macOS / Linuxbrew), 컬 + 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 개선에 참여해 주세요

버그, 이해하기 어려운 설명, 어색한 번역을 발견하셨나요? 작은 개선도 환영합니다. 이슈를 등록하거나 풀 리퀘스트를 보내 주세요.

ccmux에 기여하기 웹사이트 또는 번역 개선하기

오류나 오래된 내용을 발견하셨나요? GitHub에서 이 페이지를 편집하세요..