조대협의 블로그

조대협 (http://bcho.tistory.com)왜 SubAgent가 필요한가? Claude Code로 복잡한 작업을 하다 보면 한 가지 문제를 마주치게 된다. 코드베이스를 탐색하고, 분석하고, 수정하고, 테스트까지 하다 보면 context window가 빠르게 소모된다는 것이다. 그리고 한 AI가 "코드 리뷰어"이면서 동시에 "디버거"이고 "문서 작성자"가 되려다 보면 어느 것도 제대로 못하는 상황이 생긴다. 그렇다면 어떻게 하면 좋을까? 인간 세계에서는 이 문제를 이미 해결했다. 바로 전문화이다. 코드 리뷰는 시니어 개발자가, 테스트는 QA 엔지니어가, 배포는 DevOps가 맡는 것처럼 말이다. SubAgent는 바로 이 개념을 Claude Code에 도입한 것이라고 보면 된다. 마치 Java에서..

Claude Code-Hook의 개념조대협(http://bcho.tistory.com) Hook은 Claude Code의 실행중에, 특정 이벤트가 발생하였을때 사용자가 정해 지정해놓은 Shell Command나, HTTP 요청 또는 프롬프트를 실행할 수 있는 기능이다. 예를 들어, Claude Code를 통해서 파일을 에디트 했을때 자동으로, 포맷팅을 검사하도록 지시할 수 있다. 물론 프롬프트를 통해서 지시할 수 도 있지만, 프롬프트는 가이드일뿐 Claude 모델이 지킬 수 도, 안 지킬 수 도 있다. 그래서 조금 더 명시적으로 어떤 이벤트가 발생했을때 사용자가 특정 명령을 수정하도록 강제할 수 있다. 클로드코드의 라이프 사이클Claude Code의 Life cycle와, 각각 툴을 걸 수 있는 포인트..

Claude Code 쉽게 따라하기 (기본편)- 2. 요금제 이해하기조대협 (http://bcho.tistory.com) Claude Code 요금제는 크게, Pro, Max 5x, Max 20X 가 있다.구분Claude ProClaude Max 5xClaude Max 20x월 요금 (USD)$20$100$2005시간 세션 한도약 4.5만 토큰(메시지 약 45개)약 22.5만 토큰(메시지 약 225개)약 90만 토큰(메시지 약 900개)주간 누적 한도 (Sonnet 기준)약 500만 토큰( 40~80시간)약 4,200만 토큰(140~280시간)약 8,300만 토큰(240~480시간)Opus 모델 주간 한도매우 낮음 (수 시간)약 15~35시간약 24~40시간추가 사용 불가능 (리셋 대기)가능 (API ..

Claude Code 쉽게 따라하기 (기본편)- 1. Project 설정, CLAUD.md 이해하기조대협 (http://bcho.tistory.com)Project Setup첫번째로 해야 하는 일은, 기존의 프로젝트가 있는 (또는 작업할) 디렉토리에서 claude code 의 /init 명령을 수행하는 것이다. Claude code를 실행한다음 다음과 같이 “/init”명령을 실행한다Init 작업은 현재 디렉토리의 내용을 스캔해서 내용을 요약해서 CLAUDE.md 파일을 생성한다. CLAUDE.MD 파일이란?CLAUDE.MD는 매우매우 중요한 파일인데, 이 파일은 *.md 파일 포맷으로 안에 들어가 있는 내용은 Claude Code가 어떻게 동작할지를 가이드 하는것이다. 예를 들어서, 아키텍처나, 코딩 ..

조대협 (http://bcho.tistory.com) 작년이 Cursor, Winsurf등 AI 코딩 도구와 Lovable, Replit 등의 바이브 코딩으로 시작되는 한해였다면, 금년은 Claude Code와 같은 CLI 기반의 에이전트 코딩으로 넘어가는 한해이다. 2026년 트랜드 변화2025년에는 개발자들이 전체 코드가 아니라 일부 모듈이나 코딩 부분을 Cursor 와 같은 IDE에서 개발하는 정도로, AI의 도움을 받아서 개발하는 단계 였다면, 금년은 Claude Code와 같은 에이전트 기반의 AI로 스펙만 작성하면 크고 복잡한 코드도 개발이 가능한 방향으로 변화하고 있다. 2026년 2월5일에 발표된 글을 보면, Anthropic Claude Code 모델을 사용하여, C 컴파일러를 개발한 ..

참고한 원본 글 : https://www.anthropic.com/engineering/claude-code-best-practices Anthropic이 공개한 Claude Code는 단순한 코드 자동 완성 도구를 넘어, 개발자의 쉘 환경과 파일 시스템에 직접 접근하여 자율적으로 작업을 수행하는 '에이전트형(Agentic)' 개발 도구다. 하지만 이 강력한 자율성은 명확한 가이드라인 없이는 오히려 예측 불가능한 결과를 낳을 수 있다.이 글에서는 Anthropic이 공식적으로 밝힌 엔지니어링 블로그의 내용을 기반으로, Claude Code의 잠재력을 100% 끌어내기 위한 핵심적인 베스트 프랙티스를 항목별로 심층 분석하고, 실제 적용 가능한 예제와 함께 제시하고자 한다.1. 초기 설정 최적화 (Custo..