Claude Code는 단순히 코드를 작성하는 도구가 아닙니다 - 소프트웨어 프로젝트의 모든 단계에서 여러분과 함께 작업하도록 설계되었습니다. 초기 설정부터 배포와 지원까지 모든 것을 처리할 수 있는 팀의 또 다른 엔지니어라고 생각하세요.
/init 명령어
프로젝트에서 Claude Code로 작업을 시작할 때 가장 먼저 해야 할 일은 /init 명령어를 실행하는 것입니다. 이는 Claude에게 전체 코드베이스를 스캔하고 프로젝트의 구조, 종속성, 코딩 스타일, 아키텍처를 이해하도록 지시합니다.
Claude는 학습한 모든 내용을 CLAUDE.md라는 특별한 파일에 요약합니다. 이 파일은 이후의 모든 대화에 컨텍스트로 자동 포함되므로, Claude는 프로젝트에 대한 중요한 세부 사항을 기억합니다.
서로 다른 범위를 위해 여러 개의 CLAUDE.md 파일을 가질 수 있습니다:
- Project - 프로젝트에서 작업하는 모든 엔지니어 간에 공유됩니다
- Local - git에 커밋되지 않는 개인 메모입니다
- User - 모든 프로젝트에서 사용됩니다
/init을 실행할 때, Claude가 집중하기를 원하는 영역에 대한 특별한 지시를 추가할 수 있습니다. 생성된 파일에는 빌드 명령어, 코딩 가이드라인, Claude가 따라야 할 프로젝트별 패턴이 포함됩니다.
# 명령어를 사용하여 CLAUDE.md 파일에 빠르게 메모를 추가할 수도 있습니다. 예를 들어, # Always use descriptive variable names를 입력하면 이 가이드라인을 프로젝트, 로컬 또는 사용자 메모리에 추가하라는 메시지가 표시됩니다.
일반적인 워크플로우
Claude는 여러분이 이를 효과 증폭기로 접근할 때 가장 잘 작동합니다. 더 많은 컨텍스트와 구조를 제공할수록 더 나은 결과를 얻을 수 있습니다. 가장 효과적인 워크플로우는 다음과 같습니다:
1단계: Claude에 컨텍스트 제공하기
Claude에게 무언가를 만들어달라고 요청하기 전에, 만들고자 하는 기능과 관련된 코드베이스 내 파일들을 파악하세요. Claude에게 먼저 이 파일들을 읽고 분석하도록 요청하세요. 이를 통해 Claude는 여러분의 코딩 패턴과 기존 기능의 예시를 얻어 이를 바탕으로 작업할 수 있습니다.
2단계: Claude에게 솔루션 계획을 세우도록 지시하기
바로 구현으로 넘어가는 대신, Claude에게 문제를 충분히 생각하고 계획을 세우도록 요청하세요. Claude에게 아직 코드를 작성하지 말고 접근 방식과 필요한 단계에만 집중하라고 구체적으로 지시하세요.
3단계: Claude에게 솔루션 구현을 요청하기
견고한 계획이 마련되면, Claude에게 이를 구현하도록 요청하세요. Claude는 여러분이 함께 작업한 컨텍스트와 계획 작업을 바탕으로 코드를 작성합니다.
테스트 주도 개발 워크플로우
더 나은 결과를 위해 테스트 주도 접근 방식을 사용할 수 있습니다:
- Claude에 컨텍스트 제공하기 - 이전과 동일하게, Claude에게 관련 파일을 보여줍니다
- Claude에게 테스트 케이스를 생각해보도록 요청하기 - Claude가 새 기능을 검증할 테스트를 구상하도록 합니다
- Claude에게 해당 테스트를 구현하도록 요청하기 - 가장 관련성 높은 테스트를 선택하고 Claude가 이를 작성하도록 합니다
- Claude에게 테스트를 통과하는 코드를 작성하도록 요청하기 - Claude는 모든 테스트가 통과할 때까지 구현을 반복합니다
이 접근 방식은 Claude가 목표로 할 명확한 성공 기준을 가지고 있기 때문에 종종 더 견고한 코드를 만들어냅니다.
실제 예시
이러한 워크플로우가 실제로 어떻게 보이는지 살펴보겠습니다. 기존 프로젝트에 문서 변환 도구를 추가하고 싶다고 가정해 보겠습니다:
// First, ask Claude to read relevant files
> Read the math.py and document.py files
// Then ask for planning (not implementation)
> Plan to implement document_path_to_markdown tool:
1. Create a function that:
- Takes a file path parameter
- Validates the file exists
- Determines file type from extension
- Reads binary data from file
- Leverages existing binary_document_to_markdown function
- Returns markdown string
2. Add appropriate documentation
3. Register the tool with MCP server
4. Add tests
// Finally, ask for implementation
> Implement the plan그러면 Claude는 함수를 생성하고, 필요한 파일을 업데이트하고, 테스트를 작성하며, 모든 것이 올바르게 작동하는지 확인하기 위해 테스트 스위트를 실행하기까지 합니다.
추가 명령어
Claude Code에는 몇 가지 유용한 명령어가 포함되어 있습니다:
/clear- 대화 기록을 지우고 컨텍스트를 재설정합니다/init- 코드베이스를 스캔하고 CLAUDE.md 문서를 생성합니다#- CLAUDE.md 파일에 메모를 추가합니다
Claude는 git에 변경 사항을 스테이징하고 커밋하기, 테스트 실행하기, 종속성 관리하기와 같은 일상적인 개발 작업도 처리할 수 있습니다. 에디터와 터미널 사이를 전환하는 대신, Claude에게 이러한 작업을 처리하도록 요청하고 여러분은 더 큰 그림에 집중할 수 있습니다.
Claude Code로 성공하는 핵심은 이것이 단순한 코드 생성기가 아니라 협업 파트너로 설계되었다는 점을 기억하는 것입니다. 더 많은 컨텍스트와 구조를 제공할수록 Claude는 여러분이 프로젝트를 구축하고 유지하는 데 더 효과적으로 도움을 줄 수 있습니다.