lucas (@lucas_flatwhite)

2026-01-19 | ❤️ 513 | 🔁 173


🚀 Claude Code 워크플로우 최적화 가이드

아티클을 쓰신 분이 작년에 해커톤에서 우승한 경험을 바탕으로 Claude Code 대한 여러 설명, 설정, 팁을 공유해주셨네요.

📦 이 모든게 포함된 GitHub 저장소 https://github.com/affaan-m/everything-claude-code

저자가 10개월간 매일 사용한 완전한 설정을 공유하고, 여기에는 Skills, Hook, Subagent, MCP, Plugin, 실용적인 조언.. 이런 다양한 내용이 포함됩니다.

효율적인 워크플로우를 위해 참고해보세요. 정말 훌륭합니다! 저도 몇개만 뽑아봐요.

역시나 먼저 Skills, Commands 📝

이분은 코딩 표준, 백엔드/프론트엔드 패턴, 프로젝트 가이드라인, TDD, 보안 검토 같은 스킬들을 정의하고 있네요.

그리고 커맨드를 활용하고 있다는겁니다. 이건 워크플로우의 빠른 실행을 위한 슬래시 커맨드이구요 단축 프롬프트 역할을 한다고 생각하면 됩니다.

  • /tdd: 테스트 주도 개발 시작
  • /plan: 기능 구현 계획 처리
  • /e2e: 엔드투엔드 테스트 생성
  • /code-review: 품질 및 유지보수성 검토 수행
  • /build-fix: 빌드 오류 해결
  • /refactor-clean: 데드 코드 제거
  • /test-coverage: 테스트 커버리지 분석
  • /update-codemaps: 코드 문서 새로고침
  • /update-docs: 문서 동기화

에이전트를 구성한거~ 서브에이전트는 오케스트레이터가 제한된 범위로 작업을 위임할 수 있는 프로세스예요. 메인 컨텍스트 부하를 줄여줍니다.

  • Planner: 기능 구현 계획
  • Architect: 시스템 설계 결정
  • TDD-Guide: 테스트 주도 개발
  • Code-Reviewer: 품질 및 보안 검토
  • Security-Reviewer: 취약점 분석
  • Build-Error-Resolver: 빌드 문제 수정
  • E2E-Runner: Playwright E2E 테스트
  • Refactor-Cleaner: 데드 코드 정리
  • Doc-Updater: 문서 동기화

저도 그렇고 요즘 많이 서브에이전트 구성해서 쓰죠.

여기서 팁은 규칙을 통해 에이전트에 위임시키고, 비용 최적화를 위해 에이전트별로 다른 모델 사용해야 하는거죠. (간단한 작업 Haiku/Sonnet, 복잡한 작업 Opus 4.5)

서브에이전트는 스킬과 잘 작동합니다. 스킬의 하위 집합을 실행할 수 있는 서브에이전트는 작업을 위임받아 해당 스킬을 자율적으로 사용할 수 있죠. 특정 도구 권한으로 샌드박스화할 수도 있습니다.

Hooks.. 도구 사용과 같은 이벤트에서 발생하는 트리거 기반 자동화할 수 있어요.

스킬과 다르게 도구 호출, 라이프사이클 이벤트로 제한됩니다.

훅 타입도 참고해보세요.

  1. PreToolUse - 도구 실행 전(검증, 리마인더)
  2. PostToolUse - 도구 완료 후(포매팅, 피드백 루프)
  3. UserPromptSubmit - 메시지 전송 시
  4. Stop - Claude 응답 완료 시
  5. PreCompact - 컨텍스트 압축 전
  6. Notification - 권한 요청

이런걸로 자동으로 포맷팅하거나, 장시간 실행 커맨드 전 tmux 리마인더 같은걸 구성할 수도 있죠.

이 외에도 여러 팁과 트릭들이 있으니 한번 아티클과 GitHub repo. 살펴보면 큰 도움 되실거예요!

마지막으로 이 얘기로..

  1. 과도하게 복잡하게 만들지 마세요 - 설정을 아키텍처가 아닌 미세 조정처럼

  2. 컨텍스트 윈도우는 소중합니다 - 미사용 MCP와 플러그인 비활성화

  3. 병렬 실행을 고려해보세요 - 대화 분기, git 워크트리 사용

  4. 반복적인 것을 자동화하세요 - 포매팅, 린팅, 리마인더를 위한 훅

  5. 서브에이전트 범위를 지정하세요 - 제한된 도구 = 집중된 실행

참고로 이러한 접근은 Claude Code 에만 국한되지 않아요! 😉

🔗 원본 링크

미디어

image

image

image


인용 트윗

cogsec (@affaanmustafa)

https://t.co/NscRA7sqBt

원본 트윗

Tags

AI-ML LLM Dev-Tools