달레 스터디에서 AI 스터디를 모집한다는 소식을 듣고 지원했다. 함께 읽을 자료로 Claude Code 공식 문서를 정했고 문서에서 안내하는 학습 순서를 따라가 보기로 했다.
Claude Code는 예전부터 정말 많이 사용했다. 업무에서도 쓰고 개인 프로젝트를 만들 때도 적극적으로 활용했다. 그런데 많이 사용한 것과 잘 알고 사용하는 것은 조금 달랐다.
왜 이렇게 동작하는지, 지금 내 설정이 도움이 되는지, 더 잘 쓸 방법은 없는지. 익숙하게 쓰고 있으면서도 설명하지 못하는 부분이 꽤 있었다. 그런 블랙박스를 조금씩 열어보고 싶었다.
다른 개발자들의 사용법도 궁금했다. 다른 회사에서는 어떤 일을 맡기는지, 개인 프로젝트에서는 어떻게 쓰는지, 각자의 하네스는 어떻게 만들어가는지. 혼자 문서를 읽는 것보다 그런 이야기를 함께 나눌 수 있어 좋았다.
익숙한 도구의 안쪽을 들여다보다
첫 문서에서는 Claude Code를 모델과 하네스로 나눠 설명했다. 모델이 판단하고 하네스가 도구 실행과 컨텍스트 관리를 맡는다. 필요한 정보를 모으고 행동하고 결과를 확인하는 흐름으로 작업을 이어간다. How Claude Code works
평소에 보던 동작을 이름과 구조로 다시 읽으니 조금 더 이해가 됐다. 파일을 읽고 명령을 실행하는 일, 대화가 길어졌을 때 내용을 정리하는 일이 하나의 작업 흐름 안에 있다는 걸 알게 됐다.
사용하다 보면 답변이 마음에 들지 않을 때 더 좋은 모델이나 프롬프트부터 찾게 된다. 앞으로는 내가 어떤 정보를 줬고 어떤 도구를 쓸 수 있게 했고 무엇을 완료로 볼지 제대로 알려줬는지도 같이 살펴보고 싶다.
공식 가이드도 Claude가 작업을 확인할 방법을 함께 주라고 설명한다. 테스트라면 기대하는 결과를, 화면을 바꾸는 일이라면 실제로 확인할 화면과 동작을 알려주는 식이다. 나도 앞으로는 “고쳤다”는 답변에서 멈추지 않고 무엇으로 확인했고 어떤 결과가 나왔는지까지 보려고 한다. 테스트가 통과했다는 것과 내가 원한 동작이 맞다는 것도 따로 확인해야겠다. 작업을 검증하는 방법
서브에이전트에 대한 질문
문서를 읽으면서 서브에이전트가 컨텍스트 관리에도 도움이 된다는 걸 처음 알게 됐다. 그전에는 많이 활용하지 않았고 작업을 따로 맡기면 메인 에이전트에서 하는 것보다 품질이 낮아지지 않을까 싶었다.
이 생각은 이전 글 「서브에이전트는 더 똑똑한가?」에도 남겼다.
현재 문서에서 설명하는 일반적인 서브에이전트는 별도의 컨텍스트에서 작업한다. 다만 fork는 기존 대화를 복사해서 시작한다. 두 경우 모두 작업 중 읽은 파일과 도구 출력이 메인 대화에 그대로 쌓이지 않고 결과가 요약되어 돌아온다. 서브에이전트와 컨텍스트
결국 서브에이전트가 알아서 더 좋은 답을 만드는 것보다, 내가 무엇을 맡겼고 필요한 맥락을 얼마나 잘 전달했는지가 중요하겠다는 생각이 들었다. 목표와 확인할 범위, 필요한 자료, 어떤 결과를 돌려받고 싶은지를 분명하게 적어야겠다.
여기서 성능 수치도 조금 더 정확히 볼 필요가 있었다. Anthropic은 Opus 4 리드와 Sonnet 4 서브에이전트 조합이 내부 리서치 평가에서 단일 Opus 4보다 90.2% 높은 성능을 냈다고 설명했다. 하지만 코딩 전반이 그만큼 좋아진다는 뜻은 아니다. 약 15배라는 토큰 사용량 역시 일반 채팅과의 비교였다. Anthropic의 멀티에이전트 리서치 사례
공유할 맥락이 많고 중간 판단을 계속 주고받아야 하는 일은 메인에서 이어가고 범위를 나눌 수 있는 조사나 결과물만 필요한 일은 맡겨보려고 한다. 어디까지 나누는 게 좋은지는 직접 사용하면서 찾아가야 할 것 같다.
스킬 350개보다 자주 쓰는 50개
확장 기능을 읽다가 내 설정도 돌아보게 됐다. 당시 설치한 스킬은 350개 정도였는데, 자주 사용하는 건 50개 정도인 것 같았다. 좋다는 것을 하나씩 설치하다 보니 많이 쌓였고 정리는 제대로 하지 않았다.
스킬뿐만 아니라 hook, MCP, CLAUDE.md, rules도 마찬가지였다. 오래된 설정이 남아 있거나, 너무 엄격한 지시가 오히려 작업을 방해하는 부분도 보였다.
공식 문서는 프로젝트 규칙부터 시작하고 구체적인 필요가 생길 때 확장 기능을 더하는 방향을 안내한다. 스킬도 전체 내용이 항상 들어가는 것이 아니라, 설명을 보고 필요한 스킬의 본문을 불러오는 방식이다. Extend Claude Code
설치한 개수보다 내가 무엇을 가지고 있고 언제 쓰는지 아는 게 중요하겠다는 생각이 들었다. 자주 쓰는 스킬은 더 잘 다듬고 지금 작업과 맞지 않는 지시는 다시 살펴봐야겠다.
댓글에는 집안일처럼 개인의 하네스도 꾸준히 정리해야 할 것 같다고 썼다. 지금 봐도 그 표현이 맞는 것 같다. 한번 만들어 놓는다고 끝나는 설정은 아니었다.
글을 쓰면서 최근 릴리스도 찾아봤다. 9월 26일에는 오래된 모델에 맞춰 쓴 CLAUDE.md, 스킬, 에이전트 설정을 점검하는 /doctor prompt-audit가 추가됐다. 내가 쌓아둔 지시도 지금 사용하는 모델에 여전히 필요한지 돌아볼 만하겠다. 좋다는 설정을 더 가져오기 전에, 자주 쓰는 것부터 살펴보고 왜 필요한지 설명하기 어려운 규칙은 다시 검토해보고 싶다. v2.1.283 릴리스

컨텍스트와 캐시는 다른 이야기였다
컨텍스트 문서는 대화가 어떻게 채워지는지 시각적으로 보여줘서 좋았다. 이전에는 사용량이 30~40% 정도만 되어도 신경을 썼는데, 요즘은 목표 중심으로 작업하면서 숫자를 덜 보게 됐다. 그래서 다른 분들은 언제 대화를 정리하고 언제 새 세션을 열고 언제 서브에이전트를 쓰는지 궁금했다.
문서에서는 작업 사이의 정리, 관계없는 일을 시작할 때의 새 대화, 큰 읽기 작업의 위임을 설명한다. 나에게는 특정 비율 하나를 정하는 것보다 다음 작업에 무엇을 남겨야 하는지 생각하는 게 더 도움이 될 것 같았다. Explore the context window
프롬프트 캐싱도 이번에 처음 제대로 읽었다. 이미 처리한 같은 입력을 재사용해 비용과 지연을 줄이는 것이지, 대화가 차지하는 컨텍스트 공간을 줄여주는 기능은 아니었다. 모델을 바꾸면 캐시도 달라진다. 다만 effort 변경의 영향은 모델과 제공 방식에 따라 예외가 있다. Prompt caching
이걸 알고 나니 무조건 아껴야겠다는 생각보다는, 내가 바꾼 설정이 왜 다음 응답에 영향을 주는지 이해할 수 있었다. 시작할 때 작업에 맞는 모델을 고르고 작업의 경계에서 필요한 만큼 정리하는 방식으로 써보려고 한다.

기억에도 정리가 필요했다
CLAUDE.md와 rules의 차이도 제대로 모르고 쓰고 있었다. 둘 다 지시를 남기는 곳이지만 rules로 나누면 주제별로 정리하거나 특정 경로에만 적용할 수 있다. 자동 메모리는 그와 달리 Claude가 배운 내용과 패턴을 남기는 노트에 가깝다. Memory
내가 기억하면 좋겠다고 했던 것들이 쌓여 있었는데, 그중에는 최신화가 안 된 내용이나 굳이 남기지 않아도 될 것들도 있었다. 기억이 많다는 것만으로 잘 관리되고 있는 건 아니었다.
처음에는 이런 설정이 결국 토큰을 아끼기 위한 것 아닐까, 컨텍스트가 충분히 커지면 관리도 필요 없어지지 않을까 생각했다. 지금은 공간이 넓어져도 오래된 지시와 서로 충돌하는 규칙까지 저절로 정리되지는 않겠다는 생각이 든다.
마지막 Common Workflows는 알고 있던 내용이 많아 복습하듯 읽었다. 그래도 익숙하게 하던 작업을 다시 점검할 수 있었다. 모델이 좋아지면서 자율적으로 맡기는 범위도 넓어졌지만 내가 원하는 결과와 맡기지 않을 행동까지 알려주는 일은 여전히 남아 있는 것 같다.
문서보다 오래 남은 대화들
공식 문서에서 배운 것도 많았지만 스터디에서는 특히 각자의 사용법을 들을 수 있어 좋았다.
같은 주제를 읽고도 누군가는 업무에서 이렇게 적용하고 누군가는 개인 프로젝트에서 다른 방식으로 사용했다. 이 주제의 트렌드나 직접 써보고 좋았던 것들을 소개해 주기도 했다. 문서에 적힌 기능이 실제 작업에서는 어떻게 쓰이는지 들을 수 있었다.
작은 Claude Code를 직접 만들어보니 하네스가 어떻게 돌아가는지 더 잘 이해하게 됐다는 이야기가 기억에 남았다. 나도 문서만 읽는 것보다 직접 만들어보면 궁금했던 것들을 더 잘 알 수 있겠다는 생각이 들었다.
작업 순서를 하나하나 정해주기보다 목표, 바꿀 범위, 유지해야 할 동작, 완료 조건을 알려주는 게 중요하다는 이야기도 나눴다. AI에게 자율적으로 맡긴다고 해서 아무 조건 없이 맡기는 건 아니라는 이야기였다. 나는 원하는 결과를 얼마나 구체적으로 알려주고 있었는지도 돌아보게 됐다.
Discord에서는 작업 중 Claude가 메모리에 저장할지 먼저 물어보는 경험도 공유했다. 문서에서 읽은 메모리가 실제 작업에서는 어떻게 쓰이는지 들을 수 있었다.

내가 공유한 한국어 윤문 도구를 발표 스크립트에 써봤다는 이야기도 들었다. 코드를 만드는 일뿐 아니라 글을 쓰고 발표를 준비하는 데도 각자 도구를 적용하고 있어서 재미있었다.

회사와 맡은 일, 경력이 다르니 중요하게 보는 것도 달랐다. 경험이 더 많은 개발자분들의 이야기를 들으면서 AI를 많이 쓰는 상황에서 내가 무엇을 놓치지 말아야 하는지도 생각해볼 수 있었다.
혼자 읽었다면 이해하고 넘어갔을 내용도, 다른 사람의 설명을 듣고 내 사용법에 대입하면서 다시 질문하게 됐다. 나에게는 그 시간이 꽤 큰 자극이었다.
토요일 오전 9시
매주 토요일 오전 9시에 모이는 건 쉽지 않았다. 그래도 정해진 시간에 함께 읽고 이야기하다 보니 꾸준히 공부할 계기가 됐다. 아침에 일어나 스터디를 하고 나면 주말 하루가 조금 길어진 느낌도 들었다.
모든 회차에 참여하지는 못했다. 일정이 되는 대로 최대한 참여하려고 했고 참여한 시간마다 배워갈 것이 있었다. 다음에 AI 스터디가 열린다면 또 참여하고 싶다.
스터디가 끝난 뒤 해보고 싶은 것들
글을 마무리하면서 최근 사용 사례도 찾아봤다. Reddit에서는 파일을 수정한 뒤 포맷터와 타입 검사를 실행하면 오류를 매번 직접 전달할 필요가 없다는 사용 경험을 읽었다. 같은 대화에서는 사람이 작업해도 같은 검사를 받도록 커밋 전 검사에 두는 게 좋겠다는 의견도 있었다. 특정 도구를 더 설치하는 이야기보다 반복해서 확인할 일을 어디에 남길지에 관한 대화라서 눈길이 갔다. 나도 지금 프로젝트에서 쓰는 검사부터 정리하고 AI가 작업한 뒤에도 실제로 실행됐는지 확인하는 방식으로 써보고 싶다.
에이전트가 어떻게 동작하는지 더 공부하고 작은 에이전트도 직접 만들어보고 싶다. 도구를 사용하면서 느꼈던 궁금증을 구현해보는 과정에서 확인할 수 있지 않을까 싶다.
내 작업 방식도 작은 일 하나부터 다시 살펴보려고 한다. 무엇을 기대했는지, 어떤 맥락을 줬는지, 결과를 어떻게 확인했는지 남겨보면 좋겠다. 원하는 결과가 나오지 않았을 때도 다시 시키는 데서 끝내지 않고 정보가 부족했는지 확인 기준이 빠졌는지 먼저 돌아보고 싶다.
그렇다고 매번 긴 계획부터 만들 필요는 없을 것 같다. 공식 가이드도 범위가 분명한 작은 수정은 바로 진행하고 접근 방법이 불확실하거나 여러 파일을 바꾸는 일에서 계획이 더 유용하다고 설명한다. 나도 지금 무엇을 결정해야 하는지부터 생각해보고 싶다. 조사와 계획에 관한 가이드
그 와중에도 AI를 많이 쓰는 것만으로 공부를 대신했다고 생각하지는 않으려고 한다. 내가 이해한 것과 아직 설명하지 못하는 것을 구분하고 필요한 부분을 직접 확인하는 시간을 계속 가져가고 싶다.
스터디를 운영해 주시고 함께 읽고 이야기 나눠주신 모든 분들께 감사드린다.
함께 읽은 문서
- How Claude Code works: 공식 문서
- Extend Claude Code: 공식 문서
- Explore the context window: 공식 문서
- Prompt caching: 공식 문서
- Memory: 공식 문서
- Common workflows: 공식 문서
2026년 10월 10일 공식 문서와 최근 릴리스를 다시 확인해 정리했다. 글의 날짜는 한국 시간 기준이다. 이전 글은 읽을 당시의 기록이며 이 글에는 이후 다시 확인한 예외와 비교 범위를 덧붙였다. 현재 공식 가이드의 권고를 모두 이번 달에 새로 나온 사용법으로 보지는 않았다.
