클로드 코드(Claude Code) 설치 방법완전 초보도 5분이면 끝!

2026 최신 가이드

클로드 코드(Claude Code) 설치 방법
완전 초보도 5분이면 끝!

일반 Claude 앱과 뭐가 다른지까지 한 번에 정리했습니다

1. 클로드 코드(Claude Code)가 뭔가요?

클로드 코드는 터미널(까만 화면)에서 Claude AI를 쓸 수 있는 도구입니다. Anthropic이 공식으로 만든 CLI(Command Line Interface) 도구예요.

 

쉽게 말하면, 우리가 보통 쓰는 Claude 앱이 "카카오톡처럼 채팅하는 방식"이라면, 클로드 코드는 "개발자의 작업 환경에서 직접 일을 시키는 방식"이에요. 파일을 읽고, 코드를 짜고, 프로젝트 전체를 분석하는 걸 터미널 하나로 다 할 수 있습니다.

💡 한 줄 요약 — 클로드 코드 = 터미널에서 돌아가는 AI 코딩 비서

2. 일반 클로드 앱 vs 클로드 코드 — 핵심 차이점

"그냥 Claude 앱 쓰면 되는 거 아니야?" 이런 생각이 드실 수 있어요. 둘은 용도가 꽤 다릅니다.

구분	일반 Claude 앱/웹	클로드 코드 (CLI)
사용 환경	웹 브라우저 / 데스크톱 앱	터미널 (까만 화면)
주요 용도	질문, 글쓰기, 번역, 대화	코딩, 파일 편집, 프로젝트 관리
파일 접근	❌ 내 컴퓨터 파일 직접 접근 불가	✅ 내 컴퓨터 파일 직접 읽기/쓰기
코드 실행	❌ 코드 보여주기만 함	✅ 직접 코드 실행 가능
프로젝트 분석	파일 하나씩 복붙해야 함	폴더 전체를 한 번에 분석
Git 연동	❌ 불가	✅ 커밋, 브랜치 등 직접 관리
난이도	⭐ 누구나 쉽게	⭐⭐ 터미널 기초 필요
요금	무료 플랜 있음	Pro 이상 유료 구독 필요

🎯 그래서 누가 클로드 코드를 쓰면 좋을까?

✔ 코딩을 배우고 싶은 사람
✔ 프로젝트 전체를 AI한테 맡기고 싶은 개발자
✔ 반복 작업을 자동화하고 싶은 사람
✔ Git으로 협업하면서 AI 도움을 받고 싶은 사람

3. 설치 전 확인할 것

✅ 체크리스트

☐ 운영체제 — macOS 13.0 이상 / Windows 10 이상 / Ubuntu 20.04 이상
☐ 메모리 — 최소 4GB RAM
☐ 인터넷 — 연결 필수
☐ 계정 — Claude Pro / Max / Team / Enterprise 구독, 또는 API 크레딧
☐ Windows만 — Git for Windows 사전 설치 필요 (다운로드)

⚠️ 중요! 무료 Claude 계정으로는 클로드 코드를 사용할 수 없습니다. 유료 구독 또는 API 크레딧이 필요해요.

4. Mac 설치 방법

Step 1 — 터미널 열기

Cmd + Space 눌러서 Spotlight 열기 → "터미널" 입력 → Enter

Step 2 — 설치 명령어 입력

아래 명령어를 복사해서 터미널에 붙여넣고 Enter를 누르세요.

curl -fsSL https://claude.ai/install.sh | bash

자동으로 다운로드하고 설치까지 해줍니다. 1~2분 정도 걸려요.

💡 Homebrew 사용자라면 이 방법도 가능해요:
brew install --cask claude-code

5. Windows 설치 방법

Step 0 — Git 먼저 설치 (안 되어 있다면)

git-scm.com/downloads/win 에서 다운로드 → 설치 (기본 설정 그대로 Next만 누르면 됩니다)

Step 1 — PowerShell 열기

시작 메뉴 → "PowerShell" 검색 → 열기

⚠️ "명령 프롬프트(cmd)"가 아니라 반드시 "PowerShell"이어야 합니다!
구분법: PowerShell은 PS C:\>로 시작, cmd는 C:\>로 시작

Step 2 — 설치 명령어 입력

irm https://claude.ai/install.ps1 | iex

6. 설치 확인 & 로그인

설치 확인

claude --version

버전 번호(예: 1.x.x)가 뜨면 성공입니다!

첫 로그인

① 터미널에 claude 입력 후 Enter
② 브라우저가 자동으로 열림 → Claude 계정으로 로그인
③ "인증 완료" 메시지가 뜨면 끝!
④ 이후에는 다시 로그인할 필요 없음

브라우저가 자동으로 안 열리면, 터미널에서 c 키를 누르면 URL이 복사됩니다. 직접 브라우저에 붙여넣기 하세요.

첫 사용 예시

# 프로젝트 폴더로 이동

cd ~/my-project

# 클로드 코드 실행

claude

# 또는 바로 질문하기

claude "이 프로젝트 구조 설명해줘"

7. 자주 묻는 질문 (FAQ)

Q. Node.js 같은 거 따로 설치해야 하나요?

아니요! 2025년 이후 버전부터는 별도 설치 없이 명령어 하나로 끝납니다.

Q. VS Code가 꼭 필요한가요?

아닙니다. 기본 터미널만으로 충분합니다. 다만 코드 편집과 터미널을 한 화면에서 쓰고 싶으면 VS Code가 편합니다.

Q. 무료로 쓸 수 있나요?

클로드 코드 자체는 무료이지만, 사용하려면 Claude Pro 이상 구독 또는 API 크레딧이 필요합니다.

Q. "command not found" 에러가 떠요!

터미널을 완전히 닫았다가 다시 열어보세요. 그래도 안 되면 아래 명령어로 PATH를 설정하세요:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

Q. 한국어로 말해도 되나요?

네! 클로드 코드에서 한국어로 질문하고 명령할 수 있습니다.

지금 바로 시작해보세요!

터미널을 열고, 명령어 한 줄이면 설치 끝입니다.

curl -fsSL https://claude.ai/install.sh | bash

이 글이 도움이 되셨다면 공감과 댓글 부탁드립니다 :)