Source: https://aiprimetech.io/ko/blog/claude-code-sessions-self-hosted-environments/ 2026년 8월 9일 · 8분 · 뉴스 # Claude Code 세션: 2.1.224의 자체 호스팅 환경 및 세션 메시징 A 작성자 [AI Prime Tech](https://aiprimetech.io/ko/) · AI 활용 2026년 8월 7일에 출시된 버전 2.1.224에서 Claude Code 세션에 자체 호스팅 실행과 세션 간 메시징이 추가되었습니다. 이 가이드에서는 대화를 계속하거나 재개하는 방법, 저장된 대화와 실행 중인 세션을 구분하는 방법, 새로운 실행기 및 메시징 기능을 이해하는 방법을 설명합니다. 또한 2026년 8월 9일 기준으로 검증된 권한 동작과 세션 수정 사항도 다룹니다. ## Claude Code 세션: 시작, 계속하기, 재개 먼저 대화를 새로 시작하는 것, 디렉터리의 최신 대화를 계속하는 것, 특정 이전 대화를 선택하는 것을 구분해야 합니다. 각 작업에는 서로 다른 명령이 사용되므로, 작업과 관련된 대화가 여러 개라면 올바른 명령을 선택하는 것이 중요합니다. 이 [공식 CLI 참조 문서](https://docs.anthropic.com/en/docs/claude-code/cli-usage) 에는 기본 진입 방법이 설명되어 있습니다. | 목표 | 명령 | 선택 동작 | 대화형 세션 시작 | claude | 대화형 세션을 시작합니다 | 최신 대화 계속하기 | claude --continue 또는 claude -c | 현재 디렉터리에서 가장 최근 대화를 불러옵니다 | 이전 대화 선택 | claude --resume | 대화형 선택 화면을 엽니다 | 특정 세션 재개 | claude --resume | 제공된 세션 ID를 선택합니다 | 짧은 플래그로 재개 | claude -r "" | 제공된 세션 ID를 선택합니다 ### 최신 대화 계속하기 계속하려는 대화가 현재 디렉터리에서 가장 최근 대화라면 continue 명령을 사용하세요. ``` claude --continue ``` 짧은 형식은 다음과 같습니다. ``` claude -c ``` 디렉터리라는 조건이 중요합니다. 문서에 명시된 동작은 가장 최근 대화를 불러오는 것이며, 그 범위는 현재 디렉터리입니다. 따라서 “continue”를 어느 위치에서든 마지막으로 사용한 대화를 선택하는 전역 선택 기능으로 해석해서는 안 됩니다. ### 선택한 대화 재개 이전 대화 중에서 선택하려면 다음을 사용하세요. ``` claude --resume ``` 알고 있는 세션을 직접 선택하려면 해당 ID를 입력하세요. ``` claude --resume ``` 대화형 세션 내에서는 /resume 가 선택 화면을 제공합니다. 이 명령들은 서로 다른 필요에 대응합니다. continue는 현재 디렉터리의 최신 대화를 선택하고, resume은 대화형 선택이나 명시적 선택을 제공합니다. 다음 자료는 [Claude Code CLI 참조](/ko/claude-code/cli/) 명령줄 진입 방법 중에서 선택할 때 유용한 보조 자료입니다. ## 저장된 대화, 이름이 지정된 세션, 실행 중인 세션 검색 세션 선택과 실행 중인 세션 검색은 서로 다른 목적을 갖습니다. 재개 선택 화면은 이전 대화를 선택하는 데 도움을 주며, 실행 중인 세션 명령은 현재 실행 중인 Claude 세션을 나열합니다. 이제 세션 간에 메시지를 주고받을 수 있으므로 이 구분을 명확히 해 두는 것이 특히 유용합니다. 다시 열 대화를 찾는 것과 연락할 실행 중인 세션을 찾는 것은 별개의 작업입니다. ### 나중에 다시 사용할 대화에 이름 지정하기 이름이 있는 세션은 Claude Code 2.1.224 이전부터 지원되었습니다. 버전 2.0.64에서는 다음을 사용해 대화에 이름을 지정하는 기능이 도입되었습니다: /rename 그리고 이름으로 다시 열 수 있습니다. 대화에 이름을 지정하면 CLI에서 해당 대화를 선택할 수 있습니다: ``` claude --resume ``` 다음도 사용할 수 있습니다: /resume 세션 내에서 사용할 수 있습니다. 이름은 세션 ID 및 대화형 선택 도구와 함께 대화를 식별하는 또 다른 방법입니다. 예를 들어 이름을 사용하더라도 계속하기와 재개의 선택 기준은 동일합니다. 계속하기는 현재 디렉터리의 가장 최근 대화를 선택하고, 이름을 지정한 재개는 지정한 대화를 선택합니다. 이름 지정은 다음에 대해 문서화된 선택 동작을 바꾸지 않습니다: --continue. ### 실행 중인 세션 목록 조회하기 실행 중인 세션을 프로그래밍 방식으로 검색하려면 다음을 사용하세요: ``` claude agents --json ``` v2.1.145에서 도입된 이 명령은 실행 중인 Claude 세션을 JSON 형식으로 나열합니다. 이전 대화 중 무엇을 다시 열지보다 어떤 세션이 실행 중인지 바로 확인해야 할 때 유용합니다. 이 [버전이 명시된 변경 로그](https://raw.githubusercontent.com/anthropics/claude-code/v2.1.224/CHANGELOG.md) 에는 이름이 있는 세션 지원과 실행 중인 세션 목록 조회 명령이 모두 기록되어 있습니다. 두 기능 모두 2.1.224에서 처음 등장한 것은 아닙니다. 새 메시징 기능과 함께 사용할 수 있는 기존 세션 관리 도구입니다. ## Claude Code 2.1.224의 자체 호스팅 환경 이 [v2.1.224 릴리스](https://github.com/anthropics/claude-code/releases/tag/v2.1.224) 에서 도입한 기능은 claude self-hosted-runner입니다. 조직은 이를 통해 웹, 모바일 및 데스크톱 인터페이스에서 시작한 Claude Code 세션을 자체 머신이나 컨테이너에서 실행할 수 있습니다. 릴리스에 명시된 명령은 다음과 같습니다: ``` claude self-hosted-runner ``` 사용 가능한 요금제는 Team 및 Enterprise 요금제입니다. 이는 게시 시점 기준으로 확인된 이 기능의 요금제 요건입니다. ### 러너로 달라지는 점 러너는 조직이 제공하는 머신이나 컨테이너에서 실행할 수 있는 옵션을 제공합니다. 릴리스에 명시된 지원 세션 인터페이스는 웹, 모바일 및 데스크톱입니다. 이 범위가 Claude Code 자체 호스팅 환경 발표의 핵심입니다. 해당 세션을 어디에서 실행할 수 있는지, 어떤 요금제에서 이 기능을 사용할 수 있는지 설명합니다. 확인된 자료에는 완전한 배포 절차가 제공되어 있지 않습니다. 이 기능이 Claude Code 사용 방식에 어떻게 맞는지 평가하고 있다면, [웹 및 데스크톱 가이드](/ko/claude-code/web-and-desktop/) 에서 해당 인터페이스를 살펴볼 수 있습니다. 이번 릴리스에서는 실행 기능, 지원 인터페이스 범위, 이용 가능한 요금제를 별개의 평가 항목으로 다루세요. ### 아직 확인되지 않은 사항 릴리스에는 별도의 러너 가격, 세션당 요금 또는 자체 호스팅 세션 할당량이 제시되어 있지 않습니다. 또한 이 문서에 활용할 수 있는 자료에는 상세한 배포 플래그나 검증된 구성 예제가 명시되어 있지 않습니다. 이러한 정보의 공백은 배포를 계획할 때 중요합니다. 문서화된 명령은 기능의 진입점을 알려 주지만, 완전한 설정 절차나 비용 모델을 추론하기에는 충분하지 않습니다. 러너 요금이나 세션 허용량에 대한 추정은 제공된 릴리스 정보의 범위를 벗어납니다. ## 세션 간 메시징과 수신 메시지 승인 버전 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 하위 에이전트 가이드](/ko/claude-code/subagents/) 는 코딩 워크플로의 해당 부분에 대한 관련 참고 자료입니다. ### 재개 시 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 지원은 명시되어 있지 않으며, 권한 검사를 우회한 상태로 실행 중인 세션에 보내는 메시지는 사용자 승인을 기다립니다. [Claude](/ko/blog/tag/claude/)[코딩](/ko/blog/tag/coding/)[도구](/ko/blog/tag/tools/) A [AI Prime Tech](https://aiprimetech.io/ko/) 이 블로그는 AI Prime Tech가 발행합니다. 기사는 AI의 도움을 받아 초안을 작성합니다. 모델 ID, 가격, 한도 등 버전별 세부 정보는 활용하기 전에 공식 문서와 대조해 확인하세요. 더 저렴하게 Claude API 이용하기 API 키 하나로 Claude Opus 5.5, Sonnet 5, Haiku 4.5, Fable 5.1 및 GPT-6개 모델을 이용하세요. 구독 없이 사용한 만큼만 결제합니다. [API 키 받기 →](/register) AI Prime Tech는 독립적인 타사 API 게이트웨이입니다. Claude™ 및 Anthropic®는 Anthropic, PBC의 상표입니다. 제휴 또는 보증 관계를 의미하지 않습니다.