1. Claude Code 활용법: 6개월간의 인사이트 [0]

thumbnail Claude Code를 6개월간 사용하며 얻은 가장 중요한 인사이트는 `claude.md` 파일을 활용하는 것입니다. 이 파일은 프로젝트의 기억 역할을 하며, Claude Code가 사용자의 규칙과 선호도를 일관되게 따르도록 만들어 개발 효율성을 극대화합니다.

1.1. Level 1: Claude Code 기초 다지기 [10]

  1. Claude Code 설치 및 기본 개념 이해 [20]
    1. Claude Code는 로컬 머신 또는 원격 서버에 설치할 수 있습니다. [24]
    2. claude 명령어로 터미널에서 실행하며, --resume 플래그로 이전 세션을 이어갈 수 있습니다. [33]
  2. 핵심 기능 활용으로 생산성 향상 [36]
    1. To-do 리스트: Claude Code가 코드를 작성하기 전에 할 일 목록을 생성하여 작업 과정을 투명하게 보여주고, 복잡한 작업도 루프에 빠지지 않고 처리하도록 돕습니다. [38]
    2. Bash 모드: Claude Code 내에서 bash 명령어를 실행할 수 있어, 파일 읽기/쓰기, Git 명령어 처리 등 다양한 작업을 외부로 나가지 않고 수행할 수 있습니다. [44]
    3. 자동 문서화: 앱의 아키텍처와 작동 방식을 탐색하고 architecture.md와 같은 파일에 저장하여 프로젝트 이해도를 높입니다. [48]
    4. 자동 수락 모드 (Auto Accept Mode): Shift + Tab 키를 눌러 활성화하면 Claude Code가 변경 사항을 적용하기 전에 매번 허가를 구하지 않아 작업 흐름을 방해받지 않습니다. [52]
    5. 모델 전환: /model 명령어로 Opus (최고 성능), Sonnet (일상 작업), Opus Plan 모드 (Opus로 계획, Sonnet으로 코드 실행) 등 다양한 모델을 선택하여 토큰 사용량과 응답 속도를 조절할 수 있습니다. [56]
    6. 중단 기능: Escape 키를 한 번 눌러 Claude Code의 작업을 중단시키거나 두 번 눌러 이전 프롬프트로 돌아갈 수 있어, 잘못된 방향으로 진행될 때 즉시 수정할 수 있습니다. [65]
  3. 디버깅 및 테스트 용이성 확보 [70]
    1. 스크린샷 활용 디버깅: UI 이슈나 버그 발생 시 스크린샷을 Claude Code에 입력하여 문제점을 파악하고 해결할 수 있습니다. [72]
    2. 테스트 코드 자동 생성: 특정 기능이나 흐름에 대한 테스트 코드를 Claude Code에게 요청하여 개발 초기 단계부터 품질을 확보할 수 있습니다. [77]
    3. TDD (Test-Driven Development): Claude Code에게 먼저 테스트 코드를 작성하게 한 후 기능을 구현하도록 하여, 초기 단계에서 문제를 발견하고 구조화된 개발을 진행할 수 있습니다. [80]
  4. claude.md 파일을 통한 프로젝트 맞춤 설정 [84]
    1. 프로젝트의 기억: claude.md 파일은 Claude Code가 모든 작업에 참조하는 프로젝트의 기억 저장소 역할을 합니다. [86]
    2. 규칙 및 선호도 설정: Git 워크플로우, 아키텍처 개요, 빌드/테스트/디버깅 방법, 분석 및 문서화 방법 등 프로젝트 관련 규칙과 선호도를 이 파일에 명시하여 Claude Code가 일관되게 따르도록 합니다. [88]
    3. 자동 업데이트: Claude Code에게 claude.md 파일을 업데이트하도록 요청하여 프로젝트 진행 상황과 새로운 선호도에 맞춰 지속적으로 관리할 수 있습니다. [94]
  5. 효율적인 작업 관리 [98]
    1. 메시지 큐: Claude Code가 현재 작업을 완료하기 전에 메시지를 입력하면 메시지 큐에 추가되어, 작업 완료 후 순서대로 처리됩니다. [98]
    2. 마크다운 파일 프롬프트: 긴 프롬프트를 마크다운 파일로 작성하고 @ 기호를 사용하여 참조하면, 터미널 입력이 깔끔해지고 프롬프트 내용을 미리 구상하기 용이합니다. [102]

1.2. Level 2: 워크플로우 향상 [105]

  1. 계획 및 사고 과정 최적화 [109]
    1. 계획 모드 (Planning Mode): 코드를 작성하기 전에 plan only 모드를 활성화하여 Claude Code가 먼저 계획을 세우고 검토할 수 있도록 합니다. [109]
    2. 사고 키워드 (Think Keywords): think, think hard, ultra think와 같은 키워드를 프롬프트에 포함하여 Claude Code가 문제 해결에 더 많은 시간을 할애하도록 유도합니다. [120]
    3. 복합 기능 활용: 계획 모드와 사고 키워드를 함께 사용하여 복잡한 문제를 해결하는 강력한 워크플로우를 구축할 수 있습니다. [125]
  2. 코드 작성 이상의 활용: 리서치 및 문서화 [128]
    1. 웹 리서치: Claude Code의 웹 검색 및 가져오기 기능을 활용하여 API 사용법 조사, 최신 기술 동향 보고서 작성 등 다양한 리서치를 수행할 수 있습니다. [129]
    2. PDF 문서 활용: PDF 문서를 Claude Code에 입력하여 웹 검색 결과와 결합된 심층적인 리서치를 진행할 수 있습니다. [134]
    3. 문서 자동 생성: 제품 요구사항 문서(PRD), 사용자 경험 가이드, API 문서, 기술 설계 문서 등 다양한 문서를 Claude Code를 통해 생성하여 개발 과정에 필요한 정보를 체계적으로 관리합니다. [137]
    4. 자동 변경 추적: 변경 로그 생성, 웹사이트 업데이트용 최신 기능 문서화, 의사 결정 문서 작성 등 프로젝트 변경 사항을 자동으로 추적하고 기록하여 관리합니다. [143]
  3. GitHub 통합 및 협업 강화 [147]
    1. GitHub Actions 연동: /install GH actions 명령어로 Claude Code와 GitHub Actions를 연동하여 이슈 및 PR에 대한 자동 수정 및 검토를 수행할 수 있습니다. [148]
  4. 제품 관리자 마인드셋 적용 [155]
    1. 명확한 맥락과 제약 조건 제공: Claude Code에게 목표 달성에 필요한 명확하고 관련성 높은 맥락과 제약 조건을 제공합니다. [157]
    2. 결과 검증 중심 사고: Claude Code가 생성한 코드의 모든 줄을 이해하려 하기보다, 앱 경험, 테스트 통과 여부, 의도대로 작동하는지 등 높은 수준의 추상화에서 결과를 검증하는 데 집중합니다. [159]

1.3. Level 3: 고급 기술 마스터하기 [165]

  1. 병렬 작업 및 다중 인스턴스 활용 [169]
    1. 병렬 하위 에이전트 (Parallel Subagents): 여러 해결책을 동시에 탐색하고 최상의 것을 선택하는 브레인스토밍 세션을 진행합니다. [170]
    2. Git Worktrees 활용: 여러 Claude Code 인스턴스를 동시에 사용하여 여러 기능을 독립적으로 개발하고, Git worktrees를 통해 충돌 없이 코드를 관리합니다. [175]
  2. 고급 사용자 정의 및 확장 [187]
    1. 사용자 정의 명령어 (Custom Commands): 반복적인 작업을 위한 프롬프트 단축키를 생성하여 Claude Code의 효율성을 높입니다. [188]
    2. 특수화된 하위 에이전트 (Specialized Subagents): 사용자 경험 디자인, API 설계, 보안 검토 등 특정 작업을 자율적으로 처리하는 맞춤형 AI 시스템을 구축합니다. /agents 명령어를 통해 쉽게 생성하고 관리할 수 있습니다. [201]
    3. MCP 서버 연동: 데이터베이스, Figma, Canva 등 외부 도구와 Claude Code의 기능을 확장하기 위해 Model Context Protocol (MCP) 서버를 활용합니다. [219]
      1. 데이터베이스 MCP: MongoDB, PostgreSQL, Supabase 등 다양한 데이터베이스 작업을 직접 수행합니다. [221]
      2. Playwright MCP: 웹 UI를 시각적으로 인식하여 테스트 및 버그 수정에 활용합니다. [225]
      3. Figma MCP: 디자인을 코드로 변환하는 데 사용됩니다. [227]

1.4. 비용 및 가치 평가 [237]

  1. Claude Code 비용 구조 [238]
    1. 유료 플랜: Claude Pro ($20/월), Max 5X ($100/월), Max 20X ($200/월) 플랜을 제공합니다. [239]
    2. Anthropic API: 개인 사용자에게는 비효율적이며, 대규모 기업에 적합합니다. [246]
  2. 가치 및 고려 사항 [247]
    1. Claude Code는 유료이지만, 개발 효율성 향상을 통해 비용 이상의 가치를 제공합니다. [250]
    2. 2024년 8월 말부터 Claude Max 사용자에게 주간 속도 제한이 추가될 예정이지만, 전반적인 가치에는 큰 영향이 없을 것으로 예상됩니다. [247]