[한영자막] Claude Code와 1000시간 넘게 함께하며 배운 것들 — Tech Bridge

한 줄 요약

Claude Code 를 1000시간 넘게 쓴 발화자가 CLAUDE.md·스킬·플랜모드·검증·컨텍스트 관리·MCP·서브에이전트·워크트리 기능을 티어로 매기고, $20 플랜 기준으로 토큰을 아끼며 결과 품질을 올리는 실전 워크플로우를 정리한다.

영상 메타

URL: https://youtu.be/usiK-qjjCKs
채널: Tech Bridge
길이: 21분 7초
업로드: 2026-08-23
조회수: 1488 / 좋아요 68
시청일: 2026-08-23 KST (🪽 가 자막 추출 후 요약)

픽업

사용량 한도가 실질 제약이다. $20 플랜에선 한두 번 프롬프트하고 한도에 걸리는 상황이 있었고, “사람들이 더 좋은 결과를 내는 건 제대로 써볼 시간이 있어서”라고 본다. 한도에 걸려 자기 프로젝트조차 못 만지는 상태가 되면 안 된다.
CLAUDE.md 는 없어도 살아남는다(C~D 티어 → 약간 상향). 프로젝트 설명·현재 상태·코딩 스타일·PR 언어 정도만 두고 유연하게 바꾸며, 스킬로도 비슷하거나 더 나은 결과가 나온다. agents.md 를 쓰면 CLAUDE.md 안에서 import 해 심링크를 피한다.
스킬은 잘 쓰면 S 티어. 반복 워크플로우를 담은 마크다운이고, 회사·엔지니어가 자기 지식을 넣어둔 것이라 에이전트뿐 아니라 사람이 읽어도 배운다. 다만 스팸 금지 — 좋은 코드 기준은 주관적이라 자기 스타일에 맞는 한 계열만 쓴다.
검증(verification)이 최상위다. 테스트는 먼저 쓰고 구현해야 한다. 구현 후 테스트를 쓰게 하면 자기 코드를 통과시키는 커닝이 된다. 전 라인 테스트는 코드베이스만 불린다. 타입체커·린터를 “완료” 판정 전에 돌리게 하고, 프론트엔드는 스크린샷·브라우저 테스트로 눈을 준다 — 모델은 자기가 만든 화면을 못 본다.
플랜 모드는 큰 작업에만 쓴다. 3000줄·12파일 diff 에서 실수를 잡는 것보다 계획에서 잡는 게 쉽다. 반대로 오타·변수명·소소한 디자인 변경엔 낭비다. 흐름은 똑똑한 모델로 계획 → 싸고 빠른 모델로 구현(예: Opus 로 계획, Sonnet 으로 구현)이 기본기가 되어간다.
컨텍스트에는 “dumb zone” 이 있다. 많이 쓸수록 잊고, 자기모순에 빠지고, 멍청한 실수를 한다. 100k~200k 토큰을 넘기면 성능이 꺾이고, 컨텍스트 한도를 1M 으로 늘리는 건 dumb zone 을 없애는 게 아니라 늘릴 뿐이다. 그래서 작업 하나마다 새 세션을 열고, 불필요한 리서치 탕진을 즉시 막고, 프롬프트를 바보스러울 만큼 구체적으로 쓴다. Claude 가 스스로 compact 를 돌렸다면 그건 “치매” 신호이니 새 세션을 여는 게 낫다.
자동화·병렬은 각각 값이 다르다. /loop 는 사실상 AI 크론잡이라 자리에 없어도 진행이 쌓인다(이슈 구현·보안 버그 스윕·기능 브레인스토밍). 서브에이전트는 각자 컨텍스트를 가져 품질을 올리지만 각각이 독립 대화라 낮은 플랜에선 한도를 순식간에 태운다. 워크트리는 “채팅 하나 = 워크트리 하나”로 브랜치를 격리해 에이전트끼리 서로 간섭하지 않게 한다.

용어

CLAUDE.md [지식 · 컨텍스트 자산]: 프로젝트 영구 기억 역할을 하는 마크다운. 다른 에이전트는 agents.md 를 쓰고 Claude 만 별도 파일명을 쓴다.
Skill (SKILL.md) [하니스 · 패턴]: 반복 워크플로우·베스트프랙티스를 담은 마크다운. 모델이 필요할 때 알아서 쓰거나 명시적으로 호출한다.
Plan mode [하니스 · 패턴]: Shift+Tab 으로 진입. 수정 대신 코드를 더 꼼꼼히 읽고 전체 계획을 먼저 보여준 뒤 승인/거절을 받는다.
Verification [워크플로우 · 문화]: 모델이 “끝났다”고 판단하기 전에 스스로 정답 여부를 확인할 경로(테스트·타입체커·린터·스크린샷·브라우저)를 주는 것.
MCP [도구 통신 (MCP · CLI · API)]: GitHub·DB·Slack·브라우저 등 코드베이스 밖 도구에 모델을 연결하는 규약. 외부와 직접 상호작용할 때만 쓰고 지식성 내용은 스킬로 대체한다.
dumb zone [컨텍스트 · 캐시]: 컨텍스트를 많이 쓸수록 모델이 잊고 모순되고 실수하는 구간. 창 크기를 키우면 없어지지 않고 길어진다.
/compact [컨텍스트 · 캐시]: 대화 기록을 요약 압축해 컨텍스트 창에 맞추는 명령. 모델이 자동으로 돌리면 품질이 떨어지므로 필요하면 직접 “무엇을 남길지” 지정해 돌린다.
서브에이전트 [하니스 · 패턴]: 메인 에이전트가 특정 작업(리서치·리뷰·디버깅)용으로 띄우는 미니 세션. 각자 컨텍스트 창을 갖고 끝나면 요약만 돌려준다.
워크트리 [워크플로우 · 문화]: 같은 저장소의 여러 브랜치를 각각 별도 폴더로 체크아웃하는 git 기능. AI 병렬 개발에서 작업 격리 수단으로 쓴다.
/loop [워크플로우 · 문화]: 시간 간격을 주면 같은 작업을 반복 실행하는 AI 크론잡 성격의 명령.