Hooks

유출된 Claude Code 소스코드 51만 줄에서 발견한 9가지 비밀

AI
누군가 유출된 Claude Code 소스코드 51만 줄을 읽었습니다. 본인 말로는 “내가 읽었다기보다 Claude Code한테 읽혔다"고. 그렇게 해서 나온 결론은 하나입니다. “대부분의 사람이 Claude Code를 ‘프롬프트 치고, 기다리고, 다시 치는’ 방식으로 쓰고 있는데, 소스코드를 보면 이건 페라리를 1단 기어로만 모는 거다.” 조회 3.1만 회를 기록한 이 Threads 스레드(@unclejobs.ai)에서 정리한 9가지를 상세히 분석합니다. 더보기

주말 만에 Claude Code 마스터하기: claude-howto 완전 분석

AI
Claude Code를 설치하고 몇 가지 프롬프트를 실행했습니다. 이제 뭘 해야 할까요? 공식 문서는 기능을 설명하지만, 기능들을 어떻게 조합하는지는 알려주지 않습니다. 학습 경로도 없고, 예시는 너무 기초적입니다. GitHub 스타 5,900개를 돌파한 claude-howto는 이 공백을 메우는 구조적인 가이드입니다. 더보기

Claude Code Hooks 실전 가이드: 결정론적 자동화의 모든 것

Engineering
Claude Code에서 “파일 편집 후 항상 Prettier를 실행해 줘"라고 프롬프트하면 어떻게 될까요? 가끔은 작동하지만, Claude가 잊거나 속도를 우선시하거나 변경이 “너무 작다"고 판단하면 건너뜁니다. Hooks 는 이 문제를 근본적으로 해결합니다. 모델의 동작과 관계없이 특정 시점에 셸 명령을 반드시 실행하는 결정론적 자동화 시스템입니다. 이 글은 Blake Crosley의 Claude Code CLI: The Definitive Technical Reference를 핵심 참고 자료로 활용하여, Hooks 시스템의 전체 구조와 실전 활용법을 정리합니다. 더보기

Claude Code 프로젝트 구조 가이드: CLAUDE.md, hooks, skills, docs, tools, src를 어떻게 나눌까

AI
Claude Code를 조금만 깊게 써 보면 금방 부딪히는 문제가 있습니다. 규칙은 CLAUDE.md에 몰아넣고, 자동화는 훅에 넣고, 반복 작업은 스킬로 빼야 한다는 말은 알겠는데, 실제로 레포를 어떻게 나눠야 할지 애매합니다. 특히 프로젝트가 커질수록 “무엇을 항상 읽게 할지”, “무엇을 필요할 때만 불러올지”, “무엇을 문서로 남길지"가 섞이기 시작합니다. 이번 글은 temp/claude-structor.md의 간단한 구조 예시를 출발점으로, 실제로 운영 가능한 Claude Code 프로젝트 디렉터리 구조로 확장한 버전입니다. 단순히 폴더 이름만 나열하지 않고, 각 폴더가 왜 필요한지, 어떤 파일을 넣어야 하는지, 그리고 바로 가져다 쓸 수 있는 샘플 예제까지 같이 정리합니다. 더보기

Claude Code 에이전트 팀 비용 50% 줄이는 4가지 비법 정리

Productivity
Claude Code의 에이전트 팀은 분명 강력하지만, 아무 생각 없이 팀원 수를 늘리고 바로 구현에 들어가면 토큰이 빠르게 소모됩니다. 이 영상의 핵심은 단순합니다. 에이전트 팀이 비싼 이유를 구조적으로 이해하고, 그에 맞는 운영 규칙을 프롬프트와 워크플로에 먼저 심어야 한다 는 것입니다. 영상은 특히 네 가지를 강조합니다. 첫째, 팀원과 서브에이전트는 태어나는 방식이 다르며, 둘째, 구현 전에 계획 승인을 강제해야 낭비를 막을 수 있고, 셋째, 리드와 팀원의 모델을 섞어 써야 비용이 내려가며, 넷째, 훅을 이용해 완료 시점의 품질 게이트를 자동화해야 한다는 점입니다. 이 네 가지를 이해하면 “팀을 쓸수록 더 비싸고 더 불안정해진다”는 감각을 꽤 많이 줄일 수 있습니다. 근거 영상 더보기

Claude Code Hooks 완전 정복: 이벤트/결정 제어/비동기까지 한 번에 이해하기

AI
Claude Code의 hooks는 “언젠가 LLM이 알아서 하겠지”가 아니라, 특정 시점에 특정 검사를 반드시 실행하도록 만드는 장치입니다. 이 글은 공식 문서의 참조 스키마를 기준으로, 어떤 이벤트가 있고(언제 발화하고), matcher가 무엇을 필터링하며, 훅이 어떤 방식으로 Claude Code의 동작을 허용/차단/계속 작업 유도 할 수 있는지까지 한 번에 정리합니다. 핵심은 2가지입니다. 훅은 명령(Exit code) 과 구조화된 JSON 출력 두 축으로 동작을 제어합니다. “차단 가능 여부”는 이벤트마다 다릅니다. PreToolUse는 실행 전이라 차단이 되지만 PostToolUse는 실행 후라 차단이 아닌 피드백 으로 작동합니다. 더보기

Claude Code 기본 설정의 10% 함정: CLAUDE.md, 에이전트 팀, 보안 훅, Forge로 작업 시스템 만드는 법

AI
Claude Code를 설치하고 바로 쓰면 빠르게 결과가 나오지만, 팀 규칙 부재·검증 자동화 부재·역할 분리 부재 때문에 곧 한계에 부딪힙니다. 이 글은 Threads 연속 포스트(원글 + 1~5번 설명)를 근거로, “기본 설정 10%“라는 표현이 실제로 어떤 작업 병목을 뜻하는지 구조적으로 해석한 문서입니다. 문서 확인 시점은 2026-03-02 입니다. 더보기