EZCode 데스크톱 창에서 등록된 프로젝트 목록과 여러 개의 세션 탭이 열려 있는 메인 작업 화면

2026년 10월 17일

클로드 CLI 터미널 명령어가 답답할 때 EZCode로 Claude Code 세션과 작업창 한 번에 관리하기

검은 콘솔 창에서 Claude Code CLI를 실행할 때마다 매번 프로젝트 경로로 cd 이동하고 긴 명령어를 치는 과정은 작업 흐름을 끊기 마련입니다. 지난 대화를 이어가기 위해 세션 ID를 따로 메모해 두거나, 새로운 작업을 병렬로 돌리기 위해 터미널 창을 여러 개 띄우다 보면 화면이 어지럽혀지기 쉽습니다.

이런 비효율을 없애기 위해 만들어진 도구가 바로 Windows 데스크톱 기반의 Claude Code CLI 관리 프로그램인 EZCode입니다. 프로젝트 폴더를 마우스 드래그나 탐색기 클릭 한 번으로 등록해 두고, 웹 브라우저처럼 상단 탭을 열어 독립된 Claude 세션을 자유자재로 전환할 수 있습니다.

과거에 나눴던 대화 기록도 세션 목록 카드에서 클릭 한 번으로 바로 복원되며, 권한 승인 모드도 작업 성격에 맞게 즉시 전환할 수 있습니다. 번거로운 CLI 환경에서 벗어나 쾌적한 탭 기반 환경을 구축하는 실전 절차를 자세하게 살펴보겠습니다.

터미널 창이 늘어날수록 작업 효율이 떨어지는 이유와 EZCode 구조

Claude Code CLI는 터미널 가상 환경 안에서 강력하게 동작하지만, 작업 대상 폴더가 늘어날수록 관리 비용이 급격하게 증가합니다. 다른 프로젝트로 이동할 때마다 콘솔 창을 새로 띄워 경로를 찾아 들어가야 하고, 이전 대화 맥락을 복구하려면 --resume <세션ID> 형태의 난해한 식별자를 직접 입력해야 하기 때문입니다.

EZCode는 사용자 PC에 설치된 claude CLI를 Windows 가상 터미널(ConPTY) 기술로 백그라운드에서 구동하고, 이를 3열 인터페이스로 감싸 완벽한 대시보드 형태로 제공합니다. 좌측 1열의 프로젝트 목록, 2열의 세션 기록 아카이브, 3열의 멀티 탭 및 터미널 화면이 유기적으로 연동되어 번거로운 명령어 입력 과정을 생략해 줍니다.

또한 백엔드 서버가 로컬 포트(8000, 18000 등)를 자동으로 감지하여 브라우저 컴포넌트와 통신하므로, 복잡한 네트워크 설정 없이 데스크톱 앱 실행 한 번으로 모든 준비가 완료됩니다.

작업 시작 전 준비해야 할 필수 프로그램과 환경 요건

EZCode는 독자적인 AI 엔진을 내장한 프로그램이 아니라, 사용자 PC의 가상 터미널(ConPTY) 안에서 실행되는 Claude Code CLI(claude 명령)를 GUI 화면으로 제어할 수 있게 연결해 주는 데스크톱 관리 프로그램 입니다. 따라서 프로그램을 오류 없이 원활하게 구동하려면 작업 시작 전 다음 항목들을 반드시 확인해야 합니다.

Claude Code CLI 자동 설치: Windows 환경에서 claude 명령어가 정상 실행되어야 세션이 시작됩니다. 별도로 수동 설치할 필요 없이 EZCode 설치 마법사를 진행할 때 Claude Code CLI가 자동으로 함께 설치되므로 간편하게 준비를 마칠 수 있습니다.
Claude 데스크톱 앱 설치 및 별도 로그인 진행: 상태줄을 통해 전달되는 5시간/주간 구독 사용량과 토큰 정보를 EZCode 상단 배지 및 모달에서 확인하려면 Claude 데스크톱 앱이 PC에 설치되어 있고 로그인된 상태여야 합니다. 단, 데스크톱 앱에 로그인되어 있더라도 CLI 세션 인증은 별개이므로 EZCode 내 터미널 환경에서도 계정 로그인을 따로 완료해야 실제 대화와 사용량 연동이 정상 작동합니다.
Windows 운영체제 전용: ConPTY(pywinpty), PowerShell, cmd.exe, 작업 폴더 대화상자 등 Windows 시스템 리소스를 직접 호출하도록 설계되어 있어 Windows OS 환경에서만 구동됩니다
로컬 통신 포트 자동 확보: 로컬 백엔드 서버 구동을 위해 127.0.0.1의 5개 후보 포트(8000, 18000, 18765, 28765, 38765) 중 하나를 사용합니다. 앱 실행 시 점유되지 않은 첫 번째 빈 포트를 스스로 탐색해 자동으로 바인딩하므로 사용자가 포트를 수동으로 맞출 필요가 없습니다.

프로젝트 등록부터 멀티 세션 탭 병렬 실행까지 상세 방법

1단계: 프로젝트 폴더 등록하고 메인 목록에 추가하기

작업할 코드 저장소나 폴더를 EZCode의 좌측 1열 프로젝트 패널에 등록합니다. 좌측 상단의 탐색기 버튼을 누르면 네이티브 폴더 선택 창이 열리며 원하는 작업 경로를 선택할 수 있습니다. 또는 윈도우 파일 탐색기에서 작업 폴더를 EZCode 창 위로 직접 끌어다 놓아도 즉시 등록됩니다.

등록된 경로는 %APPDATA%\EZCode\projects.json에 저장되어 프로그램을 재시작해도 그대로 유지됩니다. 폴더 우측의 별표 아이콘을 누르면 즐겨찾기로 고정되어 목록 상단에 배치되며, 마우스 드래그를 통해 작업 우선순위에 맞춰 자유롭게 순서를 변경할 수 있습니다.

EZCode 좌측 프로젝트 패널에서 작업 폴더를 등록하고 목록에 추가하는 화면

2단계: 프로젝트 선택 후 상단 세션 탭 생성하기

1열에서 원하는 프로젝트를 클릭하면 해당 작업 공간이 열립니다. 이미 활성화된 세션이 있다면 최근 탭으로 전환되며, 처음 여는 프로젝트라면 자동으로 새 탭이 생성됩니다. 상단 탭 바 우측의 + 새 세션 시작 버튼을 누르거나 단축키 Ctrl+T를 누르면 동일한 프로젝트 내에서 새로운 세션 탭이 추가됩니다.

각 탭은 독립된 가상 터미널 프로세스(cmd.exe 기반)를 생성하여 Claude를 실행하므로, 하나의 프로젝트 안에서도 '기능 개발'과 '테스트 코드 작성' 같은 서로 다른 작업을 병렬로 동시에 진행할 수 있습니다. 탭 전환은 마우스 클릭이나 Ctrl+Tab, Alt+1~9 단축키로 빠르게 이동 가능합니다.

EZCode 상단 탭 바에서 여러 개의 독립된 세션 탭을 열어 관리하는 화면

3단계: 작업 성격에 맞게 4단계 권한 모드 설정하기

Claude가 파일 수정이나 터미널 명령어 실행을 요청할 때 매번 승인 과정을 거칠지 여부를 작업 상황에 맞게 변경할 수 있습니다. 화면 하단 상태 표시줄의 모드 토글 버튼을 누르거나 Ctrl+Shift+M을 누를 때마다 4가지 권한 모드가 순환 전환됩니다.

자동 (--dangerously-skip-permissions): 모든 실행 권한 요청을 묻지 않고 건너뛰어 완전 자동화 작업에 적합합니다.
수동 (기본값): 명령어 실행이나 파일 변경 시마다 사용자에게 승인 여부를 확인합니다.
계획 (--permission-mode plan): 코드 실행 전 단계별 계획 수립에 집중합니다.
편집허용 (--permission-mode acceptEdits): 파일 편집 권한은 자동으로 수용하고 주요 시스템 명령만 승인을 요구합니다.

모드를 변경하면 실행 중인 세션을 동일한 대화 맥락(--resume) 그대로 유지한 채 새 권한 플래그로 자동 재시작합니다.

주의: 자동 모드는 사용자 확인 없이 시스템 명령어나 파일 수정을 즉시 수행하므로, 안전이 검증된 신뢰할 수 있는 프로젝트 폴더에서만 사용해야 합니다.

EZCode 하단 바에서 자동, 수동, 계획, 편집허용 권한 모드를 전환하는 화면

4단계: 좌측 2열 기록 카드에서 이전 세션 대화 복원하기

작업 도중 이전 대화로 돌아가고 싶다면 좌측 2열의 세션 기록 패널을 확인합니다. Claude Code가 ~/.claude/ 경로에 기록한 대화 파일들을 자동으로 수집하여 최근 수정 시간 순서대로 카드 형태로 보여줍니다.

각 카드에는 세션 식별자 앞 8자리, 상대적 경과 시간, 첫 프롬프트 요약 문구, 주고받은 메시지 건수가 표시됩니다. 복원하려는 세션 카드를 클릭하면 현재 빈 탭이 있을 경우 해당 탭에서 즉시 이어받고, 작업 중인 탭이 있다면 새 탭을 열어 과거 대화를 그대로 복원합니다. 대화 제목 더블 클릭을 통한 이름 변경과 불필요한 세션 파일 삭제도 마우스 조작으로 가능합니다.

EZCode 세션 목록 패널에서 이전 대화 카드를 선택해 세션을 복원하는 화면

정상 연결 상태 점검과 프로세스 종료 시 확인사항

새로운 탭이 생성되면 상단 헤더에 WebSocket 연결 상태가 초록색의 "실시간 연결됨"으로 표시되는지 확인합니다. 세션 내부에서 Claude가 백그라운드 작업을 수행 중일 때는 탭 좌측의 상태 표시 점이 주황색으로 깜빡이며, 질문 승인을 대기하는 상태가 되면 빨간색으로 깜빡여 현재 진행 상황을 한눈에 알 수 있습니다.

작업이 진행 중인 상태에서 탭의 닫기(X) 버튼을 누르면 "이 세션은 작업 중입니다. 탭을 닫으면 Claude 프로세스가 종료됩니다."라는 확인 대화상자가 표시됩니다. 작업을 중단하고 세션을 완전히 종료하려면 확인을 눌러 가상 PTY 프로세스를 깨끗하게 정리할 수 있습니다.

사용 중 자주 겪는 궁금증과 문제 해결

Q. 프로젝트 목록에서 프로젝트를 삭제하면 실제 PC의 폴더와 소스코드도 함께 지워지나요?

A. 아닙니다. 1열 프로젝트 패널에서 휴지통 버튼을 눌러 삭제하더라도 EZCode의 등록 목록(projects.json)에서만 제외될 뿐이며, 실제 로컬 드라이브의 원본 폴더와 파일은 안전하게 보존됩니다.

Q. 세션 기록 카드에서 대화를 삭제하면 복구가 가능한가요?

A. 복구할 수 없습니다. 세션 삭제 기능은 ~/.claude/projects/ 경로 내의 실제 대화 기록 파일(.jsonl)을 완전히 삭제하므로 중요한 대화 내역은 사전에 내보내기 기능으로 백업해 두어야 합니다.

Q. 폴더를 드래그해서 창에 놓았는데 프로젝트로 등록되지 않고 파일 첨부로 들어갑니다.

A. EZCode의 드래그&드롭 판별 로직은 이름 끝자리에 점(.)이 포함되어 있는지 여부로 파일과 디렉터리를 구분합니다. 만약 폴더 이름에 my.project처럼 마침표가 포함되어 있다면 파일로 오인할 수 있으므로 상단의 탐색기 버튼을 통해 직접 선택해야 합니다.