인계하고 다시 시작

에이전트에게 새 컨텍스트를,
흐름은 잃지 않고

작업을 시작한 지 세 시간, 컨텍스트는 오래된 로그와 포기한 시도로 가득하고 에이전트는 자기가 내린 결정을 잊기 시작합니다. 깨끗하게 다시 시작했으면 좋겠지만, 처음부터는 아닙니다.

인계하고 다시 시작은 이 인계를 대신 해 줍니다. 에이전트가 프로젝트 파일에 현재 상황을 적고, 콘솔이 같은 탭에서 새 대화를 시작하며, 첫 메시지가 그 파일을 읽고 이어서 하라고 알려 줍니다. 클릭 한 번, 확인 한 번. Claude Code, Codex, 그리고 AgentsRoom 도구가 있는 모든 에이전트 CLI에서 작동합니다.

실행 중인 에이전트에서 연 AgentsRoom 에이전트 우클릭 메뉴: Fork 아래에 Hand over and restart와 그 설명, 에이전트가 인계 노트를 작성한 뒤 새 대화로 다시 시작한다는 내용
실행 중인 에이전트를 우클릭하세요: 인계하고 다시 시작이 메뉴에 있습니다. 컴퓨터에서도 휴대폰에서도 마찬가지입니다.

긴 세션은 닳습니다. 에이전트가 읽은 파일, 출력한 테스트 로그, 시도했다가 버린 접근 방식이 모두 컨텍스트 창에 남습니다. 어느 순간 쓸모 있는 부분, 즉 결정과 계획이 나머지 아래에 묻히고 답변의 질이 떨어집니다.

흔한 해결책은 수동 인계입니다. 에이전트에게 요약을 파일로 쓰게 하고, /clear를 입력한 뒤, 새 대화에 그 요약을 읽으라고 알려 주는 첫 메시지를 붙여넣습니다. 효과는 있고, 이를 빠르게 하려고 핸드오프용 스킬과 프롬프트를 만드는 사람도 있지만, 그래도 하던 일에서 손을 떼야 합니다. 에이전트마다 세 단계를, 매번 말이죠.

AgentsRoom에서는 메뉴 항목 하나입니다. 자기 컨텍스트에서 무엇이 중요한지 아는 것은 에이전트 자신이므로, 인계 노트는 에이전트가 직접 쓰고 턴이 끝나면 스스로 다시 시작합니다. 여러분이 쥐고 있는 것은 하나, 새 대화가 시작되는 첫 메시지입니다.

실제 앱에서 촬영: Claude Code 에이전트가 세 단계 리팩터링 중 1단계와 2단계를 마친 뒤, 에이전트를 우클릭해 인계하고 다시 시작을 고르고 한 번 확인합니다. 에이전트는 지금 어디까지 했는지, 무엇을 결정했는지, 무엇이 남았는지를 프로젝트 파일에 쓰고, 콘솔은 같은 탭에서 새 대화로 다시 시작합니다. 그 파일을 읽고 3단계로 이어 가며, 테스트 5개 중 5개가 통과합니다.

YouTube에서 보기

인계하고 다시 시작이 하는 일

처음부터가 아니라, 에이전트가 알던 것에서 출발하는 깨끗한 컨텍스트.

세 단계 대신 클릭 한 번

실행 중인 에이전트를 우클릭하고 인계하고 다시 시작을 고른 뒤 확인하세요. 입력할 /clear도, 요청할 요약도, 붙여넣을 프롬프트도 없습니다. 콘솔은 같은 탭에서 같은 역할, 같은 CLI, 같은 모델로 다시 시작합니다.

에이전트가 직접 쓰는 인계 노트

에이전트는 현재 상황, 내린 결정, 남은 작업을 프로젝트 파일에 씁니다. 루틴에서 자기 인계 파일을 쓰고 있다면 그 파일에, 아니면 .handoff/latest.md에 씁니다. 파일은 디스크에 남으므로 여러분도 읽을 수 있습니다.

첫 메시지는 에이전트별로 저장

새 대화는 "Read your handover and continue"와 그 뒤의 파일 경로로 시작합니다. 대화 상자에서 바꾸면 그 에이전트용으로 저장되어, 계정의 모든 컴퓨터와 휴대폰에서 쓰입니다.

메시지는 새 대화를 기다립니다

에이전트가 인계를 시작하는 순간부터, 여러분이나 다른 에이전트가 보낸 메시지는 보류되었다가 다음 대화로 전달됩니다. 마지막 순간에 이전 대화로 들어가는 일은 없습니다.

코디네이터는 요청할 뿐, 결정하지 않습니다

프로젝트의 코디네이터 에이전트는 팀원의 컨텍스트가 가득 찼을 때처럼, 팀원에게 인계를 요청할 수 있습니다. 같은 대화 상자가 코디네이터의 이름과 이유와 함께 열리고, 여러분이 인계하고 다시 시작을 클릭할 때까지 아무 일도 일어나지 않습니다.

AgentsRoom 도구가 있는 모든 CLI

다시 시작은 특정 CLI의 명령이 아니라 AgentsRoom 도구를 거치므로, Claude Code, Codex, 그리고 이 도구를 불러오는 다른 에이전트 CLI에서 똑같이 작동합니다. 도구가 없는 CLI는 그렇다고 알려 주며, 그때는 콘솔에 /clear를 직접 입력하면 됩니다.

동작 방식

네 단계 중 여러분이 하는 것은 처음 두 단계뿐입니다.

  1. 1

    에이전트 메뉴 열기

    이 컴퓨터에서 실행 중인 에이전트를 우클릭하고 인계하고 다시 시작을 고르세요. 휴대폰에서는 에이전트를 길게 누르고 같은 항목을 고르면 됩니다.

  2. 2

    첫 메시지 확인하기

    대화 상자에 다음 대화의 첫 메시지가 표시되며, 기본값은 "Read your handover and continue"입니다. 이 에이전트에게 다른 지시가 필요하면 수정하세요. 다음번을 위해 저장됩니다. 그런 다음 인계하고 다시 시작을 클릭합니다.

  3. 3

    에이전트가 인계 노트 작성

    AgentsRoom이 에이전트에게 프로젝트 파일에 인계 노트를 쓰고 턴을 마치라고 요청합니다. 이제 이 에이전트에게 오는 메시지는 다음 대화를 기다립니다.

  4. 4

    콘솔이 다시 시작

    턴이 끝나면 콘솔이 같은 탭에서 새 대화로 다시 시작합니다. 첫 메시지가 인계 파일 경로와 함께 대신 전송되고, 에이전트는 멈췄던 곳에서 작업을 이어 갑니다.

AgentsRoom Hand over and restart 대화 상자: 에이전트가 프로젝트 파일에 인계 노트를 작성한 뒤 같은 탭에서 다시 시작한다는 설명, Read your handover and continue가 입력된 First message of the next conversation 입력란, Cancel과 Hand over and restart 버튼
확인은 한 번이면 됩니다. 다음 대화의 첫 메시지는 이 에이전트용으로 저장되고, 에이전트가 인계 파일 경로를 덧붙입니다.

인계, /compact, /clear 중 무엇을?

/clear는 대화 전체를 버립니다. 작업이 끝났고 다음 작업이 전혀 다를 때는 맞는 도구지만, 작업 도중에는 틀린 도구입니다. 에이전트가 알던 모든 것이 함께 사라지기 때문입니다.

/compact는 같은 세션 안에서 대화를 CLI가 쓴 요약으로 바꿉니다. 무엇이 남을지 여러분이 고르지 못하고, 요약은 컨텍스트 안에만 존재하며, 여러 번 압축된 긴 세션에는 요약의 요약이 남습니다.

인계하고 다시 시작은 그 중간입니다. 에이전트가 직접 인계 노트를 여러분이 읽고 고칠 수 있는 파일로 쓰고, 새 대화는 컨텍스트에 그것 말고는 아무것도 없이 시작합니다. 끝나지 않았지만 컨텍스트가 닳아 버린 작업에 쓰는 수입니다. 에이전트가 적지 않은 것은 이전 대화와 함께 사라지므로, 중요한 작업이라면 파일을 한번 훑어볼 만합니다.

제한 사항

  • 에이전트가 스스로 다시 시작하려면 AgentsRoom 도구(MCP)가 필요합니다. 이 도구를 불러오지 않는 CLI는 그럴 수 없으며, 대신 /clear를 입력하라고 안내합니다.
  • 다시 시작은 에이전트의 턴이 끝나기를 기다립니다. 에이전트가 작업 중이라 지금은 다시 시작할 수 없다고 나오면, 답변이 끝난 뒤 다시 시도하세요.
  • 실행 중인 Agent Team의 단계, QA 테스트 중, 프로젝트의 터미널이 다른 창에 표시되어 있을 때는 이유를 알려 주는 메시지와 함께 거부됩니다. 터미널은 먼저 메인 창으로 다시 가져오세요.
  • 에이전트마다 2분에 한 번, 시간당 6번까지 다시 시작할 수 있어, 루프에 갇힌 루틴이 에이전트를 끝없이 다시 시작하지 못합니다.
  • 이 항목은 이 컴퓨터에서 실행 중인 에이전트에만 표시됩니다. 계정의 다른 머신에서 실행 중인 에이전트나 프로젝트 어시스턴트에는 표시되지 않습니다.
  • 에이전트가 인계 노트에 적지 않은 것은 이전 대화와 함께 사라집니다.

자주 묻는 질문

다른 질문하기
진행 상황을 잃지 않고 Claude Code 에이전트에게 새 컨텍스트를 주려면 어떻게 하나요?
AgentsRoom에서 에이전트를 우클릭하고 인계하고 다시 시작을 고르세요. 에이전트가 프로젝트 파일에 인계 노트를 쓰고, 콘솔이 그 파일을 읽는 것으로 시작하는 새 대화로 다시 시작합니다. /clear를 입력하거나 프롬프트를 붙여넣을 필요가 없고, 같은 동작이 Codex와 AgentsRoom 도구를 불러오는 다른 에이전트 CLI에서도 작동합니다.
/compact와 무엇이 다른가요?
/compact는 CLI에게 같은 세션 안에서 대화를 자기 요약으로 바꾸게 하며, 무엇이 남을지 여러분이 고르지 못합니다. 인계하고 다시 시작은 에이전트가 여러분이 읽을 수 있는 파일에 인계 노트를 쓰게 한 뒤, 그것을 읽는 깨끗한 대화를 시작합니다. 빠르게 이어 가려면 /compact를, 컨텍스트가 닳아서 무엇을 넘길지 직접 정하고 싶다면 인계를 쓰세요.
인계 파일은 어디에 저장되나요?
프로젝트 안입니다. 에이전트는 루틴에서 자기 인계 파일을 쓰고 있다면 그 파일을, 아니면 .handoff/latest.md를 쓰고, 그 경로가 새 대화의 첫 메시지에 추가됩니다. 다시 시작한 뒤에도 디스크에 남으므로 열어 보거나, 고치거나, 다른 에이전트에게 알려 줄 수 있습니다.
새 대화의 첫 메시지를 바꿀 수 있나요?
네. 대화 상자에 다음 대화의 첫 메시지 입력란이 있고, 기본값은 "Read your handover and continue"입니다. 여기에 입력한 내용은 그 에이전트용으로 저장되어 계정의 모든 컴퓨터와 휴대폰에서 그대로 쓰입니다. 비워 두면 기본 메시지로 돌아갑니다.
에이전트가 스스로 인계하고 다시 시작할 수 있나요?
에이전트는 AgentsRoom 도구의 agents_restart 도구로 자기 콘솔을 다시 시작할 수 있습니다. 예를 들어 컨텍스트가 너무 차면 체크포인트를 쓰는 루틴에서 쓸 수 있습니다. 프로젝트의 코디네이터 에이전트도 팀원에게 인계를 요청할 수 있지만, 승인은 여러분만 할 수 있습니다. 대화 상자에 누가 왜 요청하는지 표시되며, 코디네이터는 여러분의 선택을 전달받지 않습니다.
Codex와 다른 CLI에서도 작동하나요?
네, AgentsRoom 도구를 불러오는 모든 에이전트 CLI에서 작동합니다. 다시 시작이 특정 CLI 전용 명령이 아니라 이 도구를 거치기 때문입니다. 도구를 불러오지 않는 CLI라면 그렇다고 알려 주며, 그 콘솔에 /clear를 직접 입력하면 됩니다.
왜 에이전트가 지금은 다시 시작할 수 없다고 나오나요?
메시지에 이유가 나와 있습니다. 에이전트가 턴 도중일 수 있으니 답변을 기다리세요. 실행 중인 Agent Team의 단계이거나 QA 테스트 중이라면 거부됩니다. 터미널이 다른 창에 표시되어 있다면 메인 창으로 다시 가져오세요. 아니면 2분에 한 번, 시간당 6번이라는 다시 시작 한도에 도달한 것입니다.

더 알아보기

이런 것도 좋아할 수 있습니다

DevOps 엔지니어콘텐츠 에디터프론트엔드 개발자영업 담당자백엔드 개발자코치·트레이너소프트웨어 아키텍트법무 담당QA 엔지니어재무·총무풀스택 개발자크리에이티브 디자이너모바일 개발자리서처보안 엔지니어인사·채용
프로젝트 매니저번역가Git 전문가데이터 분석가SEO 전문가회계 담당자로컬라이제이션 전문가홍보·PR브레인스토머운영·물류마케팅 전문가고객 지원프로젝트 어시스턴트구매 담당자커뮤니티 매니저개인 비서

기억은 그대로, 새 출발을 에이전트에게

인계하고 다시 시작은 macOS, Windows, Linux용 AgentsRoom에 있으며, 무료로 다운로드할 수 있습니다.

AgentsRoom 다운로드무료

컴패니언 앱: 이동 중에도 에이전트를 모니터링

Claude, Codex, Antigravity CLI 또는 다른 AI 공급자를 사용하세요.

확장 프로그램 설치
Chrome Web Store

버그와 요청을 공개 백로그로 바로 보내세요.

대화처럼 읽는 에이전트

에이전트마다 역할과 얼굴이 있고, 메신저 앱처럼 스레드를 읽을 수 있습니다.

대화 보기

AgentsRoom 대화 보기: AI 코딩 에이전트의 작업이 채팅 스레드로 표시된 화면
멀티 프로젝트
멀티 프로바이더
멀티 에이전트
실시간 상태
파일 diff & 커밋
모바일 앱
라이브 프리뷰
에이전트 팀
브라우저 자동화
백로그 기반 개발
프롬프트 라이브러리
스킬 라이브러리
모든 기능 보기