Claude Code Desktop 핵심 정리

# 설치 및 로그인

Claude 다운로드 페이지에서 운영체제에 맞는 설치 파일을 다운로드합니다.
macOS는 Intel과 Apple Silicon을 함께 지원하는 하나의 설치 파일이고, Windows는 x64와 ARM64 설치 파일이 따로 있습니다.
Linux(Ubuntu, Debian)는 베타로 제공되며 apt로 설치합니다.

Claude 다운로드 페이지

설치한 앱을 실행하고 Claude 계정으로 로그인합니다.
데스크톱 앱에는 Claude Code가 포함되어 있어서 Node.js나 CLI를 따로 설치할 필요가 없습니다.

로그인하면 사이드바 상단의 두 아이콘으로 채팅과 Cowork를 사용하는 Claude 화면과 Code 화면을 전환할 수 있습니다.
오른쪽의 </> 아이콘(Code)을 선택하면 Claude Code 데스크톱이 열립니다.
무료 플랜이면 업그레이드 안내가 표시되므로 먼저 유료 플랜을 구독해야 합니다.

Code 탭

# 화면 구성

Code 화면에서 Claude와 나누는 하나의 대화를 세션(Session)이라고 합니다.
세션마다 대화 기록과 작업 폴더, 변경 내용이 따로 관리되며, 화면은 다음과 같이 구성됩니다.

• 사이드바: 새 세션을 만드는 새로 만들기(New), 검색, 아티팩트, 예약된 작업을 관리하는 예약됨(Scheduled), 스킬과 커넥터, 플러그인을 관리하는 사용자 지정(Customize) 메뉴와 프로젝트 폴더별 세션 목록을 표시
• 제목 표시줄: 왼쪽에 세션 제목과 세션 메뉴, 오른쪽에 세션 상세 패널, 터미널, 변경 사항, 브라우저, 파일 패널을 여닫는 버튼을 표시
• 대화 영역: 요청과 응답, Claude가 사용한 도구의 요약, 승인 요청 카드, 작업 목록을 표시
• 세션 상세 패널: 세션이 실행되는 환경과 폴더, Git 브랜치, 컨텍스트 사용량, 연결된 커넥터, 변경 사항, Claude가 만든 결과물, 실행 중인 서버와 백그라운드 작업을 카드로 표시
• 입력창: 요청을 작성하고, 입력창 아래 줄에서 권한 모드와 모델을 선택

화면 구성

세션 상세 패널은 대화 영역이 충분히 넓을 때 표시되며, 제목 표시줄 오른쪽의 첫 번째 버튼으로 숨기거나 다시 표시할 수 있습니다.
카드 머리글을 마우스 우클릭하면 패널에 표시할 카드를 고를 수 있습니다.
창이 좁으면 제목 표시줄의 일부 버튼이 ⋯ 메뉴 안으로 이동합니다.

# 첫 세션 시작

새 세션을 시작할 때는 메시지를 보내기 전에 입력창 아래 줄에서 어디서, 어떤 폴더로, 어떤 방식으로 작업할지 먼저 정합니다.
왼쪽부터 환경, 프로젝트 폴더, 워크트리 버튼이 있고, 오른쪽에 권한 모드, 모델과 노력, 사용량 표시가 있습니다.

입력창 아래 줄

환경(Environment)은 Claude가 작업을 실행하는 위치입니다.
보통은 로컬의 이 컴퓨터를 선택하며, 클라우드에서 실행하는 방법은 뒤에서 살펴봅니다.

환경 선택

로컬 목록에 이 컴퓨터 외의 항목이 보이면 자주 사용한 폴더를 저장해 놓은 환경입니다.
Code 탭을 처음 열 때 데스크톱 앱이 지난 한 달 동안 많이 사용한 폴더로 최대 8개까지 자동으로 만들며, 직접 만들려면 메뉴 아래쪽의 새 환경을 선택합니다.
저장된 환경을 선택하면 폴더를 다시 고르지 않아도 됩니다.

환경 옆의 폴더 버튼을 누르면 최근 폴더 목록과 폴더 열기...가 표시됩니다.
여기에서는 작은 카페의 소개 정보가 담긴 menu.md 파일 하나가 있는 cafe-homepage 폴더를 선택합니다.
같은 내용으로 폴더를 만들어서 따라 해 볼 수 있습니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
# 온새미 커피

동네 골목에 있는 작은 로스터리 카페입니다.
매주 월요일에 직접 볶은 원두로 커피를 내립니다.

## 영업 시간

- 화요일 ~ 일요일: 오전 9시 ~ 오후 9시
- 월요일: 휴무 (원두 로스팅)

## 메뉴

| 이름 | 가격 | 설명 |
| --- | --- | --- |
| 아메리카노 | 4,000원 | 산미가 적은 하우스 블렌드 |
| 카페 라떼 | 4,800원 | 고소한 우유와 에스프레소 |
| 바닐라 빈 라떼 | 5,300원 | 마다가스카르 바닐라 빈 시럽 |
| 핸드 드립 | 6,000원 | 이번 주 싱글 오리진 |
| 레몬 에이드 | 5,000원 | 직접 담근 레몬청 |
| 버터 스콘 | 3,500원 | 매일 아침 굽는 스콘 |

## 오시는 길

서울시 마포구 온새미로 12, 1층
망원역 2번 출구에서 걸어서 7분

처음 사용할 때는 권한 모드를 수동으로 두면 Claude가 파일을 바꾸기 전에 매번 확인을 요청해서 동작을 이해하기 좋습니다.
입력창에 다음과 같이 요청하고 Enter 키를 누릅니다.

1
menu.md 내용을 바탕으로 카페 소개 웹 페이지를 index.html 파일 하나로 만들어 줘. 따뜻하고 깔끔한 느낌이면 좋겠어.

Claude는 요청을 단계로 나눈 작업 목록을 만들고, 파일을 읽거나 명령을 실행하면서 하나씩 진행합니다.
계정에 관련된 스킬이 있으면 디자인 스킬처럼 필요한 스킬을 스스로 불러올 수도 있습니다.

작업 진행

수동 모드에서는 파일을 만들기 직전에 승인 요청 카드가 표시됩니다.
카드에서 만들거나 바꿀 내용을 미리 확인하고 거부, 한 번만 허용 중에서 선택합니다.
오른쪽 화살표 메뉴의 항상 허용은 이 세션을 편집 자동 수락 모드로 바꿔서 이후의 파일 편집을 더 이상 묻지 않고, 허용하고 Auto 모드로 전환은 남은 작업을 자동 모드로 진행합니다.

승인 요청 카드

파일을 만든 뒤에는 Claude가 오른쪽에 브라우저 패널을 열고 결과 페이지를 직접 확인합니다.
화면을 캡처하고 모바일 폭으로 바꿔 보면서 문제가 있으면 다시 고친 뒤에 결과를 보고할 수 있습니다.

첫 결과

작업이 끝나면 대화 끝에 무엇을 바꿨는지 정리한 카드가 표시되고, 필요하면 다음에 할 일을 버튼으로 제안할 수 있습니다.
예를 들어 '지금까지 바꾼 내용을 커밋할까요?'라는 질문과 함께 변경 사항 커밋 버튼이 표시될 수 있습니다.

# 프롬프트 입력

입력창 왼쪽의 + 버튼을 누르면 요청에 자료를 추가할 수 있습니다.

• 파일 또는 사진 추가(Cmd + U): 화면 캡처, 디자인 시안, PDF 같은 파일을 첨부
• 폴더 추가: 세션이 함께 작업할 폴더를 추가
• GitHub 이슈 가져오기: 폴더가 GitHub 저장소이면 이슈 내용을 요청으로 가져오기
• 슬래시 명령어: 사용할 수 있는 명령과 스킬 목록
• 커넥터: Google Drive, Slack 같은 외부 서비스 연결
• 플러그인 추가: 스킬, 에이전트, MCP 서버를 묶은 플러그인 설치

추가 메뉴

파일은 입력창으로 끌어다 놓아도 첨부됩니다.
작업 폴더 안의 파일을 지정할 때는 @ 다음에 파일 이름을 입력하면 자동 완성 목록에서 선택할 수 있습니다.

@로 파일 지정

입력창에 /를 입력하면 내장 명령, 직접 만든 스킬, 플러그인 스킬이 함께 표시되고, 이어서 글자를 입력하면 목록이 좁혀집니다.
항목에 마우스를 올리면 설명을 확인할 수 있고, 선택한 명령 뒤에 요청 내용을 이어서 작성합니다.

슬래시 명령 목록

터미널에서 대화상자를 여는 일부 명령은 데스크톱에서 다르게 동작합니다.
예를 들어 /config는 설정 > Claude Code 화면을 열고, 인수 없이 실행하는 /permissions처럼 터미널 전용 화면이 필요한 명령은 이 환경에서 사용할 수 없다는 안내를 표시합니다.
이런 설정은 설정 파일을 직접 고치거나 Claude에게 고쳐 달라고 요청합니다.

Claude가 작업하는 중에도 언제든 방향을 바꿀 수 있습니다.

• 중단: 입력창의 정지 버튼을 누르거나 Esc 키
• 바로 전달: 수정할 내용을 입력하고 Enter 키를 누르면, Claude가 진행 중인 동작을 마친 뒤 바로 읽고 다음 단계에 반영
• 대기열에 추가: Cmd + Enter 키를 누르면 지금 작업이 끝난 뒤에 보낼 메시지로 대기

응답이 끝난 뒤 빈 입력창에 다음 요청이 회색 글씨로 제안되기도 합니다.
Tab 또는 → 키를 누르면 제안이 입력창에 채워지고, 고쳐서 보내거나 무시하고 직접 입력해도 됩니다.
제안을 만드는 짧은 요청도 플랜 사용량에 포함되며, 설정 > Claude Code의 프롬프트 제안으로 끌 수 있습니다.
입력창 오른쪽의 마이크 버튼으로 음성 입력도 사용할 수 있습니다.

# 권한 모드

권한 모드(Permission mode)는 Claude가 파일을 고치거나 명령을 실행하기 전에 확인을 요청할지 결정합니다.
입력창 아래 줄에서 언제든 바꿀 수 있고, Cmd + Shift + M 키로도 메뉴를 열 수 있습니다.
터미널처럼 Shift + Tab 키로 모드를 순환하지는 않습니다.

권한 모드 선택

자동 모드에서는 Claude가 일상적인 작업을 묻지 않고 진행하되, 셸 명령이나 네트워크 요청 같은 작업은 실행 전에 백그라운드의 분류기가 사용자의 요청과 맞는지 검사하고 위험한 작업을 막습니다.
확인 요청이 거의 없어서 편하지만, 처음에는 수동이나 편집 자동 수락으로 Claude가 무엇을 하는지 살펴보는 것이 좋습니다.

메뉴에서 선택한 모드는 폴더마다 기억되어 같은 폴더의 다음 세션에도 적용되며, 계획 모드만 현재 세션에 한해 적용됩니다.
새 세션의 기본 모드를 정하려면 설정 파일(~/.claude/settings.json)의 permissions.defaultMode에 위 표의 설정 값을 지정합니다.

# 계획 모드

큰 변경은 계획 모드에서 방향을 먼저 맞추는 것이 좋습니다.
권한 모드를 계획으로 바꾸고 다음과 같이 요청합니다.

1
'오시는 길' 부분에 지도와 길 찾기 버튼을 넣고 싶어. 어떻게 바꿀지 계획부터 세워 줘.

Claude는 파일을 읽고 살펴본 뒤 결정이 필요한 부분을 질문 카드로 묻습니다.
선택지 중 하나를 고르거나 기타에 직접 입력하고, 질문이 여러 개이면 다음으로 넘어갑니다.

질문 카드

답변을 받으면 Claude가 계획을 작성하고 계획 제안 카드를 표시합니다.

계획 제안 카드

계획 열기를 누르면 오른쪽의 계획 패널에서 전체 내용을 확인할 수 있고, 계획의 일부 텍스트를 선택해 Claude에게 댓글을 남길 수도 있습니다.
카드의 수락은 계획대로 작업을 시작하고, 수락 및 자동 모드 사용은 자동 모드로 바꿔서 시작합니다.
고칠 부분이 있으면 수정...으로 의견을 전달하고, 계획이 마음에 들지 않으면 거부합니다.

계획 패널

# 모델과 노력

입력창 아래 줄의 모델 이름을 누르거나 Cmd + Shift + I 키를 누르면 세션에서 사용할 모델을 선택할 수 있습니다.
기본 모델은 Opus 5.5입니다.
가장 어렵고 오래 걸리는 작업에는 Fable 5.1, 일상적인 작업에는 Opus 5.5, 범위가 분명한 작업을 더 빠르고 저렴하게 처리하려면 Sonnet 5.5, 요약이나 분류처럼 단순한 작업에는 Haiku 5.5를 선택합니다.
목록에 없는 이전 모델은 더 많은 모델에서 찾을 수 있으며, 모델은 세션 도중에도 바꿀 수 있습니다.

모델과 노력 선택

노력(Effort)은 Claude가 응답하기 전에 얼마나 깊이 추론할지 정하는 사고 깊이 설정이며, Cmd + Shift + E 키로도 메뉴를 열 수 있습니다.
메뉴의 안내처럼 단계가 높을수록 더 철저하게 답하지만, 시간이 더 걸리고 사용량을 더 빨리 소모합니다.

모델별로 노력 단계에 따라 성능과 비용이 어떻게 달라지는지는 Claude Code 토큰 다이어트를 위한 최적화 핵심 전략의 노력 수준 조절에서 그래프로 비교합니다.
Opus 5.5는 평소에 중간이나 높음을 사용하고, 정말 어려운 작업에만 더 높은 단계를 사용하는 것이 효율적입니다.

노력 메뉴 아래의 Ultracode를 켜면 Claude가 큰 작업을 여러 에이전트가 나눠서 처리하는 워크플로우로 실행할지 스스로 판단합니다.
결과가 더 꼼꼼해질 수 있지만 사용량을 빠르게 소모하므로 큰 작업에만 켜는 것이 좋습니다.
모델 메뉴 아래쪽의 고속 모드 사용은 같은 Opus 모델을 최대 2.5배 빠른 출력 속도로 사용하는 기능으로, 토큰 단가가 높고 구독 플랜에서는 플랜 사용량과 별도로 사용량 크레딧에서 과금됩니다.

# 변경 사항 검토

Claude가 파일을 바꾸면 세션 상세 패널의 변경 사항 카드에 +14 -0처럼 추가되고 삭제된 줄 수가 표시됩니다.
이 숫자나 제목 표시줄의 변경 사항 버튼을 누르면(Cmd + Shift + D) 파일별로 바뀐 내용을 비교하는 패널이 열립니다.
패널 상단의 main → 작업 트리는 마지막 커밋과 지금 작업 폴더의 상태를 비교한다는 뜻입니다.

시즌 메뉴를 추가하는 다음 요청으로 변경 사항 검토를 살펴봅시다.

1
메뉴에 시즌 메뉴로 딸기 라떼(5,800원, 생딸기를 갈아 넣은 봄 한정 메뉴)를 추가해 줘. 다른 메뉴와 구분되게 '시즌' 표시도 붙여 줘.

변경 사항 패널에서 줄 번호 옆에 마우스를 올리면 + 버튼이 표시됩니다.
버튼을 눌러 그 줄에 대한 의견을 작성하고 Enter 키를 누르면 댓글이 추가됩니다.

줄에 댓글 작성

작성한 댓글은 입력창에 첨부되며, 여러 줄에 댓글을 남긴 뒤 한 번에 보낼 수 있습니다.
메시지를 보내면 Claude가 댓글을 읽고 해당 부분을 고치며, 고친 결과는 다시 변경 사항 패널에서 확인할 수 있습니다.

입력창에 첨부된 댓글

커밋하기 전에 Claude에게 변경 내용을 검토하게 하려면 입력창에 /code-review를 입력합니다.
검토가 끝나면 문제를 파일별로 묶은 카드가 표시되고, 변경 사항 패널에서 지적 사항을 하나씩 확인하거나 남은 문제를 한 번에 고치도록 요청할 수 있습니다.

변경 사항 카드의 변경 사항 커밋 버튼을 누르면 Claude에게 "Commit the working tree changes with a sensible message."라는 요청이 전달되고, Claude가 변경 내용에 맞는 커밋 메시지를 작성해서 커밋합니다.
자동 모드가 아니면 커밋 명령을 실행하기 전에 승인 요청 카드가 표시됩니다.

커밋 명령 승인

GitHub 저장소에서 작업한다면 Claude에게 풀 리퀘스트(PR) 생성까지 요청할 수 있습니다.
PR이 만들어지면 변경 사항 카드에 CI 검사 상태가 표시되고, PR 제목 옆의 ⋮ 메뉴에서 실패한 검사를 Claude가 자동으로 고치는 Auto-fix나 준비되면 자동으로 병합하는 Merge when ready를 켤 수 있습니다.
PR 기능을 사용하려면 컴퓨터에 GitHub CLI(gh)가 설치되어 로그인되어 있어야 하며, 없으면 처음 PR을 만들 때 설치 안내가 표시됩니다.

# 작업 공간 배치

Code 화면은 대화, 변경 사항, 브라우저, 터미널, 파일, 계획, 백그라운드 작업 같은 패널을 원하는 배치로 열어 놓고 사용할 수 있습니다.
패널은 제목 표시줄의 버튼으로 열고, 머리글을 끌어서 위치를 옮기거나 가장자리를 끌어서 크기를 조절합니다.
포커스된 패널은 Cmd + \ 키로 닫으며, 패널 머리글의 확장 버튼으로 패널을 별도 창으로 분리해서 다른 모니터에 띄울 수도 있습니다.

터미널 패널(Ctrl + `)은 세션의 작업 폴더에서 열리고 Claude와 같은 환경을 사용합니다.
Claude가 고치는 파일을 그대로 보면서 git status 같은 명령을 직접 실행할 수 있고, 패널 머리글의 +로 터미널 탭을 추가합니다.

터미널 패널

파일 패널에서는 작업 폴더의 파일 목록을 보고 파일을 열어 직접 고칠 수 있습니다.
대화에서 Claude가 언급한 파일 경로를 클릭해도 파일 패널에서 열리며, 마크다운 파일은 렌더링된 모습으로 표시됩니다.
편집한 내용은 기본으로 자동 저장되고, 패널의 ⋮ 메뉴에서 자동 저장을 끄면 Save 버튼으로 직접 저장합니다.

파일 패널

대화, 변경 사항, 파일 패널의 파일 경로를 마우스 오른쪽 버튼으로 클릭하면 다음 작업을 선택할 수 있습니다.

• 컨텍스트로 첨부: 다음 요청에 파일 첨부
• 복사: 절대 경로, 상대 경로, 파일 이름 복사
• 다음에서 열기: VS Code, Cursor처럼 설치된 편집기에서 열기
• Finder에서 보기: 파일이 있는 폴더 열기

대화에 표시되는 내용의 양은 보기 방식으로 조절합니다.
세션 제목 옆의 화살표 메뉴에서 트랜스크립트 보기를 선택하거나 Ctrl + O 키로 순환합니다.

트랜스크립트 보기 방식

Claude가 왜 그런 행동을 했는지 궁금할 때는 자세히로 바꿔서 확인합니다.
새 세션의 기본 보기 방식은 설정 > Claude Code의 기본 트랜스크립트 보기 방식에서 정합니다.

대화가 길어지면 챕터(Chapter)로 원하는 위치를 빠르게 찾을 수 있습니다.
Claude는 탐색을 마치고 구현을 시작할 때처럼 작업 단계가 바뀌면 대화에 챕터 제목을 표시합니다.
대화 영역 왼쪽 위의 목차 아이콘에 마우스를 올리면 챕터 목록이 표시되고, 챕터를 선택하면 해당 위치로 이동합니다.
나중에 다시 볼 응답이 있으면 응답 아래의 핀 모양 챕터로 고정 버튼을 눌러 직접 챕터로 추가합니다.

챕터 목록과 챕터로 고정한 응답

Cmd + / 키를 누르면 사용할 수 있는 모든 단축키를 검색하며 확인할 수 있습니다.

단축키 목록

자주 사용하는 단축키는 다음과 같습니다.

# 앱 미리보기

브라우저 패널(Cmd + Shift + B)은 Code 화면에 내장된 탭 브라우저입니다.
Claude는 웹 페이지를 만들거나 고치면 HTML 파일이나 개발 서버를 브라우저 패널로 열고, 화면을 캡처하고, 요소를 클릭하거나 폼을 입력하면서 변경 사항이 제대로 동작하는지 스스로 확인합니다.
글 처음의 화면처럼 대화와 결과 페이지를 나란히 놓고 작업할 수 있고, 사용자도 브라우저 패널의 페이지를 직접 조작할 수 있습니다.

브라우저 패널 하단의 도구 막대에서는 페이지의 특정 부분을 Claude에게 가리킬 수 있습니다.
요소 선택(Cmd + Shift + S)으로 페이지의 요소를 고르거나, 펜, 도형, 텍스트로 페이지 위에 표시를 남겨서 '이 버튼을 더 크게 해 줘'처럼 위치가 분명한 요청을 할 수 있습니다.

브라우저 패널의 ⋯ 메뉴에서는 다음 기능을 사용할 수 있습니다.

브라우저 패널 메뉴

• 스크린샷 저장, HTML 파일 열기
• 뷰포트: 반응형이나 모바일 크기로 페이지 폭 바꾸기
• 기본 제공 브라우저에서 링크 열기: 대화의 링크를 기본 브라우저 대신 브라우저 패널에서 열기
• Claude가 작성한 파일 자동으로 열기: Claude가 만든 HTML, 이미지, PDF, 동영상을 브라우저 패널에서 바로 열기
• 변경사항 자동 확인: 파일을 고칠 때마다 Claude가 브라우저로 결과를 확인
• 쿠키 가져오기, 쿠키 유지, 브라우징 데이터 삭제

React나 Vue처럼 개발 서버가 필요한 프로젝트는 Claude가 프로젝트에 맞는 실행 설정을 만들어 작업 폴더의 .claude/launch.json 파일에 저장합니다.
yarn dev처럼 다른 명령을 사용하거나 포트를 바꾸려면 이 파일을 직접 고치거나 Claude에게 요청합니다.

1
2
3
4
5
6
7
8
9
10
11
{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "web",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "port": 5173
    }
  ]
}

실행 중인 서버는 브라우저 패널 머리글의 개발 서버(Dev servers) 메뉴에서 시작하거나 중지할 수 있습니다.
파일을 고칠 때마다 자동으로 확인하는 동작이 필요 없으면 launch.json에 "autoVerify": false를 추가하거나 ⋯ 메뉴의 변경사항 자동 확인을 끕니다.

브라우저 패널은 개인 브라우저와 분리된 깨끗한 프로필을 사용해서, 평소에 로그인한 사이트의 정보가 없습니다.
외부 사이트에서 Claude가 처음 클릭이나 입력을 하려고 하면 한 번 허용, 항상 허용, 거부를 묻는 카드가 표시되고, 사이트마다 따로 승인해야 합니다.
승인한 사이트에서도 결제, 계정 생성, CAPTCHA 우회는 사용자 확인 없이 진행하지 않습니다.
로그인 상태가 필요한 사이트는 ⋯ 메뉴의 쿠키 가져오기...로 크롬 같은 브라우저의 쿠키를 가져오거나, 내 브라우저를 그대로 사용하는 Claude in Chrome 확장을 사용합니다.

# 세션 관리

사이드바의 새로 만들기나 Cmd + N 키로 세션을 여러 개 만들어서 서로 다른 작업을 동시에 진행할 수 있습니다.
사이드바의 세션 목록은 프로젝트 폴더별로 묶여 표시되고, Ctrl + Tab 키로 세션을 전환합니다.
보고 있지 않은 세션이 작업을 마치면 운영체제 알림이 표시됩니다.

세션에 마우스를 올리면 표시되는 ⋯ 버튼이나 마우스 오른쪽 버튼으로 세션 메뉴를 엽니다.

세션 메뉴

• 다음에서 열기: 새 창, Cursor나 VS Code 같은 편집기, Finder에서 열거나 클라우드로 옮겨서 이어 하기
• 고정, 읽지 않음으로 표시, 이름 변경
• 포크: 지금까지의 대화를 복사한 새 세션을 만들어서 다른 방향으로 진행
• 섹션으로 이동: 세션 목록의 다른 묶음으로 옮기기
• 보관: 목록에서 숨기기, 보관한 세션은 폴더 이름 옆 정렬 아이콘 메뉴의 모두 보기에서 확인
• 삭제

Shift 키를 누른 채 다른 세션을 클릭하면 그 사이의 세션이 함께 선택됩니다.
선택한 세션을 마우스 오른쪽 버튼으로 클릭하면 고정, 읽음이나 읽지 않음 표시, 섹션 이동, 모델 설정, 보관, 삭제를 한 번에 적용할 수 있습니다.

여러 세션을 선택한 메뉴

두 세션을 동시에 보려면 Option 키를 누른 채 사이드바의 세션을 클릭합니다.
화면이 나뉘어 두 세션이 나란히 표시되고, Cmd 키를 누른 채 클릭하면 새 창으로 열립니다.
Option 키를 누른 채 다른 세션을 더 클릭하면 세 개 이상의 세션도 한 화면에 나란히 표시됩니다.

두 세션을 나란히 보기

나뉜 화면의 배치는 각 세션 제목 표시줄의 ⋯ 메뉴에서 분할 보기 아래로 이동처럼 위치를 골라서 바꿉니다.
분할 보기에서 세션 하나를 빼려면 같은 메뉴의 분할 보기 닫기를 선택하거나 Cmd + Ctrl + W 키를 누릅니다.

여러 세션이 같은 폴더의 파일을 동시에 고치면 서로의 변경이 섞일 수 있습니다.
Git 저장소인 폴더에서는 세션을 시작하기 전에 입력창 아래 줄의 워크트리를 켜면, 세션이 프로젝트의 격리된 복사본인 Git 워크트리(Worktree)에서 작업합니다.
워크트리는 기본으로 <프로젝트>/.claude/worktrees/ 폴더에 만들어지며, 설정 > Claude Code의 워크트리 위치에서 바꿀 수 있습니다.
워크트리 세션을 보관하기 전에는 남길 변경 사항을 먼저 커밋합니다.

작업 흐름을 흐트러뜨리지 않고 잠깐 질문하고 싶을 때는 사이드 채팅을 사용합니다.
Cmd + ; 키를 누르거나 입력창에 /btw를 입력하면 오른쪽에 사이드 채팅이 열립니다.
사이드 채팅은 메인 대화의 내용을 읽고 답하지만, 사이드 채팅에서 나눈 대화는 메인 대화에 추가되지 않습니다.
사이드 채팅은 탭으로 열리므로, 탭 옆의 + 버튼으로 여러 개를 열어 두고 진행 상황과 코드 설명처럼 주제별로 따로 질문할 수 있습니다.
앱을 닫으면 사이드 채팅은 사라집니다.

사이드 채팅

# 중첩 세션

하나의 세션에서 성격이 다른 작업을 함께 진행하면 대화가 길어지고 작업 내용이 섞입니다.
이럴 때 Claude는 작업을 별도의 세션으로 시작할 수 있으며, 이렇게 시작한 세션을 중첩 세션(Nested session)이라고 합니다.
중첩 세션은 사이드바에서 원래 세션 아래에 들여 쓰여 표시되고, 작업을 마치면 결과를 원래 세션에 보고합니다.
서브에이전트와 달리 각자의 대화 기록이 있는 일반 세션이라서, 사이드바에서 선택해 직접 대화를 이어 갈 수도 있습니다.

다음과 같이 작업을 나눠 달라고 요청하면 Claude가 작업마다 중첩 세션을 시작합니다.

1
카페 페이지에서 두 가지 작업을 각각 별도 세션으로 나눠서 진행해 줘. 하나는 index.html의 메뉴 표에 마우스를 올리면 줄 색이 바뀌는 효과 추가, 다른 하나는 menu.md의 메뉴 설명을 손님이 읽기 좋게 다듬기야.

원래 세션 아래에 표시된 중첩 세션

Git 저장소에서는 중첩 세션이 각자의 워크트리에서 작업할 수 있어서, 여러 세션이 같은 파일을 고쳐도 변경이 섞이지 않습니다.
중첩 세션에 추가로 맡길 일은 원래 세션에 요청해도 되며, Claude가 해당 중첩 세션에 내용을 전달하고 받은 보고를 정리해 줍니다.
중첩 세션은 각자 모델에 요청을 보내므로, 세션 수가 늘어나는 만큼 플랜 사용량도 더 빨리 소모됩니다.

직접 나눠 달라고 하지 않아도, 진행 중인 작업과 관련 없는 일을 요청하면 Claude가 별도 세션에서 시작하시겠습니까? 카드로 새 세션에서 진행할지 물을 수 있습니다.
카드에서 새 세션을 선택하면 중첩 세션이 시작되고, 여기서 하기를 선택하면 지금 세션에서 진행합니다.
매번 묻지 않게 하려면 설정 > Claude Code의 관련 없는 작업을 요청할 때를 항상 여기서 실행이나 항상 새 세션 시작으로 바꿉니다.

중첩 세션이 많아지면 원래 세션을 마우스 오른쪽 버튼으로 클릭하고 중첩된 세션 숨기기를 선택해서 목록을 접습니다.
숨긴 중첩 세션 중에 승인이나 답변을 기다리는 세션이 있으면 원래 세션 아래에 표시됩니다.

Claude는 중첩 세션이 아닌 다른 세션도 확인하거나 메시지를 전달할 수 있습니다.
"결제 화면을 고치던 세션은 결론이 어떻게 났어?", "PR이 병합된 세션은 보관해 줘"처럼 평소 말투로 요청합니다.
이 기능은 데스크톱 앱이 실행하는 로컬, SSH, WSL 세션을 대상으로 하며, 터미널이나 클라우드에서 시작한 세션은 포함하지 않습니다.

# CLAUDE.md

CLAUDE.md는 Claude가 세션을 시작할 때마다 읽는 프로젝트 안내서입니다.
프로젝트 구조, 자주 사용하는 명령, 지켜야 할 규칙처럼 매번 설명하기 번거로운 내용을 작성해 놓으면 Claude가 처음부터 그 내용을 알고 작업합니다.

입력창에 /init을 입력하면 Claude가 폴더를 살펴보고 CLAUDE.md를 만들어 줍니다.

/init 명령

카페 페이지 폴더에서 실행하면 Claude가 개요, 파일 구조, 메뉴나 주소를 바꿀 때 함께 고쳐야 하는 위치, CSS 작성 규칙, 확인 방법 같은 내용을 정리할 수 있습니다.
만든 CLAUDE.md는 대화의 파일 경로를 클릭해서 파일 패널에서 확인하고 직접 고칠 수 있습니다.

생성된 CLAUDE.md

CLAUDE.md는 위치에 따라 적용 범위가 다릅니다.

데스크톱 앱과 터미널의 Claude Code는 같은 CLAUDE.md를 읽으므로, 한쪽에서 작성한 규칙이 다른 쪽에도 적용됩니다.
규칙을 추가할 때도 파일을 직접 열 필요 없이 다음과 같이 요청할 수 있습니다.

1
앞으로 메뉴를 바꿀 때는 menu.md와 index.html을 항상 함께 고친다는 규칙을 CLAUDE.md에 추가해 줘.

CLAUDE.md는 매 세션의 컨텍스트에 포함되므로 짧고 구체적으로 작성하는 것이 좋습니다.
더 자세한 작성 방법은 Claude Code CLI 핵심 정리의 CLAUDE.md를 참고하세요.

# 컨텍스트와 사용량

컨텍스트(Context)는 Claude가 한 번에 기억하며 작업할 수 있는 대화, 파일, 도구 정보의 양입니다.
세션 상세 패널의 컨텍스트 카드에 사용한 비율이 표시되고, 카드를 펼치면 메시지, 시스템 도구, MCP 도구, 스킬, 메모리 파일 등 항목별로 얼마나 차지하는지 확인할 수 있습니다.
입력창에 /context를 입력해도 같은 내용을 대화에 표시합니다.

컨텍스트 카드

컨텍스트가 가득 차면 Claude가 지금까지의 대화를 자동으로 요약하고 작업을 이어 갑니다.
/compact를 입력하면 원하는 시점에 요약해서 공간을 확보할 수 있고, 주제가 다른 작업은 새 세션에서 시작하는 것이 좋습니다.

입력창 아래 줄 맨 오른쪽의 원형 표시를 누르면 플랜 사용량을 확인할 수 있습니다.
5시간마다 초기화되는 사용 한도(Ultra 플랜은 없음)와 주간 사용 한도가 표시되며, 터미널, 웹, 데스크톱의 Claude Code 사용량이 모두 합산됩니다.
모두 보기를 누르면 설정 > 사용량 화면에서 자세한 내역을 확인할 수 있습니다.

플랜 사용량

# 사용자 지정

사이드바의 사용자 지정에서는 Claude의 기능을 넓히는 스킬, 커넥터, 플러그인을 한곳에서 관리합니다.
상단의 탭으로 종류를 고르고, 내 항목에서 설치한 항목을, 탐색에서 새 항목을 찾으며, + 추가 메뉴로 직접 만들거나 가져옵니다.
여기에서 관리하는 항목은 claude.ai 계정에 동기화되므로, Cowork에서도, 같은 계정으로 로그인한 터미널의 Claude Code에서도 사용할 수 있습니다.

사용자 지정의 Skills 탐색

스킬(Skills)은 특정 작업을 처리하는 방법을 담은 지침 묶음입니다.
Claude는 요청과 관련된 스킬을 스스로 불러오고, 입력창에 /스킬이름을 입력해서 직접 실행할 수도 있습니다.
로컬 세션에서는 계정 스킬과 함께 내 컴퓨터의 ~/.claude/skills/, 프로젝트의 .claude/skills/ 폴더에 있는 스킬도 사용합니다.

커넥터(Connectors)는 Google Drive, Gmail, Notion, Slack 같은 외부 서비스를 연결하는 기능으로, 그래픽 화면으로 설정하는 MCP 서버입니다.
입력창의 + > 커넥터 메뉴나 사용자 지정의 커넥터 탭에서 연결하며, 연결하면 Claude가 일정을 확인하거나 문서를 읽고 이슈를 만드는 등 해당 서비스를 직접 다룹니다.
목록에 없는 서비스는 원격 MCP 서버 주소로 사용자 지정 커넥터를 추가하거나, 설정 파일(~/.claude.json, .mcp.json)에 MCP 서버를 등록합니다.

사용자 지정의 커넥터

플러그인(Plugins)은 스킬, 에이전트, 훅(Hooks), MCP 서버를 하나로 묶어서 배포하는 패키지입니다.
입력창의 + > 플러그인 추가로 플러그인 목록을 열어 설치하며, 설치 범위는 모든 프로젝트에 적용하는 사용자 범위, 팀과 공유하는 프로젝트 범위, 나만 사용하는 로컬 범위 중에서 선택합니다.
데스크톱 앱에서 설치한 플러그인은 클라우드 세션과 WSL 세션에서는 사용할 수 없습니다.

플러그인 중에는 입력창 위에 사용량을 표시하거나 응답 아래에 버튼을 추가하는 것처럼 Claude Code의 화면을 바꾸는 Mod도 있습니다.
Mod는 터미널과 데스크톱의 Code 탭에서 함께 동작하고, 샌드박스 없이 사용자와 같은 권한으로 실행되므로 신뢰할 수 있는 작성자의 Mod만 설치합니다.

스킬과 플러그인을 직접 만드는 방법은 Claude Code CLI 핵심 정리의 Skills와 Plugins에서, Mod를 설치하고 만드는 방법은 Mods에서 자세히 살펴봅니다.

# 예약 작업

예약 작업(Scheduled tasks)을 만들면 정해진 시간과 주기마다 Claude가 새 세션에서 반복 작업을 자동으로 처리합니다.
사이드바의 예약됨에서 내 작업 목록과 템플릿을 확인할 수 있습니다.
템플릿에는 브리핑, 이메일 분류, PR 리뷰 요약, 종속성 업데이트 확인 같은 예시가 있어서 선택한 뒤 내용을 고쳐서 사용할 수 있습니다.

예약된 작업 템플릿

새 작업 메뉴에서 Claude로 만들기를 선택하면 대화로 작업을 만들고, 직접 설정을 선택하면 양식이 열립니다.
양식에서 작업 이름과 Claude가 실행할 지침을 작성하고, 지침 상자 아래에서 권한 모드와 모델을 고릅니다.
트리거(Trigger)는 정해진 일정에 실행하는 스케줄, GitHub 이벤트, API 호출 중에서 선택하며, 스케줄은 매시간, 매일, 평일, 매주 중에서 빈도를 고르고 시간을 지정합니다.
만든 뒤에 작업을 편집하면 직접 실행할 때만 동작하는 수동이나 cron 표현식을 사용하는 사용자 지정 일정으로도 바꿀 수 있습니다.

새 예약된 작업

예약 작업은 클라우드에서 실행하는 클라우드 작업과 내 컴퓨터에서 실행하는 로컬 작업으로 나뉩니다.
고급 설정의 이 컴퓨터에서만을 켜면 로컬 작업이 되고, 로컬 폴더에서 작업할 폴더를 선택합니다.

고급 설정

로컬 작업은 컴퓨터가 잠자기 상태이거나 앱이 닫혀 있으면 실행되지 않으므로, 꼭 실행되어야 하는 작업은 클라우드 작업이 적합합니다.
세션에서 평소 말투로 요청해도 예약 작업을 만들 수 있습니다.

1
매주 월요일 오전 9시에 menu.md와 index.html의 메뉴와 가격이 서로 같은지 확인하고, 다르면 무엇이 다른지 알려 주는 작업을 예약해 줘.

"내일 오후 3시에 배포 상태를 확인하라고 알려 줘"처럼 한 번만 실행할 작업을 요청하면, 실행된 뒤에 스스로 꺼지는 작업으로 만들어집니다.

# 컴퓨터 사용

컴퓨터 사용(Computer use)은 Claude가 내 컴퓨터의 앱을 열고 화면을 보면서 클릭하고 입력하는 기능입니다.
명령줄이나 API가 없어서 화면으로만 조작할 수 있는 앱의 작업을 맡길 때 사용합니다.
Pro, Max, Ultra 플랜의 macOS(14 이상)와 Windows에서 연구 미리보기로 제공되며, Team과 Enterprise 플랜에서는 사용할 수 없습니다.

컴퓨터 사용은 기본으로 꺼져 있으며, 설정 > 이 컴퓨터 > 시스템의 컴퓨터 사용 항목에서 컴퓨터 사용 활성화를 켭니다.
macOS에서는 Claude가 클릭하고 입력하는 데 필요한 손쉬운 사용(Accessibility) 권한과 화면을 보는 데 필요한 화면 기록(Screen Recording) 권한도 허용해야 합니다.
설정 화면에서 각 권한의 상태를 확인할 수 있고, 거부된 권한을 누르면 시스템 설정의 해당 화면이 열립니다.

컴퓨터 사용 설정

macOS에서는 Claude가 앱을 사용하는 방식을 고를 수 있습니다.
백그라운드는 사용자가 컴퓨터를 계속 사용하는 동안 허용한 앱 안에서만 작업하고, 전체 제어는 화면, 마우스, 키보드를 Claude가 직접 제어합니다.
거부된 앱에 추가한 앱은 Claude의 접근 요청이 자동으로 거부되므로, 메모나 사진처럼 개인 정보가 많은 앱을 추가하면 좋습니다.

Claude가 처음 어떤 앱을 사용하려고 하면 세션에 승인 요청이 표시되고, 승인은 그 세션 동안 유지됩니다.
앱의 종류에 따라 Claude가 할 수 있는 동작은 정해져 있습니다.

컴퓨터 사용은 가장 넓지만 가장 느린 방법이라서, Claude는 커넥터, 셸 명령, Claude in Chrome처럼 더 정확한 도구를 먼저 사용하고 다른 방법이 없을 때만 화면을 조작합니다.
샌드박스 안에서 실행되는 명령과 달리 실제 데스크톱에서 동작하므로, 민감한 정보가 열려 있는 앱은 승인하지 않는 것이 좋습니다.
macOS에서 iOS 앱을 개발한다면 컴퓨터 사용을 켜지 않아도 Claude가 iOS 시뮬레이터 패널에서 앱을 실행하고 확인할 수 있습니다.

# 클라우드와 Remote Control

시간이 오래 걸리는 작업은 클라우드에서 실행할 수 있습니다.
새 세션의 환경 메뉴에서 클라우드를 선택하고 작업할 GitHub 저장소를 고르면, 세션이 Anthropic의 서버에서 실행되어 앱을 닫거나 컴퓨터를 꺼도 작업이 계속됩니다.
진행 상황은 데스크톱 앱이나 claude.ai/code, Claude 모바일 앱에서 언제든 확인하고 추가 지시를 보낼 수 있으며, 사용량은 플랜 한도에 포함됩니다.
이미 로컬에서 시작한 세션은 세션 메뉴의 다음에서 열기 > 클라우드로 옮길 수 있고, 이때 대화는 요약되어 넘어갑니다.
여러 클라우드 세션으로 나눠야 하는 큰 작업은 프로젝트(Projects)를 사용합니다(Pro, Max, Ultra 플랜에 베타로 순차 제공).
하나의 대화에서 Claude가 작업마다 클라우드 세션을 시작하고 진행 상황을 정리해 주며, 프로젝트의 지침은 새로 시작하는 모든 세션에 적용됩니다.
오늘 안에 끝낼 작업은 중첩 세션으로 나누고, 며칠에 걸쳐 작업이 계속 생기거나 컴퓨터를 꺼 둔 동안에도 진행해야 하는 작업은 프로젝트를 사용하는 것이 좋습니다.
프로젝트는 여러 세션이 동시에 실행되므로 하나의 세션보다 플랜 사용량을 빨리 소모합니다.

Remote Control은 내 컴퓨터에서 실행 중인 로컬 세션을 휴대폰이나 다른 컴퓨터의 브라우저에서 이어서 사용하는 기능입니다.
세션 상세 패널의 환경 카드에 있는 Remote Control 스위치를 켜거나 입력창에 /remote-control을 입력하면, 그 세션이 claude.ai/code와 Claude 앱의 세션 목록에 표시됩니다.
작업은 계속 내 컴퓨터에서 실행되므로 로컬 파일과 도구를 그대로 사용합니다.

Remote Control 설정

설정 > Claude Code의 Remote Control 항목에서 동작을 정합니다.

• 새 세션을 Remote Control에 연결: 새 세션이 시작될 때 자동으로 연결
• 휴대폰 및 claude.ai에서 여기에 세션을 시작할 수 있도록 허용: 다른 기기에서 이 컴퓨터의 폴더로 새 세션을 시작
• Remote Control 사용을 위해 이 컴퓨터를 절전 모드로 전환하지 않음: 연결된 동안 잠자기 방지

Remote Control이 켜져 있는 동안에는 대화 기록이 Anthropic 서버에 저장되어 다른 기기에 전달됩니다.
다른 기기에 세션을 표시하고 싶지 않으면 세션의 스위치를 끄거나 위의 자동 연결 설정을 끕니다.

이 밖에 개인 서버나 클라우드 가상 머신에서 작업하려면 환경 메뉴의 새 환경에서 SSH 연결을 추가합니다.
처음 연결할 때 원격 컴퓨터에 Claude Code가 자동으로 설치되고, 이후에는 로컬 세션과 같은 화면으로 원격 컴퓨터의 파일을 다룹니다.

# 주요 설정

설정 > Claude Code에는 Code 화면의 동작을 바꾸는 설정이 모여 있습니다.
설정 화면은 사이드바 하단의 프로필 메뉴에서 설정을 선택하거나 Cmd + , 키로 열고, 왼쪽 위의 검색창에서 항목 이름으로 찾을 수 있습니다.

Claude Code 설정

데스크톱 앱은 터미널의 Claude Code와 같은 설정 파일(~/.claude/settings.json, .claude/settings.json)도 읽습니다.
권한 규칙이나 훅처럼 화면에 없는 설정은 설정 파일에 작성하면 데스크톱 세션에도 적용됩니다.

# CLI와 함께 사용

데스크톱 앱과 터미널의 Claude Code는 같은 엔진을 사용하므로 한 컴퓨터에서 동시에, 같은 프로젝트에서도 함께 사용할 수 있습니다.
다음 설정은 두 환경이 함께 사용합니다.

• CLAUDE.md와 CLAUDE.local.md
• 설정 파일(~/.claude/settings.json 등)의 권한 규칙과 훅
• ~/.claude.json, .mcp.json에 등록한 MCP 서버
• ~/.claude/skills/, .claude/skills/의 스킬

세션 목록은 따로 관리되지만, 터미널에서 진행하던 세션을 데스크톱에서 이어 갈 수 있습니다.
터미널의 세션에서 /desktop을 입력하면 세션을 저장해서 데스크톱 앱으로 열고 터미널은 종료됩니다.
반대로 데스크톱의 입력창에서 /resume을 입력하면 이 컴퓨터의 터미널에서 시작한 세션 목록이 표시되고, 선택한 세션이 전체 대화와 함께 이어집니다.

1
2
3
4
5
# 현재 폴더로 데스크톱 앱 열기
claude --desktop

# 이 폴더의 가장 최근 대화를 데스크톱 앱에서 이어 하기
claude --desktop --continue

데스크톱 앱의 로컬 세션은 앱에 포함된 별도의 Claude Code를 사용하므로, 터미널의 claude 명령과 버전이 다를 수 있습니다.
Code 탭에서 /status를 입력하면 세션이 사용하는 버전을 확인할 수 있고, 앱을 업데이트하면 새 세션부터 새 버전이 적용됩니다.

여러 세션을 한 창에서 관리하고 변경 사항을 눈으로 확인하며 작업하려면 데스크톱 앱이, 스크립트나 자동화와 함께 사용하려면 터미널이 편리합니다.
터미널에서만 사용하는 기능과 플래그는 Claude Code CLI 핵심 정리에서 살펴볼 수 있습니다.