MemoryLake
모든 글로 돌아가기
Tutorial2026년 11월 19일·10 분 소요

Claude Code의 /goal이란 무엇인가요? 평가기가 조건을 확인할 때 볼 수 있는 것, 세션 재개 시 목표가 다시 나타나는 이유, 그리고 /loop 또는 Stop hook이 더 적합한 경우 (2026)

점심 식사 전에 Claude Code에게 목표를 주었습니다. 통합 테스트가 통과할 때까지 계속 진행하라는 것이었죠. Claude는 여러 턴에 걸쳐 작업하며 두 개의 실패를 수정했습니다. 하지만 터미널에서 테스트가 통과하는 것을 볼 수 있었음에도 불구하고, 평가기는 목표가 달성되지 않았다고 판단했습니다. 나중에 세션을 종료하고 다음 날 아침에 다시 시작했을 때, 목표는 여전히 그 자리에서 기다리고 있었습니다.

이 두 가지 동작은 모두 /goal이 작동하는 방식에서 비롯됩니다. Anthropic의 문서에 따르면 평가기는 "Claude가 대화 중에 드러낸 내용을 바탕으로 조건을 판단합니다. 독립적으로 명령을 실행하거나 파일을 읽지 않으므로, Claude 자신의 출력이 증명할 수 있는 내용으로 조건을 작성해야 합니다."라고 명시되어 있습니다. 또한 재개에 대해서는 "세션을 재개하면 Claude Code는 세션 종료 시 여전히 활성 상태였던 목표를 복구합니다."라고 설명합니다.

이 가이드에서는 /goal이 무엇인지, 목표를 설정, 확인 및 해제하는 방법, 평가기가 볼 수 있는 내용, 작동하는 조건을 작성하는 방법, 재개 시 발생하는 상황, 백그라운드 작업 및 오류가 목표에 미치는 영향, 그리고 언제 /loop 또는 Stop hook을 선택하는 것이 더 나은지 다룹니다.

/goal이란 무엇인가

명령어 참조 문서에서는 이를 한 줄로 설명합니다: "Claude는 조건이 충족되거나 다른 이유로 목표가 해제될 때까지 여러 턴에 걸쳐 계속 작업합니다."

목표 관련 문서에서는 그 메커니즘을 다음과 같이 설명합니다: "/goal은 세션 범위의 프롬프트 기반 Stop hook을 감싸는 래퍼입니다. Claude가 한 턴을 마칠 때마다 Claude Code는 조건과 지금까지의 대화 내용을 설정된 작고 빠른 모델로 보냅니다."

그 모델이 바로 평가기입니다. 매 턴이 끝난 후, 평가기는 다음 세 가지 판정 중 하나를 반환합니다.

  • 아직 충족되지 않음(Not yet met). "Claude는 작업을 계속하며 해당 이유를 다음 턴의 가이드로 삼습니다."
  • 충족됨(Met). "Claude Code는 목표를 해제하고 트랜스크립트에 달성 기록을 남깁니다."
  • 불가능함(Impossible). 평가기가 "조건이 결코 만족될 수 없다고 판단"한 경우입니다. Claude Code는 목표를 해제하고 그 이유를 기록합니다.

문서에서는 이것이 Claude가 스스로 완료 시점을 결정하게 하는 것과 왜 다른지 설명합니다. 자동 모드는 "단일 턴 내에서 도구 호출을 승인하지만 새 턴을 시작하지는 않는" 반면, /goal은 "매 턴마다 조건을 확인하는 별도의 평가기를 추가"합니다.

목표 설정, 확인 및 해제 방법

설정하기. /goal 뒤에 조건을 입력하여 실행합니다. "목표를 설정하면 조건 자체가 지시 사항이 되어 즉시 턴이 시작됩니다. 별도의 프롬프트를 보낼 필요가 없습니다." 세션당 하나의 목표만 활성화될 수 있으며, 새 목표를 설정하면 기존 목표를 대체합니다.

확인하기. 인자 없이 /goal을 실행합니다. 상태 정보에는 조건, 실행 시간, 평가된 턴 수, 현재 토큰 소비량, 그리고 평가기의 최신 판단 이유가 표시됩니다.

해제하기. /goal clear를 실행합니다. 문서에는 stop, off, reset, none, cancel이 별칭으로 나열되어 있습니다. /clear를 실행하여 새 대화를 시작하는 것도 활성 목표를 제거합니다.

목표를 설정한다고 해서 권한 모드가 변경되지는 않습니다. 문서에 따르면: "목표 턴을 무인으로 실행하려면 자동 모드에서 /goal을 실행하세요." 수동 모드에서는 설정에서 이미 허용하지 않은 도구 호출을 하기 전에 Claude가 여전히 확인을 요청합니다.

평가기가 볼 수 있는 것

이것이 도입부 예시에서 발생한 첫 번째 놀라운 상황의 원인입니다. 평가기는 대화 내용을 읽습니다. 스스로 터미널, 파일 또는 테스트 러너를 들여다보지 않습니다.

문서에는 명시적으로 "독립적으로 명령을 실행하거나 파일을 읽지 않는다"고 되어 있습니다. 따라서 다른 터미널 창에서 통과한 테스트나 세션 외부에서 변경된 파일은 평가기가 사용할 수 있는 증거가 되지 않습니다. 중요한 것은 Claude가 실행하고 대화 중에 보고한 내용입니다.

트랜스크립트에는 각 판정이 표시되며, 문서에 따르면 Ctrl+O를 눌러 그 뒤에 숨겨진 이유를 확인할 수 있습니다. 평가기가 계속해서 목표가 충족되지 않았다고 말한다면, 그 이유를 통해 어떤 증거가 누락되었는지 알 수 있습니다.

작동하는 조건을 작성하는 방법

문서에서는 짧은 체크리스트를 제공합니다. 여러 턴 동안 유효한 조건은 대개 다음과 같은 요소를 갖추고 있습니다.

  • "측정 가능한 하나의 종료 상태": 테스트 결과, 빌드 종료 코드, 파일 수 또는 빈 큐 등.
  • "명시된 확인 방법": Claude가 이를 어떻게 증명해야 하는지(예: 테스트 명령이 0을 반환하며 종료됨).
  • "중요한 제약 조건": 진행 과정에서 변경되어서는 안 되는 사항.

평가기는 대화 내용만 보기 때문에 '명시된 확인 방법'이 가장 중요한 부분입니다. 통합 테스트 통과에 대한 조건은 명령어를 명시할 때 판단하기 더 쉽습니다. 그래야 Claude가 해당 명령을 실행하고 그 결과가 트랜스크립트에 나타나기 때문입니다.

조건은 최대 4,000자까지 작성할 수 있습니다. 목표 실행 시간을 제한하기 위해 문서에서는 정해진 턴 수 후에 중단하는 것과 같은 턴 또는 시간 절(clause)을 추가할 것을 권장합니다. "Claude는 매 턴마다 해당 절에 대한 진행 상황을 보고하고 평가기는 대화 내용을 바탕으로 이를 판단합니다."

세션 재개 시 목표가 다시 나타나는 이유

이것은 도입부 예시의 두 번째 동작입니다. 목표는 세션에 속하며, 세션을 재개하면 목표도 복구됩니다.

문서에 따르면 Claude Code는 continue, 세션 ID 또는 이름으로 재개, 트랜스크립트 파일 경로로 재개 등 "모든 재개 경로에서" 활성 목표를 복구합니다.

일부 항목은 초기화됩니다: "Claude Code는 조건은 유지하지만 턴 수, 타이머 및 토큰 소비 기준점은 초기화합니다. 이미 달성되었거나 해제된 목표는 복구하지 않습니다."

따라서 목표가 활성화된 상태로 밤에 작업을 중단하면, 재개할 때 그 목표가 그대로 남아 있게 됩니다. 원치 않는 경우 세션을 닫기 전에 해제하거나 재개 후에 해제하세요.

목표는 세션과 함께 유지되며 세션 간에는 유지되지 않습니다. 완전히 새로운 세션은 목표 없이 시작되며, /clear는 활성 목표를 제거합니다. 목표 문서는 이를 "현재 세션에만 활성화되는" 세션 범위의 단축키라고 부릅니다.

백그라운드 작업이 목표에 미치는 영향

긴 목표에는 서브에이전트나 백그라운드 명령이 포함될 수 있으며, 문서에는 이에 대한 특정 규칙이 있습니다.

평가 대기. "턴이 끝날 때 서브에이전트나 백그라운드 쉘 명령이 여전히 실행 중이면 Claude Code는 해당 턴의 평가를 건너뜁니다." 백그라운드 작업 없이 종료되는 다음 턴의 끝에서 평가를 수행합니다.

상태 확인. 백그라운드 작업으로 인해 목표가 30분 동안 대기 상태가 되면 확인이 필요합니다. Claude Code는 실행 중인 작업을 나열하고 Claude에게 출력을 읽고, 진행 중이면 계속 기다리고, 멈춘 작업이 있으면 수정하거나 중단하도록 요청합니다.

정체 시 루프 중단. "Claude가 진전 없이(여러 턴 연속으로 도구 사용 없음) 평가기에게 계속 응답만 하는 경우, Claude Code는 루프를 중단하고 경고를 출력하며 목표가 설정된 상태로 제어권을 사용자에게 돌려줍니다."

턴이 실패하면 어떻게 되나요?

문서에서는 오류를 두 가지 종류로 구분합니다.

수정해야 하는 오류는 목표를 해제합니다. 여기에는 Claude Code가 자체 자격 증명을 관리할 때의 인증 실패, 크레딧 잔액 부족, "자동 압축으로 해결할 수 없는 컨텍스트 오버플로", 모델 사용 불가 등이 포함됩니다. Claude Code는 원인을 명시한 경고를 출력하며, 사용자는 이를 수정한 후 목표를 다시 설정해야 합니다.

기타 오류는 목표 설정을 유지합니다. "그 외의 오류가 발생한 후에도 목표는 설정된 상태로 유지됩니다."

컨텍스트 오버플로 사례는 긴 목표의 경우 유의할 가치가 있습니다. 많은 턴을 실행하는 목표는 컨텍스트 창을 채우게 되며, 보통은 자동 압축을 통해 계속 진행됩니다. 압축으로 충분한 공간을 확보할 수 없으면 목표가 종료됩니다.

/loop 또는 Stop hook이 더 적합한 경우

문서에서는 프롬프트 사이에서 세션을 계속 실행하는 세 가지 방법을 비교합니다. 차이점은 무엇이 다음 턴을 시작하느냐에 있습니다.

  • /goal은 이전 턴이 끝나면 다음 턴을 시작하고, 모델이 조건을 확인하거나 불가능하다고 판단하면 중단합니다.
  • /loop는 "시간 간격이 경과하면" 다음 턴을 시작하고, 사용자가 중단하거나 Claude가 작업이 완료되었다고 판단하면 중단합니다.
  • Stop hook은 이전 턴이 끝나면 다음 턴을 시작하고, "사용자의 스크립트나 프롬프트가 결정할 때" 중단합니다.

따라서 /loop는 몇 분마다 배포를 확인하는 것과 같이 시간에 따라 구동되는 작업에 적합합니다. 예약된 작업 문서에서는 이를 "세션이 열려 있는 동안 프롬프트를 반복해서 실행하는 가장 빠른 방법"이라고 부릅니다.

Stop hook은 매번 적용되어야 하는 규칙에 적합합니다. 문서의 설명에 따르면: "/goal은 세션 범위의 단축키입니다. 조건을 입력하면 현재 세션에만 활성화됩니다. Stop hook은 설정 파일에 상주하며 해당 범위의 모든 세션에 적용되고, 결정론적 확인을 위해 스크립트를 실행할 수 있습니다."

이 마지막 문구가 중요합니다. /goal 평가기는 대화 내용을 바탕으로 판단하기 때문에, 확인 작업이 결정론적(deterministic)이어야 할 때는 스크립트를 실행하는 Stop hook이 최선의 선택입니다.

야간 테스트와 같이 열린 세션 없이 실행되어야 하는 작업의 경우, 문서에서는 대신 예약 옵션을 안내합니다. 예약된 실행 사이에 무엇이 전달되는지는 Claude Code 루틴 가이드에서 다루었습니다.

사람들이 처음에 시도하는 것들

평가기가 볼 수 없는 조건 작성하기. 평가기는 파일이나 터미널이 아닌 대화 내용을 판단합니다.

세션이 끝나면 목표도 끝날 것이라고 기대하기. 재개하면 활성 목표가 복구됩니다.

두 번째 목표 설정하기. 세션당 하나의 목표만 활성화됩니다. 새 목표는 기존 목표를 대체합니다.

예약된 확인에 /goal 사용하기. /loop는 시간 간격에 따라 실행됩니다.

/goal이 도구 호출을 승인할 것이라고 기대하기. 목표 설정은 권한 모드를 변경하지 않습니다.

해결책: 평가기가 판단할 수 있는 목표 작성

1단계: 조건에 확인 방법 명시

목표 달성을 증명할 수 있는 결과가 나오는 명령어를 포함하세요.

2단계: 제약 조건과 제한 사항 추가

변경되어서는 안 되는 사항과 중단 시점을 명시하세요.

3단계: 재개하고 싶지 않은 목표 해제

계속하지 않을 세션을 닫기 전에 /goal clear를 실행하세요.

4단계: 각 장기 목표가 생성한 결과 기록

결과, 효과적이었던 접근 방식, 미완료 상태로 남은 사항을 기록해 두세요.

MemoryLake에서 설정하기

목표는 조건이 충족되면 종료됩니다. 어떤 테스트가 불안정했는지, 어떤 수정이 효과적이었는지, 무엇을 미루었는지와 같이 그 과정에서 배운 내용은 사용자가 직접 기록하지 않는 한 다음 세션이 시작될 때 사라지는 컨텍스트입니다. 트랜스크립트에는 턴이 남아 있지만, 결론은 여러 곳에 흩어져 있습니다.

MemoryLake는 결과, 성공적인 접근 방식, 미결 항목 등 프로젝트 컨텍스트를 한 곳에서 관리하고 ChatGPT, Claude Code, Codex 등 연결된 어시스턴트가 사용할 수 있게 해주는 메모리 레이어입니다.

사용자는 자신의 언어로 직접 항목을 작성합니다. Claude Code 세션, 트랜스크립트, 목표, 설정 파일 또는 벤더의 저장소에서 내용을 읽거나 쓰거나 삭제하지 않습니다. /goal은 Anthropic이 설명한 방식 그대로 작동합니다.

1단계: API 키 생성

로그인 후 대시보드에서 키를 생성합니다. 다른 자격 증명과 마찬가지로 리포지토리 외부에 저장하세요.

새 키가 생성되고 에이전트에서 사용하기 위해 복사되는 API 키 화면을 보여주는 MemoryLake 콘솔
새 키가 생성되고 에이전트에서 사용하기 위해 복사되는 API 키 화면을 보여주는 MemoryLake 콘솔

2단계: 첫 번째 메모리 업로드

해결책의 4단계에서 작성한 내용, 즉 각 목표가 생성한 결과부터 시작하세요. 항목당 하나의 목표를 기록합니다.

첫 번째 문서가 업로드되어 각 파일이 검색 가능한 메모리로 나열된 MemoryLake 워크스페이스
첫 번째 문서가 업로드되어 각 파일이 검색 가능한 메모리로 나열된 MemoryLake 워크스페이스

3단계: AI 및 에이전트 연결

Claude Code, Codex 및 사용하는 다른 어시스턴트를 연결하세요. 다음 세션은 동일한 결과물에서 시작할 수 있습니다.

메모리 레이어에 연결할 수 있는 AI 클라이언트 및 에이전트 프레임워크가 나열된 MemoryLake 통합 화면
메모리 레이어에 연결할 수 있는 AI 클라이언트 및 에이전트 프레임워크가 나열된 MemoryLake 통합 화면

실제 작업에서의 변화

첫 번째 차이점은 더 나은 다음 목표입니다. 이전 목표가 발견한 내용을 바탕으로 조건을 작성할 수 있습니다.

두 번째는 반복되는 실패의 감소입니다. 불안정한 테스트나 막다른 길에 대한 기록이 남습니다.

세 번째는 도구 간의 일관성입니다. Claude Code와 다른 어시스턴트에서 동일한 결과를 활용할 수 있습니다.

Claude Code /goal 사용을 위한 모범 사례

확인 과정을 가시화하세요. 평가기는 대화 내용만 볼 수 있습니다.

하나의 종료 상태를 유지하세요. 측정 가능한 조건이 가장 효과적입니다.

장기 목표에 제한을 두세요. 턴 또는 시간 절을 추가하세요.

무인 실행에는 자동 모드를 사용하세요. 목표가 권한을 변경하지 않습니다.

목표를 의도적으로 해제하세요. 재개 시 활성 목표가 다시 나타납니다.

적절한 도구를 선택하세요. 시간 간격에는 /loop를, 결정론적 확인에는 Stop hook을 사용하세요.

결론

/goal은 조건이 충족될 때까지 Claude Code가 여러 턴에 걸쳐 작업하도록 유지합니다. 이는 세션 범위의 프롬프트 기반 Stop hook입니다. 각 턴이 끝난 후, 작고 빠른 모델이 조건과 대화 내용을 읽고 목표가 충족되었는지, 아직 충족되지 않았는지, 아니면 불가능한지를 결정합니다. 평가기는 명령을 실행하거나 파일을 읽지 않으므로, 조건에는 대화에 결과가 나타나는 확인 방법을 명시해야 합니다.

세션 종료 시 활성화되어 있던 목표는 모든 재개 경로에서 복구되며, 이때 턴 수, 타이머 및 토큰 기준점은 초기화됩니다. 백그라운드 작업은 평가를 지연시키고, 사용자가 수정해야 하는 오류는 목표를 해제하며, 그 외의 오류는 설정을 유지합니다. 시간 간격 기반 작업에는 /loop를 사용하고, 모든 세션에 적용되어야 하는 결정론적 확인에는 Stop hook을 사용하세요.

자주 묻는 질문

Claude Code에서 /goal은 무엇을 하나요?

설정한 조건이 충족되거나 다른 이유로 목표가 해제될 때까지 Claude가 여러 턴에 걸쳐 계속 작업하게 합니다.

Claude Code는 목표 달성 여부를 어떻게 결정하나요?

매 턴이 끝난 후, 작고 빠른 모델이 대화 내용을 바탕으로 조건을 판단합니다.

/goal 평가기가 내 파일을 읽거나 테스트를 실행할 수 있나요?

아니요. Claude가 대화 중에 드러낸 내용만을 바탕으로 판단합니다.

세션을 재개해도 목표가 유지되나요?

네. Claude Code는 모든 재개 경로에서 활성 목표를 복구합니다.

목표를 어떻게 중단하나요?

/goal clear를 실행하세요. /clear를 실행하는 것도 활성 목표를 제거합니다.

/goal과 /loop의 차이점은 무엇인가요?

/goal은 조건이 충족될 때까지 매 턴 이후에 계속됩니다. /loop는 정해진 시간 간격마다 프롬프트를 실행합니다.

한 번에 여러 개의 목표를 가질 수 있나요?

아니요. 세션당 하나의 목표만 활성화될 수 있습니다.