Anthropic는 이번 달 Claude Code의 데스크톱 프리뷰를 공개했습니다 — 터미널에서 수행하던 Anthropic의 에이전트 기반 코딩 워크플로를 그래픽 환경으로 가져오며, 여러 개의 격리된 코딩 세션을 병렬로 실행할 수 있는 내장 지원을 제공합니다. 이 데스크톱 프리뷰는 Claude Code의 웹 및 모바일 버전과 나란히 사용할 수 있도록 설계되었고, 두 가지 실용적인 개발자 문제에 초점을 맞춥니다: 동일한 저장소에서 여러 AI 에이전트를 서로 간섭 없이 실행하는 것, 그리고 하나의 GUI에서 로컬 또는 클라우드 세션을 더 쉽게 시작하는 것.
데스크톱에서의 Claude Code란?
Claude Code on Desktop은 개발자가 CLI만이 아니라 GUI를 사용하여 Claude Code 세션을 로컬 또는 Anthropic의 보안 클라우드 인프라에서 실행할 수 있게 하는 네이티브(프리뷰) 데스크톱 애플리케이션입니다. Claude Code의 핵심 에이전트 기반 코딩 기능을 데스크톱 편의성(세션 관리, 로컬 환경 통합, 웹 세션 원클릭 실행)과 결합합니다. 이 앱은 Claude Code의 CLI 및 웹 제품의 동반자로 명확히 포지셔닝되어 있으며, 안정적인 Claude Code 런타임을 번들로 제공하고 버전을 관리해 일관되고 안정적인 경험을 보장합니다.
왜 이것이 중요할까요? 역사적으로 AI 코딩 도구는 터미널(CLI 워크플로에 익숙한 개발자) 또는 클라우드(브라우저 UI) 중 하나에서만 동작했습니다. 데스크톱 앱은 로컬 실행의 저지연을 제공하고, 격리된 클라우드 컴퓨트 또는 엔터프라이즈 제어가 필요할 때 Anthropic 호스팅(웹) 세션으로 매끄럽게 전환할 수 있게 하여 그 간극을 메웁니다. 특히 이 데스크톱 프리뷰는 다중 세션 병렬 처리를 지원한다는 점이 주목할 만합니다 — 동일한 저장소에서 여러 개의 독립적인 Claude Code 에이전트를 동시에 실행할 수 있으며, 각 에이전트는 자체 Git 워크트리(격리된 브랜치 작업 공간)에서 동작하므로 서로 충돌하지 않습니다. 많은 팀이 즉시 유용하다고 느낄 헤드라인 기능입니다.
데스크톱 에디션은 웹 및 CLI 버전과 어떤 관계인가요?
Claude Code는 명령줄 도구로 시작해 이후 웹 및 모바일 인터페이스로 확장되었습니다. 데스크톱 프리뷰는 이러한 기반 위에 구축되었습니다. 데스크톱 앱은 세션 실행, 저장소 연결, 진행 상황 조회 등 웹에서 제공되는 많은 기능을 반영하면서도, 로컬 워크플로 인체공학—데스크톱 UX, 네이티브 설치, Git 워크트리를 통한 로컬 저장소와의 더 긴밀한 통합—에 초점을 맞춰 세션들이 서로의 파일 상태에 간섭하지 않고 동시에 실행될 수 있게 합니다.
참고: Claude Code Web: 무엇이며 어떻게 사용하는가
데스크톱용 Claude Code의 7가지 뛰어난 기능
1) 다중 세션 병렬 처리
데스크톱용 Claude Code는 동시에 여러 개의 독립적인 Claude 세션을 실행할 수 있습니다. 즉, 한 세션은 버그 수정에, 다른 세션은 테스트 작성에, 또 다른 세션은 문서 생성에 집중하게 하여—단일 세션에서 대기하지 않고—모두 동시에 실행할 수 있습니다. 이 병렬 처리는 워크플로를 가속화하고 서로 다른 작업을 병렬로 위임할 수 있게 합니다.
예를 들어:
my-app이라는 프로젝트가 있고 다음을 원한다고 가정해 보세요:
- 한 창에서는 Claude가 홈페이지를 변경하고;
- 다른 창에서는 Claude가 데이터베이스 로직을 최적화하도록 합니다.
Claude Desktop은 자동으로 다음을 생성합니다:
~/.claude-worktrees/my-app/homepage/
~/.claude-worktrees/my-app/database/
충돌 없는 두 개의 독립된 복사본입니다. 이는 동시에 두 개의 브랜치를 개발하는 것과 같으며, Claude가 각 작업을 처리합니다.
2. .worktreeinclude: 무시된 파일을 Claude가 인지하도록 하기
때때로 프로젝트에는 .env 또는 .local 같은 파일이 있습니다. 이러한 파일은 일반적으로 .gitignore에 의해 무시되며 Claude 작업 디렉터리로 복사되지 않습니다. .gitignore에 나열된 파일은 새 워크트리로 자동 복사되지 않습니다. Claude는 새로운 메커니즘을 제공합니다: 프로젝트 루트 디렉터리에 .worktreeinclude 파일을 만들어 어떤 파일을 복사해야 하는지 지정할 수 있습니다 — 새로 생성된 워크트리에 복사해야 할 무시된 파일을 지정하는 .gitignore 스타일 목록(예: 로컬 .env 파일 또는 개발자별 설정). .worktreeinclude와 .gitignore에 모두 나타나는 파일만 복사되므로, 추적 중인 파일을 실수로 중복하는 일을 방지합니다. 이는 각 세션의 비밀 또는 환경 파일을 Git에 커밋하지 않고 보존하는 데 중요합니다.
예시:
.env
.env.local
.env.production
**/.claude/settings.local.json
이는 다음을 의미합니다: Claude가 작업 디렉터리를 생성할 때 이 파일들도 함께 복사됩니다.
참고:
- .gitignore와 .worktreeinclude에 모두 존재하는 파일만 복사됩니다;
- 중요한 추적 파일을 실수로 복사하지 않도록 주의하세요.
3) 웹/클라우드 세션 실행 및 동기화
데스크톱 앱은 웹/클라우드 세션의 런처 역할을 할 수 있습니다 — 즉, 데스크톱 UI에서 클라우드 기반 Claude Code 세션을 시작하고 로컬에서 모니터링하거나 조정할 수 있습니다. 로컬 제어의 편의성과 클라우드 호스팅 실행의 확장성 또는 권한 모델을 결합하고 싶을 때 유용합니다.
참고:
- 클라우드에서 실행할 때 Claude의 작업은 Anthropic 보안 서버에서 수행됩니다.
- 로컬과 클라우드 환경 간 전환은 매끄럽습니다.
- 세션을 만들려면 "remote environment"를 선택하면 됩니다.
4) 웹/클라우드 세션 실행 및 동기화
데스크톱 앱은 웹/클라우드 세션의 런처 역할을 할 수 있습니다 — 즉, 데스크톱 UI에서 클라우드 기반 Claude Code 세션을 시작하고 로컬에서 모니터링하거나 조정할 수 있습니다. 이 하이브리드 모드는 로컬의 편의성과 클라우드 호스팅 실행의 확장성/권한 모델을 함께 활용하려는 경우 유용합니다(간단한 작업은 로컬로, 위험하거나 리소스 집약적인 작업은 클라우드로).
5) 번들 버전과 엔터프라이즈 구성
데스크톱에는 첫 실행 시 다운로드되고 자동으로 관리되는 안정적인 Claude Code 런타임이 번들로 포함됩니다. 엔터프라이즈 관리자들은 필요 시 로컬 Claude Code 사용을 비활성화할 수 있습니다(isClaudeCodeForDesktopEnabled 엔터프라이즈 정책). 데스크톱 설치 프로그램은 일반적인 엔터프라이즈 배포 형식(MSIX for Windows, PKG for macOS)을 지원하며, 관리자는 업데이트와 확장 액세스를 제어할 수 있습니다. 이러한 제어는 대규모 팀의 도입을 더 쉽게 만들도록 설계되었습니다.
참고:
- 애플리케이션은 처음 열 때 자동으로 다운로드됩니다;
- 데스크톱 애플리케이션은 버전 업데이트를 자동 관리합니다;
- 시스템을 깔끔하게 유지하기 위해 오래된 버전을 자동으로 정리합니다;
- 컴퓨터에 CLI 버전이 설치되어 있더라도 더 높은 안정성을 위해 자체 버전을 사용합니다;
- 데스크톱 버전은 안정성과 호환성을 우선시합니다; CLI(명령줄 버전)는 더 빠르게 업데이트될 수 있지만 새로운 기능이 데스크톱 버전에 즉시 동기화되지 않을 수 있습니다.
6) 사용자 지정 환경 변수
Claude Desktop은 .env 파일처럼 변수를 설정할 수 있습니다.
이 변수들은 Claude 세션 내에서만 적용되며, 프로젝트 구성에 이상적입니다.
예시:
API_KEY=abcd123
DEBUG=true
CERT="-----BEGIN CERT-----
MIIE...
-----END CERT-----"
7) 로컬 도구 및 환경과의 통합
로컬 세션을 실행할 때 데스크톱 앱은 셸 $PATH를 추출하여 세션 프로세스가 터미널에서 사용하는 동일한 node, npm, yarn, Python 또는 기타 CLI 도구를 사용할 수 있게 합니다. 또한 .env 형식의 사용자 지정 환경 변수를 추가할 수 있는 UI를 제공하며, 값은 보안을 위해 마스킹됩니다. 이를 통해 에이전트 세션 내에서 테스트나 빌드를 실행할 때 에이전트가 터미널과 동일한 툴체인을 호출할 수 있어 더 매끄럽게 동작합니다.
Claude Code를 데스크톱에 어떻게 설치하나요?
이 섹션은 최소한의 마찰로 설치 과정을 안내합니다. 아래 지침은 데스크톱 프리뷰에 대해 최신이며 정식 설치 프로그램을 안내합니다.
사전 준비 및 계정 설정
- Anthropic 계정과 워크스페이스: Claude Code는 Anthropic Console과 연계됩니다. Claude Console에서 OAuth 플로우를 완료하고, Anthropic의 워크스페이스 모델에서 요구하는 활성 결제 또는 연구 프리뷰 액세스가 필요합니다. Claude Code는 사용량 추적을 위해 콘솔에서 내부 워크스페이스를 사용합니다; 해당 워크스페이스에 대한 API 키는 생성할 수 없습니다 — Claude Code 사용을 위해 관리됩니다.
- Git 및 저장소 준비 상태: Git이 설치되어 있고 작업하려는 프로젝트가 Git 저장소인지(또는 Git을 초기화했는지) 확인하세요. 데스크톱 앱은 워크트리 같은 기능을 위해 유효한 저장소를 기대합니다; Git이 초기화되지 않은 폴더를 열면 워크트리가 생성되지 않습니다.
- OS별 사항: macOS와 Linux 설치는 일반적으로 네이티브 바이너리입니다; Windows 사용자는 많은 워크플로에서 전체 명령 호환성을 위해 WSL 사용을 권장합니다. PATH 또는 배포 관련 문제가 있는 경우 커뮤니티 가이드에서 고급 Windows/WSL 설정을 다루기도 합니다.
단계별 설치(요약)
- Claude 다운로드 페이지를 열고 플랫폼에 맞는 설치 프로그램을 선택합니다.
- 설치 프로그램을 실행합니다(macOS는 PKG, Windows는 MSIX 또는 EXE). 엔터프라이즈 배포의 경우 중앙 배포를 위한 MSIX/PKG 패키지를 사용하세요.
- Claude Desktop 앱을 실행하고 Anthropic/Claude 계정으로 로그인합니다. 대화와 기본 설정은 데스크톱, 웹, 모바일 전반에 동기화됩니다.
- 첫 실행 시 번들 Claude Code 런타임이 다운로드됩니다. 다운로드가 완료되도록 허용하세요; 안정적이고 관리되는 버전을 사용하기 위해 필수입니다.
설치 후 점검
• Settings > Environments를 열어 데스크톱 앱이 셸 $PATH를 추출했는지 확인합니다.
• 로컬 세션을 활성화할지(컴퓨터와 정책이 허용하는 경우) 또는 워크플로가 대신 웹 세션을 만들지 선택합니다.
선택 가능한 설치 방식
- 네이티브 설치 프로그램(권장): 가장 간단하고 통합된 경험을 위해 네이티브 OS 설치 프로그램을 사용하세요.
- Homebrew(macOS): Homebrew로 앱을 관리하는 macOS 사용자에게 편리합니다.
- NPM 또는 스크립트 기반 설치 프로그램: 더 자동화되거나 스크립트화된 설정(CI 또는 프로비저닝) 또는 간단한 설치 스크립트를 선호하는 Linux 배포판에 유용합니다.
설치: macOS, Linux, WSL(권장 흐름)
- Claude Code 다운로드 페이지에서 데스크톱 프리뷰 설치 프로그램을 다운로드합니다(제품 내 문서에 설치 프로그램 링크가 제공됩니다).
- 설치 프로그램을 실행하고 Claude 데스크톱 앱을 엽니다.
- 앱 내 Claude Console 플로우를 통해 OAuth 로그인 절차를 완료합니다.
- 데스크톱 설정에서 기본 워크트리 위치와 로컬/리모트 실행 기본값을 구성합니다.
- UI에서 프로젝트 폴더를 열거나 저장소를 클론하여 시작합니다.
터미널을 열고, 출처를 신뢰할 수 있다면 Anthropic에서 제공하는 설치 스크립트를 실행하세요(일반적으로 권장되는 편의 옵션). 예시(의역):
# macOS / Linux / WSL (example convenience installer)
curl -fsSL https://claude.ai/install.sh | bash
또는 macOS에서 Homebrew를 선호한다면:
brew install --cask claude-code
설치: Windows
WSL：
- WSL(Ubuntu가 일반적)을 설치하고 깔끔한 WSL 환경을 설정합니다. 데스크톱 앱의 WSL 통합이 배포판에 액세스할 수 있도록 PATH 및 상호 운용성 문제를 해결하세요.
- 로컬 실행에 Claude가 필요로 할 수 있는 Git 및 각종 언어 런타임(node, python 등)을 WSL에 설치합니다.
- Windows에서 데스크톱 앱을 설치하거나 실행하고, WSL 프로젝트 디렉터리를 지정(또는 지원되는 경우 WSL 내부에서 데스크톱 앱을 실행)한 다음 동일한 OAuth 플로우를 진행하세요.
PowerShell 예시(의역):
# PowerShell (example convenience installer)
irm https://claude.ai/install.ps1 | iex
CMD 예시(의역):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
일상적으로 데스크톱에서 Claude Code를 어떻게 사용하나요?
권장 세션 생성 패턴은 무엇인가요?
짧은 독립 작업 vs 장기 리팩터링
- 짧고 범위가 명확한 작업(버그 수정, 단일 파일 변경, 소규모 리팩터링)의 경우, 작업당 하나의 세션을 생성하고 Claude가 집중된 커밋을 만들도록 하세요. 신속히 리뷰하고 머지합니다.
- 장기 작업(대규모 리팩터링, 기능 개발)의 경우, 자주 체크포인트를 만들고 데스크톱 UI의 진행 제어를 사용해 작업을 조정하거나 일시 중지하는 세션을 고려하세요. 세션은 기능 브랜치에서 유지해 실수로 병합되는 일을 피하세요.
저장소에 CLAUDE.md 또는 프롬프트 템플릿을 유지해 세션을 어떻게 프롬프트해야 하는지(컨텍스트, 실행할 테스트, 스타일 규칙)를 표준화하세요. 이 관행은 변동성을 줄이고 Claude가 세션 전반에 일관된 결과를 생성하도록 돕습니다. 많은 팀이 표준 프롬프트나 가드레일을 저장소 메타데이터에 보관해 예측 가능한 에이전트 동작을 보장합니다.
세션 실행 및 이름 지정
- 데스크톱 앱을 열고 저장소를 선택하거나 클론합니다.
- “New Session”(또는 동등한 버튼)을 클릭하고
bugfix/cs-142또는add-tests-login같은 설명적인 이름을 지정합니다. 이름 지정은 UI에서 동시 세션을 구분하는 데 도움이 됩니다. - 로컬 또는 리모트 실행 모드를 선택하고, 대상 브랜치를 지정(또는 에이전트가 새 워크트리에서 브랜치를 생성하게 함)한 뒤 세션을 시작합니다. 앱은 세션을 위한 전용 Git 워크트리를 자동으로 생성합니다.
에이전트 조정: 프롬프트와 작업
- 명확하고 범위가 제한된 프롬프트를 사용하세요. 예: “
AuthService의 실패하는 단위 테스트를 찾아 기존 공개 API를 유지하면서 수정안을 만들고, 테스트를 실행해 결과를 보고해 주세요.” - 점진적 작업의 경우 Claude에게 먼저 계획(짧은 체크리스트)을 생성하도록 요청한 다음, 구체적인 코드 변경을 단계별로 요청하세요. 점진적 진행은 환각 위험을 줄이고 diff를 리뷰하기 쉽게 만듭니다. Anthropic은 모범 사례로 이 접근을 권장합니다.
진행 상황 보기 및 상호작용
데스크톱 UI는 에이전트가 작업하는 동안 액션 로그와 diff를 표시합니다. 세션을 일시 중지하거나 지시사항을 변경하거나 실행 중인 작업을 취소할 수 있습니다. 에이전트가 수정안을 제안하면 UI는 파일 diff와 변경 사항 설명을 제공합니다. 제안된 diff를 커밋 전에 승인, 편집 또는 거절하세요.
커밋, 브랜치, PR 흐름
변경을 승인하면 데스크톱 앱은 세션의 워크트리 브랜치에 커밋할 수 있습니다. 그 다음 원격(origin)으로 푸시하고 UI에서 PR을 열 수 있습니다(GitHub 액세스를 승인한 경우). 각 세션의 브랜치는 머지할 때까지 격리되어 있어 사람이 리뷰하기 쉽습니다.
Git 격리와 다중 세션 병렬 처리는 실제로 어떻게 동작하나요?
Git 워크트리: 격리 메커니즘
Anthropic의 데스크톱은 세션별 작업 디렉터리를 별도 브랜치에 연결하기 위해 Git 워크트리를 사용합니다. 워크트리는 전체 클론보다 가볍습니다 — 적절한 경우 동일한 .git 메타데이터를 공유하면서도 독립적인 작업 디렉터리를 제공하므로 동시 수정이 충돌하거나 세션 간 상태가 누출되는 일을 방지합니다. 데스크톱은 이러한 자동 생성된 워크트리를 구성 가능한 디렉터리에 배치합니다(기본값 ~/.claude-worktrees). 이 설계는 에이전트 작업의 안전한 동시성을 가능하게 합니다.
워크트리를 클론 대신 사용하는 이유
워크트리는 생성이 빠르고 동일한 Git 히스토리와의 상관관계가 쉬우며, 교차 세션 오염을 피하기 위한 파일 시스템 분리를 제공합니다. 대부분의 워크플로에서 이는 여러 개의 전체 클론보다 바람직합니다; 다만 서로 다른 의존성을 가진 완전한 격리 실행 환경이 필요하다면 별도의 클론이나 컨테이너가 더 적합할 수 있습니다.
조정과 충돌 처리
각 세션이 격리된 브랜치/워크트리에서 작업하므로 충돌이 최소화됩니다. 두 세션이 동일한 논리 코드를 독립적으로 변경하고 나중에 동일한 대상 브랜치로 모두 병합되는 경우에는 정상적인 Git 머지 충돌 처리가 적용됩니다 — 이는 사람의 리뷰와 해결이 이루어져야 하는 올바른 시점입니다. Anthropic의 모델은 의도적으로 커밋을 리뷰 가능한 PR로 표면화해, 병합 루프에 사람이 남아 있도록 합니다.
일반적인 문제 해결 단계와 제한 사항
세션 시작에 실패하거나 멈출 경우
- 저장소 액세스 토큰이 유효하고 레이트 리밋에 걸리지 않았는지 확인하세요.
- 워크트리 디렉터리(예:
~/.claude-worktrees)에 대한 로컬 디스크 공간과 권한을 확인하세요. - 데스크톱 앱 로그에서 오류 메시지를 확인하세요; 앱은 일반적으로 진단 보기 또는 로그 파일을 제공합니다.
세션 간 상태 오염이 발생할 경우
- 데스크톱 앱이 별도의 워크트리를 생성하고 있는지 확인하세요(앱 환경설정에서 설정된 워크트리 위치 또는
~/.claude-worktrees디렉터리를 확인). - 공유 상태가 보인다면 최신 데스크톱 프리뷰를 사용하고 있는지 확인하거나 Anthropic 문서를 참조하세요 — 이 릴리스는 특히 세션 격리를 개선합니다.
무시된 파일이 세션에서 사용 불가능한 경우
필요한 무시된 파일(예: .env)을 각 워크트리에 안전하게 복사하도록 .worktreeinclude 구성(또는 데스크톱 UI의 동등한 설정)에 파일명을 추가하세요. 적절한 비밀 관리 없이 워크트리에 비밀을 저장하거나 노출하는 일을 피하세요.
결론
Claude Code의 데스크톱 프리뷰는 여러 에이전트가 동일한 코드베이스에서 작업해야 할 때 개발자가 직면하는 실용적 조정 문제를 해결하면서, AI 에이전트의 속도와 표현력을 유지하는 방식으로 에이전트 기반 코딩 도구를 개발자 워크플로에 맞게 진화시켰습니다. 단일 개발자의 생산성 향상을 위해서든, 팀 전반에서 여러 에이전트 작업을 조정하기 위해서든, Git 워크트리, .worktreeinclude, 로컬 vs 웹 세션의 구분을 이해하면 데스크톱 프리뷰 첫 주가 훨씬 더 생산적일 것입니다.
Claude Code cli를 사용할 준비가 되셨나요? 자세한 지침은 API 가이드를 참고하세요.
개발자는 CometAPI를 통해 Claude Opus 4.5 API 등을 사용할 수 있으며, 최신 모델 버전은 항상 공식 웹사이트와 함께 업데이트됩니다. 시작하려면 Playground에서 모델의 기능을 탐색하고, 자세한 지침은 API 가이드를 참고하세요. 액세스 전에 CometAPI에 로그인하고 API 키를 발급받았는지 확인하세요. CometAPI는 통합을 돕기 위해 공식 가격보다 훨씬 낮은 가격을 제공합니다.
Ready to Go?→ Free trial of Claude opus 4.5 !