Claude Code 데스크톱 재설계와 병렬 세션·SSH 워크스페이스

한 창에서 여러 에이전트를 운영하는 개발 환경

2025년 처음 등장한 Claude Code 데스크톱 앱은 터미널 밖의 GUI에서 Claude 에이전트를 사용할 수 있다는 데 의미가 있었다. 그러나 초기 형태는 Claude.ai 웹 인터페이스를 감싼 래퍼에 가까웠다. 실제 편집은 VS Code나 Neovim 같은 외부 도구에 맡겨야 했고, 개발자는 Claude Code와 에디터 사이를 오가며 컨텍스트를 직접 관리했다. 하나의 태스크가 끝나기를 기다리는 동안 다른 작업을 병렬로 진행하기도 어려웠다.

전면 재설계는 이 병목을 앱 구조 자체에서 다룬다. 신규 세션 사이드바를 중심으로 여러 독립 태스크를 동시에 실행하고, 파일·터미널·diff·미리보기를 같은 워크스페이스에 배치한다. Mac에서는 SSH를 통해 원격 서버나 컨테이너까지 작업 범위에 포함한다.

Anthropic의 공식 발표가 제시한 설계 원칙은 병렬성 우선(Parallelism First), 컨텍스트 자기완결(Context Self-Containment), 원격 환경 통합(Remote Environment Integration)이다. 병렬성은 하나의 앱 인스턴스에서 여러 태스크를 실행하고 관찰하는 구조를 뜻한다. 컨텍스트 자기완결은 외부 도구를 열지 않고 파일, 터미널, diff, 미리보기를 처리한다는 의미다. 원격 환경 통합은 로컬 Mac뿐 아니라 SSH로 연결한 서버와 컨테이너도 같은 작업 모델에 넣는다. 이 원칙들은 UI 컴포넌트뿐 아니라 상태 관리와 네트워크 레이어에도 반영됐다.

⤢✕

글로벌 컨텍스트를 독립 세션으로 나눈 이유

기존 앱은 전체가 하나의 Claude 대화 컨텍스트를 공유했다. 다른 태스크를 시작하려면 이전 컨텍스트를 끝내거나 창을 추가로 열어야 했다. 새 구조에서는 태스크마다 독립된 세션 컨테이너(Session Container)를 만들고, 작업 상태와 실행 환경을 분리한다.

각 세션은 자체 LLM 컨텍스트 버퍼를 사용한다. 다른 세션의 대화 기록과 섞이지 않으므로 한 세션의 토큰 소비가 다른 세션의 컨텍스트 용량에 영향을 주지 않는다. 작업 디렉터리도 세션 단위로 바인딩된다. 로컬 경로나 SSH 원격 경로를 지정하면 파일 시스템 접근 범위가 그 경로 안으로 격리된다.

환경 변수 역시 세션별 스코프를 갖는다. 서로 다른 프로젝트의 API 키와 설정값이 충돌하지 않도록 분리하는 구조다. Claude 에이전트 실행 프로세스도 세션마다 별도 서브프로세스로 운영한다. 한쪽에서 오류나 행(Hang)이 발생해도 다른 세션으로 전파되지 않는다.

이 구조를 사용자가 다루는 진입점이 세션 사이드바(Session Sidebar)다. 좌측 사이드바의 카드에는 세션 이름, 연결된 워크스페이스 경로, 실행 중·대기·완료·오류 상태와 경과 시간이 표시된다. 카드를 선택하면 다른 태스크로 바로 전환할 수 있고, 백그라운드에서 돌아가는 세션의 진행 상황도 같은 화면에서 확인할 수 있다.

이벤트 로그로 세션 상태를 복원하고 공유한다

병렬 세션이 늘어나면 태스크 큐와 상태 동기화가 복잡해진다. 재설계된 내부 상태 관리 시스템은 이벤트 소싱(Event Sourcing) 패턴을 사용한다. 파일 수정, 명령 실행, LLM 응답 수신처럼 세션에서 발생한 상태 변화는 불변(Immutable) 이벤트 로그에 순서대로 기록된다. 현재 상태는 이 로그를 투영(Projection)해 계산한다.

이벤트 로그를 재생하면 앱이나 Mac을 다시 시작한 뒤에도 세션을 복원할 수 있다. 특정 이벤트 이전으로 되돌리는 실행 취소(Undo), 특정 시점을 표시해 두는 체크포인트(Checkpoint)도 같은 구조에서 구현할 수 있다.

세션끼리 공유해야 하는 변화는 공유 이벤트 버스(Shared Event Bus)를 거친다. 세션 A가 파일을 수정했고 세션 B도 그 파일을 컨텍스트로 사용한다면, 파일 변경 이벤트가 버스로 전달된다. 세션 B는 기존 파일 컨텍스트 캐시를 무효화하고 최신 파일을 다시 읽는다.

⤢✕

포커스와 실행 상태에 따라 리소스를 배분한다

여러 세션이 동시에 움직이면 LLM API 호출, CPU, 메모리, 파일 I/O를 어느 작업에 먼저 배정할지가 문제가 된다. Claude Code는 P0, P1, P2로 구성된 우선순위 계층을 사용한다.

P0는 사용자가 현재 보고 있거나 마지막으로 상호작용한 활성 세션이다. 이 세션은 LLM API 요청에서 최저 지연(Lowest Latency) 처리를 받는다. P1은 백그라운드에서 코드를 실행하거나 파일을 수정하는 세션이다. P0 요청을 처리한 뒤 남은 리소스가 배정된다.

P2는 사용자 입력을 기다리는 유휴(Idle) 세션이다. 메모리 사용량을 줄이기 위해 이 세션의 컨텍스트 버퍼는 디스크로 스왑(Swap)될 수 있다. 이러한 계층적 배분은 M-시리즈 Mac의 통합 메모리(Unified Memory) 구조와 맞물려, 대용량 메모리를 탑재한 맥북 프로에서 10개 이상의 세션을 동시에 유지하는 사용 패턴을 지원한다.

파일을 컨텍스트로 넘기고 변경을 바로 검토한다

메인 워크스페이스는 파일, 터미널, diff, 미리보기 패널을 한 창 안에서 배치하는 구조다. 패널은 작업 흐름에 맞춰 나눌 수 있으며, Finder나 내장 파일 트리의 파일을 채팅 입력창 또는 패널 영역으로 끌어다 놓을 수 있다.

드롭한 파일은 현재 세션 컨텍스트에 추가되고, 입력창 상단에 파일명과 아이콘을 담은 컨텍스트 칩(Context Chip)으로 나타난다. 기존의 @파일명 입력보다 여러 파일을 한꺼번에 추가하기 쉽다. 디렉터리를 드롭하면 내부 파일 목록이 펼쳐지고 포함할 파일을 개별 선택할 수 있다.

Claude가 파일을 수정하면 인라인 diff가 변경 전후를 실시간으로 보여준다. 사이드 바이 사이드(Side-by-Side)와 유니파이드(Unified) 형식을 사용할 수 있으며, 개발자는 변경 청크(Hunk)마다 수락(Accept), 거절(Reject), 코멘트 추가(Comment)를 선택할 수 있다. 전체 변경을 일괄 수락하거나 거절하는 동작도 제공된다. 빠른 diff(Quick Diff)를 통해 외부 Git diff 도구로 이동하지 않고 코드 검토를 이어갈 수 있다.

⤢✕

터미널·에디터·미리보기가 같은 작업면에 놓인다

통합 터미널(Integrated Terminal)은 macOS 네이티브 Pseudoterminal(PTY) 인터페이스를 기반으로 한다. 에이전트가 셸 명령을 실행하면 표준 출력(STDOUT), 표준 오류(STDERR), 종료 코드가 터미널 패널에 실시간으로 스트리밍된다. 개발자는 패널에 직접 명령을 입력할 수 있고, 에이전트가 제안한 명령을 실행 전에 확인해 승인하거나 수정할 수도 있다.

파일 편집기는 CodeMirror 6를 렌더링 엔진으로 사용한다. 100개 이상의 언어에 대한 구문 강조(Syntax Highlighting)와 기본 LSP 연동을 지원하며, 읽기 전용 모드와 편집 모드를 오간다. Claude가 파일을 바꾸는 동안에는 읽기 전용 상태에서 diff를 표시한다. 개발자가 직접 편집하거나 에이전트의 수정을 수락하면 편집 모드로 전환된다.

에디터와 터미널은 수평 또는 수직으로 분할(Split)할 수 있고, 패널 크기는 드래그로 조절한다. 터미널 출력을 보면서 코드를 검토하거나 테스트 결과와 수정 diff를 나란히 두는 작업에 맞춘 구성이다.

확장 미리보기(Extended Preview)는 Markdown, HTML/CSS, Mermaid 다이어그램, SVG를 앱 안에서 렌더링한다. 기술 문서, README, API 사양서를 생성한 뒤 별도 앱을 열지 않고 결과를 확인하고 다시 수정할 수 있다.

Mac SSH가 원격 실행 환경을 워크스페이스로 끌어온다

Mac SSH 지원은 Claude Code의 실행 범위를 로컬 Mac 밖으로 확장한다. SSH 원격 세션을 이용하면 Linux 서버, GPU 클러스터, Docker 컨테이너 환경에서 에이전트를 직접 실행할 수 있다.

연결 과정의 UX는 VS Code Remote-SSH 익스텐션과 비슷하지만 내부 구성은 다르다. Claude Code는 SSH 연결을 만든 뒤 원격 호스트에 경량 에이전트 프록시(Agent Proxy) 바이너리를 자동 배포한다. 프록시는 로컬 앱과 WebSocket으로 통신하면서 원격 파일 시스템 접근, 프로세스 실행, 환경 변수 관리를 중개한다.

네트워크 지연은 낙관적 업데이트(Optimistic Update) 패턴으로 다룬다. 파일 수정이나 명령 실행이 원격에서 끝나기 전에 예상 결과를 UI에 먼저 표시하고, 실제 응답과 차이가 있을 때 화면을 갱신한다. 원본 설계는 이를 통해 100ms 이상의 네트워크 지연이 있는 환경에서도 UX 응답성을 유지한다.

⤢✕

Cursor의 편집 모델과 Claude Code의 관제 모델

Cursor와 Claude Code 모두 병렬 작업을 지향하지만 출발점은 다르다. Cursor는 VS Code의 멀티탭(Multi-Tab)과 멀티창(Multi-Window) 모델을 이어받는다. 프로젝트를 독립된 창에서 열고 Cursor Composer나 Bugbot을 각 창의 컨텍스트에서 실행한다. VS Code 생태계와 익숙한 IDE 사용법을 유지하면서 AI 기능을 더하는 접근이다.

Claude Code는 하나의 앱 창에서 여러 세션을 관리한다. 각 세션에는 서로 다른 프로젝트 경로, 원격 환경, 태스크를 연결할 수 있다. 사용자가 직접 코드를 편집하는 화면보다 여러 에이전트의 진행 상황을 감독하고 조율하는 에이전트 관제(Agent Control Tower)에 가깝다.

비교 항목	Cursor	Claude Code
병렬 작업 모델	멀티창·멀티탭	세션 사이드바
UX 기반	VS Code 확장	전용 앱
주요 사용 패턴	AI 보조 직접 편집	에이전트 감독·조율
원격 환경	Remote-SSH 익스텐션	내장 SSH 지원
diff 처리	인라인 accept/reject	빠른 diff + 일괄 처리

따라서 Cursor는 AI가 보조하는 개발자 에디터에 가깝고, Claude Code는 개발자가 감독하는 에이전트 오케스트레이터에 가깝다. 같은 병렬 작업이라도 어느 쪽에 무게를 두는지에 따라 적합한 작업 유형이 달라진다.

Codex 원격 박스와 Mac SSH가 나뉘는 지점

OpenAI Codex는 클라우드에 격리된 원격 박스(Remote Box)를 프로비저닝하고 그 안에서 에이전트를 실행한다. 개발자의 로컬 환경을 건드리지 않고 표준화된 클라우드 컨테이너에서 작업한 뒤 PR이나 파일 변경 결과를 전달하는 클라우드 네이티브 실행 방식이다.

Claude Code의 Mac SSH는 로컬 앱을 UI와 오케스트레이션의 중심에 둔다. 원격 환경을 따로 제공하는 대신 개발자가 이미 운영하는 온프레미스 서버, 기업 내부 네트워크, 전용 GPU 클러스터를 SSH로 연결한다. 클라우드 박스를 새로 프로비저닝하거나 실행 환경을 다시 재현할 필요가 없다는 점이 차이다.

로컬 파일과 원격 파일은 동일한 세션 사이드바에서 관리된다. 로컬·원격 혼합(Hybrid) 작업을 한 UI에서 이어갈 수 있으며, 기업 보안 정책 때문에 코드를 외부 클라우드로 올릴 수 없는 환경에서는 내부 서버에 SSH로 연결해 에이전트를 실행하는 선택지가 된다.

멀티에이전트 작업은 역할과 변경 범위를 분리한다

2026년 AI 코딩 도구의 고급 사용자 사이에서는 한 에이전트가 모든 작업을 순차 처리하는 방식보다 여러 에이전트에 서브태스크를 나눠 병렬로 실행하는 패턴이 확산되고 있다.

예를 들어 세션 A는 프론트엔드 컴포넌트를 리팩터링하고, 세션 B는 단위 테스트를 작성하며, 세션 C는 API 문서를 갱신하고, 세션 D는 스테이징 환경을 배포할 수 있다. 네 세션을 함께 실행하면 순차 처리보다 전체 완료 시간을 크게 줄일 수 있다.

시간 절약만이 채택 이유는 아니다. 세션마다 역할과 태스크를 명확히 지정하면 에이전트가 범위를 벗어나거나 다른 영역의 코드를 의도치 않게 바꾸는 사이드 이펙트를 줄일 수 있다. 세션 격리 모델은 이런 변경의 전파를 구조적으로 막는다. Claude Code의 세션 사이드바는 이 작업 패턴을 시각적이고 인터랙티브하게 다루는 UI를 제공한 사례다.

AI IDE의 중심이 편집에서 감독으로 이동한다

2026년 AI 코딩 데스크톱 앱은 에디터에 AI를 넣는 1세대 패러다임에서 에이전트를 중심으로 IDE를 다시 구성하는 2세대 패러다임으로 이동하고 있다.

에이전트는 개발자의 요청에 하나씩 응답하는 동기적 도구에서 여러 태스크를 병렬로 처리하는 비동기 시스템으로 바뀐다. 파일, 터미널, 브라우저, 미리보기, 외부 API는 하나의 앱 창에서 컨텍스트를 공유하는 방향으로 결합된다. SSH, 컨테이너, 클라우드 박스가 실행 위치를 확장하면서 로컬과 원격의 경계도 흐려진다.

개발자의 역할 역시 코드 작성자(Writer)에서 에이전트의 결과를 감독하고 검토하는 Reviewer/Supervisor로 옮겨간다. 세션 상태, 실행 결과, 변경 diff를 빠르게 확인하고 개입할 수 있는 UI가 편집 기능만큼 중요해지는 이유다.

Claude Code는 비동기 병렬 실행, 통합 컨텍스트 환경, 원격·로컬 연결, 감독 중심 UX를 이번 재설계에 함께 반영했다. 다만 Cursor는 VS Code 생태계와의 호환성을 유지하고 있고, Codex는 클라우드 네이티브 비동기 실행에서 독자적인 위치를 차지한다. 경쟁 구도는 각 도구가 강점을 가진 작업 방식에 따라 분화될 전망이다.

⤢✕

Claude Code 데스크톱 재설계는 화면을 다듬는 수준의 변화가 아니다. 세션 사이드바와 병렬 태스크, SSH 원격 연결을 묶어 Claude Code를 명령을 전달하는 도구에서 여러 에이전트를 감독하는 플랫폼으로 옮겼다. 멀티에이전트 작업이 확산될수록 세션 격리, 컨텍스트 분리, 원격 환경 통합은 AI 개발 도구를 고르는 핵심 기준으로 작용할 것이다.