Claude Code를 설치만 하고 채팅처럼 쓰면 절반만 쓰는 겁니다. 진짜 차이는 Claude Code 워크플로우에서 나옵니다 — 프로젝트 규칙을 알려주는 CLAUDE.md, 안전을 지키는 권한, 그리고 계획→실행→검토 루프. 입문자가 이 세 가지만 익혀도 결과물이 확 달라집니다. (아직 설치 전이라면 Claude Code 설치·시작하기 먼저 보세요.)
1. CLAUDE.md로 ‘프로젝트 규칙’을 알려주기
CLAUDE.md는 프로젝트 폴더에 두는 안내문으로, Claude Code가 작업 전에 자동으로 읽습니다. 여기에 프로젝트가 무엇인지, 빌드·테스트 명령, 코딩 컨벤션, 하지 말아야 할 것 등을 적어두면 매번 설명할 필요가 없습니다.
가장 쉬운 시작은 슬래시 커맨드 /init 입니다. 프로젝트에서 한 번 실행하면 구조를 훑어 CLAUDE.md 초안을 만들어줍니다. 그 뒤 내 규칙을 다듬어 넣으면 됩니다. 예:
# 프로젝트 규칙
- 이 저장소는 Next.js 웹앱이다.
- 빌드: npm run build / 테스트: npm test
- 스타일: 함수형 컴포넌트, 주석은 한국어로.
- DB 마이그레이션은 임의로 만들지 말 것.핵심은 “사람 신입에게 건네는 온보딩 문서”처럼 쓰는 것입니다. 짧고 구체적일수록 좋습니다.
2. 권한을 이해하고 다루기
Claude Code는 안전을 위해 작업 종류에 따라 권한을 다르게 처리합니다. 기본값은 읽기는 자동 승인, 파일 수정·명령 실행은 사용자에게 확인을 받는 방식이라 대부분의 상황에 적합합니다.
- 변경 사항을 보여줄 때 내용을 확인하고 승인하세요. 특히 파일 삭제·대량 수정·외부 명령은 신중히.
- 반복적으로 안전한 작업은 허용 목록으로 자동화할 수 있지만, 입문 단계에서는 하나씩 확인하는 습관이 안전합니다.
- “무엇이든 알아서 다 해” 모드는 익숙해진 뒤에. 처음엔 통제권을 쥐고 가세요.
3. 기본 작업 루프 — 계획 → 실행 → 검토
큰 작업을 한 문장으로 던지고 바로 코드를 만들게 하기보다, 먼저 계획을 세우게 하면 결과가 훨씬 좋습니다.
- 계획: “바로 고치지 말고, 어떻게 바꿀지 먼저 설명해줘”라고 요청해 접근을 검토합니다.
- 실행: 계획에 동의하면 진행시키고, 권한 요청을 확인하며 변경을 적용합니다.
- 검토: 변경된 코드를 읽고, 빌드·테스트로 확인합니다. 이상하면 “이 부분 되돌리고 다시”처럼 짧게 교정합니다.
작업은 작게 쪼개서 시키세요. 한 번에 거대한 기능을 맡기면 검토가 어렵고 오류도 늘어납니다.
4. 슬래시 커맨드 & 훅 맛보기
자주 쓰는 슬래시 커맨드:
/init— CLAUDE.md 생성/clear— 대화(컨텍스트) 초기화. 새 작업 시작할 때./compact— 길어진 대화를 압축해 컨텍스트 정리./help— 도움말. (이 외에.claude/commands에 나만의 커스텀 커맨드도 추가 가능.)
훅(hooks)은 특정 시점(도구 실행 전/후)에 자동으로 명령을 돌리는 기능입니다. 예를 들어 파일을 저장할 때마다 포매터를 자동 실행하게 할 수 있습니다. /hooks로 설정하며, 익숙해진 뒤 생산성을 크게 올려줍니다.
5. 입문자가 자주 하는 실수
- CLAUDE.md 없이 시작 — 매번 같은 설명을 반복하게 됩니다. 처음에
/init부터. - 너무 큰 작업을 한 번에 — 작게 쪼개고 단계별로.
- 변경을 안 보고 승인 — 권한 확인은 ‘검토’의 기회입니다.
- 컨텍스트를 안 비움 — 새 작업엔
/clear로 깔끔하게.
다음 단계
여기까지면 Claude Code 기본기는 충분합니다. 다음은 MCP로 클로드에 내 도구·데이터를 연결해 활용 범위를 넓히는 단계입니다(순차 발행). 전체 로드맵은 개발자를 위한 클로드 활용법에서 볼 수 있습니다.
본 글은 정보 제공을 목적으로 하며, 기능·명령은 버전에 따라 바뀔 수 있습니다. 최신 내용은 공식 문서를 확인하세요. 최종 확인일: 2026-05-22.