채널톡 아이콘

Claude Code 해부학: 아는 만큼 달라지는 바이브 코딩

유출된 51만 줄의 Claude Code 소스코드를 바탕으로 AI 코딩 도구의 내부 동작 원리를 파헤칩니다. 컨텍스트 관리, 메모리 처리, 프롬프트 전달 메커니즘을 이해하고, 이를 실제 개발 워크플로우에 적용하는 바이브 코딩 실천법을 학습합니다.

36명 이 수강하고 있어요.

난이도 중급이상

수강기한 무제한

삼성
한화시스템/ICT

한화시스템/ICT

에 관심있는 사람들도 듣는 중!

삼성
한화시스템/ICT

한화시스템/ICT

에 관심있는 사람들도 듣는 중!

수강 후 이런걸 얻을 수 있어요

  • Claude Code의 컨텍스트 관리 및 메모리 처리 메커니즘 분석

  • AI 코딩 도구의 한계를 고려한 효율적인 프롬프트 설계 전략

  • 긴 세션에서도 일관성을 유지하는 바이브 코딩 워크플로우 구축

Claude Code 해부학: 아는 만큼 달라지는 바이브 코딩!

유출된 51만 줄의 소스가 알려 준 Claude Code의 구조와 원리 그리고 그 원리에서 도출되는 바이브 코딩 실천법. 프롬프트 엔지니어링을 뛰어 넘는 컨텍스트 관리의 미학.



CLAUDE.md에 적어 뒀는데, 왜 또 Redux를 제안할까요?

바이브코딩을 하면 "Redux 쓰지 마, MobX로 정했어"라고 분명히 적어 뒀는데 다음 세션에서 Claude가 또 Redux를 제안한 적이 있나요? 긴 세션 뒤에 Claude가 갑자기 멍청해진 것 같은데 이유를 모르겠다고 느낀 적은요? 설정 레시피를 따라 했더니 되긴 하는데, 왜 되는지는 설명할 수 없다면요?


이 문제들은 프롬프트를 더 잘 써서 해결되지 않습니다.

Claude Code가 매 턴 무엇을 모델에게 보내고, 무엇을 버리고, 무엇을 기억하지 못하는지를 알아야 풀립니다. 2026년 3월, Claude Code의 전체 소스가 npm 소스맵을 통해 노출되면서 그 구조가 공개 분석되었습니다. 이 강의는 그 분석과 공식 문서를 바탕으로 Claude Code의 내부를 한 장씩 그림으로 보여 주고, 각 원리가 바이브 코딩에서 어떤 실천으로 이어지는지를 연결합니다.


강의를 들으면

  • Claude Code가 한 턴을 처리하는 단계(전처리 → API 호출 → 에러 복구 → 도구 실행 → 후처리)에서 어떤 일이 발생하는지 설명할 수 있습니다.

  • 컨텍스트 윈도우가 무엇으로 채워지는지 그릴 수 있습니다.

  • 대화 압축(compaction)이 무엇을 버리는지 알고 대화 세션을 관리할 수 있습니다.

  • 거부된 결정이 사라지지 않도록 하기 위한 방법을 알 수 있습니다.

  • TDD · SDD 같은 기존 개발 절차가 바이브 코딩환경에서도 중요하다는 것을 알 수 있습니다.


레시피는 버전이 바뀌면 낡지만, 원리는 남습니다

Claude Code는 몇 주 단위로 바뀝니다. 설정법을 다루는 강의와 글은 많지만, 그 설정이 왜 효과가 있는지를 설명하는 자료는 드뭅니다. 이 강의는 반대로 갑니다. Claude Code가 내부에서 어떻게 동작하는지를 먼저 보여 주고, 그 동작에서 어떤 실천이 필연적으로 따라 나오는지를 보여 줍니다. 원리를 알면 레시피를 스스로 만들 수 있고, 버전이 바뀌어도 무엇이 유지되고 무엇이 달라졌는지 판단할 수 있습니다.


1. 유출된 51만 줄이 보여 준 것

2026년 3월 31일, @anthropic-ai/claude-code npm 패키지에 소스맵 파일이 포함되어 약 1,900개 파일, 51만 줄의 TypeScript가 노출되었습니다. 며칠 사이에 전 세계 개발자들이 구조를 분석했고, 그 내용은 Claude Code가 "모델"이 아니라 모델을 감싸는 정교한 "하네스"라는 것을 보여 주었습니다. 미공개 기능(항상 켜져 있는 Kairos 모드, 멀티 에이전트 코디네이터)도 함께 드러나 이 코드가 사실상 Anthropic의 로드맵이었다는 것도 알게 되었습니다.

이 강의는 유출된 소스 코드를 보여 주거나 배포하지 않습니다. 공개된 제3자 분석 글과 Anthropic 공식 문서를 근거로 구조와 원리를 설명합니다.


2. Kairos 모드

상시 대기 어시스트 모드인 Kairos 모드! 이 때 클로는 어떤 일을 하는지 이해함으로써 알아서 해내는 일들의 범위가 무엇인지 알 수 있습니다. 바이브 코딩을 잘하기 위해서는 이 시점에 AI가 더 일을 잘 할 수 있도록 도와야 합니다.

3. 매 턴 무엇이 전송되는가

Claude Code는 매 턴 시스템 프롬프트, 도구 정의, 스킬 목록, CLAUDE.md, 그리고 지금까지의 대화 전체를 통째로 다시 보냅니다. 모델은 호출 사이에 아무것도 기억하지 않기 때문입니다. 그런데도 비용이 폭발하지 않는 이유는 프롬프트 캐시 때문이고 그 캐시를 깨는 행동(세션 중 MCP 연결, 모델 전환)이 무엇인지 알면 토큰 비용이 달라집니다.

창이 차면 Claude Code는 다섯 단계로 압축을 시도합니다. 공짜인 것부터 쓰고, 모자랄 때만 모델에게 요약을 시킵니다. 사용자가 치는 /compact는 그중 마지막 단계일 뿐입니다. 그리고 이 과정에서 정보손실이 발생하고 자칫 환각으로 이어질 수 있습니다.

4. 왜 Claude는 거부된 대안을 잊는가

"A를 시도했다가 거부되어 B를 썼다"는 히스토리는 압축을 거치면 "B를 썼다"만 남습니다. 새 세션은 코드만 보고 "왜 B인가"를 그럴듯하게 사후 합리화하고, 때로는 거부됐던 A를 다시 제안합니다. 바이브 코딩에서 가장 피곤한 "거부된 패턴의 부활", "같은 실수의 반복", "일관성 훼손"이 모두 여기서 나옵니다.


👱사용자: A로 만들어 줘
🤖AI: A 구현
👱사용자: 아니, B로
🤖AI: B 구현

🤖압축압축 후새 세션: "최종적으로 B 사용" (※ A를 검토했다가 거부한 사실은 결과 중심 요약에서 제거)

🤖다음 요청AI: "A도 괜찮은대안입니다"거부된 패턴의 부활!


인간 팀에서 6개월에 한 번 일어나는 망각이
Claude Code에서는 매 세션 일어납니다!


5. 그래서 반드시 해야 하는 일

기억은 대화가 아니라 파일에 있어야 합니다. CLAUDE.md의 Do not 섹션에 "대신 무엇을, 왜"를 함께 적는 법, ADR로 거부된 대안을 남기는 법, 코드 주석과 커밋 메시지를 모델이 발견하는 흔적으로 쓰는 법, 그리고 "X를 쓰면 Y가 깨진다"를 테스트로 만들어 하네스가 집행하게 하는 법을 다룹니다. --continue가 왜 생각보다 쓸모없는지, 압축보다 새 세션이 언제 나은지도 여기서 정리됩니다.

이런 분들께
추천드려요

학습 대상은
누구일까요?

  • Claude Code가 세션마다 같은 실수를 반복해 "전에 안 된다고 했잖아!"를 반복하고 계신 분

  • 긴 세션 뒤에 Claude의 답변 품질이 떨어지는 경험을 하고 그 이유가 궁금한 분

  • 바이브 코딩으로 프로젝트를 키우다 일관성이 무너지는 것을 겪은 분

  • AI 코딩 도구를 사용 중이지만 예측 불가능한 결과에 답답함을 느끼는 개발자

선수 지식,
필요할까요?

  • Claude Code를 설치해 한 번 이상 프로젝트에 써 본 경험

  • Git 기본(커밋, 브랜치)과 터미널 사용

  • 프롬프트 엔지니어링 기본 개념 이해 (※ 프로그래밍은 몰라도 상관 없음!)

안녕하세요
널널한 개발자입니다.

인프런인증

56,296

명

수강생

3,442

개

수강평

1,228

개

답변

4.9

점

강의 평점

34

개

강의

널널한 개발자 TV 채널 주인장이자
30년 넘게 IT기술의 바다를 항해하고 있는 개발자 입니다.  반갑습니다. ^^  

강의 게시일: 
마지막 업데이트일: 

수강평

아직 충분한 평가를 받지 못한 강의입니다.
모두에게 도움이 되는 수강평의 주인공이 되어주세요!

널널한 개발자님의 다른 강의

지식공유자님의 다른 강의를 만나보세요!

비슷한 강의

같은 분야의 다른 강의를 만나보세요!

얼리버드 할인 중

₩22,000

50%

₩44,000

평생교육이용권 지원 강의