에이전트의 기억을 관리하기

시즌 1의 3강에서 이런 문장을 지나쳤어요. "에이전트는 대화를 새로 시작하면 잊어버려요."

그때는 그냥 넘어갔죠. 오늘은 그 문장이 주인공이에요.

에이전트와 오래 대화하다 보면 이상한 순간이 와요. 아까 분명히 말한 걸 또 물어보고, 조금 전에 고친 걸 다시 고치겠다고 해요. 실력이 떨어진 게 아니에요. 자리가 없는 거예요.

오늘 만들 것

에이전트의 기억이 어디까지인지 눈으로 확인하고, 대화가 무거워졌을 때 무엇을 눌러야 하는지 아는 상태.

그리고 슬래시 명령어라는 게 있다는 것. 시즌 1에서는 한 번도 안 썼죠.

준비물

• 시즌 1을 마친 상태 (인터넷에 올라간 내 페이지, 그리고 my-page 폴더)
• 30분

새 프로젝트를 만들지 않아요. 시즌 1에서 쓰던 그 폴더를 그대로 열어요.

따라 하기

1. 도마 이야기

주방에 도마가 하나 있어요. 재료를 올려가며 요리하죠. 그런데 도마는 넓지 않아요.

계속 재료를 올리면 자리가 없어져요. 그러면 오래된 것부터 치워야 해요. 아까 썰어둔 마늘은 어디 갔는지 모르게 되죠.

에이전트도 똑같아요. 대화 내용, 읽은 파일, 명령 결과가 전부 도마 위에 올라가요. 그 도마를 컨텍스트라고 불러요. 도마가 차면 오래된 것부터 밀려나요.

그래서 대화가 길어지면 에이전트가 앞부분을 잊어요. 고장이 아니라 구조예요.

2. 슬래시 명령어 열어보기

Claude Code 채팅창에 /를 하나 치세요. 목록이 뜹니다.

/help

엔터를 치면 지금 쓸 수 있는 명령어가 전부 나와요. 훑어만 보세요. 오늘 쓸 건 네 개뿐이에요.

버전에 따라 목록이 조금씩 달라요. 아래 명령어가 안 보이면 이 목록에서 비슷한 이름을 찾으면 돼요.

3. 도마를 들여다보기

시즌 1의 my-page 폴더를 열고, 일부러 대화를 길게 만들어요. 아무거나 다섯 번쯤 시키세요.

index.html을 읽고 지금 구조를 설명해 줘.

색을 하나만 바꿔 보고, 뭘 바꿨는지 알려 줘.

이렇게 몇 번 주고받은 다음, 이걸 치세요.

/context

지금 도마가 얼마나 찼는지 보여줘요. 숫자보다 중요한 건 이걸 볼 수 있다는 사실이에요. 감으로 짐작하던 걸 이제 확인할 수 있어요.

4. 요약해서 자리 만들기

도마가 꽉 차면 두 가지 길이 있어요. 첫 번째는 정리예요.

/compact

지금까지의 대화를 요약본으로 압축해요. 재료를 다시 담되, 부피를 줄이는 거예요. 무엇을 만들고 있었는지는 남고, 자잘한 과정은 사라져요.

압축이 끝나면 다시 확인하세요.

/context

줄었죠. 이게 /compact예요. 대화를 이어가고 싶은데 무거울 때 씁니다.

무엇을 남길지 지정할 수도 있어요.

/compact 지금 하고 있는 디자인 수정 작업에 집중해서 요약해 줘

5. 도마를 통째로 비우기

두 번째 길은 새로 시작하는 거예요.

/clear

도마를 싹 치워요. 그다음 이렇게 물어보세요.

아까 우리가 뭘 만들고 있었지?

모른다고 할 거예요. 진짜로 잊었어요. 이걸 직접 겪어보는 게 오늘의 핵심이에요.

그런데 하나 더 해보세요.

CSS를 별도 파일로 분리해 줘.

시즌 1에서 CLAUDE.md에 "HTML과 CSS는 index.html 한 파일에 유지할 것"이라고 적어뒀다면, 에이전트가 그 규칙을 언급할 거예요.

대화는 잊었는데 규칙은 살아 있어요. CLAUDE.md는 도마 위가 아니라 주방 벽에 붙어 있는 메모라서 그래요. 새 대화가 시작될 때마다 다시 읽혀요.

이게 다음 강의의 주제예요.

6. 언제 무엇을 쓰는가

정리하면 이래요.

• /compact — 하던 일을 계속할 건데 대화가 무거워졌을 때
• /clear — 다른 일을 시작할 때, 또는 에이전트가 자꾸 엉뚱한 소리를 할 때

새 작업을 시작할 때 /clear를 안 하면, 앞의 대화가 계속 판단에 끼어들어요. 아침에 고치던 색깔 이야기가 오후의 배포 작업에 섞이는 거죠.

습관 하나만 가져가세요. 주제가 바뀌면 /clear.

7. 어제 대화로 돌아가기

/clear가 무섭게 느껴질 수 있어요. 지운 게 아니라 치운 것뿐이에요.

/resume

지난 대화 목록이 떠요. 골라서 이어갈 수 있어요.

8. 얼마나 썼는지 보기

/cost

이번 세션에서 쓴 양이 나와요. Claude 구독 안에서 쓰는 거라 따로 돈이 나가진 않지만, 감을 잡아두면 좋아요. 긴 파일을 읽히고 대화를 길게 끌수록 많이 써요.

막혔을 때

/context가 없다고 나와요. 버전이 조금 낮을 수 있어요. /help로 목록을 열어 비슷한 이름을 찾아보세요. 없어도 괜찮아요. /compact와 /clear만 알아도 오늘 목적은 달성돼요.

/compact를 했는데 에이전트가 헷갈려 해요. 요약 과정에서 중요한 걸 놓친 거예요. 압축할 때 초점을 알려주세요. /compact 지금 작업 중인 파일과 남은 할 일에 집중해서 처럼요.

/clear를 했더니 아까 만들던 게 사라진 것 같아요. 대화만 치워졌고 파일은 그대로예요. 폴더를 열어보면 다 있어요. 겁먹지 마세요.

언제 압축되는지 모르겠어요. 도마가 차면 알아서 압축돼요. 자동으로요. /compact는 그걸 내가 원하는 시점에 미리 하는 거예요.

대화가 길어지면 느려져요. 도마가 무겁다는 신호예요. /compact하거나, 주제가 바뀌었다면 /clear하세요.

마무리 체크

나가기 전에 하나씩 확인해요:

• /help로 명령어 목록을 열어봤어요
• /context로 사용량을 확인했어요 (없으면 건너뛰어도 돼요)
• /compact를 써 봤고, 전후 차이를 봤어요
• /clear 후 "아까 뭐 했지?"를 물어 진짜로 잊는 걸 확인했어요
• 그런데 CLAUDE.md 규칙은 살아남는 걸 확인했어요
• "주제가 바뀌면 /clear"를 기억했어요

네 번째와 다섯 번째가 오늘의 전부예요. 에이전트가 무엇을 잊고 무엇을 기억하는지 손으로 확인했다면, 이제 대화가 이상해져도 당황하지 않아요. 도마를 치우면 되니까요.

다음은 주방 벽에 붙은 그 메모예요. 시즌 1에서 다섯 줄 적었던 CLAUDE.md를, 실제로 지켜지는 규칙으로 키워요.