클로드 코드(Claude Code) 설치부터 첫 명령까지

Claude Code는 Node.js 위에서 동작합니다. 먼저 Node.js가 설치되어 있는지 확인합니다. [터미널 열기] - Windows: 검색창에 "PowerShell" 입력 → 클릭 - Mac: Spotlight(Cmd+Space)에서 "터미널" 검색 → 클릭 - Linux: Ctrl+Alt+T 또는 터미널 앱 실행 [버전 확인] 터미널에 아래 명령어를 입력하고 Enter를 누릅니다. v18.x.x 이상의 숫자가 나오면 이미 설치되어 있으므로 2단계로 넘어가세요. [설치가 필요한 경우] 숫자가 안 나오거나 "command not found" 에러가 뜨면 Node.js를 설치해야 합니다. 1. 웹브라우저에서 nodejs.org 접속 2. "LTS" (안정 버전) 다운로드 버튼 클릭 3. 다운로드된 파일 실행 → "다음"만 계속 눌러서 설치 4. 설치 완료 후 터미널을 껐다 다시 열고, 다시 node -v 로 확인

# Node.js 버전 확인
node -v
# 출력 예시: v22.13.1

# npm도 함께 설치되었는지 확인
npm -v
# 출력 예시: 10.9.2

npm(Node.js 패키지 매니저)을 사용해 Claude Code를 전역 설치합니다. 전역 설치란 어느 폴더에서든 claude 명령어를 사용할 수 있도록 하는 것입니다. 아래 명령어를 터미널에 붙여넣고 Enter를 누르세요. 패키지 다운로드와 설치에 1~2분 정도 걸립니다.

# Claude Code 전역 설치
npm install -g @anthropic-ai/claude-code

# 설치 확인
claude --version

Claude Code를 처음 실행하면 Anthropic 계정 인증이 필요합니다. 두 가지 인증 방식 중 하나를 선택합니다. [방법 1: 브라우저 OAuth 로그인 (추천)] Claude Pro 또는 Max 구독자에게 추천하는 방식입니다. 1. 터미널에서 claude 를 입력하고 Enter 2. 자동으로 웹브라우저가 열리고 Anthropic 로그인 페이지가 나타납니다 3. Claude 계정으로 로그인하면 터미널에 "Authenticated" 메시지가 표시됩니다 4. 이후에는 자동으로 로그인 상태가 유지됩니다 [방법 2: API 키 설정] API 키를 직접 사용하고 싶은 경우입니다. 사용량 기반으로 과금됩니다. 1. console.anthropic.com 접속 → API Keys 메뉴에서 키 생성 2. 터미널에서 환경변수를 설정합니다 (아래 코드 참고) 3. 설정 후 claude 를 실행하면 바로 사용 가능합니다

# 방법 1: 브라우저 로그인 (그냥 claude 실행)
claude
# → 브라우저가 자동으로 열리고 로그인 페이지 표시
# → 로그인 완료 후 터미널에서 바로 사용 가능

# 방법 2: API 키 환경변수 설정
# Mac/Linux:
export ANTHROPIC_API_KEY="sk-ant-xxxxx"

# Windows PowerShell:
$env:ANTHROPIC_API_KEY="sk-ant-xxxxx"

# 영구 설정 (Mac/Linux — ~/.bashrc 또는 ~/.zshrc 에 추가)
echo 'export ANTHROPIC_API_KEY="sk-ant-xxxxx"' >> ~/.zshrc
source ~/.zshrc

Claude Code는 현재 폴더의 파일을 읽고 수정할 수 있습니다. 따라서 작업하고 싶은 프로젝트 폴더로 먼저 이동한 뒤 claude 를 실행해야 합니다. [기존 프로젝트가 있는 경우] 해당 프로젝트 폴더로 이동 후 claude 를 실행합니다. [새 프로젝트를 시작하는 경우] 빈 폴더를 만들고 그 안에서 claude 를 실행하면 됩니다. Claude에게 "프로젝트를 세팅해줘"라고 요청하면 알아서 파일을 생성합니다. 실행하면 Claude Code가 해당 폴더의 파일 구조를 파악하고, CLAUDE.md 파일이 있으면 프로젝트 규칙도 자동으로 읽어들입니다.

# 기존 프로젝트로 이동 후 실행
cd ~/my-project
claude

# 새 프로젝트를 만들어서 시작
mkdir my-new-app
cd my-new-app
claude

이제 Claude Code에게 실제 명령을 전달해봅시다. 자연어(한국어 또는 영어)로 요청하면 됩니다. Claude Code는 파일을 읽고, 수정하고, 생성하고, 터미널 명령을 실행할 수 있습니다. 파일을 수정하거나 명령을 실행할 때는 사용자에게 먼저 확인을 요청합니다. 아래에 상황별 프롬프트 예시 3가지를 준비했습니다. 본인 상황에 맞는 것을 골라 입력해보세요.

# 예시 1: 기존 프로젝트 파악하기
> 이 프로젝트의 전체 구조와 주요 파일을 설명해줘

# 예시 2: 코드 수정 요청
> src/utils/format.ts 에 날짜를 "2025년 1월 1일" 형식으로 포맷하는 함수를 추가해줘

# 예시 3: 새 프로젝트 시작
> Next.js + TypeScript + Tailwind CSS 프로젝트를 세팅해줘

# Claude Code가 파일을 수정하거나 명령을 실행하려고 하면
# "Allow?" 확인 메시지가 나타납니다.
# y 를 입력하면 실행, n 을 입력하면 취소됩니다.

Claude Code에는 대화 외에도 유용한 내장 명령어(슬래시 명령)가 있습니다. 자주 쓰는 명령어를 익혀두면 더 효율적으로 사용할 수 있습니다. 아래 명령어들은 Claude Code 대화 입력창에서 바로 입력하면 됩니다.

# 도움말 — 사용 가능한 모든 명령어 목록
/help

# 대화 내용 초기화 — 새로운 주제를 시작할 때
/clear

# 현재 세션 비용 확인
/cost

# 대화 맥락 압축 — 대화가 길어져서 느려질 때
/compact

# 진행 중인 응답 중단 — Claude가 너무 길게 답할 때
Ctrl+C

...