클로드코드 시작하기

Claude Code 설치는 끝냈는데, 커서가 깜빡이는 화면 앞에서 멍해진 적 있으시죠? “뭘 입력하면 되는 거지?” “이걸로 뭘 할 수 있는 거지?” 이 상태에서 멈춰버린 분이 정말 많습니다.

설치 방법은 여기저기 많은데, 설치 후 실제로 뭘 어떻게 시키면 되는지 알려주는 글은 의외로 적어요. 이 글에서는 설치는 건너뛰고, Claude Code에 처음 말을 거는 순간부터 실전에서 바로 쓸 수 있는 사용법 5가지를 다룹니다.

핵심 정리 — 이것만 기억하세요

• Claude Code는 터미널에서 자연어로 내 컴퓨터의 파일을 직접 읽고, 수정하고, 생성하는 AI 도구입니다.
• 설치 후 프로젝트 폴더로 이동한 뒤 claude를 입력하면 바로 시작됩니다.
• 파일 수정, 코드 작성, 버그 수정, 웹 검색 후 보고서 생성, 깃 커밋까지 자연어 한 문장으로 시킬 수 있습니다.
• Claude 웹(claude.ai)과 달리, Claude Code는 실제 파일을 직접 고치고 명령어를 실행합니다.
• /plan 명령으로 먼저 계획을 세우게 하고, 확인 후 실행시키면 실수를 크게 줄일 수 있습니다.
• 프롬프트는 짧고 구체적으로 쓸수록 결과가 좋습니다.
• 작업 전에 CLAUDE.md 파일에 프로젝트 규칙을 적어두면 매번 설명할 필요가 없습니다.

Claude Code가 뭔지 한마디로

내 컴퓨터에서 직접 일을 시킬 수 있는 AI 비서입니다.

일반 Claude(웹이나 앱)는 대화만 합니다. “이 파일 수정해줘”라고 하면 수정된 내용을 텍스트로 보여주기만 하지, 실제 파일은 그대로예요.

Claude Code는 다릅니다. 진짜로 파일을 열고, 고치고, 저장합니다. 터미널 명령어도 실행하고, 웹 검색도 하고, 깃(Git) 커밋도 해요. 말하자면 “말만 하는 AI”에서 “직접 손을 쓰는 AI”로 업그레이드된 겁니다.

처음 실행하면 뭐가 보이나요?

터미널을 열고 작업할 폴더로 이동한 뒤 claude를 입력하면 이런 화면이 나타납니다.

╭──────────────────────────────────╮
│  Claude Code                     │
│  /help for commands              │
╰──────────────────────────────────╯

 >

> 표시가 나오면 준비 완료입니다. 여기에 한국어든 영어든 자연어로 입력하면 됩니다. 특별한 명령어를 외울 필요 없어요.

자주 쓰는 슬래시 명령어는 아래 정도만 알면 충분합니다.

명령어	하는 일	언제 쓰나요
/help	사용 가능한 명령어 목록 표시	뭘 할 수 있는지 모를 때
/plan	실행 전에 계획부터 보여줌	큰 작업 시작 전
/compact	대화 맥락을 요약해서 정리	대화가 길어졌을 때
/clear	대화 초기화	새 주제로 넘어갈 때
/cost	현재 세션 비용 확인	요금이 궁금할 때
/doctor	설정 문제 자동 진단	뭔가 안 될 때
/model	AI 모델 변경	모델을 바꾸고 싶을 때

실전 사용법 5가지 — 이렇게 시키면 됩니다

1. 파일 수정 시키기

가장 기본적인 사용법입니다. 수정하고 싶은 파일이 있을 때, 파일명과 바꿀 내용을 말하면 됩니다.

이렇게 입력하세요:

index.html 파일에서 제목을 "내 포트폴리오"로 바꿔줘

Claude Code가 파일을 읽고, 수정할 부분을 보여주고, 승인을 요청합니다. Y를 눌러야 실제로 반영됩니다. 실수로 이상한 게 바뀔 걱정은 하지 않아도 돼요.

이런 것도 됩니다:

• “config.json에서 포트 번호를 3000에서 8080으로 바꿔줘”
• “README.md에 프로젝트 설명 추가해줘”
• “style.css에서 배경색을 흰색으로 바꿔줘”

2. 코드 짜달라고 하기

코드를 처음부터 만들어달라고 할 수도 있습니다. 파일이 아직 없어도 괜찮아요.

이렇게 입력하세요:

사용자 이름과 이메일을 입력받는 HTML 폼을 만들어줘. form.html로 저장해줘

Claude Code가 코드를 작성하고, 파일을 생성합니다. 결과가 마음에 안 들면 “버튼 색을 파란색으로 바꿔줘”처럼 추가로 수정을 시키면 됩니다.

비개발자도 가능한 예시:

• “매출 데이터가 담긴 CSV를 읽어서 월별 합계를 계산하는 파이썬 스크립트 만들어줘”
• “이미지를 가운데 정렬하는 CSS 코드 추가해줘”
• “간단한 할 일 목록 웹페이지 만들어줘”

3. 버그 고치기

에러가 나는데 원인을 모를 때, 에러 메시지를 그대로 붙여넣으면 됩니다.

이렇게 입력하세요:

python app.py 실행하면 "ModuleNotFoundError: No module named 'requests'" 에러가 나. 고쳐줘

Claude Code가 파일을 분석하고, 원인을 찾고, 해결 방법을 실행합니다. 필요하면 패키지 설치 명령어까지 직접 돌려줘요.

이런 식으로도 쓸 수 있어요:

• “이 프로젝트 전체에서 에러 나는 부분 찾아서 고쳐줘”
• “login.py 실행하면 화면이 안 뜨는데 원인 찾아줘”
• “TypeError 에러가 자꾸 나는데 왜 그런지 설명하고 수정해줘”

4. 웹 검색하고 보고서 만들기

코딩만 하는 도구가 아닙니다. 웹에서 정보를 검색하고 정리하는 것도 가능해요.

이렇게 입력하세요:

2026년 국내 AI 시장 규모를 웹에서 검색해서 HTML 보고서로 만들어줘

Claude Code가 웹 검색을 수행하고, 데이터를 정리하고, HTML 파일로 만들어 저장합니다. 출처까지 자동으로 붙여요.

업무에서 바로 쓸 수 있는 예시:

• “경쟁사 3곳의 가격 정책을 검색해서 비교표로 만들어줘”
• “이 CSV 데이터를 분석해서 요약 보고서 만들어줘”
• “오늘 환율 검색해서 표로 정리해줘”

5. 깃(Git) 커밋하기

작업한 내용을 깃으로 저장하고 싶을 때도 말로 시키면 됩니다.

이렇게 입력하세요:

지금까지 수정한 내용 깃 커밋해줘

Claude Code가 변경 사항을 확인하고, 커밋 메시지를 자동으로 작성하고, 커밋까지 해줍니다. 메시지가 마음에 안 들면 “커밋 메시지를 한국어로 바꿔줘”라고 하면 돼요.

Claude Code vs Claude 웹, 뭐가 다를까?

“그냥 Claude 웹(claude.ai)에서 물어보면 되지, 왜 Claude Code를 써야 해요?” 이런 질문을 많이 받습니다. 핵심 차이를 정리해봤어요.

구분	Claude 웹 (claude.ai)	Claude Code
실행 환경	브라우저	내 컴퓨터 터미널
파일 수정	수정된 코드를 보여주기만 함	실제 파일을 직접 수정·저장
명령어 실행	불가능	터미널 명령어 직접 실행
프로젝트 이해	복사해서 붙여넣은 것만 봄	폴더 전체를 읽고 구조 파악
웹 검색	제한적	검색 후 파일로 저장까지 가능
깃(Git) 관리	불가능	커밋, 브랜치, 상태 확인 가능
적합한 용도	질문, 글쓰기, 아이디어 정리	파일 수정, 코드 작성, 프로젝트 관리
요금	무료 플랜 있음	Pro 구독($20/월) 이상 필요

한 줄 요약: 대화만 할 거면 Claude 웹, 내 컴퓨터에서 직접 일을 시킬 거면 Claude Code.

잘 시키려면 어떻게 말해야 할까? 프롬프트 팁 3가지

팁 1: 구체적으로 말하세요

안 좋은 예	좋은 예
“이거 고쳐줘”	“login.py 23번째 줄에서 나는 TypeError 고쳐줘”
“사이트 만들어줘”	“상품 3개를 카드 형태로 보여주는 HTML 페이지 만들어줘”
“데이터 정리해줘”	“sales.csv에서 2026년 1분기 매출 합계를 계산해줘”

파일명, 위치, 원하는 결과를 함께 말하면 정확도가 확 올라갑니다.

팁 2: 큰 작업은 /plan부터

여러 파일을 동시에 바꾸거나 복잡한 작업을 시킬 때는 /plan 명령을 먼저 쓰세요.

/plan 이 프로젝트에 사용자 로그인 기능을 추가하려면 어떤 순서로 해야 할까?

Claude Code가 단계별 계획을 먼저 보여줍니다. 계획을 확인하고 “좋아, 실행해줘”라고 하면 그때 시작해요. 바로 실행시켰다가 의도와 다르게 바뀌는 걸 방지할 수 있습니다.

팁 3: CLAUDE.md 파일을 만들어두세요

프로젝트 폴더에 CLAUDE.md 파일을 만들어서 규칙을 적어두면, Claude Code가 매 세션마다 자동으로 읽습니다. 매번 같은 말을 반복하지 않아도 돼요.

예시:

# 프로젝트 규칙
- 이 프로젝트는 Python 3.12를 사용합니다
- 코드에 한국어 주석을 달아주세요
- 파일명은 영어 소문자와 하이픈만 사용합니다
- 테스트 파일은 tests/ 폴더에 넣어주세요

이렇게 적어두면 Claude Code가 알아서 규칙을 지킵니다. 프로젝트가 커질수록 효과가 큽니다.

자주 겪는 문제, 이렇게 해결하세요

문제 상황	원인	해결 방법
claude 입력해도 반응이 없음	설치가 안 됐거나 PATH 설정 문제	터미널을 껐다 켜거나, claude --version으로 설치 확인
“인증 실패” 또는 로그인 에러	토큰 만료 또는 구독 문제	claude logout 후 claude login으로 재로그인
파일을 못 찾겠다고 함	다른 폴더에서 실행 중	cd 명령으로 프로젝트 폴더로 먼저 이동
응답이 중간에 끊김	대화 맥락이 너무 길어짐	/compact로 맥락 정리 후 다시 시도
수정이 의도와 다르게 됨	지시가 너무 모호했을 수 있음	Ctrl+Z(실행 취소) 후 더 구체적으로 다시 요청
뭔가 전체적으로 이상함	설정 꼬임	/doctor 명령으로 자동 진단 실행

팁: Claude Code가 파일을 수정하기 전에 항상 승인을 요청합니다. 잘 모르겠으면 일단 N을 누르고 다시 물어보면 됩니다. 되돌릴 수 없는 실수가 날 일은 거의 없어요.

다음에 읽으면 좋은 글

Claude Code 기본 사용법을 익혔다면, 아래 글에서 더 깊은 기능을 확인해보세요.

• 설치가 아직이라면 → Claude Code 설치 방법 (비개발자 기준 30분 셋업)
• 설정을 바꾸고 싶다면 → Claude Code 설정 파일 다루는 법
• 자동화를 하고 싶다면 → Claude Code 훅(Hooks)으로 반복 작업 자동화하는 법
• 외부 도구를 연결하고 싶다면 → Claude Code MCP 연동으로 할 수 있는 것들
• 복잡한 작업을 맡기고 싶다면 → Claude Code 서브에이전트로 큰 작업 쪼개서 시키는 법
• 나만의 명령어를 만들고 싶다면 → Claude Code 스킬(Skills)로 자주 쓰는 작업 등록하는 법
• 생산성을 더 높이고 싶다면 → Claude Code 생산성 팁 모음

이 글은 2026년 7월 기준으로 작성되었습니다. Claude Code는 업데이트가 빠른 도구이므로, 세부 기능이 달라질 수 있습니다.