클로드 코드 비주얼: 훅, 서브에이전트, MCP, 그리고 CLAUDE.md에 관한 실용적 노트
Claude Code Visual 사용자 경험 노트
r/ClaudeAI의 한 개발자가 Claude Code Visual을 몇 달간 실무에서 사용한 경험을 공유하며, 구체적인 기능과 구현상의 어려움을 강조했습니다.
출처의 주요 세부사항
해당 개발자는 다음과 같은 관찰 사항을 기록했습니다:
- MCP 훅: 훅 구문을 기억하기 어려워 문서를 참조해야 했습니다. 특히 PreToolUse와 PostToolUse 훅의 구분이 문서에서 명확하지 않아, 약 반나절이 소요되는 설정 오류가 발생했습니다.
- CLAUDE.md: 이 파일은 프로젝트 컨텍스트를 유지하는 데 예상보다 유용했습니다. 일단 구현되면, 각 세션마다 폴더 구조와 기술 스택을 반복해서 설명할 필요가 없어졌습니다. 개발자는 더 일찍 설정했어야 했다고 언급했습니다.
- 서브에이전트: 개발자는 서브에이전트 기능을 충분히 활용하지 못하고 있다고 느낍니다. 연구 → 계획 → 실행 → 검토 패턴을 사용하지만, 작업을 서브에이전트에 위임할 시기와 메인 에이전트가 직접 처리할 시기를 완전히 결정하지 못했습니다.
- /loop 명령어: 이 명령어는 최대 3일 앞서 반복 작업을 예약할 수 있게 합니다. 개발자는 우연히 발견했으며, 모든 사용자에게 명확하지 않을 수 있다고 지적했습니다.
해당 개발자는 시각적 참고 자료(출처에 링크됨)를 만들었으며, 정보를 최신 상태로 유지하기 위해 수정사항이나 업데이트를 요청했습니다.
📖 전체 출처 읽기: r/ClaudeAI
👀 See Also
클로드 에이전트를 위한 거버넌스 계층: 프로덕션 환경에서의 엄격한 안전 경계와 실시간 추적
한 Claude API 사용자가 에이전트 아래에 가벼운 거버넌스 레이어를 구축하여 하드 안전 경계, 실시간 추적, Telegram을 통한 인간 개입 제어, 자동 체크포인팅을 추가하고, 장기 실행 에이전트 루프에서 발생하는 무음 실패와 폭주하는 토큰 비용 문제를 해결했습니다.
클로드 코드 에이전트는 프로젝트 문서를 자동으로 읽지 않습니다.
Claude Code가 Sonnet과 같은 하위 에이전트를 파견하여 코드를 작성할 때, 해당 에이전트들은 명시적으로 프롬프트에 포함된 내용만 볼 수 있으며, 특별히 지시하지 않는 한 CLAUDE.md, MEMORY.md 또는 기타 프로젝트 컨텍스트 파일을 자동으로 읽지 않습니다.
CLAUDE.md 항목: 오푸스 4.7의 인간적 속도 조절 동작 비활성화
긴 코딩 세션 중 Claude 4.7 Opus의 휴식 제안, 시간 과대 추정, 단계 분할을 억제하는 세 가지 CLAUDE.md 지시문.
OpenClaw API 예산 소진: 즉시 변경해야 할 설정
OpenClaw의 기본 하트비트 기능은 30분마다 작업을 확인하고 매번 전체 컨텍스트 파일, 메모리, 채팅 기록을 로드함으로써 API 예산을 소진시킬 수 있습니다. 출처에서는 작업 시간 변경, 더 저렴한 기본 모델 사용, 필요할 때만 프리미엄 모델로 수동 전환, 그리고 /new 명령어로 세션을 초기화할 것을 권장합니다.