따라하기
설치와 첫 세션
무엇을 맡길지 정했으면, 이제 내 환경에 Claude를 올립니다. 설치부터 첫 파일까지.
단계 13개입니다. 체크는 이 브라우저에 저장됩니다.
0 / 13단계 완료
설치
Claude 데스크톱 앱과 Claude Code CLI를 설치하고 같은 프로젝트 폴더에서 시작할 수 있습니다
-
Claude 공식 다운로드 페이지를 열고 macOS와 Windows 중 쓰고 있는 운영체제에 맞는 설치 파일을 내려받습니다.
이 단계의 실제 화면 
화면에서 확인할 것 운영체제에 맞는 Claude 데스크톱 앱을 받습니다. 출처는 Claude 공식 다운로드 페이지입니다. Claude 공식 웹 · 2026-08-19 예상 결과 페이지에 macOS용과 Windows용 다운로드 버튼이 보이고 누르면 내려받기 폴더에 설치 파일이 생깁니다.
-
내려받은 설치 파일을 실행해 앱을 설치하고 Claude 계정으로 로그인한 다음 앱 안에서 Code를 엽니다.
이 단계의 실제 화면 
화면에서 확인할 것 앱 설치, 로그인, Code 열기 순서를 확인합니다. 출처는 Claude Code 공식 문서입니다. Claude Code Docs · 2026-08-19 예상 결과 Claude 앱이 열리고 Code 화면으로 넘어갑니다.
-
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
이 단계의 실제 화면 
화면에서 확인할 것 운영체제에 맞는 공식 CLI 설치 명령을 확인합니다. 출처는 Claude Code 공식 설치 문서입니다. Claude Code Docs · 2026-08-19 예상 결과 글자가 한동안 흐른 뒤 Claude Code successfully installed! 문장이 나옵니다.
-
Windows를 쓰면 PowerShell을 엽니다.
윈도우 키와 X를 함께 누른 뒤 메뉴에서 Windows PowerShell 또는 터미널을 고릅니다. 창이 열리면 아래 명령어 토글을 펼쳐 설치 명령을 붙여넣고 엔터를 누릅니다.
명령어로 직접 하기
irm이 claude.ai에서 설치 파일을 가져오고 iex가 그 파일을 실행합니다. Windows PowerShell에서 공식 문서가 권장하는 명령입니다.
그대로 붙여넣기irm https://claude.ai/install.ps1 | iex
이 단계의 실제 화면 화면에서 확인할 것 Windows에서는 PowerShell용 명령을 사용합니다. 출처는 Claude Code 공식 설치 문서입니다. Claude Code Docs · 2026-08-19 예상 결과 글자가 한동안 흐른 뒤 Claude Code successfully installed! 문장이 나옵니다.
-
설치에 쓴 창을 닫고 터미널이나 PowerShell을 새로 연 다음, 아래 명령어 토글의 확인 명령 두 줄을 차례로 실행합니다.
명령어로 직접 하기
첫 줄은 설치된 버전을 출력합니다. 둘째 줄은 세션을 시작하지 않고 설치 상태와 설정 파일을 점검한 결과를 보여 줍니다.
그대로 붙여넣기claude --version claude doctor
이 단계의 실제 화면 
화면에서 확인할 것 설치 뒤 새 터미널에서 버전과 상태를 확인합니다. 출처는 Claude Code 공식 설치 문서입니다. Claude Code Docs · 2026-08-19 예상 결과 첫 명령에서 2.1.211 (Claude Code)처럼 버전 번호가 나오고 둘째 명령에서 점검 결과가 나옵니다.
-
앱에서 연 것과 같은 프로젝트 폴더로 터미널의 위치를 옮기고 Claude Code를 실행한 뒤, 파일을 고치지 않는 요청으로 폴더가 맞는지 확인합니다.
그대로 붙여넣기지금 선택한 프로젝트 폴더의 이름과 최상위 파일·폴더 이름만 보여 줘. 파일은 아직 고치지 마.
명령어로 직접 하기
첫 줄은 터미널이 보고 있는 위치를 그 폴더로 옮깁니다. cd를 입력하고 한 칸 띄운 다음 Finder나 파일 탐색기에서 폴더를 창 안으로 끌어다 놓으면 경로가 대신 입력됩니다. 둘째 줄은 그 폴더에서 Claude Code를 시작합니다.
그대로 붙여넣기cd 프로젝트-폴더-경로 claude
예상 결과 앱에서 본 것과 같은 프로젝트 이름과 최상위 목록이 나오고 파일은 하나도 바뀌지 않습니다.
첫 세션
화면에서 권한 모드를 확인해 고르고 첫 세션에서 파일을 하나 만든 뒤 되돌릴 수 있습니다
-
Claude 앱에서 Code를 열고 Local을 고른 뒤, Select folder를 눌러 이번에 작업할 프로젝트 폴더 하나를 엽니다.
명령어로 직접 하기
일반 터미널(Claude Code 세션 밖)에서, 작업할 폴더로 이동한 뒤 실행합니다.
그대로 붙여넣기claude
이 단계의 실제 화면 
화면에서 확인할 것 Code에서 Local과 Select folder를 차례로 누른 뒤, 실제로 진행할 프로젝트 폴더 하나를 선택합니다. Claude Code 공식 문서 · 2026-08-03 예상 결과 화면에 방금 고른 폴더 이름이 표시되고 아래에 대화 입력창이 열립니다.
-
보내기 버튼 옆 모드 선택기를 눌러 지금 켜져 있는 권한 모드 이름을 읽고 목록에서 Manual을 고릅니다.
Manual에서는 파일을 읽는 일만 바로 진행하고 파일을 고치거나 명령을 실행할 때는 승인 창을 띄웁니다.
이 단계의 실제 화면 
화면에서 확인할 것 화면에 Manual로 표시되는 모드의 설정값 이름이 표의 default입니다. acceptEdits는 파일 수정까지, auto는 전체 작업을 승인 창 없이 진행하며, plan은 파일을 고치기 전에 계획을 먼저 내놓습니다. Claude Code 공식 문서 · 2026-08-19 예상 결과 모드 선택기에 Manual이 표시됩니다. 계정과 조직 설정에 따라 세션이 다른 모드로 시작할 수 있으므로, 이미 Manual이면 그대로 둡니다.
-
대화 입력창에 아래 요청을 붙여넣고 보냅니다.
그대로 붙여넣기메모 파일 하나를 새로 만들어 줘. 파일 이름은 note.md로 하고, 오늘 확인해야 할 일 3가지를 체크리스트로 적어 줘.
예상 결과 파일이 바뀌기 전에 승인 창이 뜨고 만들려는 파일 이름과 새로 들어갈 내용이 함께 보입니다.
-
승인 창에서 파일 이름이 note.md인지, 새로 들어갈 내용이 체크리스트 세 항목인지 읽은 뒤 Yes를 누릅니다.
다른 파일 이름이 보이면 No를 누르고 무엇을 만들지 다시 적어 보냅니다.
이 단계의 실제 화면 
화면에서 확인할 것 공식 빠른 시작 문서도 첫 설치 세션에서는 변경마다 승인을 물은 뒤 Yes를 눌러 적용한다고 안내합니다. Claude Code 공식 문서 · 2026-08-19 예상 결과 Yes를 누르면 승인 창이 닫히고 파일을 만들었다는 답이 이어집니다. No를 눌렀다면 폴더의 파일은 그대로입니다.
-
프로젝트 폴더에서 note.md를 찾아 엽니다.
예상 결과 폴더에 note.md가 새로 생겨 있고 안에 체크리스트 세 항목이 들어 있습니다.
-
입력창을 완전히 비운 뒤 Esc를 두 번 눌러 rewind 메뉴를 엽니다.
목록에서 방금 보낸 요청을 고른 뒤 파일만 되돌릴 때는 Restore code를 고릅니다.
명령어로 직접 하기
터미널에서 claude 명령으로 연 Claude Code 화면 안에서 입력합니다. Esc를 두 번 누르는 것과 같은 메뉴가 열립니다.
그대로 붙여넣기/rewind
이 단계의 실제 화면 
화면에서 확인할 것 Restore code는 파일 변경만 되돌리고 대화는 남깁니다. Restore code and conversation을 고르면 파일과 대화를 같은 시점으로 되돌립니다. Claude Code 공식 문서 · 2026-08-19 예상 결과 이번 세션에서 보낸 요청이 차례로 보이고 Restore code를 고르면 note.md가 만들어지기 전 상태로 돌아갑니다.
다음
여기까지가 설치와 첫 세션 순서입니다.