티스토리 뷰

카테고리 없음

CMUX 터미널 (워크스페이스, 내장 브라우저, 컨텍스트 공유)

.NOMA 2026. 8. 20. 16:47

목차


    ai안경을 쓰고 코드를 보고. 있는 여성

     

     

    솔직히 말하면, 저도 처음엔 "터미널이 다 거기서 거기지"라고 생각했습니다. 그런데 AI 코딩 에이전트 전용으로 설계된 CMUX를 접하고 나서 생각이 바뀌었습니다. 출시된 지 얼마 되지 않았는데도 GitHub 스타가 6,800개를 넘어섰다는 건, 단순한 유행이 아니라 실제로 개발자들이 느끼는 불편함을 건드린 도구라는 의미로 읽혔습니다. AI 시대에는 어떤 모델을 쓰느냐만큼, AI가 일하기 좋은 환경을 어떻게 만드느냐가 생산성을 가르는 기준이 될 수 있습니다.



    워크스페이스 단위 관리, 왜 이게 필요한가

    개발할 때 창을 몇 개나 띄워두는지 세어본 적 있으신가요. 제 경우엔 보통 다섯 개를 넘겼습니다. 프론트엔드 개발 서버 하나, 빌드 터미널 하나, Git 작업 터미널 하나, 그리고 Claude Code 세션까지. 거기에 로그 확인용 창까지 따로 열다 보면, 정작 코드보다 창 전환에 집중력이 더 쓰이는 상황이 반복됐습니다.

    CMUX는 이 문제를 워크스페이스(Workspace) 단위로 풉니다. 여기서 워크스페이스란 서로 다른 프로젝트나 역할을 물리적으로 분리된 공간에 담아두는 개념입니다. 예를 들어 프론트엔드 워크스페이스에는 개발 서버와 빌드 탭을, 백엔드 워크스페이스에는 API 서버와 DB 로그 탭을 각각 배치할 수 있습니다. 프로젝트마다 이름을 지정하고, 전환은 사이드바에서 클릭 한 번이면 됩니다.

    각 워크스페이스 안에서는 다시 탭(서페이스)과 페인(Pane)으로 세분화됩니다. 페인이란 하나의 탭을 가로 또는 세로로 분할해서 여러 터미널 창을 동시에 보이게 하는 기능으로, 흔히 화면 분할이라고도 부릅니다. Claude Code 세션 여러 개를 동시에 돌리는 멀티 에이전트 환경에서 이 구조가 특히 쓸모 있습니다.

    기존 터미널인 iTerm, Ghostty, Warp도 탭과 분할 화면을 지원하지만, AI 에이전트 작업에 특화된 알림이나 세션 간 컨텍스트 공유 같은 기능은 없습니다. CMUX가 그 빈자리를 채우는 구조입니다.

    • 워크스페이스: 프로젝트·역할별로 독립된 작업 영역 분리
    • 서페이스(탭): 워크스페이스 안에서의 개별 작업 공간
    • 페인: 탭을 분할해 여러 터미널을 한 화면에 배치
    • AI 에이전트 작업 완료 시 상단 알림 탭과 반짝이는 탭 표시
    요약: CMUX의 워크스페이스·서페이스·페인 3단 구조는 여러 AI 에이전트 세션을 동시에 돌리는 개발 환경에서 창 전환 피로를 실질적으로 줄여줍니다.

     

    터미널 안에 브라우저가 들어오다

    제가 직접 써봤는데, 내장 브라우저 기능은 처음에 예상보다 훨씬 실용적이었습니다. CMUX는 터미널 안에서 크로미움(Chromium) 기반의 브라우저를 직접 띄울 수 있습니다. 크로미움이란 구글 크롬의 오픈소스 버전으로, 실제 웹 표준을 그대로 구현한 렌더링 엔진입니다. 이 내장 브라우저는 버셀(Vercel)의 에이전트 브라우저를 기반으로 만들어졌습니다(출처: Vercel 공식 블로그).

    단순히 페이지를 보는 것에서 그치지 않고, 개발자 도구까지 함께 사용할 수 있습니다. 즉, 터미널을 벗어나지 않고도 UI 디버깅, 네트워크 요청 확인, 콘솔 로그 확인이 가능합니다. 저는 평소에 이 작업들을 위해 브라우저와 터미널을 계속 오갔는데, 그 전환 동선 자체가 없어지는 경험이었습니다.

    더 흥미로운 부분은 AI 에이전트가 이 브라우저를 직접 제어할 수 있다는 점입니다. Claude Code에게 특정 페이지에 접속해서 정보를 수집하거나, 자바스크립트를 주입하거나, 스냅샷을 찍는 작업을 요청하면 CMUX가 새 서페이스에 브라우저를 열고 자동으로 처리합니다. 브라우저 자동화(Browser Automation)란 코드나 에이전트가 사람 대신 브라우저를 조작해 반복 작업을 처리하는 방식을 말합니다. 보통 Playwright나 Puppeteer 같은 별도 도구를 설치해야 하는 작업인데, CMUX에서는 별도 설치 없이 기본 탑재된 기능으로 처리됩니다.

    제 경험상 이 기능이 빛나는 순간은, 개발 중에 발생한 화면 오류를 AI에게 직접 확인시키고 수정까지 연결할 때입니다. 캡처해서 붙여넣고 설명하는 과정이 사라지고, 에이전트가 직접 보고 판단하게 됩니다.

    요약: CMUX의 내장 크로미움 브라우저는 단순 뷰어가 아니라 AI 에이전트가 직접 제어할 수 있는 자동화 도구로, 별도 설치 없이 브라우저 자동화 작업을 터미널 안에서 완결할 수 있습니다.

     

    세션 간 컨텍스트 공유, 복사·붙여넣기의 종말

    여러 AI 세션을 동시에 운영할 때 가장 번거로웠던 것은 정보 전달이었습니다. 백엔드 서버에서 에러 로그가 터지면, 그걸 직접 복사해서 프론트엔드 AI 세션에 붙여넣고, "이 로그를 참고해서 원인을 찾아줘"라고 다시 설명해야 했습니다. 매번 반복되는 이 과정이 생각보다 집중력을 많이 갉아먹었습니다.

    CMUX는 이 문제를 세션 간 컨텍스트 공유(Cross-Session Context Sharing) 기능으로 해결합니다. 여기서 컨텍스트 공유란 한 AI 세션이 다른 터미널 세션의 화면 내용이나 로그를 직접 읽어와 활용하는 것을 말합니다. cmux read screen 명령어가 그 핵심입니다. 예를 들어 "백엔드 워크스페이스의 로그 터미널을 읽어서 에러 원인을 분석하고 수정해 줘"라고 요청하면, Claude Code가 CMUX 명령어를 통해 해당 화면을 직접 읽고 작업을 이어갑니다.

    cmux tree 명령어도 실용적입니다. 이 명령어는 현재 열려 있는 워크스페이스, 서페이스, 페인의 전체 구조를 트리 형태로 시각화해서 보여줍니다. 에이전트가 현재 환경의 구조를 파악할 때 이 명령어 하나로 충분합니다. 이처럼 CMUX는 CLI(Command-Line Interface, 즉 명령줄 기반으로 컴퓨터를 조작하는 방식)로 거의 모든 기능을 제어할 수 있도록 API 레퍼런스를 제공합니다(출처: CMUX GitHub 공식 저장소).

    이 기능에서 제가 가장 가능성을 느끼는 부분은 단일 에이전트 한계를 넘어서는 방식입니다. 지금까지는 Claude Code 하나가 전체 컨텍스트를 쥐고 있어야 했는데, CMUX를 활용하면 역할별로 분리된 에이전트들이 서로 정보를 주고받으며 협업하는 구조를 만들 수 있습니다. 물론 아직 초기 버전이라 세션 복원(프로세스 유지) 기능이 없고, 현재는 macOS에서만 사용 가능하다는 점은 분명한 한계입니다. TMUX처럼 터미널을 재시작해도 세션이 살아있는 안정성을 기대한다면 아직 이른 감이 있습니다.

    요약: CMUX의 cmux read screen 명령어를 활용하면 여러 AI 에이전트 세션이 서로의 터미널 정보를 직접 읽어 컨텍스트를 공유할 수 있어, 반복적인 복사·붙여넣기 없이 멀티 에이전트 협업이 가능합니다.

     

    자주 묻는 질문

    Q. CMUX는 TMUX랑 뭐가 다른가요?

    A. 기본 개념은 TMUX의 세션·윈도우·페인 구조를 참고해서 만들어졌습니다. 다만 TMUX는 명령어 기반으로만 조작해야 해서 초기 학습 곡선이 높은 반면, CMUX는 사이드바 UI로 워크스페이스를 직관적으로 관리할 수 있습니다. 결정적 차이는 AI 에이전트 알림, 내장 브라우저, 세션 간 컨텍스트 공유 같은 AI 특화 기능이 CMUX에만 있다는 점입니다. 단, 세션 복원(프로세스 유지)은 TMUX만 지원합니다.

     

    Q. CMUX가 Windows에서도 되나요?

    A. 현재는 macOS에서만 사용 가능합니다. Windows 지원은 아직 제공되지 않습니다. macOS 사용자라면 GitHub에서 오픈소스로 설치할 수 있으며, 출시 초기인 만큼 향후 지원 범위가 확장될 가능성은 있지만 공식 발표 전까지는 확정된 내용이 아닙니다.

     

    Q. Claude Code 말고 다른 AI 에이전트도 CMUX에서 쓸 수 있나요?

    A. 네, Claude Code 외에도 OpenAI Codex에서도 작업 완료 알림 기능이 확인되었습니다. CMUX 자체가 특정 AI 에이전트에 종속된 구조가 아니라, CLI 명령어 기반으로 동작하기 때문에 터미널에서 실행되는 에이전트라면 대부분 함께 활용할 수 있습니다. 커스텀 명령어를 통해 자신만의 알림 시스템을 구성하는 것도 가능합니다.

     

    Q. CMUX 내장 브라우저로 실제 개발자 도구도 쓸 수 있나요?

    A. 가능합니다. 내장 브라우저는 크로미움 엔진을 기반으로 하기 때문에 개발자 도구(DevTools)도 그대로 사용할 수 있습니다. 콘솔 확인, 네트워크 탭, 요소 검사 등 일반 브라우저와 동일한 디버깅 환경을 터미널 안에서 쓸 수 있어, 별도로 브라우저를 전환할 필요가 없습니다.

     

    결론

    CMUX를 살펴보면서 드는 생각은, 앞으로의 개발 생산성 경쟁이 AI 모델 선택보다 AI 작업 환경 설계에서 갈릴 수 있다는 것입니다. 어떤 모델을 쓰느냐보다, 여러 에이전트 세션을 얼마나 자연스럽게 연결하고 관리하느냐가 실제 속도를 좌우하게 될 것 같습니다. CMUX는 그 방향을 구체적으로 보여주는 도구라고 생각합니다.

    다만 저는 당장 TMUX를 완전히 대체할 생각은 없습니다. 세션 복원 기능이 없는 현재 상태에서는 안정적인 장기 세션 유지가 필요한 작업에는 여전히 TMUX가 더 낫습니다. 제 계획은 AI 에이전트 중심 작업에는 CMUX를, 서버 접속이나 장시간 프로세스 유지가 필요한 작업에는 TMUX를 병행하는 방식입니다. 새 도구를 무조건 받아들이기보다, 내 개발 방식에서 반복적으로 불편했던 지점을 해결해주는지를 먼저 따지는 것이 맞다고 봅니다.

    참고: https://www.youtube.com/watch?v=jGj9yCqN08s