Claude Code 세션: 2.1.224의 자체 호스팅 환경 및 세션 메시징

Claude Code 세션: 시작, 계속하기, 재개

먼저 대화를 새로 시작하는 것, 디렉터리의 최신 대화를 계속하는 것, 특정 이전 대화를 선택하는 것을 구분해야 합니다. 각 작업에는 서로 다른 명령이 사용되므로, 작업과 관련된 대화가 여러 개라면 올바른 명령을 선택하는 것이 중요합니다.

이 공식 CLI 참조 문서 에는 기본 진입 방법이 설명되어 있습니다.

최신 대화 계속하기

계속하려는 대화가 현재 디렉터리에서 가장 최근 대화라면 continue 명령을 사용하세요.

claude --continue

짧은 형식은 다음과 같습니다.

claude -c

디렉터리라는 조건이 중요합니다. 문서에 명시된 동작은 가장 최근 대화를 불러오는 것이며, 그 범위는 현재 디렉터리입니다. 따라서 “continue”를 어느 위치에서든 마지막으로 사용한 대화를 선택하는 전역 선택 기능으로 해석해서는 안 됩니다.

선택한 대화 재개

이전 대화 중에서 선택하려면 다음을 사용하세요.

claude --resume

알고 있는 세션을 직접 선택하려면 해당 ID를 입력하세요.

claude --resume <session-id>

대화형 세션 내에서는 /resume 가 선택 화면을 제공합니다. 이 명령들은 서로 다른 필요에 대응합니다. continue는 현재 디렉터리의 최신 대화를 선택하고, resume은 대화형 선택이나 명시적 선택을 제공합니다. 다음 자료는 Claude Code CLI 참조 명령줄 진입 방법 중에서 선택할 때 유용한 보조 자료입니다.

저장된 대화, 이름이 지정된 세션, 실행 중인 세션 검색

세션 선택과 실행 중인 세션 검색은 서로 다른 목적을 갖습니다. 재개 선택 화면은 이전 대화를 선택하는 데 도움을 주며, 실행 중인 세션 명령은 현재 실행 중인 Claude 세션을 나열합니다.

이제 세션 간에 메시지를 주고받을 수 있으므로 이 구분을 명확히 해 두는 것이 특히 유용합니다. 다시 열 대화를 찾는 것과 연락할 실행 중인 세션을 찾는 것은 별개의 작업입니다.

나중에 다시 사용할 대화에 이름 지정하기

이름이 있는 세션은 Claude Code 2.1.224 이전부터 지원되었습니다. 버전 2.0.64에서는 다음을 사용해 대화에 이름을 지정하는 기능이 도입되었습니다: /rename 그리고 이름으로 다시 열 수 있습니다.

대화에 이름을 지정하면 CLI에서 해당 대화를 선택할 수 있습니다:

claude --resume <name>

다음도 사용할 수 있습니다: /resume <name> 세션 내에서 사용할 수 있습니다. 이름은 세션 ID 및 대화형 선택 도구와 함께 대화를 식별하는 또 다른 방법입니다.

예를 들어 이름을 사용하더라도 계속하기와 재개의 선택 기준은 동일합니다. 계속하기는 현재 디렉터리의 가장 최근 대화를 선택하고, 이름을 지정한 재개는 지정한 대화를 선택합니다. 이름 지정은 다음에 대해 문서화된 선택 동작을 바꾸지 않습니다: --continue.

실행 중인 세션 목록 조회하기

실행 중인 세션을 프로그래밍 방식으로 검색하려면 다음을 사용하세요:

claude agents --json

v2.1.145에서 도입된 이 명령은 실행 중인 Claude 세션을 JSON 형식으로 나열합니다. 이전 대화 중 무엇을 다시 열지보다 어떤 세션이 실행 중인지 바로 확인해야 할 때 유용합니다.

이 버전이 명시된 변경 로그 에는 이름이 있는 세션 지원과 실행 중인 세션 목록 조회 명령이 모두 기록되어 있습니다. 두 기능 모두 2.1.224에서 처음 등장한 것은 아닙니다. 새 메시징 기능과 함께 사용할 수 있는 기존 세션 관리 도구입니다.

Claude Code 2.1.224의 자체 호스팅 환경

이 v2.1.224 릴리스 에서 도입한 기능은 claude self-hosted-runner입니다. 조직은 이를 통해 웹, 모바일 및 데스크톱 인터페이스에서 시작한 Claude Code 세션을 자체 머신이나 컨테이너에서 실행할 수 있습니다.

릴리스에 명시된 명령은 다음과 같습니다:

claude self-hosted-runner

사용 가능한 요금제는 Team 및 Enterprise 요금제입니다. 이는 게시 시점 기준으로 확인된 이 기능의 요금제 요건입니다.

러너로 달라지는 점

러너는 조직이 제공하는 머신이나 컨테이너에서 실행할 수 있는 옵션을 제공합니다. 릴리스에 명시된 지원 세션 인터페이스는 웹, 모바일 및 데스크톱입니다.

이 범위가 Claude Code 자체 호스팅 환경 발표의 핵심입니다. 해당 세션을 어디에서 실행할 수 있는지, 어떤 요금제에서 이 기능을 사용할 수 있는지 설명합니다. 확인된 자료에는 완전한 배포 절차가 제공되어 있지 않습니다.

이 기능이 Claude Code 사용 방식에 어떻게 맞는지 평가하고 있다면, 웹 및 데스크톱 가이드 에서 해당 인터페이스를 살펴볼 수 있습니다. 이번 릴리스에서는 실행 기능, 지원 인터페이스 범위, 이용 가능한 요금제를 별개의 평가 항목으로 다루세요.

아직 확인되지 않은 사항

릴리스에는 별도의 러너 가격, 세션당 요금 또는 자체 호스팅 세션 할당량이 제시되어 있지 않습니다. 또한 이 문서에 활용할 수 있는 자료에는 상세한 배포 플래그나 검증된 구성 예제가 명시되어 있지 않습니다.

이러한 정보의 공백은 배포를 계획할 때 중요합니다. 문서화된 명령은 기능의 진입점을 알려 주지만, 완전한 설정 절차나 비용 모델을 추론하기에는 충분하지 않습니다. 러너 요금이나 세션 허용량에 대한 추정은 제공된 릴리스 정보의 범위를 벗어납니다.

세션 간 메시징과 수신 메시지 승인

버전 2.1.224에서는 세션 간 SendMessage기능을 추가하며, ListAgents 을 검색에 사용합니다. 지원 플랫폼은 macOS 및 Linux입니다. 릴리스에서는 “사용자의 어떤 머신에서든” 세션에 메시지를 보낼 수 있다고 설명합니다.

이 표현은 릴리스 설명에서 머신 간 메시징을 지원함을 보여 줍니다. 이 기능에 대한 Windows 지원은 명시되어 있지 않으므로, 여기서 확인된 지원 플랫폼은 macOS와 Linux입니다.

검색과 메시징은 역할이 다릅니다

ListAgents 은 세션 간 메시징을 위한 검색 기능을 제공하고, SendMessage 은 다른 세션에 메시지를 보냅니다. 릴리스에 명시된 기능은 이와 같으며, 확인된 자료에는 호출 예제나 매개변수 스키마가 제공되어 있지 않습니다.

기존의 claude agents --json 명령도 실행 중인 세션을 나열하지만, 문서화되지 않은 다음 기능의 호출을 대신하는 용도로 사용해서는 안 됩니다: ListAgents 하나는 확인된 CLI 명령이고, 다른 하나는 세션 간 메시징과 함께 명시된 검색 기능입니다.

개발자는 이를 통해 저장된 대화 다시 열기, 실행 중인 세션 검색하기, 세션에 메시지 보내기라는 세 가지 세션 작업을 구분할 수 있습니다. 첫 번째 작업에는 재개 명령을 사용하고, 나머지 작업에는 문서화된 검색 또는 메시징 기능을 사용하세요.

수신 메시지에 승인이 필요할 수 있습니다

릴리스에서는 메시징과 함께 두 가지 설정을 추가합니다: crossSessionInbound 및 dialogExpiry또한 승인 여부를 다음과 같이 구분합니다:

• 권한 검사를 우회한 상태로 실행 중인 세션에 보내는 메시지는 사용자 승인을 기다립니다.
• 다른 세션에 보내는 메시지는 자동으로 전달됩니다.

따라서 메시지의 승인 동작은 수신 세션의 권한 모드에 따라 달라집니다. 세션을 조율할 때는 수신 메시지가 승인을 기다리고 있을 가능성을 고려한 후 전달된 것으로 판단하세요.

확인된 릴리스 자료에는 다음 설정의 허용 값, 기본값, 만료 시간 단위 또는 구성 예제가 명시되어 있지 않습니다: crossSessionInbound 및 dialogExpiry이름만으로는 신뢰할 수 있는 설정 파일을 작성하기에 충분하지 않습니다.

이제 전달 실패가 오류로 표시됩니다

릴리스에서는 오해를 유발하던 다음 기능의 결과도 수정합니다: SendMessage 이전에는 팀원의 받은편지함에 쓰기가 실패해도 “메시지가 전송되었습니다”라고 보고할 수 있었습니다. 2.1.224에서는 전달 실패를 오류로 보고합니다.

이 수정은 메시지 결과를 해석할 때 중요합니다. 이제 전달 실패는 오류로 표시되며, 권한 검사를 우회한 상태로 실행 중인 세션의 수신 메시지 승인 규칙은 별도로 고려해야 합니다.

세션 격리, 하위 에이전트 제한 및 Remote Control 수정

주요 추가 기능과 함께 세션 처리 방식도 변경되었습니다. 이러한 수정은 프로젝트 격리, 하위 에이전트 생성, 작업 재개 시 Remote Control 동작에 영향을 줍니다.

긴 프로젝트 경로가 올바르게 해석됩니다

버전 2.1.224에서는 프로젝트 경로가 다음 길이보다 길 때 발생하던 문제를 수정합니다: 200자 이러한 경로가 다른 프로젝트의 세션 디렉터리로 해석되던 문제입니다. 영향을 받던 작업에는 세션 목록 조회, 이름 변경, 분기, 삭제 및 다음이 포함됩니다: /resume.

프로젝트가 깊게 중첩된 경로에 있다면 이 수정이 관련됩니다. 여러 세션 작업을 대상으로 하므로 수정 범위는 재개 선택 도구에만 한정되지 않습니다.

하위 에이전트의 총 생성 상한이 제거됩니다

릴리스에서는 다음 제한을 제거합니다: 세션당 하위 에이전트 200개 생성 상한동시 실행 및 깊이 제한은 계속 적용됩니다.

이들은 서로 다른 제약입니다. 총 생성 상한을 제거해도 동시 활동이나 깊이에 대한 나머지 제한이 제거되지는 않습니다. 하위 에이전트를 사용하는 세션을 평가할 때는 세 개념을 모두 구분하세요. Claude Code 하위 에이전트 가이드 는 코딩 워크플로의 해당 부분에 대한 관련 참고 자료입니다.

재개 시 Remote Control 비활성화 상태가 유지됩니다

사용자가 Remote Control을 비활성화한 후 세션을 재개할 때 더 이상 알림 없이 다시 연결되지 않습니다. 이 수정의 적용 대상은 --resume, SDK 호스트 및 VS Code 확장 프로그램입니다.

VS Code에서는 명시적으로 활성화한 다음 설정이 무시되던 문제도 수정됩니다: remoteControlAtStartup 이러한 변경은 재개 중 비활성화 상태가 덮어써지는 문제와 VS Code에서 명시적으로 활성화한 시작 설정이 무시되는 문제를 모두 해결합니다.

이들은 세션 동작에 대한 수정 사항이며, 재개 워크플로에 추가해야 하는 명령이 아닙니다.

핵심 요점

• Claude Code 2.1.224은 2026년 7월에 출시되어 자체 호스팅 러너와 세션 간 메시징을 추가했습니다.
• 다음을 사용하세요: claude --continue 은 현재 디렉터리의 가장 최근 대화를 선택하며, claude --resume 은 이전 대화를 선택하거나 해당 ID 또는 이름을 지정하는 데 사용합니다.
• claude agents --json 은 실행 중인 세션을 나열합니다. /resume 은 대화를 다시 열기 위한 선택 도구를 제공합니다.
• claude self-hosted-runner 은 조직의 머신이나 컨테이너에서 웹, 모바일 및 데스크톱 세션을 실행하도록 지원하며, Team 및 Enterprise 요금제에서 사용할 수 있다고 명시되어 있습니다.
• 세션 간 메시징은 macOS 및 Linux에서 지원된다고 명시되어 있습니다. 권한 검사를 우회한 세션으로 들어오는 메시지는 사용자 승인을 기다리며, 이제 전달 실패는 오류로 보고됩니다.
• 릴리스에서는 긴 경로에서의 세션 격리와 Remote Control 재개 동작을 수정하고, 동시 실행 및 깊이 제한을 유지하면서 하위 에이전트 200개 생성 상한을 제거합니다.

자주 묻는 질문

다음 항목의 차이점은 무엇인가요: --continue 및 --resume?

claude --continue, 또는 claude -c은 현재 디렉터리의 가장 최근 대화를 불러옵니다. claude --resume 은 대화형 선택 화면을 열며, 세션 ID 또는 이름을 제공하면 해당 대화를 직접 선택합니다.

저장된 대화와 실행 중인 세션의 목록은 각각 어떻게 조회하나요?

다음을 사용하세요: claude --resume 또는 세션 내의 /resume 선택 도구로 이전 대화를 선택하세요. 다음을 사용하세요: claude agents --json 실행 중인 Claude 세션을 JSON 형식으로 나열할 수 있습니다. 이 명령은 v2.1.145에서 도입되었습니다.

어떤 요금제에서 자체 호스팅 Claude Code 환경을 지원하나요?

v2.1.224 릴리스에서는 자체 호스팅 러너를 Team 및 Enterprise 요금제에서 사용할 수 있다고 명시합니다. 러너를 통해 조직은 웹, 모바일 및 데스크톱 세션을 자체 머신이나 컨테이너에서 실행할 수 있지만, 릴리스에는 별도의 러너 가격이나 자체 호스팅 세션 할당량이 제시되어 있지 않습니다.

Claude Code 세션은 머신 간에 서로 메시지를 보낼 수 있나요?

버전 2.1.224에서는 세션 간 SendMessage 및 ListAgents macOS와 Linux에서의 검색 기능으로, “어느 기기에서든” 세션에 메시지를 보낼 수 있다고 설명합니다. Windows 지원은 명시되어 있지 않으며, 권한 검사를 우회한 상태로 실행 중인 세션에 보내는 메시지는 사용자 승인을 기다립니다.