ClOr

ClOr

백엔드 실무 트러블슈팅과 AI 에이전트 구조 분석을 기록합니다.

Claude Code 해부학 (완결)

51만 줄 소스코드를 19편에 걸쳐 분석한 완결 시리즈

전체 시리즈 보기 →

백엔드 트러블슈팅

실무에서 겪은 장애와 해결 과정 기록

전체 시리즈 보기 →

최신 글

article thumbnail
Claude Agent SDK: Claude Code를 라이브러리로 써서 나만의 에이전트 만들기
AI 코딩 에이전트 2026. 4. 9. 23:59

Claude Code의 도구, 에이전트 루프, 컨텍스트 관리를 그대로 가져다 쓸 수 있는 SDK가 있다. pip install claude-agent-sdk 한 줄이면 된다.Claude Agent SDK(구 Claude Code SDK)는 Claude Code를 CLI가 아닌 라이브러리로 쓸 수 있게 해주는 공식 SDK다. 파일 읽기, 명령어 실행, 코드 편집, 웹 검색까지 — Claude Code가 할 수 있는 모든 것을 Python이나 TypeScript 코드에서 프로그래밍 가능하다.핵심은 query() 함수 하나다. 프롬프트를 넣으면 Claude가 알아서 도구를 호출하고, 파일을 읽고, 코드를 수정한다. 도구 실행 루프를 직접 구현할 필요가 없다.목차설치와 첫 실행최소 동작 코드Client SDK와..

article thumbnail
Claude Code 프로젝트 구조 분석: 1,900개 파일의 지도 그리기 (해부학 Part 1)
AI 코딩 에이전트 2026. 4. 1. 01:53

시리즈 이전 편: [Part 0] 소스코드 51만 줄이 유출됐다목차1,900개 파일, 어떻게 정리했을까전체 디렉토리 구조핵심 디렉토리 5개 해부src/tools/ — LLM이 사용하는 도구들src/commands/ — 사용자가 치는 슬래시 명령어src/components/ — 터미널 UI의 모든 것src/services/ — 외부 세계와의 접점src/entrypoints/ — 앱이 시작되는 곳진입점 흐름: cli.tsx -> init.ts -> main.tsx그래서 뭐가 달라지나 -- 구조 설계 교훈1,900개 파일, 어떻게 정리했을까Claude Code의 src/ 디렉토리 안에는 정확히 1,920개의 파일이 들어 있습니다. 이 정도 규모면 아무리 잘 만든 프로젝트라도 디렉토리 구조가 엉망이면 개발자가 ..

article thumbnail
Claude Code 소스코드 51만 줄 전체 분석: 유출된 코드를 전부 뜯어본다 (해부학 Part 0)
AI 코딩 에이전트 2026. 4. 1. 01:41

2026년 3월 31일, Anthropic의 공식 CLI 도구인 Claude Code의 소스코드 전체가 인터넷에 풀렸습니다. TypeScript로 작성된 51만 줄, 파일 1,920개. 난독화도 안 된 원본 그대로입니다.목차어떻게 유출됐나뭐가 들어있나이 시리즈에서 다룰 것어떻게 유출됐나보안 연구원 Chaofan Shou(@Fried_rice)가 npm에 배포된 Claude Code 패키지에서 .map 파일을 발견했습니다. source map이란 빌드된 코드를 원본 소스에 매핑해주는 파일인데, Anthropic이 이걸 그대로 배포해버린 겁니다.문제의 .map 파일은 약 57MB 크기였고, Anthropic의 R2 스토리지 버킷에서 zip으로 다운로드할 수 있었습니다. source map 안에는 빌드 전 원..