Claude Code 실전 사용법: 작업 흐름부터 프로젝트 규칙까지

Claude Code를 잘 쓰려면 설치 방법보다 먼저 이해해야 할 것이 있습니다. 바로 작업 흐름입니다.

Claude Code는 채팅창에 질문하고 답을 받는 도구가 아닙니다. 프로젝트 폴더 안에서 파일을 읽고, 코드를 수정하고, 명령어를 실행하고, 결과를 다시 확인할 수 있는 개발 에이전트에 가깝습니다.

Claude Code는 무엇이 다른가요?

일반 AI 챗봇은 대화창 안에서 답을 줍니다. 반면 Claude Code는 프로젝트와 연결되어 파일을 읽고, 코드를 수정하고, 명령어를 실행할 수 있습니다.

Claude Code에게는 “정답을 알려줘”보다 “이 프로젝트를 읽고, 계획을 세우고, 작은 단위로 고치고, 확인해줘”가 더 잘 맞습니다.

설치 후 첫 확인

공식 문서 기준으로 macOS, Linux, WSL에서는 설치 스크립트를 사용할 수 있습니다. Windows에서는 PowerShell 또는 CMD 방식이 따로 제공됩니다.

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

설치 후에는 프로젝트 폴더로 이동해 Claude Code를 실행합니다.

cd your-project
claude

처음 실행하면 브라우저에서 로그인하는 과정을 안내합니다. 나중에 계정을 바꾸거나 다시 인증해야 한다면 Claude Code가 실행된 세션 안에서 아래 명령을 사용할 수 있습니다.

/login

처음에는 바로 코딩을 시키기보다, 현재 폴더를 제대로 읽는지 확인하세요.

안녕. 지금 내가 어떤 폴더에서 작업하고 있는지 알려줘.
이 폴더의 파일 구조를 간단히 요약해줘.
아직 파일은 수정하지 마.

IDE와 함께 쓰기

터미널만으로도 Claude Code를 쓸 수 있습니다. 하지만 초보자라면 IDE와 함께 쓰는 편이 훨씬 편합니다.

IDE에서는 파일 트리, 코드 변경, diff, 실행 결과를 눈으로 확인할 수 있습니다. 그래서 Claude Code가 수정한 내용을 사람이 판단하기 좋습니다.

처음 IDE에서 시작할 때는 이렇게 요청해보세요.

이 프로젝트의 폴더 구조를 먼저 읽어줘.
프론트엔드, 백엔드, 설정 파일을 구분해서 설명해줘.
그리고 내가 어디부터 보면 좋을지 알려줘.

웹 화면은 스크린샷 루프로 개선하기

프론트엔드 작업에서 특히 효과적인 방식은 스크린샷 루프입니다.

말로만 “예쁘게 만들어줘”라고 하면 결과가 흔들립니다. 대신 원하는 디자인 레퍼런스나 현재 화면 캡처를 보여주고, Claude Code가 구현한 뒤 다시 화면을 찍어 비교하게 만들면 품질이 올라갑니다.

요청 예시는 이렇게 쓸 수 있습니다.

첨부한 스크린샷의 레이아웃을 참고해서 대시보드 첫 화면을 개선해줘.
기술 스택은 Next.js와 Tailwind CSS야.

먼저 관련 컴포넌트와 스타일 파일을 찾아 구조를 요약해줘.
그다음 수정 계획을 제안하고, 승인 후 구현해줘.
완료 후 데스크톱과 모바일 화면에서 깨지는 부분이 없는지 확인해줘.

프로젝트 규칙은 CLAUDE.md에 정리하기

Claude Code를 매번 처음부터 가르치면 피곤합니다. 프로젝트마다 반복해서 알려줘야 하는 규칙은 CLAUDE.md에 정리하는 편이 좋습니다.

예를 들어 이런 내용을 넣을 수 있습니다.

# 프로젝트 규칙

## 기술 스택
- Next.js
- TypeScript
- Tailwind CSS

## 작업 방식
- 코드를 수정하기 전에 먼저 계획을 제안한다.
- 관련 테스트가 있으면 수정 후 실행한다.
- 큰 변경은 여러 단계로 나눠 진행한다.

## 디자인 원칙
- 기존 컴포넌트와 스타일을 우선 사용한다.
- 모바일 화면에서 텍스트가 버튼 밖으로 넘치지 않게 한다.
- 새 UI를 만들 때는 접근성과 반응형 상태를 함께 확인한다.

## 금지 사항
- 사용하지 않는 패키지를 임의로 추가하지 않는다.
- 기존 디자인 시스템과 다른 스타일을 새로 만들지 않는다.
- 민감한 환경 변수나 토큰을 출력하지 않는다.

프로젝트가 커지면 .claude/rules/ 폴더에 규칙을 나눠둘 수도 있습니다. 아래 구조는 처음부터 전부 만들 필요는 없습니다. 프로젝트가 커질 때 하나씩 나누면 됩니다.

project/
|-- .claude/
|   |-- rules/
|   |   |-- workflow.md
|   |   |-- tech-defaults.md
|   |   `-- design-rules.md
|   |-- skills/
|   |   `-- release-check.md
|   `-- agents/
|       |-- reviewer.md
|       `-- tester.md
`-- CLAUDE.md

프로젝트에 처음 Claude Code를 도입할 때는 /init 명령으로 현재 구조를 분석하게 하고 초기 지침을 만들 수도 있습니다.

/init

다만 CLAUDE.md가 너무 길어지면 오히려 방해가 될 수 있습니다. 오래된 규칙, 더 이상 쓰지 않는 명령어, 중복 지시는 주기적으로 정리하세요.

바로 구현시키지 말고 Plan Mode부터 쓰기

Claude Code를 쓰다가 결과가 흔들리는 가장 흔한 이유는 너무 빨리 구현을 시작시키기 때문입니다.

작업이 조금이라도 크다면 먼저 계획을 받는 편이 좋습니다.

바로 수정하지 말고 먼저 계획을 세워줘.
관련 파일, 변경 방향, 위험 요소, 검증 방법을 나눠서 설명해줘.

예를 들어 결제 기능이 들어간 앱을 만든다면 이렇게 요청할 수 있습니다.

Supabase 인증과 Stripe 결제를 사용하는 작은 구독 앱을 만들고 싶어.
바로 코드를 쓰지 말고 먼저 설계부터 해줘.

다음 내용을 포함해줘.
- 필요한 페이지와 사용자 흐름
- Supabase에 필요한 테이블
- Stripe 연동 지점
- 구현 순서
- 위험한 부분과 확인 방법

계획이 괜찮으면 그때 구현을 시작합니다.

좋아. 계획 중 1번만 먼저 구현해줘.
다른 항목은 아직 건드리지 마.
구현 후 변경 파일과 확인 결과를 정리해줘.

이렇게 하면 Claude Code가 한 번에 너무 많은 코드를 바꾸는 일을 줄일 수 있습니다.

권한 모드는 편의성과 위험을 같이 보기

Claude Code에는 파일 수정이나 명령 실행과 관련된 권한 흐름이 있습니다. 확인을 받으면서 작업할 수도 있고, 더 자동화된 방식으로 빠르게 진행할 수도 있습니다.

자동 승인에 가까운 모드는 빠릅니다. 하지만 위험도 큽니다.

claude --dangerously-skip-permissions

특히 중요한 운영 데이터, 결제, 인증, 배포 설정이 연결된 프로젝트에서는 조심해야 합니다. 초보자라면 작은 테스트 프로젝트에서만 익숙해지는 편이 좋습니다.

컨텍스트 관리하기

Claude Code는 프로젝트와 대화의 맥락을 바탕으로 작업합니다. 그런데 세션이 길어질수록 맥락이 흐려질 수 있습니다.

현재 컨텍스트 상태를 확인하고 싶다면 이런 명령을 사용할 수 있습니다.

/context

긴 작업에서는 중간중간 요약을 요청하세요.

지금까지 한 작업을 요약해줘.
현재 목표, 완료된 것, 남은 것, 다음에 확인할 것을 나눠서 정리해줘.

다음 세션으로 넘길 때는 이렇게 요청할 수 있습니다.

다음 세션에서 이어서 작업할 수 있게 인수인계 메모를 작성해줘.
관련 파일, 현재 상태, 주의할 점, 다음 단계 순서로 정리해줘.

Claude Code를 오래 쓸수록 “얼마나 잘 시키느냐”보다 “맥락을 얼마나 잘 정리하느냐”가 중요해집니다.

MCP는 외부 도구를 연결할 때 쓰기

MCP는 Model Context Protocol의 줄임말입니다. 쉽게 말하면 Claude Code가 외부 도구와 연결되는 통로입니다.

예를 들어 이런 연결을 생각할 수 있습니다.

• 브라우저 화면 확인
• GitHub 같은 코드 협업 도구 연결
• Slack, Jira, Notion 같은 업무 도구 연결
• 사내 API나 직접 만든 개발 도구 연결

도구를 추가하는 명령은 연결하려는 MCP 서버에 따라 달라집니다. 기본 흐름은 “서버 이름, 전송 방식, 주소 또는 실행 명령을 등록한다”에 가깝습니다.

# 원격 HTTP MCP 서버 예시
claude mcp add --transport http github https://api.example.com/mcp

# 로컬 stdio MCP 서버 예시
claude mcp add --transport stdio my-tool -- npx -y my-mcp-server

# 등록된 MCP 서버 확인
claude mcp list

Claude Code 안에서 MCP 서버 상태를 확인하고 싶다면 아래 명령을 사용할 수 있습니다.

/mcp

예를 들어 메일이나 업무 데이터를 분류하는 작업이라면 처음에는 MCP로 테스트할 수 있습니다.

최근 항목 50개를 읽고 결제, 고객 문의, 뉴스레터, 기타로 분류해줘.
결과를 표로 정리하고, 자동화하기 전에 위험한 부분을 알려줘.

자주 쓰는 작업이라면 나중에는 스킬이나 스크립트로 고정하는 편이 더 안정적입니다.

서브에이전트는 병렬 작업에 쓰기

서브에이전트는 메인 작업에서 특정 역할을 떼어 맡기는 방식입니다.

예를 들어 코드 리뷰 흐름은 이렇게 나눌 수 있습니다.

개발 에이전트: 기능 구현
리뷰 에이전트: 변경된 코드 검토
테스트 에이전트: 테스트 실행과 실패 원인 정리
메인 세션: 최종 판단과 병합 여부 결정

대량 분류 작업이라면 이런 식으로 나눌 수 있습니다.

전체 데이터 1,000개를 4개 묶음으로 나눠서 처리해줘.
각 서브에이전트는 자기 범위만 분류하고,
마지막에 결과 형식을 맞춰 하나로 합쳐줘.

처음부터 모든 작업에 쓰기보다, 역할이 분명한 경우에만 쓰는 편이 좋습니다.

배포와 자동화까지 연결하기

Claude Code는 로컬에서 코드를 고치는 데서 끝나지 않습니다. 배포, 자동화, 반복 업무 처리까지 이어질 수 있습니다.

예를 들어 웹 앱은 Vercel, Netlify 같은 프론트엔드 배포 서비스를 쓸 수 있습니다. 데이터베이스나 인증이 필요하면 Supabase 같은 도구와 연결할 수 있습니다. Python 기반 API나 작은 자동화 서버는 서버리스 또는 컨테이너 기반 환경에 배포할 수도 있습니다.

다만 배포 명령과 설정 파일은 서비스마다 다릅니다. Claude Code에게 배포까지 맡길 때는 먼저 현재 프로젝트의 설정 파일을 읽게 하고, 어떤 서비스에 어떤 명령으로 배포할지 계획부터 확인하는 편이 안전합니다.

이 프로젝트를 배포하려고 해.
먼저 배포 관련 설정 파일과 package.json, 환경 변수 사용 지점을 찾아줘.
어떤 배포 서비스가 적합한지, 필요한 설정과 위험한 부분을 정리해줘.
아직 배포 명령은 실행하지 마.

처음부터 거창하게 시작하지 않아도 됩니다. 매일 반복하는 데이터 정리, 이메일 분류, 리포트 초안 생성, 고객 문의 요약 같은 작은 자동화부터 시작해도 충분합니다.

Claude Code 작업 체크리스트

바로 복사해서 쓰는 시작 프롬프트

Claude Code를 켰을 때 바로 붙여 넣을 수 있는 시작 프롬프트입니다.

이 프로젝트를 먼저 읽고 현재 구조를 요약해줘.
아직 파일은 수정하지 마.

다음 순서로 답변해줘.
1. 프로젝트의 주요 폴더와 역할
2. 기술 스택 추정
3. 실행 또는 테스트에 필요한 명령어
4. 내가 주의해야 할 파일
5. 다음 작업을 시작하기 전에 확인해야 할 질문

기능 구현을 맡길 때는 이렇게 시작하세요.

목표는 [기능 또는 수정 내용]이야.
먼저 관련 파일을 찾고 현재 흐름을 요약해줘.
그다음 수정 계획, 예상 위험, 검증 방법을 제안해줘.
내가 승인하기 전까지 코드는 수정하지 마.

구현을 승인할 때는 범위를 좁힙니다.

좋아. 계획 중 [번호]만 먼저 구현해줘.
다른 파일이나 기능은 건드리지 마.
완료 후 변경 파일, 변경 이유, 테스트 결과를 정리해줘.

자주 묻는 질문

마무리

Claude Code에서 중요한 것은 기능 목록을 많이 아는 것이 아닙니다.

설치, IDE, CLAUDE.md, Plan Mode, MCP, 서브에이전트 같은 도구들은 모두 중요합니다. 하지만 이 도구들이 힘을 발휘하려면 먼저 작업 흐름이 잡혀 있어야 합니다.

Claude Code에게 이렇게 말하는 습관부터 시작해보세요.

바로 수정하지 말고, 먼저 관련 파일을 읽고 현재 구조를 요약해줘.
그다음 수정 계획과 검증 방법을 제안해줘.
내가 승인하면 한 단계씩 구현하자.

이 한 문장이 Claude Code 사용 경험을 꽤 많이 바꿉니다.

AI에게 일을 잘 맡긴다는 건 더 긴 프롬프트를 쓰는 일이 아닙니다. 작업을 읽고, 계획하고, 작게 구현하고, 확인하는 흐름을 만드는 일입니다.