첫 사용법
Claude Desktop을 설치했다면, 각 모드를 처음 사용하는 방법을 알아보겠습니다.
첫 사용 단계 — 5단계 시작 흐름
claude 입력claude 명령어를 실행합니다. 브라우저에서 인증 페이지가 자동으로 열립니다.나에게 맞는 모드 찾기
Claude에는 세 가지 모드가 있습니다. 무엇을 하고 싶은지에 따라 어떤 모드를 사용할지 결정하세요.
Chat 모드부터 시작하세요! 설치 직후 바로 사용할 수 있고, 질문·번역·요약·브레인스토밍 등 대부분의 일상적인 작업을 처리할 수 있습니다. 다른 모드가 필요하다고 느껴질 때 확장해 나가면 됩니다.
Desktop 앱 vs 터미널 vs 웹: 어디서 시작할까?
| 환경 | 추천 대상 | 장점 | 시작 방법 |
|---|---|---|---|
| Desktop 앱 | 처음 사용자, 비개발자 | GUI 방식, 드래그앤드롭, 직관적 | claude.ai/download에서 다운로드 |
| 웹 (claude.ai) | 설치 없이 바로 체험하고 싶은 분 | 가입 즉시 사용 가능, 설치 불필요 | claude.ai 접속 |
| 터미널 (CLI) | 개발자, 코드 직접 편집이 필요한 분 | 코드 직접 편집, Git 연동, 자동화 | curl -fsSL https://claude.ai/install.sh | bash |
Chat 모드 시작하기
Claude Desktop을 실행하면 기본적으로 Chat 모드가 열립니다.
Claude Desktop 앱을 열면 중앙에 텍스트 입력창이 보입니다. 여기에 원하는 질문이나 요청을 자연스럽게 입력하면 됩니다. 입력창 왼쪽 하단의 클립(📎) 아이콘을 누르면 파일을 첨부할 수 있고, 새 대화를 시작하려면 왼쪽 상단의 + 버튼을 누르세요. 특별한 문법 없이 평소 말하듯이 입력하면 됩니다.
기본 대화
- 하단의 입력창에 질문이나 요청을 입력합니다
- Enter를 눌러 전송합니다
- Claude가 응답을 생성합니다
파일 첨부
입력창 왼쪽의 클립 아이콘을 클릭하거나, 파일을 직접 드래그 앤 드롭하여 첨부할 수 있습니다.
지원하는 파일 형식:
- 문서: PDF, DOCX, TXT, MD
- 이미지: PNG, JPG, GIF, WebP
- 코드: 대부분의 프로그래밍 언어 파일
- 단일 파일 최대 크기: 25MB (PNG/JPG 이미지는 5MB)
- 한 번의 대화에서 첨부 가능한 최대 파일: 약 10개
- 이미지는 자동으로 리사이징될 수 있습니다
- PDF는 텍스트 추출 방식으로 처리되며, 스캔된 이미지 PDF는 인식률이 낮을 수 있습니다
- Pro/Max 플랜은 더 많은 파일 첨부를 지원합니다
실전 예제: Chat 모드로 코드 리뷰 요청하기
사용자: 이 Python 함수를 리뷰해줘 [코드 파일 첨부]
Claude: 코드를 분석했습니다. 다음과 같은 개선점이 있습니다:
1. 예외 처리가 너무 넓습니다 - 구체적인 예외 타입을 사용하세요
2. 변수명이 불명확합니다 - `d` 대신 `data`를 권장합니다
3. ...
프로젝트 만들기
관련 대화를 묶어서 관리하려면 프로젝트를 만듭니다:
- 좌측 사이드바에서 "새 프로젝트" 클릭
- 프로젝트 이름 입력
- 프로젝트 지침(Instructions) 설정 (선택사항)
- 관련 파일을 프로젝트에 추가
Cowork 모드 시작하기
Cowork 모드는 Claude에게 작업을 위임하는 방식으로 동작합니다.
작업 위임하기
- Claude Desktop 좌측 사이드바에서 Cowork 탭을 선택합니다
- 새 대화를 시작하고 수행할 작업을 구체적으로 설명합니다
- Claude가 백그라운드(Background)에서 자율적으로 작업을 시작합니다
- 작업 진행 상황을 실시간으로 확인할 수 있습니다
- 완료되면 결과를 검토하고 필요 시 추가 피드백을 제공합니다
좋은 위임 예시
- "최근 3개월간 AI 코딩 도구 시장 트렌드를 조사해서 정리해줘"
- "이 PDF 보고서를 분석하고 핵심 인사이트를 정리해줘"
- "경쟁사 3곳의 가격 정책을 비교 분석해줘"
실전 예제: Cowork 모드로 리서치 위임하기
사용자: "2024년 한국 SaaS 시장 규모와 주요 트렌드를 조사해서
표와 함께 정리해줘. 특히 AI 관련 SaaS에 집중해줘."
Claude: [백그라운드에서 작업 시작]
→ 웹 검색으로 시장 데이터 수집
→ 주요 기업 및 제품 분석
→ 트렌드 정리 및 표 작성
→ 최종 보고서 형태로 정리하여 제출
Code 모드 시작하기
터미널에서 Claude Code를 실행합니다:
# 현재 디렉토리에서 시작
claude
# 특정 작업 바로 실행
claude "이 프로젝트의 구조를 설명해줘"
권한 모드 이해하기
Claude Code는 파일을 수정하고 터미널 명령어를 실행할 수 있습니다. 처음에는 기본 default 모드로 시작하여, 모든 변경 사항을 직접 확인하면서 진행하세요.
| 권한 모드 | 동작 | 권장 상황 |
|---|---|---|
default (기본값) | 파일 수정, 명령 실행 시 매번 확인 | 처음 사용, 중요한 프로젝트 |
auto | 안전한 변경은 자동 승인 | Claude Code에 익숙해진 후 |
기본 사용법
Claude Code가 실행되면 자연어로 요청할 수 있습니다:
> 이 프로젝트에서 사용하지 않는 import를 찾아서 정리해줘
> 이 함수에 대한 단위 테스트를 작성해줘
> package.json의 의존성을 최신 버전으로 업데이트해줘
실전 예제: Code 모드로 버그 수정하기
$ claude
> src/api/users.ts에서 404 에러가 발생하는 버그를 수정해줘
Claude: 파일을 분석하겠습니다.
→ [파일 읽기: src/api/users.ts]
→ 문제를 발견했습니다. getUserById 함수에서 ID가 문자열로 비교되고 있습니다.
수정할 내용:
- 파일: src/api/users.ts (17번째 줄)
- 변경: `if (user.id == id)` → `if (user.id === Number(id))`
이 변경을 적용할까요? (y/n)
키보드 단축키
Code 모드에서 사용할 수 있는 주요 단축키입니다:
기본 단축키
| 단축키 | 동작 |
|---|---|
Enter | 메시지 전송 |
Shift+Enter | 줄바꿈 (멀티라인 입력) |
Escape | 현재 응답 생성 중단 |
Ctrl+C | 진행 중인 작업 취소 |
Ctrl+D | 세션 종료 |
Tab | 파일 경로 자동 완성 / 프롬프트 제안 수락 |
Up/Down | 이전/다음 입력 히스토리 |
Ctrl+P / Ctrl+N | 이전/다음 히스토리 탐색 (Up/Down 화살표 별칭) |
Ctrl+R | 이전 명령 역방향 검색 (readline/fzf) |
Alt+Y | 붙여넣기 히스토리 순환 |
? | 사용 가능한 단축키 목록 보기 |
/ | 슬래시 명령어 입력 시작 |
@ | 파일 경로 멘션 자동완성 |
Ctrl+L | 화면 지우기 |
Ctrl+V / Cmd+V | 클립보드에서 이미지 붙여넣기 (스크린샷, 다이어그램 등) |
Alt+V | 클립보드에서 이미지 붙여넣기 (Windows 전용) |
Left/Right | 대화상자 내 탭(버튼) 간 이동 |
편집 단축키
| 단축키 | 동작 |
|---|---|
Ctrl+A | 줄 처음으로 이동 |
Ctrl+E | 줄 끝으로 이동 |
Ctrl+K | 커서 이후 줄 삭제 |
Ctrl+U | 커서 앞의 텍스트 삭제 |
Ctrl+W | 이전 단어 삭제 |
Ctrl+Y | 붙여넣기 |
Alt+B / Option+B | 이전 단어로 이동 |
Alt+F / Option+F | 다음 단어로 이동 |
기능 단축키
| 단축키 | 동작 |
|---|---|
Ctrl+O | 상세 모드 토글 / 트랜스크립트 뷰어 |
Ctrl+E | 편집기에서 트랜스크립트 열기 |
Ctrl+T | 작업 목록(Task List) 보기 |
Ctrl+B | 백그라운드 태스크 실행 |
Ctrl+G | 외부 에디터에서 입력 편집 (Ctrl+X Ctrl+E 와 동일) |
Ctrl+X Ctrl+E | 외부 에디터 열기 (별칭) |
Ctrl+X Ctrl+K | 모든 백그라운드 에이전트 종료 |
Esc+Esc | 입력 취소 |
Option+T / Alt+T | 확장 사고(Extended Thinking) 토글 |
Option+O / Alt+O | 빠른 모드(Haiku) 전환 |
Option+P / Alt+P | 모델 선택 메뉴 열기 |
Shift+Tab | 권한 모드 순환 (default → acceptEdits → plan → auto) 및 Plan Mode 토글 |
Alt+M | 권한 모드 순환 (Shift+Tab과 동일한 대체 단축키) |
트랜스크립트 뷰어 단축키
Ctrl+O로 트랜스크립트 뷰어를 열면 아래 단축키를 사용할 수 있습니다:
| 키 | 동작 |
|---|---|
Ctrl+E | 외부 편집기에서 트랜스크립트 열기 |
[ | 전체 대화를 터미널 스크롤백에 기록 (검색 가능) |
v | 선택한 메시지 내용 보기 |
q | 뷰어 닫기 |
다중 줄 입력
긴 프롬프트나 코드 스니펫을 여러 줄에 걸쳐 입력할 수 있습니다:
| 방법 | 동작 |
|---|---|
\ + Enter | 줄 이어 쓰기 (역슬래시 후 엔터) |
Option+Enter / Alt+Enter | 새 줄 추가 |
Shift+Enter | 일부 터미널에서 새 줄 삽입 |
Ctrl+J | 새 줄 삽입 |
코드를 붙여넣기하면 자동으로 멀티라인으로 처리됩니다.
프롬프트 제안
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=1 환경변수를 설정하면 입력 중 프롬프트 제안이 활성화됩니다:
Tab- 제안된 전체 텍스트 수락→(Right Arrow) - 제안된 텍스트 부분 수락 (단어 단위)
세션 선택기 단축키
claude --resume 또는 /resume 명령으로 세션 선택기를 열면 다음 단축키를 사용할 수 있습니다:
| 키 | 동작 |
|---|---|
P | 이전 세션 (Previous) |
R | 최근 세션 목록 (Recent) |
A | 모든 세션 목록 (All) |
B | 현재 브랜치의 세션 (Branch) |
PR 상태 색상 표시
GitHub PR 관련 작업 시 상태가 색상으로 표시됩니다:
| 색상 | 상태 |
|---|---|
| 🟢 초록 | CI 통과, 승인됨 |
| 🟡 노랑 | CI 진행 중 또는 검토 대기 |
| 🔴 빨강 | CI 실패 또는 변경 요청 |
| ⚫ 회색 | CI 상태 없음 |
| 🟣 보라 | 이미 병합됨 |
PR 상태는 60초마다 자동으로 업데이트됩니다. PR URL에 Cmd+클릭(macOS) / Ctrl+클릭(Windows/Linux)으로 브라우저에서 바로 열 수 있습니다.
@ 파일 경로 멘션
@를 입력하면 파일/디렉토리 경로 자동완성이 활성화됩니다:
> @src/components/Button.tsx를 리팩토링해줘
> @package.json의 의존성을 확인해줘
Vim 에디터 모드
Vim 에디터 모드를 활성화하면 NORMAL/INSERT 모드로 입력을 제어할 수 있습니다:
> /vim
또는 설정에서 영구 활성화:
{
"editorMode": "vim"
}
NORMAL 모드 주요 키바인딩:
| 키 | 동작 |
|---|---|
h/j/k/l | 좌/하/상/우 이동 |
w/b/e | 단어 단위 이동 |
0/^/$ | 줄 처음/공백 제외 처음/끝으로 |
gg/G | 버퍼 시작/끝으로 이동 |
f{c}/F{c} | 앞/뒤 방향으로 문자 c 위치로 이동 |
t{c}/T{c} | 앞/뒤 방향으로 문자 c 직전 위치로 이동 |
;/, | 마지막 f/t 이동 반복/역반복 |
i/a/I/A | INSERT 모드 진입 |
o/O | 아래/위에 새 줄 추가 후 INSERT |
dd/yy | 줄 삭제/복사 |
p/P | 아래/위에 붙여넣기 |
u | 실행 취소 |
V | Visual 줄 선택 모드 |
ci{/ca{ | {} 안/포함 텍스트 변경 (텍스트 오브젝트) |
/ | 검색 |
Esc | NORMAL 모드로 복귀 |
! 배시(Bash) 직접 실행 모드
입력창에 !를 먼저 입력하면 Claude를 거치지 않고 셸 명령어를 직접 실행하는 배시 모드가 활성화됩니다:
> !ls -la
> !git status
배시 모드 사용 팁:
Tab— 히스토리 자동완성Ctrl+C또는 빈Enter— 배시 모드 종료
백그라운드 작업 제한 사항
백그라운드 작업(Ctrl+B)에는 다음과 같은 제한이 있습니다:
- 최대 출력 크기: 5GB
- 비활성화 방법:
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1환경변수 설정
# 백그라운드 작업 비활성화
export CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1
/btw — 현재 작업 흐름을 방해하지 않는 부가 질문
/btw 명령어를 사용하면 현재 진행 중인 작업 맥락을 방해하지 않고 별도의 부가적인 질문을 할 수 있습니다:
> /btw 이 함수 이름을 좀 더 명확하게 바꾸면 어떨까?
Claude가 부가 질문에 답변한 뒤, 원래 작업 흐름을 이어서 계속 진행합니다.
세션 요약 기능
Claude Code는 긴 대화를 자동으로 요약하여 컨텍스트를 효율적으로 관리합니다:
/recap— 현재 세션의 요약을 명시적으로 요청/config에서sessionSummary옵션으로 자동 요약 활성화/비활성화 설정 가능
/terminal-setup — VS Code / Cursor에서 Shift+Enter 설정
VS Code나 Cursor의 통합 터미널에서 Shift+Enter로 줄바꿈하려면 별도 키바인딩 설정이 필요합니다. /terminal-setup 명령어를 실행하면 안내를 확인할 수 있습니다:
> /terminal-setup
macOS 기본 Terminal.app이나 iTerm2에서 Alt+B, Alt+F, Alt+Y 등 Meta 키 단축키를 사용하려면, 터미널 환경 설정에서 Option 키를 Meta 키로 설정해야 합니다. iTerm2는 Profiles → Keys → Left Option Key: Esc+ 로 설정합니다.
음성 입력 (Voice Dictation)
Push-to-talk 방식의 음성 받아쓰기를 지원합니다. 마이크 버튼을 누르거나 해당 단축키를 누른 상태에서 말하면 텍스트로 변환됩니다.
| 방법 | 동작 |
|---|---|
Space 길게 누르기 | 음성 받아쓰기 활성화 (누르는 동안 녹음) |
| 마이크 버튼 클릭 | 음성 받아쓰기 토글 |
더 나은 결과를 얻는 팁
Claude에게 더 좋은 결과를 얻으려면 다음 원칙을 따르세요.
1. 구체적으로 지시하기
# 나쁜 예
> 코드 좀 고쳐줘
# 좋은 예
> src/utils/date.ts의 formatDate 함수에서 한국 시간대(KST)가
적용되지 않는 버그를 수정해줘. UTC+9를 기본으로 사용해야 해.
2. 컨텍스트 제공하기
# 나쁜 예
> 테스트 작성해줘
# 좋은 예
> src/services/auth.ts의 login 함수에 대한 단위 테스트를 작성해줘.
이 프로젝트는 Vitest를 사용하고, 테스트 파일은 __tests__ 디렉토리에
넣어야 해. 성공/실패/토큰 만료 케이스를 포함해줘.
3. 단계별로 요청하기
# 복잡한 작업은 단계별로 나누기
> 1단계: 먼저 현재 데이터베이스 스키마를 분석해줘
> 2단계: 사용자 프로필에 avatar_url 필드를 추가하는 마이그레이션을 만들어줘
> 3단계: 해당 필드를 사용하는 API 엔드포인트를 수정해줘
자주 하는 실수와 해결법
| 실수 | 문제점 | 해결법 |
|---|---|---|
| 프로젝트 외부에서 claude 실행 | 프로젝트 파일을 인식하지 못함 | 반드시 프로젝트 루트에서 claude 실행 |
| CLAUDE.md 없이 시작 | 매번 컨텍스트를 반복 설명해야 함 | claude /init으로 CLAUDE.md 생성 |
| 너무 큰 범위의 요청 | 품질 저하, 잘못된 수정 가능 | 파일 단위 또는 기능 단위로 나눠서 요청 |
| 결과 확인 없이 auto 모드 | 의도치 않은 파일 수정 가능 | 처음에는 default 모드로 변경 내용 확인 |
| 영어로만 요청 | 한국어 프로젝트에서 주석이 영어로 생성됨 | CLAUDE.md에 "한국어로 주석 작성" 명시 |
연계 기능
첫 사용 후 더 깊이 활용하기 위해 이어지는 문서들과의 연관 관계입니다.
installation.md — 아직 설치하지 않았거나 설치에 문제가 생겼을 때 돌아가서 참고합니다. OS별 설치 방법과 트러블슈팅을 제공합니다.
settings.md — 권한 모드, 허용/차단 도구 목록, CLAUDE.md 등 첫 사용 후 환경을 세밀하게 조정하는 방법을 다룹니다.
basic-workflow.md — 5단계를 거쳐 감을 익힌 후, 일상적인 개발 작업(버그 수정, PR 리뷰, 리팩토링 등)을 효율적으로 처리하는 패턴을 배웁니다.
장점, 단점과 한계점
장점
- 세 모드 즉시 체험 가능: Chat, Cowork, Code 세 가지 모드를 설치 직후 바로 사용해볼 수 있어 자신에게 맞는 활용법을 빠르게 찾을 수 있습니다.
- 직관적인 시작: 자연어로 요청만 하면 되므로 별도의 문법이나 명령어를 배우지 않아도 즉시 활용할 수 있습니다.
- 다양한 활용 가능: 코드 리뷰, 버그 수정, 리서치 위임, 문서 분석 등 개발과 비개발 작업 모두에 활용할 수 있습니다.
단점과 한계점
- 모드 선택 혼란 가능: Chat, Cowork, Code 세 가지 모드의 차이와 적합한 상황을 처음에 구분하기 어려울 수 있습니다.
- 권한 모드 이해 필요: Code 모드의
default/auto권한 모드 개념을 이해하지 않으면 의도치 않은 파일 수정이 발생하거나, 반대로 매번 확인 요청에 피로감을 느낄 수 있습니다. - 최적 활용법 학습 곡선: 구체적인 프롬프트 작성법, 단계별 요청 기법 등 효과적인 활용 방법을 익히는 데 시간이 필요합니다.
- 초기 비용 예측 어려움: 사용량 기반 과금 구조를 처음 접하면 작업별 토큰 소비량과 비용을 예측하기 어렵습니다.
처음에는 Code 모드의 default 모드(기본값)로 시작하여 Claude가 어떤 작업을 수행하는지 하나씩 확인하면서 감을 익히세요. /cost 명령어로 현재 세션의 비용을 수시로 확인하면 비용 관리에 도움이 됩니다.
다음 단계 가이드
목적에 따라 다음으로 읽을 문서를 선택하세요:
시작
├─ Desktop 앱 사용이 주 목적 → [Chat 모드 상세](/docs/chat/overview)
├─ 코드 작업이 주 목적 → [Code 모드 개요](/docs/code/overview)
├─ 설정을 먼저 정리하고 싶다 → [설정](/docs/getting-started/settings)
└─ 팀에서 함께 사용 → [Cowork 모드](/docs/cowork/overview)
- 설정 - 각 모드의 세부 설정
- Chat 모드 상세 - Chat 모드 깊이 알아보기
- Code 모드 개요 - AI 코딩 에이전트 알아보기