설치와 첫 세션

무엇을 맡길지 정했으면, 이제 내 환경에 Claude를 올립니다. 설치부터 첫 파일까지.

이미 아는 내용이면 건너뛰기

아래 세 가지에 막힘없이 답할 수 있으면 이 단원은 건너뛰고 다음으로 가도 됩니다.

내 환경에 맞는 창구를 골라 Claude Code를 이미 설치하고 로그인했나요?
무엇을 물어보고 무엇을 바로 실행하는지, 권한 모드를 이해하고 있나요?
첫 세션에서 파일을 하나 만들거나 고쳐 본 적이 있나요?

다음 단원으로 — 요청하는 법 →

학습 카드 2장

이 단원의 학습 카드

모든 학습 카드 내용을 아래에서 차례로 볼 수 있습니다.

01 설치 설치 설치 Claude 데스크톱 앱과 Claude Code CLI를 설치하고 같은 프로젝트 폴더에서 시작할 수 있습니다

Claude 설치

Claude 공식 다운로드 페이지에서 운영체제에 맞는 데스크톱 앱을 설치합니다
로그인 후 Code → Local → Select folder 순서로 프로젝트 폴더 하나를 엽니다
macOS용 Claude 공식 다운로드
Windows용 Claude 공식 다운로드
Windows ARM64용 Claude 공식 다운로드
이용 가능 요금제: Pro, Max, Team, Enterprise (무료 요금제 제외)
회사에서 발급받은 Anthropic Console 계정으로도 터미널의 Claude Code를 쓸 수 있습니다

Claude Code CLI 설치

CLI(Command Line Interface, 명령줄 인터페이스): 앱 화면의 버튼 대신 터미널에 명령어를 입력해 Claude Code를 실행하는 방식
터미널을 열어 본 적이 없어도 됩니다
설치 방법: 아래 설치 순서의 명령어 토글 안 문장을 그대로 붙여넣고 엔터
이후 과정에서 터미널 명령과 자동 실행을 다루므로 앱 설치 바로 다음에 함께 설치합니다
설치 명령은 이 페이지와 공식 문서에 적힌 것만 실행하고, 다른 곳에서 받은 설치 스크립트는 실행하지 않습니다

같은 프로젝트 폴더를 엽니다

워크스페이스: 프로젝트 폴더를 여러 개 모아 둔 상위 폴더
Claude가 읽고 고칠 수 있는 범위는 연 폴더에서 시작합니다
작업 대상은 워크스페이스 전체 대신 지금 진행할 프로젝트 폴더 하나로 고릅니다
연결 확인: 앱과 터미널에서 같은 프로젝트 이름과 최상위 파일 목록이 보이면 맞습니다
첫 요청에는 파일을 고치지 말라는 조건을 함께 적습니다

Claude 공식 다운로드 페이지를 열고 macOS와 Windows 중 쓰고 있는 운영체제에 맞는 설치 파일을 내려받습니다.
Claude 공식 다운로드 열기
확인페이지에 macOS용과 Windows용 다운로드 버튼이 보이고 누르면 내려받기 폴더에 설치 파일이 생깁니다.

이 단계의 실제 화면

화면에서 확인할 것 운영체제에 맞는 Claude 데스크톱 앱을 받습니다. 출처는 Claude 공식 다운로드 페이지입니다. Claude 공식 웹 · 2026-08-19
내려받은 설치 파일을 실행해 앱을 설치하고 Claude 계정으로 로그인한 다음 앱 안에서 Code를 엽니다.
Claude 데스크톱 앱 시작 안내 열기
확인Claude 앱이 열리고 Code 화면으로 넘어갑니다.

이 단계의 실제 화면

화면에서 확인할 것 앱 설치, 로그인, Code 열기 순서를 확인합니다. 출처는 Claude Code 공식 문서입니다. Claude Code Docs · 2026-08-19
Code 화면에서 Local을 고르고 Select folder를 눌러, 프로젝트를 모아 둔 상위 폴더 대신 지금 작업할 프로젝트 폴더 하나를 엽니다.

확인화면에 방금 고른 프로젝트 폴더 이름이 표시됩니다.

이 단계의 실제 화면

화면에서 확인할 것 Code에서 Local과 Select folder를 차례로 선택합니다. 출처는 Claude Code 공식 문서입니다. Claude Code Docs · 2026-08-19
macOS나 Linux를 쓰면 터미널을 엽니다. macOS는 command와 스페이스를 함께 눌러 Spotlight 검색을 열고 Terminal을 입력한 뒤 엔터를 누르며, Linux는 control과 alt와 T를 함께 누릅니다. 창이 열리면 아래 명령어 토글을 펼쳐 설치 명령을 붙여넣고 엔터를 누릅니다.
터미널이 처음이라면 공식 안내 열기
명령어로 직접 하기

claude.ai에서 설치 파일을 내려받아 그대로 실행하는 명령입니다. macOS와 Linux에서 공식 문서가 권장하는 방식이며 Node.js를 미리 설치하지 않아도 됩니다.
```
curl -fsSL https://claude.ai/install.sh | bash
```
확인글자가 한동안 흐른 뒤 Claude Code successfully installed! 문장이 나옵니다.

이 단계의 실제 화면

화면에서 확인할 것 운영체제에 맞는 공식 CLI 설치 명령을 확인합니다. 출처는 Claude Code 공식 설치 문서입니다. Claude Code Docs · 2026-08-19
Windows를 쓰면 PowerShell을 엽니다. 윈도우 키와 X를 함께 누른 뒤 메뉴에서 Windows PowerShell 또는 터미널을 고릅니다. 창이 열리면 아래 명령어 토글을 펼쳐 설치 명령을 붙여넣고 엔터를 누릅니다.
Windows용 공식 터미널 안내 열기
명령어로 직접 하기

irm이 claude.ai에서 설치 파일을 가져오고 iex가 그 파일을 실행합니다. Windows PowerShell에서 공식 문서가 권장하는 명령입니다.
```
irm https://claude.ai/install.ps1 | iex
```
확인글자가 한동안 흐른 뒤 Claude Code successfully installed! 문장이 나옵니다.

이 단계의 실제 화면

화면에서 확인할 것 Windows에서는 PowerShell용 명령을 사용합니다. 출처는 Claude Code 공식 설치 문서입니다. Claude Code Docs · 2026-08-19
설치에 쓴 창을 닫고 터미널이나 PowerShell을 새로 연 다음, 아래 명령어 토글의 확인 명령 두 줄을 차례로 실행합니다.
Claude Code 공식 설치 안내 열기
명령어로 직접 하기

첫 줄은 설치된 버전을 출력합니다. 둘째 줄은 세션을 시작하지 않고 설치 상태와 설정 파일을 점검한 결과를 보여 줍니다.
```
claude --version
claude doctor
```
확인첫 명령에서 2.1.211 (Claude Code)처럼 버전 번호가 나오고 둘째 명령에서 점검 결과가 나옵니다.

이 단계의 실제 화면

화면에서 확인할 것 설치 뒤 새 터미널에서 버전과 상태를 확인합니다. 출처는 Claude Code 공식 설치 문서입니다. Claude Code Docs · 2026-08-19
앱에서 연 것과 같은 프로젝트 폴더로 터미널의 위치를 옮기고 Claude Code를 실행한 뒤, 파일을 고치지 않는 요청으로 폴더가 맞는지 확인합니다.
```
지금 선택한 프로젝트 폴더의 이름과 최상위 파일·폴더 이름만 보여 줘. 파일은 아직 고치지 마.
```
명령어로 직접 하기

첫 줄은 터미널이 보고 있는 위치를 그 폴더로 옮깁니다. cd를 입력하고 한 칸 띄운 다음 Finder나 파일 탐색기에서 폴더를 창 안으로 끌어다 놓으면 경로가 대신 입력됩니다. 둘째 줄은 그 폴더에서 Claude Code를 시작합니다.
```
cd 프로젝트-폴더-경로
claude
```
확인앱에서 본 것과 같은 프로젝트 이름과 최상위 목록이 나오고 파일은 하나도 바뀌지 않습니다.

연습

Claude 앱과 Claude Code CLI를 모두 설치하고 두 곳에서 같은 실제 프로젝트 폴더의 최상위 목록을 확인합니다.

Claude 앱의 Code와 Claude Code CLI에서 같은 프로젝트 이름과 최상위 파일 목록이 보이며 파일 변경이 0건이면 완료입니다.

알아두면 좋습니다

앱에서 Code를 눌렀을 때 업그레이드 안내가 나오면 요금제를 확인합니다. Claude Code는 Pro, Max, Team, Enterprise 요금제에서 쓸 수 있고 무료 요금제에는 포함되지 않습니다. Select folder에서는 프로젝트를 모아 둔 상위 폴더 대신 지금 작업할 프로젝트 폴더 하나를 고릅니다. Windows에서 앱의 Local 세션을 쓰려면 Git을 먼저 설치해야 합니다. 대부분의 Mac에는 Git이 기본으로 들어 있습니다. 터미널에서 쓰는 CLI에서는 Git for Windows가 선택입니다. 설치하면 Claude Code가 Git Bash로 Bash 도구를 쓰고 설치하지 않으면 PowerShell을 대신 씁니다. Windows에서 irm is not recognized라는 오류가 나오면 PowerShell 대신 CMD 창을 연 것이므로 줄 앞이 PS로 시작하는지 보고 창을 닫은 뒤 PowerShell을 새로 엽니다. 설치가 끝났는데 claude 명령을 찾지 못한다는 안내가 나오면 창을 완전히 닫았다가 새로 연 뒤 다시 실행합니다. 앱과 터미널에서 서로 다른 폴더 이름이 보이면 앱에서 Select folder를 다시 누르거나 터미널에서 그 폴더로 이동한 뒤 다시 확인합니다.

용어 풀이

전체 용어집 →

터미널: 명령어를 글자로 입력해 컴퓨터에 일을 시키는 창입니다. macOS에서는 터미널 앱, Windows에서는 PowerShell이 이 역할을 합니다.
CLI: Command Line Interface의 줄임말입니다. 앱 화면의 버튼 대신 터미널에 명령어를 입력해 Claude Code를 실행하는 방식입니다.

2026-08-22 기준 · 출처 · Download Claude, Get started with the desktop app, Install Claude Code, Terminal guide for new users

02 설치 첫 세션 첫 세션 화면에서 권한 모드를 확인해 고르고 첫 세션에서 파일을 하나 만든 뒤 되돌릴 수 있습니다

새 세션: 방금 고른 폴더를 작업 대상으로 잡고 요청을 기다립니다
요청을 보내면 폴더 안의 파일이 실제로 만들어지거나 고쳐집니다
그 전에 승인 창을 띄울지는 권한 모드가 정합니다

권한 모드가 무엇을 허용하고 무엇을 막는지

모드 이름은 화면에 늘 표시됩니다
데스크톱 앱: 보내기 버튼 옆 모드 선택기에서 읽고 바꿉니다
터미널: Shift+Tab을 누를 때마다 다음 모드로 넘어가고, 아래쪽 상태 표시줄에 현재 모드가 나타납니다
Manual — 파일을 읽는 일만 바로 진행합니다. 파일을 만들거나 고칠 때, 터미널 명령을 실행할 때, 인터넷에 접속할 때는 그때마다 승인 창을 띄웁니다. 설정 파일과 안내 문서에서는 같은 모드를 default라는 값으로 부릅니다.
acceptEdits — 지금 연 폴더 안의 파일을 만들고 고치는 일까지 승인 창 없이 적용하며, mkdir·touch·mv·cp 같은 파일 정리 명령도 함께 통과시킵니다. 폴더 밖의 경로와 그 밖의 터미널 명령은 여전히 승인을 묻습니다.
plan — 파일을 고치지 않고 먼저 계획을 내놓습니다. 계획을 승인하면 그때 모드가 바뀌면서 수정이 시작되므로, 무엇을 건드릴지 미리 읽어 보고 싶을 때 씁니다.
auto — classifier라는 별도 모델이 작업을 대신 검토하면서 승인 창 없이 진행합니다. 요청 범위를 넘어서는 작업은 막지만, 사람이 읽는 승인 절차를 대신하지는 못합니다.
dontAsk, bypassPermissions: 자동화 스크립트와 격리된 컨테이너에서 쓰는 모드. 연습 중에는 고르지 않습니다

모드를 잘못 골랐을 때

바꾼 모드는 다음 요청부터 적용됩니다
요청을 보내기 전: 모드 선택기에서 Manual을 다시 고릅니다
요청이 지나간 뒤: 파일이 바뀐 상태라 되돌리기까지 합니다
데스크톱 앱에서 고른 모드는 그 폴더에 기억돼, 다음에 열어도 그대로 켜져 있습니다
연습이 끝나면 Manual로 돌려 둡니다. plan은 예외로 그 세션에만 적용됩니다

되돌리는 방법

체크포인트: 요청을 보낼 때마다 그 직전의 파일 상태를 저장합니다
입력창을 비운 상태에서 Esc 두 번 → 이번 세션의 요청 목록 → 돌아갈 지점 선택 → 되돌릴 대상 선택
- Restore code: 파일만 되돌리고 대화는 남깁니다
- Restore code and conversation: 파일과 대화를 같은 지점으로 되돌립니다
되살아나는 범위: Claude가 파일 편집 기능으로 직접 고친 파일까지
터미널 명령으로 지우거나 옮긴 파일은 체크포인트에 없어 rewind로 돌아오지 않습니다. 되돌리려면 Git으로 기록해 둡니다
진행 중인 답이나 실행 멈추기: Esc 한 번
붙여넣기 예제: 순서의 각 단계 아래. 위에서부터 하나씩 실행합니다

Claude 앱에서 Code를 열고 Local을 고른 뒤, Select folder를 눌러 이번에 작업할 프로젝트 폴더 하나를 엽니다.
Claude Code 데스크톱 공식 안내 열기
명령어로 직접 하기

일반 터미널(Claude Code 세션 밖)에서, 작업할 폴더로 이동한 뒤 실행합니다.
```
claude
```
확인화면에 방금 고른 폴더 이름이 표시되고 아래에 대화 입력창이 열립니다.

이 단계의 실제 화면

화면에서 확인할 것 Code에서 Local과 Select folder를 차례로 누른 뒤, 실제로 진행할 프로젝트 폴더 하나를 선택합니다. Claude Code 공식 문서 · 2026-08-03
보내기 버튼 옆 모드 선택기를 눌러 지금 켜져 있는 권한 모드 이름을 읽고 목록에서 Manual을 고릅니다. Manual에서는 파일을 읽는 일만 바로 진행하고 파일을 고치거나 명령을 실행할 때는 승인 창을 띄웁니다.
Claude Code 권한 모드 공식 안내 열기
확인모드 선택기에 Manual이 표시됩니다. 계정과 조직 설정에 따라 세션이 다른 모드로 시작할 수 있으므로, 이미 Manual이면 그대로 둡니다.

이 단계의 실제 화면

화면에서 확인할 것 화면에 Manual로 표시되는 모드의 설정값 이름이 표의 default입니다. acceptEdits는 파일 수정까지, auto는 전체 작업을 승인 창 없이 진행하며, plan은 파일을 고치기 전에 계획을 먼저 내놓습니다. Claude Code 공식 문서 · 2026-08-19
대화 입력창에 아래 요청을 붙여넣고 보냅니다.
```
메모 파일 하나를 새로 만들어 줘. 파일 이름은 note.md로 하고, 오늘 확인해야 할 일 3가지를 체크리스트로 적어 줘.
```
확인파일이 바뀌기 전에 승인 창이 뜨고 만들려는 파일 이름과 새로 들어갈 내용이 함께 보입니다.
승인 창에서 파일 이름이 note.md인지, 새로 들어갈 내용이 체크리스트 세 항목인지 읽은 뒤 Yes를 누릅니다. 다른 파일 이름이 보이면 No를 누르고 무엇을 만들지 다시 적어 보냅니다.
Claude Code 첫 변경 공식 안내 열기
확인Yes를 누르면 승인 창이 닫히고 파일을 만들었다는 답이 이어집니다. No를 눌렀다면 폴더의 파일은 그대로입니다.

이 단계의 실제 화면

화면에서 확인할 것 공식 빠른 시작 문서도 첫 설치 세션에서는 변경마다 승인을 물은 뒤 Yes를 눌러 적용한다고 안내합니다. Claude Code 공식 문서 · 2026-08-19
프로젝트 폴더에서 note.md를 찾아 엽니다.

확인폴더에 note.md가 새로 생겨 있고 안에 체크리스트 세 항목이 들어 있습니다.
입력창을 완전히 비운 뒤 Esc를 두 번 눌러 rewind 메뉴를 엽니다. 목록에서 방금 보낸 요청을 고른 뒤 파일만 되돌릴 때는 Restore code를 고릅니다.
Claude Code 되돌리기 공식 안내 열기
명령어로 직접 하기

터미널에서 claude 명령으로 연 Claude Code 화면 안에서 입력합니다. Esc를 두 번 누르는 것과 같은 메뉴가 열립니다.
```
/rewind
```
확인이번 세션에서 보낸 요청이 차례로 보이고 Restore code를 고르면 note.md가 만들어지기 전 상태로 돌아갑니다.

이 단계의 실제 화면

화면에서 확인할 것 Restore code는 파일 변경만 되돌리고 대화는 남깁니다. Restore code and conversation을 고르면 파일과 대화를 같은 시점으로 되돌립니다. Claude Code 공식 문서 · 2026-08-19

연습

승인 창에 뜬 파일 이름과 바뀔 내용을 끝까지 읽은 뒤에 Yes를 눌러 보세요.

지금 세션의 권한 모드 이름을 화면에서 찾아 말할 수 있고 방금 만든 파일을 되돌리는 rewind 메뉴를 열어 봤으면 통과입니다.

알아두면 좋습니다

acceptEdits는 파일 수정과 mkdir·mv·cp 같은 명령을 승인 창 없이 적용합니다. 데스크톱 앱의 모드 선택기에서 고른 모드는 그 폴더에 기억되어 다음에 같은 폴더를 열 때도 그대로 켜지므로, 한 번 바꿔 두면 다음 세션의 파일 변경도 승인 창 없이 지나갑니다. 파일을 하나씩 확인하며 연습하는 동안에는 모드 선택기에서 Manual을 고르고 터미널에서는 Shift+Tab으로 Manual까지 돌립니다.

용어 풀이

전체 용어집 →

세션: Claude Code를 열어 대화를 시작한 순간부터 끝낼 때까지를 뜻합니다.
승인 창: 파일을 고치거나 명령을 실행하기 전에 무엇을 바꿀지 보여 주고 Yes와 No를 묻는 화면입니다.
권한 모드: Claude Code가 무엇을 승인 없이 바로 할지 정하는 설정입니다. 데스크톱 앱에서는 보내기 버튼 옆 모드 선택기로, 터미널에서는 Shift+Tab으로 바꿉니다.
체크포인트: 요청을 보낼 때마다 Claude Code가 자동으로 저장해 두는 그 시점의 파일 상태입니다.
rewind(리와인드): 체크포인트로 되돌아가는 메뉴입니다. 입력창이 비어 있을 때 Esc를 두 번 누르면 열립니다.

2026-08-22 기준 · 출처 · Quickstart, Interactive Mode, Choose a permission mode, Checkpointing

설치와 첫 세션

Claude 설치

Claude Code CLI 설치

같은 프로젝트 폴더를 엽니다

용어 풀이

권한 모드가 무엇을 허용하고 무엇을 막는지

모드를 잘못 골랐을 때

되돌리는 방법

용어 풀이

다음 단계