Claude Code 첫 작업 런북: 빠르게 신뢰를 만드는 안전한 시작 작업 7가지

첫 작업이 Claude Code에 대한 신뢰를 결정한다

Claude Code를 설치하자마자 “기능 전체를 만들어 줘”라고 맡기면 실패 확률이 높아집니다. 첫 작업은 작고, 로컬에서 끝나고, 검증 가능하며, 쉽게 되돌릴 수 있어야 합니다.

이 글은 Claude Code 시작 가이드 다음에 읽기 좋은 실행 메모입니다. 팀 규칙까지 정리하려면 CLAUDE.md 템플릿 도 함께 보세요.

좋은 첫 작업의 조건

조건	이유
로컬에서 끝난다	운영 환경이나 외부 서비스를 건드리지 않는다
범위가 작다	작업이 프로젝트 전체로 번지지 않는다
검증할 수 있다	diff, build, test 로 성공을 판단한다
되돌릴 수 있다	결과가 나쁘면 바로 취소한다

신뢰를 만드는 7가지 안전한 시작 작업

1. 수정 전에 repo를 먼저 읽게 한다

이 repo를 읽고 다음을 알려 주세요.
1. 주요 entry point
2. 자주 쓰는 명령
3. 위험한 디렉터리
4. 처음 수정해도 되는 작은 파일

먼저 이해도를 확인한 뒤 편집을 맡깁니다.

2. 실패한 테스트나 보이는 오류 하나만 요약하게 한다

git status --short
npm.cmd run test

Claude Code에는 실패 지점, 가능한 원인, 가장 작은 다음 행동을 설명하게 합니다.

3. 작은 리팩터 계획만 먼저 받는다

이 파일을 읽고 동작을 바꾸지 않는 가장 작은 리팩터를 제안하세요.
계획, 수정할 줄, 위험, 검증 방법을 먼저 쓰고 아직 편집하지 마세요.

계획이 약하면 코드를 망치기 전에 멈출 수 있습니다.

4. 기존 테스트에 assertion 하나를 추가한다

새 기능보다 작고 측정 가능해서 첫 작업에 잘 맞습니다.

5. 모호한 버그를 재현 메모로 바꾼다

“가끔 깨진다”를 바로 고치게 하지 말고 버그 리포트 템플릿 으로 조건을 정리하세요.

6. 최소 CLAUDE.md를 만든다

# CLAUDE.md
- stack: Astro + TypeScript
- commands: npm.cmd run build
- do not touch: .env, dist, generated exports
- output preference: 여러 파일 수정 전 계획을 먼저 설명

이 작은 규칙 파일이 이후 세션 전체를 안정시킵니다.

7. 다음 세션용 handoff note를 남긴다

첫 성공이 꼭 patch일 필요는 없습니다. 다음 사람이 안전하게 이어갈 수 있으면 충분한 성과입니다.

피해야 할 시작 방식

production deploy, push, 외부 전송, 전면 재작성부터 시작하지 마세요. 첫 작업은 로컬에서 끝나고 한 명령으로 검증되어야 합니다.

다음 단계

자주 쓰는 명령은 무료 cheatsheet 에 고정하세요. setup, permission, CLAUDE.md에서 자주 막히면 Setup Guide 를 보세요. 팀 도입 설계가 필요하면 상담 페이지 로 이동하세요.

작업 후 반드시 리뷰할 항목

첫 작업은 “끝났는가”보다 “다음에도 맡겨도 되는가”를 판단하는 단계입니다. 완료 후에는 변경 파일, 검증 명령, 남은 위험, 다음에 맡길 수 있는 최소 작업을 확인해야 합니다. 이 과정이 없으면 우연한 성공인지 반복 가능한 운영인지 구분할 수 없습니다.

이번 작업을 리뷰해 주세요.
1. 실제로 변경한 파일
2. 성공을 확인한 명령
3. 아직 확인하지 않은 위험
4. 다음에 맡겨도 되는 최소 작업
5. 되돌릴 때 사용할 절차

좋은 첫 세션은 큰 diff가 아니라 다음 판단을 쉽게 만드는 세션입니다. 테스트 하나만 고쳐도 검증 방법과 금지 영역, 다음 범위가 분명하면 충분합니다. diff가 큰데 검증이 약하면 다음 세션은 더 작은 단위로 돌아가야 합니다.