Claude Code 처음 시작하기 — 설치부터 첫 작업까지
맥 터미널에서 Claude Code를 설치하고 폴더를 열어 첫 코딩 작업을 지시하는 방법을 초보자의 눈높이에 맞춰 안내합니다.
1. Claude Code란 무엇인가요?
Claude Code는 터미널(명령 프롬프트 창)에서 대화하듯 지시하여 컴퓨터 안의 파일과 코드를 직접 읽고 수정해 주는 인공지능 코딩 도구입니다. 복잡한 명령어를 외우지 않아도 일상적인 한국어로 요청하면 Claude가 폴더 구조를 살펴보고 코드를 대신 작성해 줍니다.
2. 맥(Mac)에서 1분 만에 설치하기
맥 기본 앱인 '터미널'을 실행한 뒤 공식 설치 명령어를 붙여넣고 엔터를 누르면 바로 설치됩니다.
curl -fsSL https://claude.ai/install.sh | bash
Homebrew를 쓰고 있다면 아래 명령으로도 설치할 수 있습니다.
brew install --cask claude-code
npm으로 설치하려면 Node.js 22 이상이 필요합니다. 이때 sudo 는 붙이지 마세요.
npm install -g @anthropic-ai/claude-code
설치 후 다음 명령어로 버전을 확인합니다.
claude --version
3. 작업할 폴더 열고 실행하기
Claude Code는 반드시 작업할 프로젝트 폴더로 이동한 뒤 실행해야 안전합니다.
터미널에서 cd 명령어 뒤에 작업할 폴더 경로를 입력하여 이동합니다.
해당 폴더 안에서 claude를 입력하고 엔터를 누릅니다.
cd ~/Desktop/my-project
claude
처음 실행하면 브라우저가 열려 로그인합니다. 로그인이 끝나면 터미널에 대화창이 뜹니다. Claude Code는 유료 요금제(Pro, Max, Team, Enterprise) 또는 Console 계정이 있어야 쓸 수 있고, 무료 요금제에는 포함되지 않습니다.
4. 첫 작업 요청해 보기
대화창이 열리면 쉬운 한국어로 첫 작업을 지시해 보세요.
이 폴더의 파일 목록을 살펴보고, index.html 파일의 제목을 '우리 학원 홈페이지'로 바꿔줘.
요청을 입력하면 Claude가 파일들을 읽고 수정 계획을 세워 단계별로 보여줍니다.
5. 권한 확인 화면 이해하기
Claude는 명령을 실행하거나 파일을 고치기 전에 "Do you want to proceed?"(진행할까요?)라고 묻습니다. 화살표로 고르고 엔터를 누릅니다.
Yes : 이번 한 번만 허락합니다.
Yes, and don't ask again for ... : 같은 종류의 명령은 앞으로 묻지 않고 허락합니다. 무엇을 허락하는지 꼭 읽고 고르세요.
No : 거절합니다. Claude는 다른 방법을 찾습니다.
고른 항목에서 Tab 을 누르면 "이 파일은 건드리지 마" 같은 메모를 덧붙일 수 있고, Esc 를 누르면 취소됩니다. 처음에는 Yes로 한 번씩 허락하면서 Claude가 무엇을 하는지 지켜보는 것을 추천합니다.
6. 초보자가 자주 하는 실수 3가지
홈 폴더(~)에서 바로 실행: 최상위 폴더에서 실행하면 불필요한 개인 파일까지 모두 검색해 느려집니다. 반드시 cd로 작업 폴더로 이동하세요.
백업 생략: 작업 전 폴더를 복사해 두거나 Git 커밋을 남기면 언제든 이전 상태로 안전하게 되돌릴 수 있습니다.
너무 막연한 요청: 한 번에 모든 것을 요구하기보다 '구조 파악 → 문구 수정 → 기능 추가' 순서로 한 단계씩 나누어 요청하세요.