클로드 코드, 몇 시간짜리 작업 조종하는 6가지 방법 공개

이 영상은 클로드 아카데미의 "클로드 코드 인 액션" 강좌 전체 9개 수업 가운데 1강이에요. 제목은 "몇 시간짜리 클로드 코드 세션 조종하기: 계획모드, 컴팩트, 리와인드, 골"이고 유튜브에 올라왔어요.

최근 이어진 클로드 코드 업데이트 위에 나온 강의

이번 강의는 갑자기 나온 게 아니에요. 8월 23일에는 안드레이 카파시의 LLM 코딩 지적을 CLAUDE.md 한 장으로 정리한 지침이 개발자 커뮤니티에서 주목받기도 했어요. 도구가 계속 늘어난 흐름 속에서, 이번 강의는 그 도구를 오래 쓸 때 방향을 잃지 않는 법을 정리한 셈이에요.

시작 전엔 범위를 정하고, 시작한 뒤엔 조종한다

영상은 긴 작업을 다루는 두 가지 습관을 제시해요. 첫째는 클로드가 작업을 시작하기 전에 범위를 정하는 거예요. 계획모드를 켜면 클로드가 코드를 고치지 않고 읽기 전용으로 조사만 한 뒤 계획을 내놓는데, 이 계획을 꼼꼼히 읽고 필요한 부분을 고쳐달라고 요청할수록 실행 단계에서 문제가 생길 가능성이 줄어든다고 설명해요. 계획을 세운 뒤 결과를 그냥 바라기보다 계획 자체를 반복해서 다듬는 쪽이 훨씬 빠르다는 게 핵심이에요.

둘째는 작업이 진행되는 동안 방향을 잡아주는 조종이에요. 여기서 네 가지 구체적인 도구가 나와요.

어떻게 써보나

컴팩트는 대화 내용을 요약해서 새 맥락으로 쓰고 기존 대화는 지워, 컨텍스트 윈도우(AI가 한 번에 기억하며 읽을 수 있는 분량)를 다시 확보해요. 다만 요약 과정에서 중요한 내용이 빠지면 클로드가 엉뚱한 방향으로 흐를 위험이 있어서, 컴팩트 명령을 쓸 때 원하는 변경 사항을 함께 적어주면 클로드가 무엇을 남기고 지울지 판단하는 기준이 돼요. 디버깅은 끝났고 API 변경 부분만 남기고 싶다면 그렇게 지시하면 돼요.

리와인드는 클로드가 엉뚱한 길로 가도 프롬프트로 되돌리려 애쓰지 않고 마지막 체크포인트로 곧바로 돌아가는 기능이에요. 빈 프롬프트 상태에서 Esc 키를 두 번 누르면 리와인드 메뉴가 열리고, 프롬프트를 입력할 때마다 체크포인트가 하나씩 쌓여요. 메뉴에서는 코드만 되돌리기, 대화만 되돌리기, 둘 다 되돌리기 중 고를 수 있고, 체크포인트 이후 내용만 요약하거나 이전 내용만 요약하는 것도 가능해요. 긴 설정 단계는 지우고 실제 구현 부분만 남기고 싶을 때 쓰기 좋은 방식이에요.

골은 완료 조건을 미리 설명해두면 클로드가 여러 턴에 걸쳐 작업을 계속하다가, 빠른 평가 모델이 조건 충족을 확인한 뒤에야 멈추는 기능이에요. 모든 테스트가 통과하고 타입 검사기가 오류 0건을 보고한다는 식으로 조건을 걸면, 클로드가 처음 끝났다고 느낀 시점이 아니라 실제 조건이 맞는 시점에 작업을 마쳐요. 다만 평가 모델은 대화 기록만 읽기 때문에 조건은 결과물에서 확인 가능한 형태여야 해요. 조건을 취소하려면 /goal clear를 입력하면 돼요.

루프는 정해진 간격이나 자체 판단 간격으로 프롬프트를 반복 실행하는 기능이에요. CI 실행 결과나 배포 상태처럼 외부에서 바뀌는 값을 계속 확인하다가 상태가 달라지면 그에 맞춰 움직이도록 쓸 수 있고, Esc 키를 누르면 멈춰요.

마지막으로 여러 에이전트를 같은 코드베이스에서 동시에 돌릴 때는 워크트리가 필요해요. 자동차 한 대에 운전대가 두 개면 위험한 것처럼, 클로드 세션 여러 개가 같은 파일을 두고 충돌하면 안 되기 때문에 각 세션마다 독립된 파일 트리를 만들어 충돌을 막아요. 세션이 끝나면 깨끗한 워크트리는 자동으로 삭제되고, 저장소 루트에 두는 .worktreeinclude 파일에 목록을 적으면 버전 관리에 올리지 않으면서도 각 워크트리에 복사해야 하는 환경변수 파일이나 로컬 설정을 지정할 수 있어요.

여섯 가지 도구, 쓰는 시점이 다르다

도구	언제 쓰나	무엇을 하나
계획모드	작업 시작 전	읽기 전용 조사 후 계획 제시
컴팩트	맥락이 꽉 찼을 때	대화 요약으로 컨텍스트 확보, 지시로 요약 기준 지정
리와인드	방향이 틀렸을 때	체크포인트로 코드·대화 되돌림
골	완료 조건을 설명할 수 있을 때	조건 충족까지 여러 턴 자동 진행
루프	외부 상태를 계속 확인할 때	간격을 두고 프롬프트 반복 실행
워크트리	여러 에이전트를 동시에 돌릴 때	독립 파일 트리로 충돌 방지

추가로 확인된 것

클로드 코드 인 액션 강좌 4강은 "클로드 코드 권한 모드: 오토 모드로 손 놓고 돌릴 때"라는 제목으로, 오토 모드가 기본값이 되기 전 클로드 코드에 원래 여섯 가지 권한 모드가 있었다는 사실을 다뤄요. 각 모드는 어떤 작업을 클로드가 스스로 실행하고 어떤 작업은 사용자 승인을 기다려야 하는지 그 경계를 각기 다르게 설정한다고 강의는 설명해요. 이 4강 역시 클로드 아카데미가 유튜브 영상과 별도로 텍스트 강의를 함께 제공하는 형태로 공개됐어요.

클로드 코드 인 액션 강좌 6강은 "루틴과 헤드리스 모드로 클로드 코드 자동화하기"라는 제목으로 공개됐어요. 이 6강은 클로드 코드를 자동화하는 두 가지 방법을 다루는데, 루틴은 클라우드에서 실행되는 저장된 프롬프트를 말하고, 헤드리스 모드는 사용자가 직접 짠 스크립트에서 클로드 코드를 실행하는 방식이에요.

클로드 코드 인 액션 강좌 8강은 "지켜보지 않은 클로드 코드 실행을 믿는 법"이라는 제목으로 공개됐어요. 이 8강은 지켜보지 않은 실행을 오토 모드로 그대로 두고, 실행이 끝난 뒤 무엇을 했는지 확인하는 방식으로 신뢰를 확보하는 법을 다뤄요.

에디터의 시선

이번 강의가 눈에 띄는 이유는 새 기능을 얹은 게 아니라 이미 있는 기능들을 하나로 묶어 긴 작업을 다루는 실무 문제에 답을 낸 데 있어요. 지난달 오토 모드가 기본값이 되면서 클로드 코드는 매번 승인받지 않고도 알아서 움직이는 방향으로 갔는데, 사람이 지켜보지 않는 시간이 늘어난 만큼 방향을 잃었을 때 되돌리는 안전판이 더 중요해졌어요. 리와인드와 골, 루프는 그 안전판 역할을 하는 도구들이고, 이번 강의는 그 도구들을 언제 어떻게 조합하는지를 처음으로 순서 있게 정리한 자료로 보여요.

실무에서 짧은 프롬프트 한 번으로 끝나는 작업과 몇 시간짜리 리팩터링을 같은 방식으로 다루면 늘 같은 문제가 생겨요. 후자는 중간에 맥락이 넘치고, 엉뚱한 파일을 고치고, 언제 끝났는지 판단이 애매해지는 지점이 꼭 나오는데, 계획모드로 시작 전 범위를 좁히고 리와인드로 되돌릴 지점을 확보해두면 그 지점에서 처음부터 다시 시작하는 대신 몇 초 안에 복구할 수 있어요. 개발팀이라면 큰 리팩터링을 맡기기 전에, 완료 조건을 테스트 통과나 타입 검사처럼 확인 가능한 문장으로 먼저 써보는 연습부터 해볼 만해요. 그 문장이 안 나오면 골 기능도 쓸 수 없기 때문이에요.

앞으로 남은 8개 수업에서는 컨텍스트 관리나 대규모 코드베이스 탐색 같은 주제가 이어질 가능성이 커요. 클로드 코드를 짧은 작업에만 써봤다면, 이번 강의가 몇 시간짜리 자동화로 넘어가는 입구가 될 걸로 보여요.