[ Claude Code #5 ] Claude Desktop 완벽 가이드

1. 웹을 넘어선 완전한 워크스테이션: 3가지 핵심 탭 이해하기

Claude Desktop의 상단 중앙에는 목적과 동작 방식이 완전히 다른 세 가지 탭이 존재합니다.

Claude Desktop 상단 중앙에는 Chat · Cowork · Code 세 탭이 있습니다. 각 탭은 완전히 다른 목적과 동작 방식을 가집니다.

탭 (Tab)실행 위치파일 접근주요 특징 및 활용
Chat브라우저와 동일❌ 불가• 일반 대화, 글쓰기, Q&A 등 일상 AI 작업
• Free 플랜 포함 모든 사용자 이용 가능
Cowork클라우드 VM✅ 독립 환경• 리서치 종합, 대규모 문서 생성 등 백그라운드 자동화
• 결과만 확인하면 되는 장시간 작업에 최적
CodeLocal / Remote / SSH✅ 로컬 파일• 파일 직접 접근 및 실시간 코드 수정/승인
• 강력한 IDE급 개발 도구 (Pro 이상 유료 플랜 전용)

주의 사항: Code 탭과 Cowork 기능은 Pro, Max, Team, Enterprise 등 유료 플랜에서만 활성화됩니다.


2. 환경 요구 사항 및 설치 가이드

다운로드 경로: https://claude.com/download

지원 OS 및 특이사항

플랫폼인스톨러비고
macOSPKG (Universal)Intel + Apple Silicon 통합 빌드
Windows x64MSIX로컬 세션 사용 시 Git for Windows 필수
Windows ARM64MSIX (별도)ARM64 전용 인스톨러 페이지에서 다운로드
Linux미지원커뮤니티 비공식 빌드만 존재

⚠️ 주의Cowork 탭은 Intel Mac에서 사용 불가합니다. M1 이상 Apple Silicon 또는 Windows에서만 이용 가능합니다.

Code 탭에서 첫 세션을 시작할 때, 3가지 실행 환경 중 하나를 선택해야 해요.

  • 🖥️ Local: 내 컴퓨터에서 실행되며 로컬 파일에 직접 접근해요. 일반적인 개발 작업의 기본 옵션이에요.
  • ☁️ Remote: Anthropic 클라우드 인프라에서 실행돼요. 앱을 닫아도 백그라운드 작업이 유지되어서 장시간 작업에 유리하죠.
  • 🔌 SSH: 원격 서버나 개발 컨테이너에 접속하여 Claude를 실행해요.

💡 Tip: 처음에는 파일 구조를 잘 아는 소규모 로컬 프로젝트로 시작하는 걸 추천해요. 프롬프트 박스에서 @를 입력하면 로컬 파일을 쉽게 멘션하고 컨텍스트에 추가할 수 있어요.


3. Code 탭 실전: 권한 모드부터 시각적 Diff 뷰까지

Claude code - Claude desktop

실행 환경(Environment) 선택

첫 세션을 시작할 때 다음 세 가지 환경 중 하나를 선택해야 합니다.

  1. Local: 내 컴퓨터의 파일 시스템에 직접 접근합니다.
  2. Remote: Anthropic 클라우드 인프라에서 실행되며, 앱을 닫아도 백그라운드 작업이 유지됩니다.
  3. SSH: 사내 원격 서버나 개발 컨테이너에 접속하여 해당 환경에서 Claude를 실행합니다.

4단계 권한 모드(Permission Mode) 전략

AI의 자율성을 제어하는 권한 모드는 작업 속도에 직결됩니다.

  • Ask (권한 요청): 모든 파일 수정과 명령 실행 전 사용자의 승인을 받습니다 (기본값).
  • Auto Accept Edits: 파일 편집은 자동 수락하되, 터미널 명령어는 승인을 받습니다.
  • Plan Mode: 파일 수정 없이 코드를 분석하고 작업 계획만 수립합니다. 대규모 리팩토링 시 접근 방식을 검토할 때 유용합니다.
  • Bypass Permissions: 모든 승인을 생략하는 전문가용 모드로, 격리된 VM 샌드박스에서만 사용해야 합니다.

좌측 사이드바 메뉴 100% 활용하기

Code 탭에 진입하면 좌측에 작업 워크플로우를 관리하는 사이드바가 나타납니다.

  • + New session (새 세션): 완전히 독립적인 새로운 코딩 세션을 시작합니다. 실행 시 프로젝트 내 .claude/worktrees/에 별도의 Git Worktree를 자동 생성하므로, 기존 작업과 충돌 없이 여러 브랜치 작업을 병렬로 진행할 수 있습니다.
  • ⚡ Routines (루틴 관리): 정기적인 코드 감사, 의존성 패키지 업데이트 등 반복적인 작업을 일정에 따라 자동 실행하도록 예약(Scheduled Tasks)하는 메뉴입니다.
  • 💼 Customize (환경 커스텀): 내 개발 환경에 맞게 기능을 확장합니다. 사내 DB, Jira, Slack 등 외부 리소스를 연결하는 MCP(Model Context Protocol) 서버를 추가하거나 플러그인을 관리할 수 있습니다.
  • Pinned & Recents (세션 관리): 진행 중인 수많은 세션 중 중요한 세션을 상단에 고정(Drag to pin)하거나, 최근 작업한 세션(예: General coding session)에 클릭 한 번으로 복귀하여 컨텍스트 스위칭 비용을 최소화합니다.
Sidebar

시각적 Diff 리뷰와 인라인 댓글

코드가 수정되면 상단에 +12 -1 형태의 통계 지표가 표시됩니다. 이를 클릭해 Diff 뷰어를 열고 특정 라인에 댓글을 달아 피드백을 전달할 수 있습니다. 코멘트 작성 후 macOS는 Cmd+Enter, Windows는 Ctrl+Enter를 누르면 피드백이 일괄 제출됩니다.


4. 워크스페이스 최적화: 분할창(Pane) 레이아웃 정복

Claude Desktop v1.2581.0 이상부터는 완전한 드래그 앤 드롭 분할창 레이아웃을 지원합니다. Chat, Diff, Terminal, File Editor, Preview 등의 패널을 IDE처럼 자유롭게 배치할 수 있습니다.

  • 추천 레이아웃 (프론트엔드): Chat(좌측) + Preview(우상단) + Terminal(우하단).
  • View Modes 제어: Ctrl+O 단축키를 통해 Claude의 응답 상세도를 조절할 수 있습니다. 모든 도구 호출을 보는 Verbose, 기본인 Normal, 결과만 보는 Summary 모드가 있습니다.
  • Side Chat: Cmd+; (Windows: Ctrl+;)를 누르면 메인 스레드를 오염시키지 않고 현재 컨텍스트 내에서 빠른 질문(예: 디버깅, 코드 설명)을 던질 수 있는 브랜치 대화가 열립니다.

참고: 현재 Desktop은 단일 창(Single Window) 기반이며, 멀티 모니터를 위한 다중 창 분리 기능은 제공하지 않습니다.


5. 딥다이브: 병렬 세션, 백그라운드 자동화, 그리고 Cowork

Git Worktree를 활용한 병렬 세션 관리

사이드바에서 여러 세션을 생성하면, 각 세션은 프로젝트 내 .claude/worktrees/ 디렉토리에 독립적인 Git Worktree를 자동 생성합니다. 덕분에 한 세션에서 인증 모듈을 수정하는 동안, 다른 세션에서 DB 레이어를 리팩토링해도 코드 충돌이 발생하지 않습니다.

Cowork 모바일 연동 (Remote Dispatch)

외출 중이거나 회의 중일 때 스마트폰으로 작업을 지시할 수 있습니다.

  1. 무료 iOS 모바일 앱을 데스크탑과 페어링합니다.
  2. 모바일 앱에서 작업(Dispatch)을 요청하면, 켜져 있는 데스크탑의 Cowork VM이 이를 수신하여 백그라운드에서 자동 실행합니다.

프로젝트 컨텍스트 메모리 (CLAUDE.md)

프로젝트 루트에 CLAUDE.md 파일을 생성해두면, 새 세션이 시작될 때마다 아키텍처 개요, 코딩 컨벤션, 금지 사항 등을 Claude가 자동으로 숙지합니다.


6. 팀 및 엔터프라이즈 도입을 위한 베스트 프랙티스

기업 환경에서는 보안과 관리 통제가 중요합니다.

  • 배포 및 인증: MSIX(Windows) 및 PKG(macOS) 인스톨러를 통한 MDM/GPO 표준 배포를 지원하며, SSO(Single Sign-On) 자동 인증을 통해 팀원들의 로그인 과정을 일원화할 수 있습니다.
  • 확장 프로그램 허용 통제: Admin Console을 통해 팀별로 특정 Extension만 표시되도록 허용 목록(Allowlist)을 제어하거나, Bypass Permissions 모드를 강제로 비활성화할 수 있습니다.
  • 작업 예약 (Scheduled Tasks): 정기적인 코드 감사나 의존성 업데이트를 위해 예약 작업을 생성할 수 있습니다. 무인 환경에서 실행되므로 권한 모드는 Auto Accept Edits로 설정하는 것을 권장합니다.

참고링크

Claude Desktop 공식 다운로드 : https://claude.com/download

Claude Code 공식 문서 (Docs) : https://code.claude.com/docs

Claude Code Docs Index (LLMs) : https://code.claude.com/docs/llms.txt

GitHub CLI 공식 문서 (PR 자동화 연동용) : https://cli.github.com/

댓글 남기기