콘텐츠로 이동

세션 중단과 재개

에이전트가 잘못된 방향으로 가고 있거나, 끝없이 기다리고 있거나, 추가 지시가 필요할 때 이 컨트롤을 사용합니다. 이 컨트롤은 기존 대화에 적용됩니다. 새 대화를 만들려면 원격 에이전트에서 작업 시작을 사용하세요.

Chorus daemon이 아닌 원래 Hermes 게이트웨이를 복구합니다. Interrupt는 게이트웨이 작업을 취소하고 Resume은 Hermes 연속 턴 지원 서버가 필요하며 원래 저장소를 사용합니다. 재개 전 부분 변경을 확인하세요.

백그라운드 자식 에이전트(0.22.0)

섹션 제목: “백그라운드 자식 에이전트(0.22.0)”

Claude daemon 실행은 주 턴 이후 기본 60분(3600000 ms) 동안 자식을 기다립니다. CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS가 CHORUS_CLAUDE_BG_WAIT_CEILING_MS보다 우선하며 전체 실행 제한이 아닙니다. 부모는 완료 결과를 수집하거나 자식을 명시적으로 중지한 뒤 턴을 끝내야 합니다. 강제 종료된 자식이 있으면 실제 종료 코드가 0이어도 비정상이며 시작점 아이디어나 작업에 댓글을 게시하려고 합니다. 상태 복구나 새 자동 재시도는 없습니다. 0/빈 값 위험, 설정, 진단은 daemon 시간 제한 설정을 참조하세요.

  1. 실행 중인 대화를 엽니다.
  2. 최신 출력을 검토해 중단이 필요한지 확인합니다.
  3. 중단을 선택합니다.
  4. 대화에 실행이 멈췄다고 표시될 때까지 기다립니다.
현재 턴, 경과 시간, 중단 컨트롤을 표시하는 실행 중인 에이전트 대화
실행 중인 대화에는 현재 턴, 경과 시간, 중단 컨트롤이 표시됩니다.

중단은 먼저 에이전트 프로세스에 정상 종료를 요청합니다. 구성된 타임아웃 안에 멈추지 않으면 데몬이 프로세스를 강제로 종료합니다.

실행 중 표시가 사라지지 않을 때

섹션 제목: “실행 중 표시가 사라지지 않을 때”

프로세스가 끝났는데 대화가 계속 실행 중이라면 해당 대화에서 중단을 선택하세요. 활성 실행이 목록에 없어도 이 컨트롤을 사용할 수 있습니다. 중지할 활성 실행이 없으면 Chorus가 턴을 바로 중단됨으로 표시할 수 있고, 활성 실행이 있으면 데몬에 요청을 전달한 뒤 중지 결과를 기다립니다.

Chorus는 턴 종료 보고가 일시적으로 실패하면 다시 보고하며, 에이전트 프로세스가 끝나면 그 프로세스가 시작한 백그라운드 프로세스가 아직 실행 중이더라도 에이전트가 종료된 것으로 처리합니다. 이 중 어느 것도 턴의 실행 시간을 제한하지 않지만, 백엔드별 제한은 여전히 적용됩니다. DeepSeek Harness(dsh)는 기본적으로 턴당 30분이며 CHORUS_DSH_TIMEOUT_MS로 변경할 수 있습니다. 재개하기 전에 마지막 출력과 남아 있는 프로세스를 확인하세요.

Chorus 0.21.0부터 시작이나 실행에 실패하면 에이전트가 응답하지 않아도 해당 대화 턴에 에이전트 시작 또는 실행 실패 요약이 표시됩니다. 제공되는 경우 오류 세부 정보 펼치기를 선택해 수집된 진단 출력, 종료 코드, 신호를 확인하세요. 진단은 턴에 저장되므로 새로고침하거나 대화를 다시 열어도 볼 수 있습니다.

항상 세부 정보가 있는 것은 아닙니다. 이전 턴이나 진단이 수집되지 않은 실패에는 일반 설명을 표시하며, 사용자가 요청한 중단은 충돌이 아닙니다. 요약에 따라 작업 디렉터리, 백엔드 로그인·모델 설정, 인증 정보를 확인하고 필요하면 chorus daemon logs를 사용하세요. 실패해도 파일이나 외부 작업은 되돌려지지 않으므로 재개 전에 부분 변경을 확인하세요. 진단에 민감한 정보가 포함될 수 있으니 공유 전에 가리세요.

재개하기 전에 다음을 확인합니다.

  • 에이전트의 최종 출력과 오류 세부 정보를 읽습니다.
  • 변경된 파일과 실행 중인 프로세스(있는 경우)를 살펴봅니다.
  • 그대로 이어 갈지, 수정한 지시를 줄지, 아니면 평소의 버전 관리 워크플로로 부분 변경을 버릴지 결정합니다.

첫 세션이 무엇을 바꿨는지 파악하기 전에는 같은 디렉터리에서 두 번째 세션을 시작하지 마세요.

대화가 중단되었거나 크래시 후 복구할 수 있는 상태라면 다음과 같이 합니다.

  1. 원래 데몬 연결이 오프라인이면 복구합니다.
  2. 같은 대화를 엽니다.
  3. 수정 사항이나 빠진 맥락이 있으면 추가합니다.
  4. 재개를 선택합니다.

재개는 원래의 에이전트 연결과 작업 디렉터리를 사용합니다. 세션을 다른 컴퓨터나 디렉터리로 옮기지 않습니다. 원래 런타임을 되살릴 수 없다면 새 세션을 직접 시작하고, 이전 시도의 관련 맥락을 함께 전달하세요.

실패가 반복되면 에이전트 연결 문제 해결을 참고하세요.

UI의 재개 버튼 대신 자신의 터미널에서 대화를 이어 갈 수도 있습니다. 대화를 열고 기록 헤더에서 세션 ID 복사를 선택합니다. 에이전트 CLI가 재개할 때 쓰는 세션 ID가 복사되므로, 수동으로 재개해도 새 대화가 시작되지 않고 같은 대화로 돌아갑니다.

대화가 실행되던 작업 디렉터리에서, 복사한 세션 ID를 백엔드의 재개 명령에 넘깁니다.

  • Claude Code — claude --resume <sessionId>
  • Codex — codex exec resume <thread_id>
  • Kiro — kiro-cli chat --resume-id <sessionId>

백엔드마다 ID 형식이 다르며, 복사되는 값은 해당 백엔드가 받아들이는 형식입니다. 정확한 명령은 각 플랫폼의 참고 문서(Claude Code, Codex, Kiro)를 확인하세요.

Chorus는 아이디어마다 세션을 하나만 유지합니다. 다른 작업 디렉터리에서 그 아이디어의 작업을 시작하면 Chorus는 새 세션을 만들지 않고 이 세션을 그곳으로 옮깁니다. 따라서 마지막에 어디서 실행되었든 이어받을 대화는 언제나 하나뿐입니다. 전체 구조는 온라인 에이전트 개요를 참고하세요.