에이전트에게 새 컨텍스트를,
흐름은 잃지 않고
작업을 시작한 지 세 시간, 컨텍스트는 오래된 로그와 포기한 시도로 가득하고 에이전트는 자기가 내린 결정을 잊기 시작합니다. 깨끗하게 다시 시작했으면 좋겠지만, 처음부터는 아닙니다.
인계하고 다시 시작은 이 인계를 대신 해 줍니다. 에이전트가 프로젝트 파일에 현재 상황을 적고, 콘솔이 같은 탭에서 새 대화를 시작하며, 첫 메시지가 그 파일을 읽고 이어서 하라고 알려 줍니다. 클릭 한 번, 확인 한 번. Claude Code, Codex, 그리고 AgentsRoom 도구가 있는 모든 에이전트 CLI에서 작동합니다.

긴 세션은 닳습니다. 에이전트가 읽은 파일, 출력한 테스트 로그, 시도했다가 버린 접근 방식이 모두 컨텍스트 창에 남습니다. 어느 순간 쓸모 있는 부분, 즉 결정과 계획이 나머지 아래에 묻히고 답변의 질이 떨어집니다.
흔한 해결책은 수동 인계입니다. 에이전트에게 요약을 파일로 쓰게 하고, /clear를 입력한 뒤, 새 대화에 그 요약을 읽으라고 알려 주는 첫 메시지를 붙여넣습니다. 효과는 있고, 이를 빠르게 하려고 핸드오프용 스킬과 프롬프트를 만드는 사람도 있지만, 그래도 하던 일에서 손을 떼야 합니다. 에이전트마다 세 단계를, 매번 말이죠.
AgentsRoom에서는 메뉴 항목 하나입니다. 자기 컨텍스트에서 무엇이 중요한지 아는 것은 에이전트 자신이므로, 인계 노트는 에이전트가 직접 쓰고 턴이 끝나면 스스로 다시 시작합니다. 여러분이 쥐고 있는 것은 하나, 새 대화가 시작되는 첫 메시지입니다.
실제 앱에서 촬영: Claude Code 에이전트가 세 단계 리팩터링 중 1단계와 2단계를 마친 뒤, 에이전트를 우클릭해 인계하고 다시 시작을 고르고 한 번 확인합니다. 에이전트는 지금 어디까지 했는지, 무엇을 결정했는지, 무엇이 남았는지를 프로젝트 파일에 쓰고, 콘솔은 같은 탭에서 새 대화로 다시 시작합니다. 그 파일을 읽고 3단계로 이어 가며, 테스트 5개 중 5개가 통과합니다.
인계하고 다시 시작이 하는 일
처음부터가 아니라, 에이전트가 알던 것에서 출발하는 깨끗한 컨텍스트.
세 단계 대신 클릭 한 번
실행 중인 에이전트를 우클릭하고 인계하고 다시 시작을 고른 뒤 확인하세요. 입력할 /clear도, 요청할 요약도, 붙여넣을 프롬프트도 없습니다. 콘솔은 같은 탭에서 같은 역할, 같은 CLI, 같은 모델로 다시 시작합니다.
에이전트가 직접 쓰는 인계 노트
에이전트는 현재 상황, 내린 결정, 남은 작업을 프로젝트 파일에 씁니다. 루틴에서 자기 인계 파일을 쓰고 있다면 그 파일에, 아니면 .handoff/latest.md에 씁니다. 파일은 디스크에 남으므로 여러분도 읽을 수 있습니다.
첫 메시지는 에이전트별로 저장
새 대화는 "Read your handover and continue"와 그 뒤의 파일 경로로 시작합니다. 대화 상자에서 바꾸면 그 에이전트용으로 저장되어, 계정의 모든 컴퓨터와 휴대폰에서 쓰입니다.
메시지는 새 대화를 기다립니다
에이전트가 인계를 시작하는 순간부터, 여러분이나 다른 에이전트가 보낸 메시지는 보류되었다가 다음 대화로 전달됩니다. 마지막 순간에 이전 대화로 들어가는 일은 없습니다.
코디네이터는 요청할 뿐, 결정하지 않습니다
프로젝트의 코디네이터 에이전트는 팀원의 컨텍스트가 가득 찼을 때처럼, 팀원에게 인계를 요청할 수 있습니다. 같은 대화 상자가 코디네이터의 이름과 이유와 함께 열리고, 여러분이 인계하고 다시 시작을 클릭할 때까지 아무 일도 일어나지 않습니다.
AgentsRoom 도구가 있는 모든 CLI
다시 시작은 특정 CLI의 명령이 아니라 AgentsRoom 도구를 거치므로, Claude Code, Codex, 그리고 이 도구를 불러오는 다른 에이전트 CLI에서 똑같이 작동합니다. 도구가 없는 CLI는 그렇다고 알려 주며, 그때는 콘솔에 /clear를 직접 입력하면 됩니다.
동작 방식
네 단계 중 여러분이 하는 것은 처음 두 단계뿐입니다.
- 1
에이전트 메뉴 열기
이 컴퓨터에서 실행 중인 에이전트를 우클릭하고 인계하고 다시 시작을 고르세요. 휴대폰에서는 에이전트를 길게 누르고 같은 항목을 고르면 됩니다.
- 2
첫 메시지 확인하기
대화 상자에 다음 대화의 첫 메시지가 표시되며, 기본값은 "Read your handover and continue"입니다. 이 에이전트에게 다른 지시가 필요하면 수정하세요. 다음번을 위해 저장됩니다. 그런 다음 인계하고 다시 시작을 클릭합니다.
- 3
에이전트가 인계 노트 작성
AgentsRoom이 에이전트에게 프로젝트 파일에 인계 노트를 쓰고 턴을 마치라고 요청합니다. 이제 이 에이전트에게 오는 메시지는 다음 대화를 기다립니다.
- 4
콘솔이 다시 시작
턴이 끝나면 콘솔이 같은 탭에서 새 대화로 다시 시작합니다. 첫 메시지가 인계 파일 경로와 함께 대신 전송되고, 에이전트는 멈췄던 곳에서 작업을 이어 갑니다.

인계, /compact, /clear 중 무엇을?
/clear는 대화 전체를 버립니다. 작업이 끝났고 다음 작업이 전혀 다를 때는 맞는 도구지만, 작업 도중에는 틀린 도구입니다. 에이전트가 알던 모든 것이 함께 사라지기 때문입니다.
/compact는 같은 세션 안에서 대화를 CLI가 쓴 요약으로 바꿉니다. 무엇이 남을지 여러분이 고르지 못하고, 요약은 컨텍스트 안에만 존재하며, 여러 번 압축된 긴 세션에는 요약의 요약이 남습니다.
인계하고 다시 시작은 그 중간입니다. 에이전트가 직접 인계 노트를 여러분이 읽고 고칠 수 있는 파일로 쓰고, 새 대화는 컨텍스트에 그것 말고는 아무것도 없이 시작합니다. 끝나지 않았지만 컨텍스트가 닳아 버린 작업에 쓰는 수입니다. 에이전트가 적지 않은 것은 이전 대화와 함께 사라지므로, 중요한 작업이라면 파일을 한번 훑어볼 만합니다.
제한 사항
- 에이전트가 스스로 다시 시작하려면 AgentsRoom 도구(MCP)가 필요합니다. 이 도구를 불러오지 않는 CLI는 그럴 수 없으며, 대신 /clear를 입력하라고 안내합니다.
- 다시 시작은 에이전트의 턴이 끝나기를 기다립니다. 에이전트가 작업 중이라 지금은 다시 시작할 수 없다고 나오면, 답변이 끝난 뒤 다시 시도하세요.
- 실행 중인 Agent Team의 단계, QA 테스트 중, 프로젝트의 터미널이 다른 창에 표시되어 있을 때는 이유를 알려 주는 메시지와 함께 거부됩니다. 터미널은 먼저 메인 창으로 다시 가져오세요.
- 에이전트마다 2분에 한 번, 시간당 6번까지 다시 시작할 수 있어, 루프에 갇힌 루틴이 에이전트를 끝없이 다시 시작하지 못합니다.
- 이 항목은 이 컴퓨터에서 실행 중인 에이전트에만 표시됩니다. 계정의 다른 머신에서 실행 중인 에이전트나 프로젝트 어시스턴트에는 표시되지 않습니다.
- 에이전트가 인계 노트에 적지 않은 것은 이전 대화와 함께 사라집니다.
자주 묻는 질문
다른 질문하기진행 상황을 잃지 않고 Claude Code 에이전트에게 새 컨텍스트를 주려면 어떻게 하나요?
/compact와 무엇이 다른가요?
인계 파일은 어디에 저장되나요?
새 대화의 첫 메시지를 바꿀 수 있나요?
에이전트가 스스로 인계하고 다시 시작할 수 있나요?
Codex와 다른 CLI에서도 작동하나요?
왜 에이전트가 지금은 다시 시작할 수 없다고 나오나요?
더 알아보기
이런 것도 좋아할 수 있습니다
에이전트 포크
실행 중인 AI 에이전트를 클릭 한 번으로 포크하면 대화 전체를 그대로 가진 쌍둥이가 생깁니다: 같은 역할, 같은 CLI, 같은 컨텍스트. 또는 에이전트가 보지 못하는 버블에서 곁다리 질문을 던져, 그 터미널을 뺏지 않고 답을 받으세요.
토큰 사용량: 세션별: 실시간
AgentsRoom의 모든 Claude Code 세션에 실시간 토큰 미터를 제공합니다. 빨간색 과다 사용 경고, 캐시 적중률, 입력·출력·캐시 전체 내역까지. 100% 로컬. macOS, Windows, Linux에서 무료.
MCP : 에이전트 조종 가능 : 수동 또는 자동
MCP 서버 4개로 Claude Code, Codex를 비롯한 CLI가 AgentsRoom 자체를 조종합니다. 백로그를 읽고, dev 명령을 실행하고, 프롬프트 라이브러리를 쓰고, 내장 브라우저를 조작합니다.
기억은 그대로, 새 출발을 에이전트에게
인계하고 다시 시작은 macOS, Windows, Linux용 AgentsRoom에 있으며, 무료로 다운로드할 수 있습니다.
컴패니언 앱: 이동 중에도 에이전트를 모니터링
Claude, Codex, Antigravity CLI 또는 다른 AI 공급자를 사용하세요.
버그와 요청을 공개 백로그로 바로 보내세요.
