Claude Code를 더 효과적으로 다루기 위한 스킬, 자체 설정, 지식 베이스 활용 팁을 정리한다.
Claude Code 길들이기.
2026-01-27 게시 :: 태그: llm, claude-code
최근 동료와 친구들을 대상으로 Claude Code 마스터클래스를 진행했는데, 거기서 보여준 팁 몇 가지를 공유하는 게 좋겠다고 느꼈다.
WARNING
⚠️ 대상 독자: 시니어 개발자. 코딩 에이전트는 초보자에게 적합한 도구가 아니다.
"컴퓨터는 지시를 따르는 데는 능하지만, 당신의 마음을 읽는 데는 능하지 않다." © Donald Knuth
많은 연사들이 코딩 에이전트와 일하려면 매니저가 되어야 한다고 말한다. 이 말은 많은 프로그래머를 겁먹게 한다. 다행히도 좋은 소식이 있다. 그건 거짓말이다! 그런 접근은 거친 프로토타입 하나가 필요할 때는 통할지 몰라도, 계속 밀고 나가면 아마 처참하게 실패할 것이다. 훨씬 나은 전략은 시스템 분석가 또는 소프트웨어 아키텍트 역할을 맡는 것이다. 코딩 에이전트는 좋은 해법을 고를 전문성이 없다. 에이전트는 자신이 가진 맥락에서 가장 흔한 해법을 고른다. 그리고 우리의 목표는 다음과 같다:
각 작업마다 이런 일을 상호작용적으로 수행하는 것은 극도로 피곤하므로, 가능한 한 많이 재사용하는 것이 좋다. 그리고 Claude Code에는 이런 재사용을 위한 매우 좋은 도구가 몇 가지 있다.
프로젝트에서 강제하려는 모든 관행(practice)을 떠올려 보라. 아마 그것마다 Skill을 만들어야 할 것이다. Skill은 에이전트적(Agentic) 분신에게 지식을 전이하는 매우 효율적인 접근이다. Skill은 마크다운 문서 하나와 추가 파일들로 구성되며, 추가 파일에는 추가 문서뿐 아니라 특정 작업을 위한 미리 만들어진 도구도 포함될 수 있다. 메인 마크다운 파일에는 짧은 설명 텍스트가 있는데, 이 텍스트는 언제나 컨텍스트에 포함된다. 에이전트는 현재 목표를 이 설명과 대조하도록 지시받으며, 일치하는 경우 더 깊게 파고든다. 한 스킬에는 VCS/브랜칭 선호를 인코딩할 수 있고(내 로컬 스킬 하나는 jj를 사용하는 개인 규칙을 담고 있다), 다른 스킬에는 코드 코멘트를 쓰는 방식에 대한 접근을 담을 수 있다. 내 툴셋에는 파이썬 도구를 내가 원하는 방식으로 만드는 법(Claude는 임시 파이썬 도구를 정말 많이 작성한다!)과 Dioxus 앱에서 반응성(reactivity)을 구현하는 방식에 대한 스킬이 있다. 나는 이런 스킬을 수십 개 갖고 있고, 계속 추가하고 있다.
그리고 일부 스킬은 공유할 만하지만, 대부분은 개인의 취향과 선호에 의존하며 다른 사람에게는 별 의미가 없을 것이다. 그건 좋은 일이다. 스킬의 큐레이션 목록이나 마켓플레이스를 급하게 찾으려 하지 말라. 직접 만들어라.
그리고 내가 “직접 만들어라”라고 말할 때, 말 그대로 손으로 일일이 쓰라는 뜻은 아니다. 메타 레벨로 올라가서 Claude Code에게 그것을 대신 시켜라.
최근 Claude Code의 스킬 작성 문서를 살펴보고 …에 대한 스킬을 만들어줘. 내가 어떻게 동작하길 원하는지 질문해줘.
“질문해줘”는 매우 중요한 부분이다. Claude가 당신 대신 결정을 내리게 하고 싶지 않다. 당신에게서 세부사항을 끌어내길 원하는 것이다. 미리 무엇을 물어봐야 하는지 알고 있다면 한 번에 써도 되지만, 종종 올바른 표현을 바로 떠올리기 어려울 때가 있다. 괜찮다. Claude는 훌륭한 인터뷰어다. 그리고 여러 번에 걸쳐 질문을 반복하면서 세부 수준을 점진적으로 높일 수 있다. 어떤 극단적인 경우에는, 상세한 인터뷰를 위한 계획부터 세우는 방식으로 과정을 시작하라고 제안하기도 한다. Claude에게 약간의 리서치를 시키고, 질문 20개와 답을 적을 자리를 지정한 파일을 준비하게 하라. 노력이 들겠지만, 결과는 그만한 가치가 있을 것이다.
같은 방식이 일반 지시에도 적용된다:
전역 CLAUDE.md에 /a, /b, /c 스킬을 언급해줘. 에이전트들이 아주 눈에 잘 띄게 보고 싶어.
흥미로운 것들에 대해 메모를 남기는 방법을 모두가 하나쯤은 찾아야 한다고 제안한다. 단순한 텍스트/마크다운 파일 모음일 수도 있고, 유용하다고 생각한 글을 자동으로 요약해주는 파이프라인 같은 복잡한 시스템일 수도 있다. 중요한 것은 에이전트들에게 그 안에서 정보를 찾는 방법을 가르치는 것이다(맞다. 이것도 내가 만들길 제안하는 또 하나의 스킬이다). 웹 검색 기능에 의존하지 않고 로컬에 있는 무언가를 참조할 수 있다는 건 매우 유용하다:
지난주에 내가 읽었던 Martin Fowler의 그 글에서 제시한 접근을 적용해줘
정보를 모으는 습관이 드디어 보상받는 순간 🤪
anticipation
p.s. 아마 내가 프로젝트 레벨의 CLAUDE.md 파일에 대해 아무 말도 하지 않았다는 걸 눈치챘을 것이다 — 의도한 것이다. 나는 그것들이 사람들이 생각하는 것보다 덜 유용하다고 느낀다. 아마 이것만 따로 글을 써야 할 것 같다.
다시 नियमित적으로 블로깅을 하고 싶다. 내 글이 흥미롭고 유용하다고 느꼈다면 커피 한 잔 사주기를 고려해 달라. 고맙다! 더 자주 글을 쓰는 데 우선순위를 두는 데 큰 도움이 될 것이다.
