로드 중
로드 중

Claude Code는 단순히 코드를 작성하는 도구가 아니라, 프로젝트 전체 생명주기에 걸쳐 여러분의 코딩 파트너가 되도록 설계되었습니다. 초기 설정부터 배포 및 유지보수까지, Claude는 소프트웨어 개발의 모든 단계를 도울 수 있습니다.

Discover, Design, Build, Deploy, Support and Scale의 다섯 가지 프로젝트 단계, 각 단계마다 세 가지 Claude Code 작업이 있음.

/init 명령어

새로운 프로젝트를 시작할 때, /init 명령어가 첫 단계입니다. Claude Code는 여러분의 코드베이스를 스캔하여 프로젝트 구조, 종속성, 명령어, 코딩 패턴을 파악합니다. 이 발견 내용은 CLAUDE.md 파일에 요약되며, Claude는 이후 대화에서 이 파일을 자동으로 읽습니다.

VS Code 터미널에서 "/init"을 입력하여 "코드베이스 문서화로 새 CLAUDE.md 파일 초기화"를 힌트로 보여주는 Claude Code.

서로 다른 범위를 위해 여러 개의 CLAUDE.md 파일을 가질 수 있습니다:

  • 프로젝트 - git에 커밋되어 엔지니어 간에 공유됨
  • 로컬 - git에 커밋되지 않으며, Claude에게 전달하는 개인적인 메모
  • 사용자 - 모든 프로젝트에서 사용됨

/init을 실행할 때, Claude가 집중하기를 원하는 영역에 대한 특별한 지시사항을 추가할 수 있습니다. 또한 # 단축키를 사용하여 CLAUDE.md 파일에 추가되는 빠른 메모를 덧붙일 수도 있습니다.

일반적인 워크플로우

Claude는 작업 효율을 높이는 도구로 사용할 때 가장 효과적입니다. 더 많은 맥락과 구조를 제공할수록 더 좋은 결과를 얻을 수 있습니다. 다음은 두 가지 효과적인 접근 방식입니다:

계획 우선 워크플로우의 3단계 화살표: 맥락 제공, 솔루션 계획, 구현, 아래에 설명됨.

계획 우선 워크플로우

이 3단계 접근 방식은 복잡한 기능에 잘 작동합니다:

  1. Claude에게 맥락 제공하기 - 기능과 관련된 파일을 찾아 Claude에게 읽어달라고 요청하세요
  2. Claude에게 솔루션을 계획하도록 지시하기 - 만들고자 하는 내용을 설명하되, 아직 코드를 작성하지 말라고 구체적으로 요청하세요
  3. Claude에게 솔루션 구현을 요청하기 - 확실한 계획이 준비되면, Claude는 이미 완료한 맥락과 계획을 바탕으로 코드를 작성할 수 있습니다

예를 들어, 문서 변환 도구를 만들 때 먼저 Claude에게 기존 도구 예제와 헬퍼 함수를 살펴보도록 요청할 수 있습니다. 그런 다음 구현 단계를 계획하도록 요청하세요. 마지막으로 실제 코드 구현을 요청하세요.

테스트 주도 개발 워크플로우

Claude Code 터미널: main.py, tools/document.py, tests/test_document.py에 대한 변경사항을 스태시한 후 "/clear"를 입력.

이 접근 방식은 더 많은 사전 작업이 필요하지만 Claude의 효율성을 극적으로 높여줍니다:

  1. Claude에게 맥락 제공하기 - 기능과 관련된 파일을 공유하세요
  2. Claude에게 테스트 케이스를 생각해보도록 요청하기 - 아직 코드를 작성하지 말라고 구체적으로 Claude에게 지시하세요
  3. Claude에게 해당 테스트 구현을 요청하기 - 기능과 관련성이 있어 보이는 테스트만 선택하세요
  4. Claude에게 테스트를 통과하는 코드 작성을 요청하기 - Claude는 테스트를 통과할 때까지 솔루션을 반복 개선합니다

이 워크플로우는 여러분의 코드가 견고하며, 처음에 미처 고려하지 못했을 수 있는 엣지 케이스를 처리할 수 있도록 도와줍니다.

실용적인 팁

Claude는 단순히 코드를 작성하는 것을 넘어 일상적인 개발 작업을 처리할 수 있습니다. 다음과 같은 작업을 요청할 수 있습니다:

  • 프로젝트 환경을 설정하고 종속성을 설치하기
  • 변경사항을 스테이징하고 설명이 포함된 커밋 메시지로 커밋하기
  • 테스트 스위트를 실행하고 결과를 해석하기
  • /clear로 대화 기록을 지워 맥락을 초기화하기

Claude Code는 CLAUDE.md 파일을 자동으로 읽으므로, 여러분이 거기에 문서화하는 코딩 표준, 프로젝트별 메모, 또는 아키텍처 결정이 앞으로의 모든 상호작용에 영향을 미친다는 점을 기억하세요. 이는 Claude가 여러분의 프로젝트 패턴과 요구사항을 더 많이 학습할수록 점점 더 효과적으로 만들어줍니다.