Claude Code 서브에이전트와 검증 하네스로 설계 신뢰도를 높인다
Claude가 “구현을 완료했습니다”라고 말해도 그게 맞다는 뜻은 아니다. 에이전트는 품질이 평범해도 자기 작업을 자신 있게 칭찬하는 경향이 있다. 그래서 좋은 구조는 책임을 잘게 나누고, 만든 것과 검증하는 것을 분리하며, 최종 결정권은 사람에게 남긴다. 앞 글에서 코어 루프와 Context·Permission·Tool 하네스를 다뤘다.…
Claude가 “구현을 완료했습니다”라고 말해도 그게 맞다는 뜻은 아니다. 에이전트는 품질이 평범해도 자기 작업을 자신 있게 칭찬하는 경향이 있다. 그래서 좋은 구조는 책임을 잘게 나누고, 만든 것과 검증하는 것을 분리하며, 최종 결정권은 사람에게 남긴다. 앞 글에서 코어 루프와 Context·Permission·Tool 하네스를 다뤘다.…
문제를 받으면 “이렇게 구현하면 되겠다” 싶어 곧장 코드로 넘어가는 경우가 많다. 그런데 Claude Code가 강력한 이유는 모델이 똑똑해서가 아니다. 모델을 둘러싼 하네스(harness) 구조가 강력해서다. 같은 원리를 사람의 문제 설계에도 적용할 수 있다. 이 글은 Claude Code의 코어 루프와 하네스를 분해한…
Claude Code에게 “이 기능 구현해줘”라고 한 문장만 던지면 동작하는 코드는 나온다. 처음에는 그럴듯해 보이지만 엣지 케이스 한두 개만 추가해도, 유효하지 않은 입력이 한 번만 들어와도 쉽게 무너진다. CodeCraft 유형의 설계 문제는 코드를 치기 전에 다섯 단계로 먼저 분해해야 한다. 이…
알고리즘 인터뷰는 정답 코드를 빠르게 작성하는 능력을 본다. 그러나 DoorDash, Uber, Stripe, Netflix, Amazon이 보는 것은 다르다. “실제 서비스에서 마주칠 법한 문제를 어떻게 해석하고, 어떤 구조로 설계하고, 어떤 트레이드오프를 고려하면서 확장 가능하게 구현하는가.” 이 흐름을 다루는 문제 해결 전략이 Code…
NCP에서 /home 파티션 사용률 90% 경고가 왔다. 처음 한 번은 수동으로 정리했다. 2시간이 걸렸다. 두 번 다 하고 싶지 않았다. 백업하고, 무결성 확인하고, 로컬에 내려받고, NAS에 올리고, 원본을 지우는 순서는 매번 똑같다. 리스크는 크고 절차는 반복된다. 이걸 셸 스크립트로 묶기로…
Claude Code를 쓰다 보면 어느 순간 Claude가 이상하게 움직인다. 아까 하지 말라고 했던 파일을 건드리거나, 작업 범위를 스스로 넓히거나, 검증 없이 작업 완료를 선언한다. 모델이 나빠진 게 아니다. 컨텍스트가 무너진 것이다 이 글은 Claude Code의 Context Harness를 설계하는 세 가지…
Claude Code는 대화 도구가 아니다 Anthropic 공식 문서는 Claude Code를 “코드베이스를 읽고, 파일을 수정하고, 명령을 실행하고, 개발 도구와 통합하는 에이전틱 코딩 툴”로 정의한다. 핵심은 질문에 답하는 것이 아니라 작업을 이어서 수행하는 데 있다 백엔드 개발에서 Claude Code를 사용하면 워크플로우는 다음과…
게시물에 이미지 업로드 기능을 추가하려고 AWS S3를 처음 붙이면 예상보다 훨씬 많은 설정을 건드리게 된다. 버킷 생성, IAM 사용자, 정책, 액세스 키, CORS, 그리고 Mixed Content 에러까지. 이 글은 그 흐름을 개념 중심으로 정리한다 S3 버킷이란 S3(Simple Storage Service)는 객체(Object)…
Claude Code를 본격적으로 쓰기 시작하면 한 달 토큰 사용량을 보고 한 번쯤 놀란다. 똑같은 작업을 시켰는데 어떤 날은 컨텍스트가 가볍고 어떤 날은 무거워진다. 토큰이 어디서 새는지 모르면 절약 전략도 세울 수 없다는 결론에 도달한다. Anthropic 공식 마켓플레이스에는 이 문제를 정면으로…
같은 Claude 모델을 두고도 어느 날은 멀쩡한 패치를 만들어내고, 어느 날은 엉뚱한 파일을 고친 채 “완료했다”고 내미는 경험이 있을 것이다. 이 차이를 모델 탓으로 돌리기 쉽지만, 실제로는 모델이 일하는 환경, 곧 하네스(Harness)가 결과를 가른다. 모델이 똑같아도 컨텍스트가 흐리면 엉뚱한 파일을…