Claude Code 초보자 완전 입문 가이드 — 설치부터 첫 대화까지 step by step [파트 1]
솔직히 말하면, 저는 Claude Code를 처음 접했을 때 "이게 나한테 필요한 도구인가?" 반신반의했습니다. 터미널이라는 단어 자체가 왠지 개발자 전용 세계처럼 느껴졌거든요. 그런데 AI가 내 컴퓨터 파일을 직접 읽고 수정한다는 말에 호기심이 생겼습니다. 블로그 운영하면서 반복적인 작업들을 자동화할 수 있다면 얼마나 편할까 싶은 마음에 혹한것도 사실입니다.
설치 자체는 명령어 한 줄을 붙여넣는 것으로 생각보다 빨리 끝났습니다. 그런데 문제가 생겼습니다. 터미널에 claude를 입력했는데 아무 반응이 없더군요. 분명히 설치 완료 메시지가 떴는데, 왜 안 되지? 한참을 혼자 끙끙댔습니다. 알고 보니 터미널을 완전히 닫았다가 다시 열어야 환경 변수가 적용된다는 걸 그때 처음 알았습니다. 이 글을 쓰는 이유 중 하나가 바로 이겁니다. 저처럼 이런 작은 것에서 막히는 분들이 분명히 계실 거라서요.
그렇게 우여곡절 끝에 처음으로 Claude Code를 실행하고, 연습용 폴더에서 "간단한 할 일 목록 파이썬 파일을 만들어줘"라고 입력했습니다. 그랬더니 AI가 계획을 설명하고, 파일을 생성하고, 실행까지 스스로 하는 걸 눈앞에서 보게 됐습니다. "AI가 이렇게까지 하는구나" 하는 생각이 절로 들었습니다. 채팅창에서 답변을 받는 것과는 완전히 다른 경험이었습니다. 이 글은 그 날 제가 겪은 시행착오를 모두 담아, 처음 시작하는 분들이 저처럼 헤매지 않도록 정리한 설치·기본 사용 가이드입니다.
Claude Code ↗는 AI 회사 Anthropic이 만든 터미널 기반 AI 코딩 에이전트입니다. ChatGPT처럼 웹 브라우저에서 대화하는 방식이 아니라, 컴퓨터의 터미널(명령 프롬프트) 안에서 실행되며 실제 파일을 직접 읽고, 수정하고, 실행까지 합니다. 한마디로 "자연어로 말하면 AI가 내 컴퓨터에서 직접 코드를 짜주는 도구"입니다.
2025년 5월 정식 출시 이후, 2026년 초 개발자 선호도 조사에서 응답자의 46%가 "가장 좋아하는 AI 코딩 도구"로 Claude Code를 꼽았습니다. 2위인 Cursor(19%)와 3위 GitHub Copilot(9%)을 크게 앞서는 수치입니다. (출처: digitalmarketer.co.kr, 2026년 3월)
다른 도구와 가장 큰 차이는 프로젝트 전체를 이해한다는 점입니다. GitHub Copilot이 현재 열려 있는 파일 한 개의 코드를 자동 완성해 주는 수준이라면, Claude Code는 프로젝트 안에 있는 수십 개의 파일 구조와 관계를 파악하고 여러 파일을 동시에 수정하며 터미널 명령어까지 직접 실행합니다. 비유하자면 Copilot이 "자동완성 키보드"라면, Claude Code는 "내 옆에서 같이 일하는 시니어 개발자"에 가깝습니다.
| 구분 | Claude Code | GitHub Copilot | ChatGPT |
|---|---|---|---|
| 실행 환경 | 터미널 (로컬) | IDE 내 플러그인 | 웹 브라우저 |
| 파일 접근 | 전체 프로젝트 | 열린 파일 중심 | 직접 접근 불가 |
| 명령어 실행 | 가능 | 불가 | 불가 |
| 입력 방식 | 자연어 대화 | 코드 컨텍스트 | 자연어 대화 |
| 최소 요금 | $20/월 (Pro) | $10/월 | 무료 (제한) |
(출처: blog.highoutputclub.com·digitalmarketer.co.kr, 2026년 3월 기준. 요금은 변동될 수 있으므로 각 공식 사이트 확인 권장.)
Claude Code를 시작하기 전에 아래 두 가지를 확인하세요.
필수 조건
첫째, 운영체제는 macOS, Windows 10 이상, Ubuntu 20.04 이상이 지원됩니다. 맥북, 윈도우 PC 모두 사용 가능합니다. 둘째, Anthropic 유료 계정이 필요합니다. 무료 계정으로는 Claude Code를 사용할 수 없습니다. claude.ai에서 회원가입 후 유료 플랜을 구독해야 합니다.
요금제 선택 가이드
처음 시작하는 초보자라면 Pro 플랜($20/월, 약 2만 8천 원)으로 충분합니다. 주 2~3회 가벼운 사용, 간단한 코드 생성이나 버그 수정 등을 주로 한다면 Pro로 시작해 보세요. 매일 사용하거나 중간 규모 이상의 프로젝트를 다룬다면 Max 5x 플랜($100/월)이 적합하고, 대규모 프로젝트나 복수 인스턴스 동시 실행이 필요한 헤비 유저는 Max 20x 플랜($200/월)을 고려하시는 것이 좋습니다.
설치 방법은 크게 세 가지입니다. 초보자에게는 데스크톱 앱 방식이 가장 쉽고, 터미널에 익숙해지고 싶다면 네이티브 CLI 설치를 권장합니다. 2026년 3월 기준 Anthropic 공식 권장 방식은 네이티브 CLI입니다.
방법 A — 데스크톱 앱 (초보자 최우선 추천)
Step 1. claude.ai/download에 접속해 데스크톱 앱을 다운로드합니다.
Step 2. macOS는 .dmg 파일을 열고 Applications 폴더로 드래그합니다. Windows는 설치 파일을 실행합니다.
Step 3. 앱을 열고 Anthropic 계정으로 로그인합니다.
Step 4. 앱 상단에 Chat, Cowork, Code 탭이 보이면 설치 완료입니다. Code 탭을 클릭하면 별도 설치 없이 Claude Code를 바로 사용할 수 있습니다.
방법 B — 네이티브 CLI 설치 (터미널 방식)
macOS / Linux 사용자:
Windows 사용자 (PowerShell):
명령어를 터미널에 붙여넣고 Enter를 누르면 자동으로 설치가 진행됩니다. 몇 초~수십 초 후 설치가 완료됩니다. 이 방식은 자동 업데이트를 지원하므로 항상 최신 버전을 유지할 수 있습니다. Homebrew나 npm을 통한 설치도 가능하지만 자동 업데이트가 되지 않아 공식 인스톨러 방식을 권장합니다.
설치 확인
터미널에 아래 명령어를 입력해 버전 정보가 출력되면 설치 성공입니다.
Step 1 — 로그인
터미널에서 claude를 입력하면 처음 실행 시 브라우저가 열리며 Anthropic 로그인 화면이 나타납니다. 계정으로 로그인하면 터미널로 돌아와 Claude Code가 활성화됩니다. 로그인은 최초 1회만 하면 이후에는 자동으로 인증됩니다.
Step 2 — 작업 폴더로 이동
Claude Code는 현재 터미널이 위치한 폴더를 기준으로 동작합니다. 먼저 작업할 폴더로 이동하세요. 연습용 폴더를 새로 만들어도 됩니다.
mkdir ~/my-first-project
cd ~/my-first-project
# Windows PowerShell
mkdir $HOME\my-first-project
cd $HOME\my-first-project
Step 3 — Claude Code 시작 및 첫 대화
폴더로 이동한 후 claude를 입력해 실행합니다.
Claude Code가 실행되면 프롬프트 입력창이 나타납니다. 이제 그냥 한국어나 영어로 원하는 것을 말하면 됩니다. 예를 들어 아래처럼 입력해 보세요.
또는 영어: "Create a simple Python file that prints a to-do list."
Claude Code가 계획을 설명하고 파일을 생성하거나 코드를 실행합니다. 중간에 "이 작업을 진행해도 될까요?"라고 확인을 요청하면 y를 입력해 허락하면 됩니다. 작업이 완료되면 실제로 폴더 안에 파일이 생성되어 있는 것을 확인할 수 있습니다.
Claude Code 안에서는 슬래시(/)로 시작하는 특수 명령어를 사용할 수 있습니다. 자연어 대화와 함께 아래 명령어만 알아도 기본 사용에 전혀 불편함이 없습니다.
| 명령어 | 기능 | 언제 쓰나요? |
|---|---|---|
| /help | 도움말 전체 보기 | 처음 시작할 때, 명령어가 헷갈릴 때 |
| /clear | 대화 내용 초기화 | 새 작업 시작 전, 불필요한 토큰 소모 방지 |
| /model | AI 모델 선택 | 복잡한 작업은 Opus, 빠른 작업은 Sonnet |
| /exit | Claude Code 종료 | 작업을 마치고 나갈 때 |
| /cost | 현재 세션 토큰 사용량 확인 | API 사용자 / 비용 체크 시 |
| /status | 연결 상태·계정 정보 확인 | 연결이 이상할 때 확인용 |
(출처: dev-inventory.com·blog.highoutputclub.com, 2026년 기준. 명령어는 버전 업데이트에 따라 변경될 수 있음.)
특히 /clear 명령어는 새로운 작업을 시작할 때마다 습관적으로 사용하는 것이 좋아요. 이전 대화 내용이 누적되면 AI가 혼동하거나 불필요한 토큰이 소모될 수 있기 때문입니다.
파트 1에서는 Claude Code가 무엇인지, 어떻게 설치하고 처음 실행하는지를 다뤘습니다. 터미널이 낯설게 느껴지더라도 명령어 한 줄로 설치가 끝나고, 이후에는 평범한 한국어로 대화하듯 사용하면 됩니다. 파트 2에서는 실제 프로젝트에 Claude Code를 적용하는 방법과 생산성을 높이는 CLAUDE.md 설정, 고급 팁을 이어서 안내할 예정입니다. 파트 2가 포스팅 될 때까지 기다려 주세요!
Q. 코딩을 전혀 모르는 사람도 Claude Code를 사용할 수 있나요?
A. 네, 가능합니다. Claude Code는 자연어로 지시하는 방식으로 동작하기 때문에 "로그인 기능이 있는 웹페이지를 만들어줘"처럼 말하면 AI가 코드를 작성합니다. 터미널 명령어와 설치 과정이 처음에는 낯설 수 있지만, 이 글의 순서대로 따라가면 코딩 지식 없이도 첫 번째 결과물을 만들 수 있습니다. 데스크톱 앱 방식으로 시작하면 터미널 진입 장벽도 크게 낮출 수 있습니다.
Q. 무료로 사용할 수 있는 방법은 없나요?
A. Claude Code 자체는 유료 구독(최소 Pro, $20/월)이 필요합니다. 단, claude.ai/code에서 브라우저로 먼저 체험해 볼 수 있으며, 구독 전에 어떤 툴인지 감을 잡는 데 도움이 됩니다. 유료 결제가 부담스럽다면 첫 달만 사용해보고 취소하는 방식도 고려해 보세요.
Q. 설치 후 터미널에 claude를 입력했는데 "명령어를 찾을 수 없습니다"라고 나옵니다. 어떻게 하나요?
A. 터미널을 완전히 닫았다가 다시 열어보는 것이 첫 번째 해결책입니다. 설치 후 환경 변수가 새 터미널 세션에서만 적용되는 경우가 있기 때문입니다. 그래도 해결되지 않으면 설치 명령어를 다시 실행하거나, macOS에서는 source ~/.zshrc 또는 source ~/.bashrc를 입력해 환경 변수를 새로 고침하면 해결되는 경우가 많습니다.
— Jin Jin
댓글
댓글 쓰기