Claude Code 데스크톱 앱: 2026 완벽 가이드 (Chat, Cowork, Code)

- 이 글의 버전 요구 사항, 요금제 요건, 플랫폼 제약은 작성 시점(2026-08-20)의 공식 문서와 대조 확인했어요. Desktop 기능은 빠르게 업데이트되니, 정확한 메뉴 경로에 의존하기 전에 최신 공식 문서를 확인하세요.

Claude Code Desktop App이란? (Chat vs Cowork vs Code)

짧게 말하면, 이것은 네이티브 앱(웹 래퍼가 아니에요)으로, 세 개의 독립된 탭이 있고 각각 다른 용도로 만들어졌어요. "Desktop이냐 CLI냐"를 고를 필요가 없어요. Desktop은 이미 알고 계실지 모를 터미널 기반 Claude Code 위에 얹힌 또 하나의 인터페이스일 뿐이에요.

세 탭은 하나의 계정과 하나의 앱을 공유하지만, 실행 모델은 각각 달라요: Chat은 파일을 전혀 건드리지 않고, Cowork는 격리된 VM 안에서 실행되며, Code는 Claude Code가 실제로 여러분의 컴퓨터에서 코드를 읽고 편집하는 곳이에요 - CLI에서 이미 알고 있는 것과 같은 방식이되, 사이드바와 탭, 그리고 터미널 로그를 스크롤하는 대신 시각적 diff가 더해졌을 뿐이에요.

왜 하나의 채팅 창이 아니라 세 개의 탭으로 나눌까요? 이 세 가지 일이 서로 다른 위험을 안고 있기 때문이에요: Q&A는 파일 쓰기 권한이 필요 없고, 수십 분씩 실행되는 백그라운드 에이전트가 디스크에서 곧바로 읽어서는 안 되며, 코드 편집은 그 반대여서 실제 파일을 건드릴 수 있어야만 도움이 돼요. 탭을 나누면, 그 특정 채팅에 어떤 권한을 줬는지 기억할 필요 없이, 어느 탭에 있는지만 봐도 세션의 모드를 알 수 있어요.

Desktop 앱 설치 - macOS, Windows, Linux(베타), WSL

Desktop은 Pro, Max, Team 또는 Enterprise 요금제가 필요해요(Free에서는 사용 불가). 기능별 요금제 제한은 바뀔 수 있으니, 설치 전에 현재 요금제를 확인하세요.

놓치기 쉬운 세부 사항 몇 가지: Windows는 Git for Windows가 미리 설치돼 있어야 하고(설치 프로그램에 포함돼 있지 않아요), Linux 베타에서는 Computer Use와 음성 받아쓰기 같은 "있으면 좋은" 기능 묶음이 아직 없어요 - 아직 베타이니 macOS/Windows와 완전히 같은 수준을 기대하지 마세요. WSL에서는 Claude Code가 정말로 여러분의 Linux 배포판 안에서 실행되므로(경로가 /home/user/project처럼 되고 C:\Users\...가 아니에요), git 훅, 권한, 심볼릭 링크가 모두 진짜 Linux처럼 동작해요 - 그 대신 통합 파일 브라우저 같은 일부 UI 편의 기능을 잠시 잃게 돼요.

고를 수 있다면, 지금 어느 플랫폼이 가장 매끄러울까요? 대부분의 독자에게 macOS와 Windows가 완전한 기능을 갖춘 두 개의 안정 빌드예요 - 트레이드오프 없이 바로 사용할 수 있어요. Linux는 아직 베타이니, Computer Use나 받아쓰기가 필요하다면 CLI에 머물거나 안정 릴리스를 기다리세요. WSL은 이미 Windows에서 Linux 배포판 안에서 작업하고 있고, 익숙한 경로와 도구에서 Desktop이 여러분을 떼어놓지 않길 바랄 때 알맞아요 - 다만 위에서 언급한 UI 편의 기능이 빠지는 점은 감수해야 해요.

Code 탭에서 첫 세션 시작하기

설정 흐름은 간단해요: 환경 선택(Local/Cloud/SSH/WSL) → 프로젝트 폴더 선택 → 모델 선택 → 권한 모드 선택 → 작업 입력 → diff 리뷰. 어느 단계도 터미널 명령을 입력할 필요가 없어요.

권한 모드는 에이전트가 무언가를 승인받기 전에 스스로 얼마나 많은 일을 할 수 있는지를 결정해요:

• Manual - 모든 파일 변경과 모든 명령마다 승인을 요청해요.
• Accept edits - 파일 편집은 자동 적용하고, 위험한 셸 명령 전에는 여전히 확인해요.
• Plan - 읽고 계획만 하며, 계획을 승인하기 전에는 파일을 변경하지 않아요.
• Auto - 작업 대부분을 연속으로 실행하고, 위험이 더 큰 동작에서만 멈춰요.
• Bypass - 거의 모든 확인을 건너뛰며, CLI의 --dangerously-skip-permissions에 해당해요 - 정말 조심해서 사용하세요.

CLI에서 넘어온 분이라면 좋은 습관: 익숙하지 않은 저장소에서 처음 실행할 때는 Plan을 고르고, 에이전트가 제안한 계획을 꼼꼼히 읽은 뒤, 신뢰가 생기면 Accept edits나 Auto로 올리세요.

네 가지 환경 옵션은 단지 이름만 다른 게 아니라, 코드가 실제로 어디서 실행되는지를 결정해요. Local은 여러분의 컴퓨터에서 실행되며 실제 파일을 읽고 써요. Cloud는 Anthropic이 호스팅하는 샌드박스 안에서 실행되며, 컴퓨터 성능이 낮거나 직접 쓰기 권한을 아직 주고 싶지 않을 때 유용해요. SSH는 여러분이 관리하는 원격 컴퓨터(개발용 머신, 내부 서버)에 연결해 거기서 에이전트를 실행해요. WSL은 Windows에서 Linux 배포판 안에서 실행되며, 설치 섹션에서 다룬 그대로예요. 잘못된 환경을 고르는 것이, 볼 수 있다고 생각한 파일을 에이전트가 "찾지 못하는" 가장 흔한 원인이에요 - 첫 디버깅 단계는 실제로 어느 환경에서 실행 중인지 확인하는 거예요.

병렬 세션과 Git 워크트리 격리

바로 이 지점에서 Desktop이 터미널 탭을 손으로 저글링하는 것보다 확실히 앞서요: 사이드바의 각 세션 탭은 자동으로 자체 Git 워크트리에서 실행되며, 기본값은 <project-root>/.claude/worktrees/예요(위치와 브랜치 접두사는 바꿀 수 있어요). 즉, 두 세션이 서로 방해하지 않고 같은 저장소에서 동시에 작업할 수 있고, 각자 자기 브랜치와 작업 디렉터리를 가져요.

세션 간 이동: Ctrl+Tab으로 사이드바 탭을 순환하고, Ctrl/Cmd를 누른 채 클릭하면 분할 보기가 열려 두 세션을 나란히 볼 수 있어요. 모든 워크트리가 봐야 하는 gitignore 대상 파일(샘플 .env.local, 개발용 인증서)이 있다면, .worktreeinclude에 선언해 두면 손으로 복사하는 대신 새 워크트리마다 자동으로 복사돼요.

실용적인 예: 같은 저장소 안에 독립적인 두 가지 일이 있다고 해요 - API 버그 수정과, 무관한 기능의 테스트 작성이에요. 순차로 하는 대신 세션 탭 두 개를 열고, 각각 자기 워크트리와 브랜치를 갖게 한 뒤, 여러분이 다른 일을 하는 동안 둘 다 병렬로 돌려요. 둘 다 끝나면 각 diff를 따로 리뷰하고 하나씩 병합하면 돼요 - 두 에이전트가 작업 디렉터리를 공유하는 일이 절대 없으므로, 서로의 파일을 밟을 위험이 없어요.

시각적 diff 리뷰와 PR 모니터링

모든 변경은 세션 탭에 +12 -1 같은 diff 통계 표시로 바로 나타나며, 채팅으로 다시 입력하는 대신 코드 위에서 직접 답하고 싶을 때는 인라인 라인 코멘트를 쓸 수 있어요.

"Review code" 버튼은 자동 리뷰를 한 번 실행하지만, 컴파일 오류·로직 버그·보안 구멍 같은 신호가 강한 문제만 짚어내고 스타일이나 lint 같은 사소한 지적은 하지 않아요(잡음이 적어요). GitHub를 쓴다면, Desktop에는 CI용 자동 수정과 자동 병합 토글도 있어요: 에이전트가 실패한 CI 실행을 고치고 초록불이 되면 병합해요. 다만 이는 로컬에 gh CLI가 인증돼 있을 때만 동작하고, 병합은 항상 스쿼시 병합이에요(머지 커밋이나 리베이스 옵션은 없어요).

이렇게 나누는 것의 장점: 무엇이 중요한지 찾으려고 diff 전체를 다시 읽을 필요가 없어요 - "Review code"가 이미 신호가 강한 문제를 걸러 주고, 스타일과 서식은 늘 그렇듯 lint/CI에 맡겨져요. GitHub에서 PR을 리뷰하는 데 익숙하다면 느낌이 비슷해요 - 다만 에이전트가 아직 실행 중일 때, 실제 PR이 열리기도 전에 리뷰하므로, CI가 결과를 알려줄 때까지 기다리는 것보다 훨씬 일찍 문제를 잡아요.

예약 작업 vs. Cloud Routines vs. /loop

바로 이 부분이 사람들을 가장 헷갈리게 하는데, Claude Code에는 이제 하나가 아니라 세 가지 서로 다른 예약 방식이 있기 때문이에요:

짧게 말하면: 컴퓨터가 꺼져 있거나 앱이 닫혀 있을 때 무언가를 실행해야 한다면 Cloud Routines를 고르세요(트레이드오프는 로컬 파일 접근이 없고 최소 간격이 훨씬 성기다는 점 - 1분이 아니라 약 1시간이에요). 로컬 파일을 짧은 간격으로 읽거나 쓰는 작업이 필요하다면 Desktop 예약 작업이나 CLI의 /loop를 쓰세요 - 다만 둘 다 컴퓨터가 켜져 깨어 있을 때만 실행돼요. 실행 예정 순간에 컴퓨터가 잠들어 있었다면, Desktop에는 따라잡기 메커니즘이 있어요: 깨어날 때 놓친 실행을 정확히 한 번만 실행해요(놓친 모든 실행을 쌓아 두었다가 실행하지 않아요). 클라우드 쪽에 대한 자세한 내용은 Claude Code Routines 설명을 참고하세요.

어느 방식이 어느 일에 맞을까요: "매일 아침 오래된 의존성을 확인하고 업데이트 PR을 연다" 같은 작업은 Cloud Routines에 맞아요 - 여러분의 컴퓨터가 전혀 필요 없어요. "코딩하는 동안 파일이 바뀔 때마다 테스트 스위트를 다시 실행한다" 같은 작업은 CLI의 /loop나 Desktop 작업에 맞아요 - 로컬 파일을 짧은 간격으로 반복해서 읽어야 하고, 어차피 여러분은 이미 컴퓨터 앞에 있으니까요.

iOS 시뮬레이터 창(macOS 전용, 베타)

iOS 앱을 만든다면, Desktop에는 코딩 세션 바로 옆에 iOS 시뮬레이터를 보여 주는 창이 있어요 - 별도의 시뮬레이터 창으로 전환하는 대신, 에이전트가 직접 UI 결과를 실행하고 살펴보게 할 수 있어 유용해요. 알아 둘 만한 제약 몇 가지: macOS 전용, Xcode 26.x 필요(Xcode 27은 Device Hub 변경 때문에 현재 동작하지 않아요), 로컬 세션만(Cloud/SSH 불가), 세션당 최대 4개 기기, 그리고 각 기기는 에이전트가 제어하기 전에 각자 동의가 필요해요. 미리 알아 둘 점 하나: 시뮬레이터의 스크린샷은 일반 보존 정책에 따라 Anthropic으로 전송돼요 - 테스트 앱이 화면에 민감한 데이터를 표시한다면, 이 창을 켜기 전에 그 점을 따져 보세요.

이 창이 베타인데도 중요한 이유: 여러분이 빌드하고, 시뮬레이터를 열고, 버그를 스크린샷으로 찍어 에이전트에게 설명하는 대신, 이제 에이전트가 UI 결과를 직접 보고 여러분이 중간 다리 역할을 하지 않아도 "수정-빌드-확인" 루프를 돌 수 있어요. 그 대신 아직 초기 기능이니, 가끔 창이 다시 시작되거나 위에서 말한 Xcode 버전 제약이 있으리라 예상하세요.

Dispatch에서 온 세션 - 휴대폰에서 작업 시작하기

Dispatch는 지속되는 Cowork 탭 대화예요: 휴대폰(모바일 Claude 앱이나 웹)에서 작업을 메시지로 보내면, 내용이 개발성 작업처럼 보일 경우 Desktop에서 Dispatch 태그가 붙은 Code 탭 세션으로 자동 라우팅돼요 - 끝났을 때나 여러분의 승인이 필요할 때 푸시 알림을 받아요. 알아 둘 제약 몇 가지: Dispatch는 Pro/Max 요금제에서만 되고 Team/Enterprise에서는 아직 안 되며, Dispatch로 생성된 세션에서 준 권한 승인은 30분 후에 만료돼요(승인이 세션 내내 유지되는 일반 세션과 달라요).

실용적인 예: 책상에서 떨어져 있는데 CI가 실패했다는 푸시 알림을 받고, 휴대폰에서 "빌드 실패를 고치고, 테스트를 다시 실행한 다음, PR을 열어 줘"라고 입력해요 - Dispatch가 이를 개발성 작업으로 인식하고, Dispatch 태그가 붙은 Code 탭 세션을 띄워요. 여러분이 컴퓨터로 돌아올 즈음이면 그 세션은 이미 실행 중이고, 처음부터 시작하는 대신 권한을 승인하거나 결과를 리뷰해 주기를 기다리고 있어요.

Desktop vs. CLI vs. Web - 무엇을 써야 할까?

같은 Claude Code의 세 가지 인터페이스로, 설정(CLAUDE.md, MCP, 훅, 스킬, 각종 설정)을 공유해요 - 그래서 이들 사이를 오가도 아무 비용이 들지 않고, 그저 다르게 상호작용하는 방식일 뿐이에요:

일부 CLI 명령은 Desktop으로 직접 "번역"돼요: 세션 드롭다운에서 모델을 고르는 것은 --model 플래그에 해당하고, 사이드바에서 예전 세션 탭을 다시 클릭하는 것은 이전 세션을 이어 가는 --resume에 해당하며, Desktop의 Bypass 모드는 CLI의 --dangerously-skip-permissions와 정확히 같아요. 기억해 둘 만한 차이 하나: CLI에는 Desktop에 아직 없는 dontAsk 모드가 추가로 있어요 - 워크플로가 그것에 의존한다면, 그 부분은 CLI에 머무르세요.

솔직히 말하면: Claude Code를 CI 파이프라인이나 자동화 스크립트에서 실행해야 하거나 --print/Agent SDK가 필요하다면 Desktop은 자리가 아니에요 - 그건 여전히 CLI의 영역이에요. 설치 없이 브라우저에서 빠르게 접근하고 싶다면 Claude Code on the web을 쓰세요. 매일 코딩하고 UI가 있는 병렬 세션과 눈에 편한 diff를 원한다면, Desktop이 가장 편한 선택이에요. 작은 편의 하나: CLI의 /desktop 명령은 실행 중인 세션을 곧바로 Desktop 앱으로 옮겨요(현재 macOS와 Windows x64만, 구독 로그인 필요 - API 키와는 호환되지 않아요).

Desktop Code 탭에서 AgentKit 사용하기

자주 나오는 질문: CLI에서 AgentKit으로 설치한 스킬이나 킷이 Desktop에서도 동작할까요? Desktop 자체 문서에 따르면, 앱은 CLI와 같은 ~/.claude 설정(스킬, 설정, MCP)을 읽어요 - 그러니 이론상 AgentKit이 설치한 스킬도 같은 방식으로 나타나, CLI에서 $ak: 형태의 명령을 입력하듯 프롬프트 상자에서 /로 호출할 수 있어야 해요. 정확히 말하면, 이는 Desktop이 "설정 공유"를 설명한 내용에서 추론한 것이지, AgentKit 자체 문서가 Desktop Code 탭에 대해 직접 확인해 준 것은 아니에요 - 이 점이 워크플로에 중요하다면, 실제 작업에 의존하기 전에 여러분의 컴퓨터에서 직접 테스트하세요. AgentKit이 실제로 무엇을 하고 그만한 가치가 있는지 알아보려면 AgentKit 리뷰(agentkit.best)를 읽어 보세요.

자주 묻는 질문(FAQ)

Claude Code Desktop은 무료인가요?

아니요, Free 요금제에서는 안 돼요. Code 탭은 Pro, Max, Team 또는 Enterprise가 필요하고, Dispatch는 특히 Pro/Max에서만 되며 아직 Team/Enterprise에서는 안 돼요. 이 조건은 바뀔 수 있으니, 설치 전에 현재 요금제의 기능 제한을 확인하세요.

CLI를 따로 설치해야 하나요?

일상적인 코딩에는 아니에요 - Desktop은 Code 탭을 통해 완전한 Claude Code를 실행해요. 하지만 스크립팅, CI 사용, --print, 또는 Agent SDK가 필요하다면 그것들은 CLI 전용이라 Desktop에는 없어요.

Claude Code Desktop은 Linux에서 되나요?

네, 다만 아직 베타예요: Ubuntu 22.04+와 Debian 12+만 지원되고, x86_64/arm64 아키텍처만이며, Computer Use와 음성 받아쓰기 같은 기능은 macOS/Windows처럼 아직 없어요.

Desktop과 Claude Code on the web의 차이는 무엇인가요?

Web(claude.ai/code)은 전적으로 클라우드에서 실행되어 여러분 컴퓨터의 로컬 파일을 전혀 건드리지 않고, 설치할 것이 없어요. Desktop은 네이티브 앱으로 여러분 컴퓨터의 파일을 직접 읽고 편집하며, 병렬 세션과 시각적 diff 리뷰를 제공해요 - 트레이드오프는 설치가 필요하고 컴퓨터를 계속 켜 둬야 한다는 점이에요.

Claude Code Desktop을 WSL과 함께 쓸 수 있나요?

네, Windows에서요: 세션은 정말로 WSL2 배포판 안에서 네이티브 Linux 경로로 실행되며, 배포판 안에 git이 설치돼 있어야 해요. 통합 터미널, 커넥터, 플러그인, @멘션 같은 일부 UI 기능은 작성 시점 기준 WSL 모드에서는 사용할 수 없어요.

컴퓨터가 꺼져 있어도 예약 작업이 실행되나요?

Desktop 예약 작업과 CLI /loop는 안 돼요 - 둘 다 컴퓨터가 켜져 깨어 있어야 해요. 실행 예정일 때 잠들어 있었다면, Desktop은 깨어날 때 놓친 실행을 정확히 한 번 따라잡아요. 컴퓨터 상태와 상관없이 무언가를 실행해야 한다면, 대신 Cloud Routines를 쓰세요(트레이드오프: 로컬 파일 접근이 없고 최소 간격이 더 성겨요, 약 1시간).

결론

Desktop은 다른 Claude Code가 아니에요 - 병렬 작업, 시각적 diff, 그리고 터미널 없는 예약을 위해 GUI를 위에 얹은 같은 Claude Code예요. 여러분의 플랫폼에 맞게 올바르게 설치하고(Windows는 Git for Windows를 잊지 말고, Linux 베타는 아직 몇몇 기능이 빠져 있음을 잊지 마세요), 시작할 때 알맞은 권한 모드를 고르고, 알맞은 일에 알맞은 인터페이스를 쓰세요 - 매일의 시각적 코딩에는 Desktop, 스크립트와 CI에는 CLI, 설치 없이 빠른 접근에는 Web이에요. CLI 쪽을 더 깊이 알고 싶다면 what is Claude Code를 참고하세요.