클로드 코드란? 설치와 첫 실행

클로드 코드(Claude Code)는 터미널에서 동작하는 AI 코딩 에이전트입니다. 챗봇에게 질문하고 답을 복사해 오는 방식이 아니라, 클로드가 직접 내 컴퓨터에서 파일을 읽고, 코드를 고치고, 명령어를 실행합니다. 비유하자면 챗GPT가 '전화 상담원'이라면, 클로드 코드는 '우리 집에 직접 방문해서 일하는 기사님'입니다.

그래서 할 수 있는 일의 범위가 완전히 다릅니다. "이 폴더 정리해 줘", "이 버그 고쳐 줘", "이 프로젝트에 로그인 기능 추가해 줘" 같은 요청을 말로 하면, 클로드 코드가 스스로 파일을 탐색하고 계획을 세워 실제 작업을 수행합니다.

설치하기

설치 방법은 두 가지입니다. 가장 간단한 것은 공식 설치 스크립트이고, Node.js가 이미 있다면 npm으로도 설치할 수 있습니다. 터미널(맥은 '터미널' 앱, 윈도우는 PowerShell)을 열고 아래 중 하나를 입력하세요.

설치 명령어 (둘 중 하나만)

# 방법 1: 공식 설치 스크립트 (맥/리눅스, 권장)
curl -fsSL https://claude.ai/install.sh | bash

# 방법 2: npm으로 설치 (Node.js 18 이상 필요)
npm install -g @anthropic-ai/claude-code

npm이 뭔지 모르셔도 괜찮습니다. 방법 1의 공식 설치 스크립트는 Node.js 없이도 동작하고, 업데이트도 자동으로 해 줍니다. 초보자라면 방법 1을 추천합니다.

첫 실행과 로그인

설치가 끝나면 작업하고 싶은 폴더로 이동한 뒤 claude라고 입력하면 됩니다. 처음 실행하면 브라우저가 열리면서 로그인 화면이 나타납니다. Claude Pro/Max 구독 계정이나 API 계정으로 로그인하면 준비 끝입니다.

첫 실행

# 작업할 폴더로 이동 (예: 내 프로젝트 폴더)
cd ~/my-project

# 클로드 코드 실행
claude

실행하면 채팅창 같은 입력 화면이 나옵니다. 여기에 한국어로 그냥 말하듯 입력하면 됩니다. 첫 명령으로 아래 프롬프트를 복사해서 넣어 보세요.

첫 번째 명령 (복사해서 붙여넣기)

이 폴더에 어떤 파일들이 있는지 살펴보고, 이 프로젝트가 무엇을 하는 프로젝트인지 초보자도 이해할 수 있게 설명해 줘.

클로드 코드는 실행한 '현재 폴더'를 작업 공간으로 삼습니다. 바탕화면 전체나 홈 폴더에서 실행하면 너무 많은 파일을 뒤지게 되니, 반드시 작업할 프로젝트 폴더로 이동한 뒤 실행하세요.

이것으로 준비가 끝났습니다. 다음 레슨부터는 대화를 이어가고 관리하는 방법을 배웁니다.