6개월간 매일 사용해 본 Claude Code 치트 시트
핵심 요약
Claude Code를 효율적으로 활용하기 위한 실무 팁과 설정 노하우를 공유함.
- 반복 작업 자동화 — 반복되는 워크플로우를 '스킬'로 정의하여 Claude가 스스로 실행하도록 유도함.
- 파일 참조 최적화 — @ 기호를 사용하여 파일을 직접 지정함으로써 Claude의 컨텍스트 로딩 속도를 높임.
- 설정 파일 관리 — CLAUDE.md를 200줄 이하로 유지하고 AGENTS.md를 활용해 설정을 모듈화함.
- 보안 점검 수행 — /security 명령어를 주기적으로 실행하여 코드의 취약점을 상시 점검함.
지난주에 제 Claude Code 워크플로우와 몇 가지 관련 팁에 대한 글을 공유했는데, 솔직히 이렇게 긍정적인 반응이 올 줄은 몰랐습니다! 댓글로 각자의 팁을 공유해 주신 모든 분께 감사드립니다. 덕분에 저도 읽으면서 꽤 많이 배웠습니다.
사람들이 유용하다고 생각하는 것 같아서, 몇 가지 모범 사례를 더 공유해 보려고 합니다. 자, 시작합니다:
- 반복적인 워크플로우를 위한 스킬 생성. 같은 지시를 반복하고 있다면, 저는 그것을 스킬로 만듭니다. 핵심 비결은 스킬에 대한 정확한 설명을 작성하는 것입니다. 그렇게 하면 Claude는 제가 묻지도 않아도 스스로 스킬을 실행하는 법을 결국 배우게 됩니다.
- 프롬프트에서 파일을 직접 가리키려면
@를 사용하세요. Claude가 여기저기 검색하게 만드는 대신,@/path/to/file.ts와 같이 입력하면 Claude가 참조된 파일을 컨텍스트로 직접 로드합니다. 그렇지 않으면 Claude는 파일을 찾아서 청크 단위로 읽어야 하는데, 이는 훨씬 느립니다. - 셸 명령어를 실행하려면
!를 사용하세요. 테스트를 시작하거나 타입 체크를 해야 할 때, Claude에게 시키는 것보다 CLI 명령어를 직접 입력하는 것이 더 빠릅니다. CLAUDE.md를 짧게 유지하세요. 저는 개인적으로 항상 200줄 이하를 목표로 합니다. 이 200줄 정도의 내용에는 비즈니스 컨텍스트나 도메인 지식(예: 데이터 모델, 명명 규칙, 내부 규칙 등)과 같이 Claude가 스스로 알 수 없는 정보만 포함되어야 합니다. 나머지는 모두 노이즈입니다.AGENTS.md파일을 만드세요.AGENTS.md는 모든 코딩 도구의 새로운 표준이므로, 저는 핵심 로직을 거기에 넣습니다(그래야 에이전트 간에 이식 가능하니까요). 이렇게 하면@/AGENTS.md로 간단히 가져오는 짧은CLAUDE.md를 유지할 수 있습니다./security명령어를 실행하세요: 이 명령어는 보안 검토를 수행하며 가끔씩 실행해야 합니다. 하지만 모든 취약점을 잡아낼 것이라고 기대하지는 마세요(코드의 보안을 보장하는 것은 여전히 여러분의 몫입니다 lol).
지난 게시물에 보내주신 모든 사랑에 다시 한번 감사드립니다!


