“코딩을 전혀 몰라도 AI가 다 해준다”는 말, 들어보셨죠? 그 말이 가장 잘 들어맞는 도구가 바로 클로드 코드(Claude Code)입니다.
그런데 막상 써보려고 구글 검색하면 영어 문서에 터미널 명령어가 줄줄이 나와서 지레 겁먹고 창을 닫게 되죠. 이 글은 그런 분들을 위해 썼습니다. 코딩 경험 제로, 터미널이 뭔지 모르는 분도 읽고 나면 클로드 코드를 설치하고 첫 명령어를 실행할 수 있도록 최대한 쉽게 풀어드릴게요.
내용이 많아서 1부(개념·설치·첫 실행)와 2부(실전 활용·핵심 기능·꿀팁)으로 나눴습니다. 지금은 1부입니다.
📌 클로드 코드가 뭔가요?
클로드 코드는 Anthropic이 만든 AI 코딩 어시스턴트입니다. 한마디로, 클로드(Claude)라는 AI가 내 컴퓨터 안에 들어와서 코드를 직접 짜주는 도구예요.
일반적인 AI 챗봇(ChatGPT, Claude.ai 등)과 결정적으로 다른 점이 있습니다. 챗봇은 코드를 알려줍니다. 클로드 코드는 코드를 직접 만들어줍니다. 내 컴퓨터 폴더에 접근해서 파일을 읽고, 수정하고, 여러 파일을 동시에 바꾸고, Git 커밋까지 처리합니다. “이런 앱 만들어줘”라고 말하면 진짜로 만들어주는 거예요.
챗봇 vs 클로드 코드, 한눈에 비교
| 구분 | 일반 AI 챗봇 | 클로드 코드 |
|---|---|---|
| 코드 작성 | 텍스트로 알려줌 | 파일에 직접 작성 |
| 파일 접근 | 불가 | 내 컴퓨터 직접 접근 |
| 여러 파일 수정 | 불가 | 동시에 수십 개 수정 |
| 프로젝트 이해 | 복붙한 코드만 | 전체 구조 자동 파악 |
| Git 커밋 | 불가 | 자동 처리 가능 |
| 작업 방식 | 브라우저 | 터미널(내 컴퓨터 안) |
💰 요금제 — 어떤 플랜이 필요한가요?
먼저 확인해야 할 게 있어요. 클로드 코드는 무료 플랜에서는 사용할 수 없습니다. 최소 Pro 구독 이상이 필요해요.
| 플랜 | 가격 | 클로드 코드 | 추천 대상 |
|---|---|---|---|
| Free | 무료 | ❌ 사용 불가 | – |
| Pro | $20/월 (약 2만 8천원) | ✅ 사용 가능 | 입문자, 가끔 사용 |
| Max (5배) | $100/월 | ✅ 사용량 5배 | 자주 쓰는 사용자 |
| Max (20배) | $200/월 | ✅ 사용량 20배 | 헤비유저, 전문가 |
| API (종량제) | 사용량만큼 지불 | ✅ 사용 가능 | CI/CD, 간헐적 사용 |
처음 시작한다면 Pro($20/월)로 시작해서 사용량이 많아지면 Max로 업그레이드하는 걸 권장합니다. claude.ai에서 바로 구독할 수 있어요.
🖥️ 설치 전 확인 — 내 컴퓨터는 지원이 되나요?
클로드 코드는 Mac, Windows, Linux 모두 지원합니다. 2026년 현재 공식 권장 설치 방식은 네이티브(Native) 설치예요. Node.js 같은 별도 프로그램 없이 명령어 한 줄로 설치가 되고, 이후 자동 업데이트도 지원됩니다.
참고로 예전에는 npm으로 설치하는 방식이 많이 쓰였는데, 2026년 초부터 공식 지원이 중단됐어요. 예전에 npm으로 설치하셨다면 아래 네이티브 방식으로 다시 설치하시는 걸 권장합니다.
🔧 설치 방법 — Mac / Linux
Mac이나 Linux 사용자라면 가장 간단합니다. 터미널을 열고 아래 명령어 한 줄만 입력하면 끝입니다.
터미널 여는 법 (Mac): 키보드에서 Command + 스페이스바를 누르고 “터미널”을 검색해서 실행하세요.
curl -fsSL https://claude.ai/install.sh | sh이 명령어를 복사해서 터미널에 붙여넣고 엔터를 누르면 자동으로 설치됩니다. 설치가 끝나면 아래 명령어로 제대로 설치됐는지 확인하세요.
claude --version버전 번호가 출력되면 성공입니다.
🔧 설치 방법 — Windows
Windows는 두 가지 방법이 있어요.
방법 1: WinGet (가장 간단, 권장)
Windows 10 이상이라면 이미 WinGet이 설치되어 있어요. PowerShell을 관리자 권한으로 열고(시작 버튼 우클릭 → “Windows PowerShell(관리자)”) 아래를 입력하세요.
winget install Anthropic.ClaudeCode단, WinGet 방식은 자동 업데이트가 안 되니 가끔 winget upgrade Anthropic.ClaudeCode로 수동 업데이트해줘야 합니다.
방법 2: WSL (더 강력한 기능 필요 시)
WSL은 Windows 안에서 리눅스를 쓸 수 있게 해주는 기능입니다. 클로드 코드의 샌드박싱 보안 기능까지 쓰려면 WSL2가 필요해요. PowerShell 관리자 권한으로 아래를 입력해 WSL을 먼저 설치하세요.
wsl --install재부팅 후 WSL 터미널을 열고, Mac/Linux와 동일한 명령어를 실행하면 됩니다.
curl -fsSL https://claude.ai/install.sh | sh🔑 로그인 — Claude 계정 연결하기
설치가 끝났으면 이제 로그인입니다. 터미널에서 claude를 입력하고 엔터를 누르세요.
claude처음 실행하면 브라우저가 자동으로 열리면서 로그인 화면이 나옵니다. claude.ai 계정(Pro 이상)으로 로그인하면 터미널로 자동 복귀하고 연동이 완료됩니다. 브라우저가 자동으로 안 열리면 c를 눌러서 로그인 URL을 클립보드에 복사한 뒤 직접 붙여넣으세요.
로그인 후 터미널에 클로드 코드 인터페이스가 뜨면 성공입니다. 🎉
🚀 첫 실행 — Hello, Claude Code!
이제 진짜 첫 실행입니다. 클로드 코드는 현재 내가 들어가 있는 폴더를 기준으로 동작합니다. 바탕화면에 테스트 폴더를 하나 만들어보세요.
터미널에서 바탕화면으로 이동하는 방법은 아래와 같습니다.
cd ~/Desktop그다음 테스트 폴더를 만들고 그 안으로 들어갑니다.
mkdir test-projectcd test-project이제 클로드 코드를 실행합니다.
claude인터페이스가 뜨면 아래처럼 한국어로 입력해보세요.
이 폴더에 있는 파일 목록을 보여줘클로드가 폴더를 스캔하고 응답해주면 정상 작동하는 겁니다. 텅 빈 폴더라면 “파일이 없습니다”라고 응답해줄 거예요.
이번엔 좀 더 재밌는 걸 시켜볼게요.
hello.txt 파일을 만들고 "안녕하세요, 클로드 코드입니다"라고 내용을 써줘클로드가 파일 생성 권한을 물어보면 y를 눌러 허용하세요. 그러면 실제로 내 컴퓨터 test-project 폴더 안에 hello.txt 파일이 생겨있을 거예요. 직접 파인더(Mac)나 탐색기(Windows)에서 확인해보세요. 이게 클로드 코드의 핵심입니다. 말 한마디가 실제 파일로 이어집니다.
⌨️ 기억해두면 좋은 기본 명령어
클로드 코드 안에서 자주 쓰는 명령어 몇 가지만 기억해두세요.
| 명령어 | 설명 |
|---|---|
/help | 도움말 보기 |
/status | 현재 로그인 상태, 모델 확인 |
/clear | 대화 기록 초기화 |
/exit | 클로드 코드 종료 |
Shift + Tab | 작업 모드 전환 (계획/자동/일반) |
Ctrl + C | 진행 중인 작업 중단 |
슬래시 명령어를 다 외울 필요는 없어요. 대부분의 경우 그냥 자연어로 요청하면 클로드가 알아서 처리해줍니다.
✍️ 1부 마무리 — 가장 어려운 첫 걸음을 뗐습니다
여기까지 따라오셨다면 클로드 코드 설치와 첫 실행을 완료하신 겁니다. 생각보다 어렵지 않죠?
터미널이 무섭게 느껴질 수 있지만, 클로드 코드 안에서는 결국 자연어로 대화하는 게 전부예요. “이거 해줘”, “저거 만들어줘”, “버그 고쳐줘” — 이게 전부입니다.
2부에서는 클로드 코드의 진짜 능력을 쓰는 방법을 다룹니다. Plan Mode로 안전하게 대규모 작업 시키는 법, CLAUDE.md로 나만의 지침 파일 만드는 법, 그리고 실전에서 바로 써먹을 수 있는 프롬프트 예시까지 정리해드릴게요.
👉 [2부 보러 가기] — 클로드 코드(Claude Code) 완전 초보 가이드 2부 — Plan Mode·CLAUDE.md·실전 프롬프트 총정리
By
