Claude Code 완전 가이드: Part 1 - 에이전틱 개발자의 사고방식

1.1. 거대한 목표는 잘게 쪼개서 지시하기

AI에게 막연한 업무를 주면 원치 않는 결과물이 나옵니다. 작업 단위를 구체적으로 분해하세요.

• ❌ 나쁜 예: "로그인 페이지 만들어줘."
• ✅ 좋은 예 (단계별 지시):
  1. "DB 스키마부터 설계해줘."
  2. "이걸 바탕으로 마이그레이션 파일 만들어."
  3. "React로 로그인 UI 컴포넌트 짜줘."
  4. "로그인 API 엔드포인트 연결해줘."
• 💡 실전 팁: 한 번에 완성하려 하지 마세요. '기능 1 구현 -> 검증 -> 기능 2 구현 -> 검증' 순으로 넘어가는 것이 디버깅에도 훨씬 유리합니다.

 

1.2. 상황에 맞는 모드 선택: Plan vs YOLO

Claude Code의 두 가지 작업 모드를 적재적소에 활용해야 생산성이 극대화됩니다.

• 계획(Plan) 모드 (기본 추천): 코드를 분석하고 계획만 짠 뒤, 사용자의 승인을 기다립니다. 복잡한 작업이나 대규모 리팩토링 등 **업무의 90%**는 이 모드로 진행하세요.
  (visual code>codex 에서 plan 모드 키고 끄는 단축키는 shift + tab)
• 욜로(YOLO) 모드: 묻지도 따지지도 않고 AI가 바로 코드를 수정하고 실행합니다. 단순 반복 작업에 좋지만, 치명적인 실수를 방지하기 위해 반드시 격리된 컨테이너 환경에서만 사용하세요.

 

1.3. 컨텍스트(작업 기억) 관리하기

AI의 기억력은 무한하지 않습니다. 대화가 길어지고 주제가 섞이면 AI가 초기의 중요 지시를 까먹는 '컨텍스트 드리프트'가 발생합니다.

• 1대화 1목표: 로그인 기능 만들다 갑자기 대시보드를 수정해달라고 섞어서 지시하지 마세요. 새 터미널 탭을 여는 것이 좋습니다.
• HANDOFF.md 활용 (중요): 대화가 너무 길어졌다면, AI에게 지금까지의 진행 상황, 성공/실패 여부, 다음 할 일을 HANDOFF.md 파일로 요약하게 하세요. 그다음 /clear로 AI의 기억을 비우고, 새 대화에서 해당 파일만 읽게 하면 깔끔하게 작업을 이어갈 수 있습니다.
  • 예시 Prompt :
    “Put the rest of the plan in the system-prompt-extraction folder as HANDOFF.md. Explain what you have tried,
    what worked, what didn’t work, so that the next agent with fresh context is able to just load that file and nothing
    else to get started on this task and finish it up.”
• /context 명령어: 현재 AI의 메모리 용량을 무엇이 차지하고 있는지 확인하고 불필요한 정보는 쳐내세요.
• 자동 압축 비활성화: Claude Code는 컨텍스트가 가득 차면 자동으로 압축합니다. 하지만 저자는 /config 를 통해 자동 압축을 끄고 수동으로 관리하는 것을 선호합니다.

 

1.4. 추상화 수준 조절하기 (Vibe Coding vs Deep Dive)

상황에 따라 코드를 보는 시야를 넓히거나 좁혀야 합니다.

• Vibe Coding (숲 보기): 전체적인 흐름만 파악합니다. 빠른 프로토타입 제작이나 일회성 스크립트를 짤 때 적합합니다.
• Deep Dive (나무 보기): 개별 코드 라인과 의존성까지 꼼꼼히 살핍니다. 실제 프로덕션 코드, 보안, 복잡한 버그 수정 시에는 직접 깊게 파고들어야 합니다.

 

1.5. 낯선 기술에 과감하게 도전하기

AI라는 든든한 파트너가 생겼으니, 한 번도 안 써본 언어나 프레임워크를 두려워할 필요가 없습니다.

• 💡 실전 팁: 막히면 당황하지 말고, AI에게 "천천히 가자. 이 코드가 정확히 무슨 뜻인지 설명해 줘"라고 요청하며 속도를 조절하세요. 방향을 틀거나 깊이를 조절하며 반복하다 보면 낯선 환경(예: 처음 써보는 Rust나 React)에서도 결국 해결책을 찾을 수 있습니다.