연결 중…
연결 중…
전체 보기
ordinary subinium
Telegram · @web3subin

<Claude Code 처음에 이해하기 어려운 기능>

게시
2026.01.25 16:51
조회
3,259
포워드
180
  • CLAUDE.md
  • skill
  • hook
  • sub-agents

참고로 개념만 알면, 생성은 Claude Code한테 이런 거 만들려한다면 다 만들어줌. 어떤 게 적재적소인지 아는 게 중요.

<1> CLAUDE.md

Claude Code가 매 세션 시작 시 자동으로 읽어서 프로젝트 맥락을 이해하는 파일. "세션 시작"에 불러온다는 게 핵심.

매번 새로운 대화를 시작하면 "이 프로젝트가 뭔지, 어떤 컨벤션(포맷)을 따르는지, 테스트는 어떻게 돌리는지"를 처음부터 설명해야 하는데, 이걸 시작 때 미리 주입해주는 것.

컴퓨터 가장 상위 폴더에서 매번 인식시켜줄 수도 있고, 아니면 프로젝트 폴더 메인에 위치시켜 프로젝트 별로 설정도 가능

<2> Skill

특정 작업을 위한 작업 지침서. 특정 작업 마다 재사용을 위한 프롬프트 엔지니어링이라고 보면 됨.

CLAUDE.md는 전체적인 프로젝트에 대한 이해도를 주입하거나 반드시 해야하는 필수 룰을 기록하는데 좋다면, Skill은 작업마다 세분화할 수 있음.

그래서 작업할 때 명시적으로 불러서 사용할 수도 있고, 또는 알아서 당신의 프롬프트에서 필요한 스킬을 불러오기도 함.

근데 그냥 프롬프트 아니야? 라고 하지만 도메인 지식 기반 잘깎아둔 프롬프트 하나가 얼마나 유용한지 대부분 알 것임. 잘 만들어둔 스킬 레포들은 찾아서 세팅하는 것이 본인의 개발 실력을 멀티플 시켜줄 수 있는 것.

지금 그래서 개발 인프라 팀들이 팀별로 본인 스킬 공유하고 있음.

<3> Hook

특정 이벤트가 발생할 때 자동으로 실행되는 스크립트. 이건 범위가 모든 것에 달려있음. 세션 시작/끝. 특정 도구 시작 / 끝 등 여러 범위에서 넣어둘 수 있음.

그래서 특정 파일 읽을 때마다 안전 검토할 수도 있고, 스킬 쓰고 꼭 그 다음에는 어떤 작업을 자동화해둘 수도 있고, 결국 특정 동작에서 앞뒤로 붙여놓는 것.

이걸 완전 이해하고 싶다면 Tool의 종류도 공부해보면 좋음 (읽기, 쓰기, Bash 실행 등등)

참고로 전에 만들어서 공유한 Claude Code Achievements는 이걸 바탕으로 특정 동작 여부를 체크해서 기능 해금하는 느낌으로 만들어둔 것.

<4> Sub-agents

이건 별도의 에이전트 돌리는 작업임. 당연히 생산성 측면에서도 도움이 되겠지만 또 좋은 것은 컨텍스트의 효과적 활용임.

이게 서브에이전트는 메인컨텍스트와 별도로 컨텍스트를 사용함. 그래서 컴팩팅 이슈에서 불필요한 읽기용 컨텍스트 등을 좀 생략할 수 있음.

여기서 팁은 서브에이전트 끼리 중첩안하도록 권한 세팅하기, 성능을 위해 default로 4.5 opus로 세팅하기 등이 있음

본인은 아직 기능 개발은 그래도 읽으면서 하려는 편이라 보통 i18n 동시 번역 및 검수 작업, 큰 파일 읽기 작업 등에 사용하는 편.

https://x.com/subinium/status/2015339657995993272

조회3,259포워드180텔레그램에서 보기