🔥 불타는 고구미 블로그

일상을 맛있게
기록하는 곳

개발 · 맛집 · 여행 · 취미까지
모든 기록을 따뜻하게 담아냅니다.

불타는 고구미 캐릭터
불타는 고구미 🍠🔥

최근 글

새롭게 올라온 기록들을 확인해보세요.

/ AI/Claude
AI/Claude

Claude Desktop 신규 업데이트 정리

반응형
2026년 4월 업데이트

Claude Desktop 신규 업데이트 정리

설치부터 Code 탭 리디자인, Routines까지 — 공식 문서 기반 총정리

1. Claude Desktop이 뭔데?

Anthropic이 만든 공식 데스크톱 앱이다. 웹(claude.ai)에서 쓰던 Claude를 macOS, Windows에 설치해서 쓸 수 있다.

그런데 "그냥 웹을 앱으로 만든 거 아니야?"라고 생각하면 오산이다.

💡 핵심 차이

웹 Claude → 파일을 업로드해야 한다
Desktop Claude → 내 컴퓨터 파일을 직접 읽고 수정한다

앱 좌측 상단 아이콘을 호버하면 Chat, Cowork, Code 세 개의 탭이 나타난다. 이게 Claude Desktop의 전부다.

2026년 4월 15일, 이 중 Code 탭이 완전히 재설계되었다. Anthropic 공식 표현: "redesigned from the ground up for parallel work."

2. Chat vs Cowork vs Code — 3탭 완벽 비교

"이게 다 뭐가 다른 거지?" — 가장 많이 나오는 질문이다. 한 방에 정리한다.

구분 Chat Cowork Code
대상 누구나 비개발자~일반 개발자
핵심 대화·질문·글쓰기 파일 수정·웹 리서치·자동화 코드 생성·터미널·Diff·PR
파일 접근 업로드만 ✅ (VM 기반) ✅ (직접 접근)
Computer Use ✅ 마우스·키보드 ✅ macOS
Dispatch (원격)
자동화 Scheduled Tasks Routines + Tasks
예시 번역, 요약, 브레인스토밍 회의록 정리, 데이터 분석 웹앱 개발, PR 자동화
요금제 무료~ Pro($20)~ Pro($20)~

💡 카일스쿨 팁: Claude Code(CLI)를 바로 설치하기 전에, Desktop Code 탭으로 먼저 입문하는 걸 추천한다. GUI라서 진입 장벽이 훨씬 낮다.

3. 설치 방법 (복붙용)

✅ Step 1 — 다운로드

# 공식 다운로드 페이지
https://claude.com/download

macOS → .dmg 파일 → Applications로 드래그
Windows → .exe 파일 → 실행해서 설치

✅ Step 2 — 로그인

앱 실행 → Google 계정 또는 이메일로 로그인. 계정이 없으면 회원가입.

✅ Step 3 — 업데이트 확인

이미 설치되어 있다면 앱 재시작으로 자동 업데이트된다. 최신 버전은 v1.2581.0 이상.

# 버전 확인
macOS: Claude 메뉴 → About Claude
Windows: Help → About

✅ Step 4 — 탭 확인

좌측 상단 아이콘을 호버하면 Chat / Cowork / Code 세 탭이 나타난다.

플랫폼 지원 비고
macOS 전체 기능. 단, Intel Mac은 Cowork 불가 (Apple Silicon 전용)
Windows Windows 10 이상, ARM64 포함
Linux 공식 미지원. CLI 사용 권장

4. 4월 15일 업데이트 — 뭐가 바뀌었나? (10가지)

이번 업데이트의 핵심은 Code 탭의 완전한 재설계다. Anthropic 블로그에서도 "처음부터 다시 만들었다(redesigned from the ground up)"고 표현할 정도.

🎯 한 줄 요약

"대화형 챗봇" → "병렬 에이전트 오케스트레이터"로 진화했다

① 세션 관리 사이드바 — "미션 컨트롤"

모든 활성/최근 세션을 한 곳에서 관리한다. 상태(Active/Archived), 프로젝트, 환경(Local/Remote/SSH)으로 필터링·그룹화 가능. PR이 머지되면 해당 세션이 자동 아카이브된다.

② 멀티 세션 병렬 작업

하나의 창에서 여러 Claude 세션을 나란히 실행할 수 있다. Git 저장소의 경우 세션마다 자동으로 독립된 Git Worktree를 생성해서 코드 충돌 없이 병렬 작업이 가능하다.

# Worktree 기본 위치
<project-root>/.claude/worktrees/

③ 사이드 챗 (Side Chat)

메인 작업 도중 별도 질문이 필요할 때. 메인 스레드의 컨텍스트를 참조하지만, 사이드 챗 내용은 메인으로 되돌아가지 않는다. 작업 집중도를 깨지 않는다.

# 사이드 챗 열기
macOS: Cmd + ;
Windows: Ctrl + ;
CLI: /btw

④ 드래그 앤 드롭 패널 레이아웃

모든 패널을 자유롭게 배치할 수 있다. Anthropic 공식 문서 기준 8종 패널:

💬 채팅

Claude와의 대화

📝 Diff

코드 변경사항 검토

👁️ 프리뷰

개발 서버·HTML·PDF·이미지

⬛ 터미널

통합 터미널

📄 파일

인앱 파일 편집기

📋 플랜

작업 계획 시각화

✅ 작업(Tasks)

진행 중인 작업 추적

🤖 서브에이전트

복잡한 작업 분담

⑤ 통합 터미널 내장

앱 안에서 직접 빌드, 테스트, git 명령어 실행 가능. Claude가 편집하는 파일과 동일한 환경을 공유한다. CLI 플러그인도 터미널에서와 똑같이 작동한다.

⑥ 인앱 파일 에디터 + 강화된 Diff 뷰어

Claude가 수정한 파일을 앱 안에서 직접 열어 편집할 수 있다. Diff 뷰어는 대규모 변경사항에서도 빠르게 동작하도록 재구축되었다.

Diff 뷰어에서 할 수 있는 것

→ 변경사항 +12 -1 요약 확인
→ 클릭해서 전체 diff 확인 → 수락/거절
인라인 댓글 · 코드 리뷰 가능
→ "Review code" 버튼 → Claude가 자기 코드를 셀프 리뷰 (보안·성능·린터)
Cmd+Enter(macOS) / Ctrl+Enter(Windows)로 모든 변경사항 일괄 수락

⑦ 프리뷰 패널 + 자동 검증(Auto-Verify)

HTML, PDF, 이미지 + 로컬 앱 서버 결과물까지 앱 안에서 미리보기. 여기서 끝이 아니다 — Claude가 코드 수정 후 자동으로 개발 서버를 시작하고, 내장 브라우저에서 스크린샷 촬영, DOM 검사, 요소 클릭, 폼 입력까지 수행하며 문제를 스스로 수정한다.

# 프리뷰 서버 커스터마이징
.claude/launch.json

⑧ 3가지 뷰 모드

Claude의 도구 호출 활동을 얼마나 볼지 선택한다.

모드 설명
Verbose 모든 도구 호출 과정 상세히 표시
Normal 적절한 수준의 정보
Summary 결과만 간결하게

Ctrl + O로 순환 전환.

⑨ 사용량 인디케이터 + 토큰 소비 표시

화면 하단 원형 인디케이터를 호버하면 컨텍스트 윈도우 사용량 + 주간 플랜 한도 확인. 각 응답에 오렌지색 별표(✱)로 소요 시간·소비 토큰도 실시간 표시된다.

⑩ SSH Mac 지원 + 플러그인 동등성

SSH 세션이 기존 Linux에 이어 Mac에서도 지원 시작. CLI 플러그인이 Desktop에서 동일하게 작동하도록 동등성(parity) 확보.

Anthropic 공식 블로그 원문: "The desktop app now has parity with CLI plugins. If your org manages Claude Code plugins centrally, or you've installed your own locally, they work in the desktop app exactly the way they do in your terminal."

5. Code 탭 사용법 — 권한 모드 & 핵심 기능

세션 시작하기

Code 탭 선택 → 세션 환경을 고른다:

환경 설명
Local 내 컴퓨터에서 실행
Remote Anthropic 클라우드 실행 (노트북 꺼도 작업 지속)
SSH 원격 서버·VM에 연결하여 실행

환경 선택 후 작업 폴더를 지정하면 Claude가 파일 구조를 인식하고 작업을 시작한다.

권한 모드 5가지

Claude가 어디까지 자율적으로 행동할지 설정한다. 전송 버튼 옆 모드 선택기로 언제든 변경 가능.

모드 설명
Default 파일 수정 시 diff 보여주고 승인 요청. 초보자 추천.
acceptEdits 파일 편집 자동 수락, 명령어 실행만 확인
Plan mode 실제 수정 없이 계획만 수립. 큰 작업 전 미리 확인할 때.
Auto 거의 모든 작업 자동 수행. Team/Enterprise/API 전용. Sonnet 4.6·Opus 4.6만 가능.
Bypass Permissions 모든 권한 프롬프트 건너뜀. VM 환경에서만 권장. Settings에서 활성화 필요.

핵심 기능 요약

@mention 파일 참조

@로 특정 파일을 직접 참조

드래그 & 드롭

이미지, PDF 파일 첨부

GitHub PR 모니터링

CI 확인·Auto-fix·Auto-merge

Connectors

GitHub, Slack, Linear, Notion, Calendar 연결

Plugins

마켓플레이스에서 skills, agents, MCP 확장

Skills

/ 명령어로 반복 워크플로우 실행

6. 단축키 치트시트

macOS Windows 기능
Cmd + N Ctrl + N 새 세션 생성
Cmd + W Ctrl + W 세션 닫기
Ctrl + Tab Ctrl + Tab 다음 세션 전환
Ctrl + Shift + Tab Ctrl + Shift + Tab 이전 세션 전환
Cmd + ; Ctrl + ; 사이드 챗 열기
Ctrl + ` Ctrl + ` 터미널 패널 토글
Cmd + Shift + D Ctrl + Shift + D Diff 패널 토글
Cmd + Shift + P Ctrl + Shift + P 프리뷰 패널 토글
Ctrl + O Ctrl + O 뷰 모드 순환 (Verbose → Normal → Summary)
Cmd + \ Ctrl + \ 포커스된 패널 닫기
Cmd + Enter Ctrl + Enter Diff 변경사항 일괄 수락
Cmd + / Ctrl + / 전체 단축키 목록 보기

7. Routines — 노트북 꺼도 돌아가는 자동화

이번 업데이트와 동시에 출시된 신규 기능이다. 리서치 프리뷰 상태.

🎯 Routines가 뭔데?

프롬프트 + 리포지토리 + 커넥터를 묶어서, Anthropic 클라우드에서 실행하는 자동화.
내 노트북이 꺼져 있어도 새벽 2시에 버그 트리아지가 자동으로 돌아간다.

3가지 유형

유형 트리거 예시
⏰ Scheduled 시간/일/주 반복 매일 밤 Linear 버그 트리아지 → Slack 요약
🔌 API HTTP 요청 Datadog 알림 → Claude가 트레이스 분석 → 수정 초안
🔗 Webhook (GitHub) GitHub 이벤트 PR 생성 시 → 보안·성능 체크리스트 자동 리뷰

실전 활용 사례 (Anthropic 공식)

# Scheduled: 매일 밤 백로그 정리
Every night at 2am: pull the top bug from Linear,
attempt a fix, and open a draft PR.

# API: 배포 후 자동 검증
CD pipeline → POST → Claude가 스모크 테스트
→ 에러 로그 회귀 스캔 → go/no-go 판정

# Webhook: Python SDK PR → Go SDK 자동 포팅
PR merged to Python SDK → Claude가 Go SDK에
포팅 → 매칭 PR 자동 생성

# 시작하기
웹: claude.ai/code
CLI: /schedule

일일 실행 한도

요금제 일일 Routines 한도
Pro ($20/월) 5회
Max ($100~200/월) 15회
Team / Enterprise 25회

※ 추가 사용량 구매 가능. Routines는 일반 세션과 동일하게 구독 사용량을 소비함.

8. 스케줄링 3종 비교 (Cloud vs Desktop vs /loop)

반복 작업을 예약하는 방법이 3가지인데, 각각 용도가 다르다.

항목 Cloud Routines Desktop Tasks /loop
실행 위치 Anthropic 클라우드 내 컴퓨터 내 컴퓨터
PC 켜야 함? ❌ No ✅ Yes ✅ Yes
세션 열어야 함? ❌ No ❌ No ✅ Yes
재시작 후 유지? ❌ 세션 종료 시 소멸
로컬 파일 접근 ❌ (fresh clone)
최소 간격 1시간 1분 1분

9. CLI vs Desktop — 뭘 써야 할까?

Claude Code는 터미널(CLI)과 Desktop(GUI) 두 가지로 쓸 수 있다. 동일한 엔진을 공유하고, CLAUDE.md·MCP·Hooks·Skills 등 모두 호환된다. 하지만 중요한 차이가 있다.

항목 CLI (터미널) Desktop (GUI)
모델 프로바이더 Anthropic + Bedrock + Vertex + Foundry Anthropic만
병렬 세션 여러 터미널 탭 수동 관리 사이드바에서 시각적 관리
프리뷰 별도 브라우저 필요 앱 내 통합
@mention · 드래그드롭
Dispatch (원격)
Agent Teams ✅ (CLI + Agent SDK)
Linux 지원
속도 · 리소스 가볍고 빠름 GUI 오버헤드 존재

💡 결론

CLI가 유리한 경우: 터미널 익숙 + 단일 레포 빠른 작업 + Bedrock/Vertex 등 다중 프로바이더 사용 + Linux

Desktop이 유리한 경우: 여러 세션 동시 관리 + Diff/프리뷰 시각적 확인 + 파일 드래그드롭 + CLI 처음인 사람

10. 요금제 & 주의사항

요금제 비교

요금제 월 가격 Chat Cowork Code Routines/일
무료 $0
Pro $20 5회
Max 5x $100 15회
Max 20x $200 15회
Team $25~/인 25회
Enterprise 별도 25회

⚠️ 주의사항

Intel Mac 주의

Cowork는 Apple Silicon(M1+) 전용. Intel Mac은 Chat + Code만 가능.

Desktop 모델 제한

Desktop Code 탭은 Anthropic API만 지원. Bedrock·Vertex·Foundry는 CLI에서만.

403 에러 시

① 앱 업데이트 확인 → ② 요금제 확인(Pro 이상) → ③ 앱 재시작

로그 확인

macOS: Console.app / Windows: Event Viewer → Windows Logs → Application

728x90
반응형