Kumamap(38.9만 사용자) 개발자로부터
몇 달이 아닌 며칠 만에 Claude Code 마스터하기
초보자와 파워 유저를 구분하는 워크플로우, 단축키, 설정들.
01 터미널 사용하기02 CLAUDE.md 생성하기03 단축키와 명령어04 Git 적극 활용하기05 민감한 파일 보호하기06 Bash 명령어 자동 승인 금지07 안전한 작업 자동 승인08 항상 플랜 모드 사용09 일반적인 계획 수락 금지10 CLAUDE.md에 대해 검증하기11 엔드투엔드 사고 강제하기12 Ultrathink 항상 켜기13 직접적으로 말하기14 하지 말아야 할 것이 아닌 해야 할 것 말하기15 중요성 과장하기16 Claude를 사람이 아닌 도구로 취급하기17 Claude는 어시스턴트 작업에 뛰어남 - 전략적 작업은 안내하기18 하나의 작업 = 하나의 세션19 긴 세션에서 품질 저하20 /resume으로 세션 계속하기21 '모두 완료'를 믿지 마세요22 이미지/스크린샷 사용하기23 오류 메시지 그대로 복사하기24 첫 번째에 완벽을 기대하지 마세요25 큰 작업에는 여러 에이전트26 복잡한 문제를 단계로 분해하기27 Git Worktrees28 서브에이전트 - 주의해서 사용29 계층적 CLAUDE.md30 커스텀 슬래시 명령어31 커스텀 에이전트32 Claude는 URL을 만들어냅니다33 Claude는 과잉 설계합니다34 Claude는 중복을 만듭니다35 Claude는 추가만 하고 제거하지 않습니다36 Claude는 예스맨입니다37 Claude는 묻지 않고 가정합니다38 Claude는 파일을 부분적으로만 읽습니다39 Claude는 코드 대신 테스트를 수정합니다40 Hooks41 MCP 서버42 Skills43 GitHub Actions44 헤드리스 모드45 정기적으로 코드베이스 품질 검사 실행46 POC에 Claude Code 활용하기47 Claude는 보일러플레이트에 뛰어납니다48 Claude로 배우기49 커밋 메시지에 Claude 사용50 모든 새 기능을 쫓지 마세요51 실전 검증된 CLAUDE.md
전체 51개 팁 보기 →왜 이 가이드를 신뢰해야 할까요?
"수백 시간의 시행착오를 통해 Claude Code에서 실제로 효과가 있는 것을 알아냈습니다. 이 가이드는 제가 배운 모든 것입니다."
Danyel Koca
Sakana AI 응용 연구 엔지니어
전 McKinsey & Company 시니어 데이터 사이언티스트
익숙한가요?
이러한 불만이 이 가이드를 쓰게 만들었습니다
Claude가 CLAUDE.md를 무시함
사용자 지정 지시가 무시되거나 대화 중간에 잊혀짐
모든 것을 과잉 설계함
간단한 함수를 요청하면 500줄의 추상화가 돌아옴
매번 다른 결과
같은 프롬프트, 매우 다른 출력 품질
완료라고 하지만 망가져 있음
자신있게 실제로 작동하지 않는 코드를 제공함
이 가이드 뒤의 경험
이 문제들을 읽기만 한 게 아니라, 직접 겪었습니다.
27억 토큰의 경험을 51개의 실용적인 팁으로 압축했습니다.
효과의 증거
저는 Kumamap — 일본 1위 곰 출몰 추적기 — 를 전적으로 Claude Code로 만들었습니다. 이 가이드는 제가 사용한 정확한 패턴을 가르쳐 드립니다.
구성 내용
13개 섹션에 걸친 51가지 팁
설정
터미널, CLAUDE.md, 단축키 및 명령어
3 팁
설정
터미널, CLAUDE.md, 단축키 및 명령어
안전
Git, 권한, 민감한 파일 보호
4 팁
안전
Git, 권한, 민감한 파일 보호
계획
플랜 모드, 상세 계획, 엔드투엔드 사고
4 팁
계획
플랜 모드, 상세 계획, 엔드투엔드 사고
프롬프팅
Ultrathink, 직접적으로 말하기, 중요성 강조
6 팁
프롬프팅
Ultrathink, 직접적으로 말하기, 중요성 강조
Ultrathink 항상 켜기
Claude가 처음 떠오른 것을 말하게 두지 마세요. 생각하게 하세요. 항상.
직접적으로 말하기
수량에 대해 명시적으로 말하세요. Claude는 쉬운 길을 선택하는 경향이 있습니다.
하지 말아야 할 것이 아닌 해야 할 것 말하기
Claude에게 하지 말아야 할 것을 말할 때 항상 대안을 제시하세요.
중요성 과장하기
Claude는 인식된 중요성에 따라 노력을 조정합니다. 높은 중요성 = 철저한 작업.
Claude를 사람이 아닌 도구로 취급하기
예의를 걱정하지 마세요. 직접적일 때 Claude가 더 잘 동작합니다.
Claude는 어시스턴트 작업에 뛰어남 - 전략적 작업은 안내하기
전략적 작업을 어시스턴트형 작업으로 변환해 Claude가 먼저 조사하게 안내하세요.
세션
컨텍스트 관리, 재개, 품질 저하
4 팁
세션
컨텍스트 관리, 재개, 품질 저하
입력
이미지, 스크린샷, 오류 메시지
2 팁
입력
이미지, 스크린샷, 오류 메시지
멀티 에이전트
병렬 에이전트, 워크트리, 서브에이전트
5 팁
멀티 에이전트
병렬 에이전트, 워크트리, 서브에이전트
첫 번째에 완벽을 기대하지 마세요
한 에이전트가 코드를 작성하게 하고, 다른 에이전트로 코드를 확인하세요.
큰 작업에는 여러 에이전트
같은 프롬프트로 여러 에이전트를 실행하세요. 큰 작업에서 한 에이전트가 제대로 하는 경우는 드뭅니다.
복잡한 문제를 단계로 분해하기
하나의 거대한 세션보다 하위 작업당 하나의 세션이 낫습니다.
Git Worktrees
같은 저장소에서 여러 작업 디렉토리. 각각에서 Claude를 실행하세요.
서브에이전트 - 주의해서 사용
서브에이전트 요약은 세부사항을 잃습니다. 중요한 코드는 메인 에이전트가 직접 파일을 읽게 하세요.
커스터마이징
계층적 설정, 명령어, 커스텀 에이전트
3 팁
커스터마이징
계층적 설정, 명령어, 커스텀 에이전트
함정
주의해야 할 일반적인 Claude 동작
8 팁
함정
주의해야 할 일반적인 Claude 동작
Claude는 URL을 만들어냅니다
존재하지 않는 URL을 환각합니다. 외부 링크를 신뢰하기 전에 항상 확인하세요.
Claude는 과잉 설계합니다
간단한 함수를 요청하면 팩토리 패턴이 있는 추상 클래스를 받습니다.
Claude는 중복을 만듭니다
Claude는 코드베이스를 검색하지 않습니다. 그냥 새 코드를 작성합니다.
Claude는 추가만 하고 제거하지 않습니다
Claude는 코드를 추가만 합니다. 절대 제거하지 않습니다. 명시적으로 삭제를 강제해야 합니다.
Claude는 예스맨입니다
Claude는 당신이 말하는 모든 것에 동의합니다. 가정에 이의를 제기하라고 말하세요.
Claude는 묻지 않고 가정합니다
모호한 요구사항? Claude는 해석을 선택하고 그대로 진행합니다.
Claude는 파일을 부분적으로만 읽습니다
Claude는 첫 번째 청크를 읽고 작업을 시작합니다. 400번 줄의 중요한 함수? 놓칩니다.
Claude는 코드 대신 테스트를 수정합니다
코드가 잘못되면 Claude는 나쁜 코드에 맞게 테스트 단언을 변경합니다.
고급
훅, MCP 서버, 스킬, 헤드리스 모드
5 팁
고급
훅, MCP 서버, 스킬, 헤드리스 모드
사용 사례
품질 검사, POC, 학습, 커밋
5 팁
사용 사례
품질 검사, POC, 학습, 커밋
정기적으로 코드베이스 품질 검사 실행
각 쿼리 = 1 세션. 하드코딩된 텍스트, 디자인 일관성 등을 확인하세요.
POC에 Claude Code 활용하기
빠른 프로토타이핑에 완벽합니다. POC에서는 Claude에게 맡기세요.
Claude는 보일러플레이트에 뛰어납니다
CRUD 작업, 폼, 설정 파일, 반복 패턴. Claude에게 맡기세요.
Claude로 배우기
Claude가 코드만 작성하게 두지 마세요. 설명하게 하세요.
커밋 메시지에 Claude 사용
Claude가 diff로부터 커밋을 작성하게 하세요. 일관된 형식, '왜'를 포착합니다.
마무리
자신만의 워크플로우 찾기에 대한 최종 조언
1 팁
마무리
자신만의 워크플로우 찾기에 대한 최종 조언
보너스
6개월 일일 사용에서 검증된 CLAUDE.md
1 팁
보너스
6개월 일일 사용에서 검증된 CLAUDE.md
Featured Tips
Start with these popular tips
