MemoryLake
모든 글로 돌아가기
Tutorial2026년 11월 18일·11 분 소요

Claude Code 채널이란 무엇인가요? 세션이 열려 있을 때만 메시지가 도착하는 이유, 메시지 도착 시 Claude가 이미 알고 있는 내용, 그리고 답장이 터미널에 표시되지 않는 이유 (2026)

휴대폰으로 긴 디버깅 세션을 확인하기 위해 Claude Code용 Telegram 채널을 설정했습니다. 점심시간에는 잘 작동했습니다. 테스트 실행 결과가 무엇인지 물었고, Claude는 아침 내내 열어두었던 파일의 세부 정보를 포함하여 채팅으로 답변했습니다. 그날 저녁, 노트북을 닫고 기차 안에서 다른 질문을 보냈습니다. 아무런 응답이 없었습니다.

두 경험 모두 Anthropic 문서의 한 문장에서 비롯됩니다: "이벤트는 세션이 열려 있는 동안에만 도착하므로, 상시 가동 설정을 위해서는 백그라운드 프로세스나 영구 터미널에서 Claude를 실행해야 합니다."

이 가이드에서는 채널이 무엇인지, 원격으로 Claude Code에 접속하는 다른 방법과 어떻게 다른지, 왜 메시지가 이미 컨텍스트(context)를 가진 세션에 도착하는지, 세션이 실행 중이지 않을 때 어떤 일이 일어나는지, 왜 답장이 휴대폰에는 나타나지만 터미널에는 나타나지 않는지, 발신자 허용 목록(allowlist)은 어떻게 작동하는지, 그리고 조직에서 무엇을 활성화해야 하는지 다룹니다.

채널이란 무엇인가

Anthropic의 문서는 첫 줄에서 이 기능을 다음과 같이 설명합니다: "채널을 사용하여 MCP 서버에서 실행 중인 Claude Code 세션으로 메시지, 알림 및 웹훅을 푸시하세요."

이 메커니즘은 특정 종류의 MCP 서버입니다. "채널은 실행 중인 Claude Code 세션에 이벤트를 푸시하는 MCP 서버이므로, 사용자가 터미널에 없을 때 발생하는 일에 Claude가 반응할 수 있습니다."

채널은 양방향으로 작동할 수 있습니다. 문서에 따르면: "채널은 양방향일 수 있습니다. Claude가 이벤트를 읽고 채팅 브리지처럼 동일한 채널을 통해 다시 답장을 보냅니다."

채널을 플러그인으로 설치하고 본인의 자격 증명으로 구성합니다. 문서에 따르면: "Telegram, Discord 및 iMessage가 리서치 프리뷰에 포함되어 있습니다." 지원되는 각 채널은 Bun이 필요한 플러그인이며, 실제 플랫폼을 연결하지 않고도 흐름을 시도해 볼 수 있도록 본인의 머신에서 채팅 페이지를 실행하는 fakechat이라는 데모 채널도 있습니다.

이 기능은 리서치 프리뷰로 표시되어 있습니다. 가용성은 점진적으로 확대되고 있으며, 문서에서는 피드백에 따라 플래그 구문과 프로토콜이 변경될 수 있다고 경고합니다.

채널과 Claude Code에 접속하는 다른 방법의 차이점

Claude Code에는 터미널 외부 세계와 연결하는 여러 기능이 있습니다. 문서는 이를 다음과 같이 비교합니다:

  • Cloud 세션은 GitHub에서 복제된 신선한 클라우드 샌드박스에서 작업을 실행합니다. 나중에 확인하는 독립형 작업에 적합합니다.
  • Slack 내 Claude는 채널이나 스레드에서의 멘션을 통해 클라우드 세션을 시작합니다.
  • 표준 MCP 서버는 Claude가 작업 중에 쿼리하는 대상입니다. 세션으로 푸시되는 것은 없습니다.
  • Remote Control을 사용하면 claude.ai 또는 Claude 모바일 앱에서 로컬 세션을 제어할 수 있습니다.

그리고: "채널은 Claude가 아닌 소스의 이벤트를 이미 실행 중인 로컬 세션으로 푸시함으로써 해당 목록의 공백을 메웁니다."

핵심적인 차이점은 메시지가 도착하는 위치입니다. 문서에 따르면, 새로운 클라우드 세션을 생성하거나 폴링될 때까지 기다리는 통합 기능과 달리 "이벤트는 이미 열려 있는 세션에 도착합니다".

메시지가 도착했을 때 Claude가 이미 알고 있는 것

채널 메시지는 실행 중인 세션에 합류하기 때문에, Claude는 해당 세션이 이미 보유하고 있는 모든 정보를 바탕으로 답변합니다.

문서는 이에 의존하는 두 가지 용도를 설명합니다:

  • 채팅 브리지. "Telegram, Discord 또는 iMessage를 통해 휴대폰에서 Claude에게 무언가를 물어보면, 작업이 실제 파일에 대해 머신에서 실행되는 동안 동일한 채팅으로 답변이 돌아옵니다."
  • 웹훅 수신기. CI, 오류 추적기 또는 배포 파이프라인의 이벤트가 "Claude가 이미 파일을 열어두고 무엇을 디버깅하고 있었는지 기억하는 곳으로 도착합니다."

두 번째 문구가 중요합니다. 채널을 통한 메시지는 새로운 대화가 아닙니다. 이미 파일, 실행된 명령, 조사 중이던 내용을 가지고 있는 세션의 다음 입력이 됩니다. 이것이 도입부 예시에서 점심시간의 질문이 유용한 답변을 얻은 이유입니다.

또한 답변의 품질이 세션에 따라 달라짐을 의미합니다. 5분 전에 시작한 세션에 보내는 채널 메시지는 5분간의 컨텍스트를 바탕으로 답변을 받게 됩니다.

세션이 열려 있을 때만 메시지가 도착하는 이유

동일한 설계가 저녁의 침묵을 설명해 줍니다. 채널은 실행 중인 세션에 이벤트를 푸시합니다. 세션이 실행 중이지 않으면 이벤트가 도착할 곳이 없습니다.

문서의 문장은 직접적입니다: "이벤트는 세션이 열려 있는 동안에만 도착하므로, 상시 가동 설정을 위해서는 백그라운드 프로세스나 영구 터미널에서 Claude를 실행해야 합니다."

문서에는 닫힌 세션을 위해 채널 메시지가 큐에 대기한다는 설명이 없으므로, 세션이 다운된 동안 보낸 메시지는 도달하지 않는 것으로 간주하고 계획을 세우십시오. 자리를 비운 상태에서 채널을 사용하려면 세션을 계속 켜져 있는 곳에서 실행해 두어야 합니다.

종료 시 백그라운드에서 실행 중인 Claude Code 작업에 어떤 일이 일어나는지, 그리고 이를 계속 유지하는 방법은 Claude Code 백그라운드 작업 가이드에서 다루었습니다.

이벤트에 반응하는 대신 일정에 따라 무언가를 확인해야 하는 작업의 경우, 문서에서는 타이머에 따라 폴링하는 세션 범위의 예약된 작업을 안내합니다.

답장이 터미널에 표시되지 않는 이유

휴대폰으로 답장한 후 터미널을 슥 훑어본다면 놓치기 쉬운 부분입니다. 문서에서는 다음과 같이 설명합니다: "Claude가 채널을 통해 답장할 때, 터미널에는 수신 메시지는 표시되지만 답장 텍스트는 표시되지 않습니다."

터미널에서는 수신 메시지가 인바운드 채널 라인으로 표시되고, 이어서 Claude가 답장을 위해 수행한 도구 호출과 전송되었다는 짧은 확인 메시지가 표시됩니다. 답장 자체는 상대방 플랫폼에 나타납니다.

따라서 채널 대화의 기록은 나뉩니다. 질문은 터미널에서 볼 수 있습니다. Claude의 답변은 Telegram, Discord 또는 iMessage에 있습니다. 해당 대화에서 중요한 결정이 내려졌다면 전체 텍스트는 휴대폰에 있는 것입니다.

권한 요청 시 발생하는 일

휴대폰으로 조종 중인 세션이라도 권한 승인을 위해 멈출 수 있습니다. 문서에 따르면: "사용자가 터미널을 비운 동안 Claude가 권한 요청을 만나면, 사용자가 응답할 때까지 세션이 일시 중지됩니다."

일부 채널이 도움이 될 수 있습니다. 문서에 따르면 권한 릴레이(permission relay) 기능을 선언한 채널 서버는 이러한 요청을 전달하여 원격으로 승인하거나 거부할 수 있게 해줍니다. 무인 사용을 위해 권한 확인을 완전히 건너뛰는 모드도 안내하고 있지만, 이는 안전장치를 제거하는 것입니다.

-p를 사용하여 비대화형 모드로 채널을 실행하면 터미널 입력이 필요한 도구는 꺼집니다. 문서의 예시로는 객관식 질문과 계획 모드 승인이 있으며, "세션이 입력을 기다리며 멈추지 않도록" 비활성화됩니다.

채널로 세션을 시작하는 방법

채널 플러그인을 설치한 후, --channels 플래그와 플러그인 이름을 지정하여 Claude Code를 재시작합니다. 그러면 시작 화면에 해당 플러그인의 메시지가 세션으로 직접 전달된다는 알림이 표시됩니다.

두 가지 세부 사항이 중요합니다:

  • 채널은 세션별로 선택(opt-in)해야 합니다. 문서에 따르면 모든 경우에 사용자가 --channels로 해당 세션에 대해 채널을 선택하기 전까지는 어떤 채널도 실행되지 않습니다.
  • 구성만으로는 충분하지 않습니다. ".mcp.json에 있는 것만으로는 메시지를 푸시하기에 충분하지 않습니다. 서버가 --channels에도 명시되어야 합니다."

프리뷰 기간 동안 --channels나 개발 플래그는 claude --help에 나타나지 않습니다. 문서에 따르면 목록에 없더라도 플래그는 작동합니다.

누가 내 세션에 메시지를 보낼 수 있나요?

채널은 머신의 파일을 읽고 변경할 수 있는 세션으로의 경로를 열어주므로, 문서는 누가 이를 사용할 수 있는지에 대해 신중합니다.

"승인된 모든 채널 플러그인은 발신자 허용 목록을 유지합니다. 추가한 ID만 메시지를 푸시할 수 있으며, 그 외의 모든 메시지는 자동으로 무시됩니다."

Telegram과 Discord는 페어링을 통해 목록을 작성합니다. 봇에게 메시지를 보내면 봇이 페어링 코드로 답장하고, Claude Code 세션에서 해당 코드를 승인하면 발신자 ID가 추가됩니다. iMessage는 다르게 작동합니다. 자신에게 문자를 보내는 것은 자동으로 허용되며, 다른 연락처는 핸들(handle)로 추가합니다.

허용 목록은 권한 릴레이도 제어하며, 문서에서는 그 의미를 명확히 밝힙니다: "채널을 통해 답장할 수 있는 사람은 누구나 세션의 도구 사용을 승인하거나 거부할 수 있으므로, 해당 권한을 신뢰할 수 있는 발신자만 허용 목록에 추가하십시오."

리서치 프리뷰 기간 동안 --channels는 Anthropic에서 관리하는 허용 목록에 있는 플러그인이나, 관리자가 설정한 경우 조직의 허용 목록에 있는 플러그인만 수락합니다.

조직에서 활성화해야 하는 사항

가용성은 로그인 방식에 따라 다릅니다.

  • 조직이 없는 Pro, Max, Ultra 사용자. "조직이 없는 Pro, Max, Ultra 사용자는 이러한 확인을 완전히 건너뜁니다." 채널을 사용할 수 있으며 세션별로 선택합니다.
  • Claude Team 및 Enterprise. 소유자(Owner)가 조직 설정의 Claude Code 항목에서 활성화하거나, 관리 설정에서 channelsEnabled를 true로 설정하기 전까지 채널은 차단됩니다.
  • API 키 인증을 사용하는 Console. 조직에서 관리 설정을 배포하지 않는 한 채널은 기본적으로 허용됩니다.

채널이 활성화되지 않은 경우에도 서버는 연결된다고 문서에 명시되어 있습니다: "설정이 비활성화되어 있거나 설정되지 않은 경우에도 MCP 서버는 연결되고 도구는 작동하지만, 채널 메시지는 도착하지 않습니다." 시작 시 경고를 통해 사용자에게 관리자에게 문의하라고 안내합니다.

관리자는 allowedChannelPlugins를 사용하여 승인된 채널 플러그인의 기본 목록을 자체 목록으로 대체할 수도 있습니다.

채널을 사용하려면 claude.ai 또는 Console API 키를 통한 Anthropic 인증이 필요합니다. Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry에서는 사용할 수 없습니다.

사람들이 흔히 겪는 실수

실행 중이지 않은 세션에 메시지 보내기. 이벤트는 세션이 열려 있는 동안에만 도착합니다.

터미널에서 Claude의 답장 찾기. 터미널에는 메시지와 확인 내용만 표시됩니다. 답장은 상대방 플랫폼에 있습니다.

.mcp.json에 서버를 추가하고 거기서 멈추기. --channels에도 이름을 지정해야 합니다.

그룹 채팅을 허용 목록에 추가하기. 허용 목록에 있는 사람은 누구나 권한 릴레이를 통해 도구 사용을 승인할 수 있습니다.

오지 않는 팀 배포 기다리기. Team 및 Enterprise 플랜에서는 소유자가 채널을 활성화해야 합니다.

해결책: 세션, 기록, 컨텍스트를 동기화 상태로 유지하기

1단계: 세션이 계속 켜져 있는 곳에서 실행하기

자리를 비운 동안 메시지를 보낼 예정이라면 영구 터미널이나 백그라운드 프로세스를 사용하세요.

2단계: 자신 또는 신뢰하는 사람만 허용 목록에 추가하기

자신의 계정을 먼저 페어링하고, 도구 사용을 승인할 수 있어야 하는 사람만 추가하세요.

3단계: 중요한 답변은 다시 복사해두기

채널 대화를 통해 무언가 결정되면, 팀의 나머지 구성원이 볼 수 있는 곳에 기록해 두세요.

4단계: 프로젝트 컨텍스트를 세션 외부에 유지하기

새로운 세션에 필요한 결정 사항을 적어 두어, 재시작된 세션도 이전 세션만큼 잘 답변할 수 있도록 하세요.

MemoryLake에서 설정하기

채널 메시지가 좋은 답변을 얻는 이유는 세션이 사용자가 무엇을 작업하고 있었는지 이미 알고 있기 때문입니다. 해당 세션이 종료되면 컨텍스트도 함께 종료되며, 채팅 브리지를 통해 내린 결정은 메시징 앱에 남게 됩니다. 어떤 수정을 승인했는지, 왜 배포를 일시 중지했는지, 어떤 오류를 무시할지 등의 결정 사항은 한곳에 보관할 가치가 있는 프로젝트 컨텍스트입니다.

MemoryLake는 이러한 종류의 프로젝트 컨텍스트(결정 사항, 현재 우선순위 및 그 이유 등)를 위한 기억 계층(memory layer)으로, 사용자가 직접 관리하는 한곳에 보관되어 ChatGPT, Claude Code, Codex 등 연결된 어시스턴트가 사용할 수 있도록 합니다.

항목은 본인의 언어로 직접 작성합니다. Claude Code 세션, 채널 플러그인, Telegram, Discord, iMessage 대화, 설정 파일 또는 공급업체의 저장소에서 아무것도 읽거나 쓰거나 삭제하지 않습니다. 채널은 Anthropic이 설명하는 방식 그대로 작동합니다.

1단계: API 키 생성

로그인하고 대시보드에서 키를 생성합니다. 다른 자격 증명과 마찬가지로 리포지토리 외부에 저장하세요.

에이전트에서 사용할 새 키를 생성하고 복사하는 API 키 화면을 보여주는 MemoryLake 콘솔
에이전트에서 사용할 새 키를 생성하고 복사하는 API 키 화면을 보여주는 MemoryLake 콘솔

2단계: 첫 번째 기억 업로드

해결책의 4단계에서 작성한 내용, 즉 새 세션이 알아야 할 결정 사항부터 시작하세요. 항목당 하나의 결정을 날짜와 함께 작성합니다.

첫 번째 문서가 업로드된 MemoryLake 워크스페이스, 각 파일이 검색 가능한 기억이 되는 목록을 보여줌
첫 번째 문서가 업로드된 MemoryLake 워크스페이스, 각 파일이 검색 가능한 기억이 되는 목록을 보여줌

3단계: AI 및 에이전트 연결

Claude Code, Codex 및 사용하는 다른 어시스턴트를 연결하세요. 재시작된 세션은 이전 세션과 동일한 결정 사항을 활용할 수 있습니다.

기억 계층에 연결할 수 있는 AI 클라이언트 및 에이전트 프레임워크가 나열된 MemoryLake 통합 화면
기억 계층에 연결할 수 있는 AI 클라이언트 및 에이전트 프레임워크가 나열된 MemoryLake 통합 화면

실제적인 변화

첫 번째 차이점은 단일 세션에 대한 의존도가 낮아진다는 것입니다. 세션이 재시작되어도 결정 사항은 여전히 사용 가능합니다.

두 번째는 더 완전한 기록입니다. 휴대폰으로 받은 답변이 휴대폰에만 머물 필요가 없습니다.

세 번째는 도구 간의 일관성입니다. Claude Code와 다른 어시스턴트에서 동일한 결정 사항을 공유합니다.

Claude Code 채널을 위한 모범 사례

fakechat으로 시작하세요. 실제 플랫폼을 연결하기 전에 본인의 머신에서 흐름을 테스트하세요.

세션을 계속 실행하세요. 메시지는 세션이 열려 있는 동안에만 도착합니다.

세션별로 선택하세요. --channels로 각 채널의 이름을 지정하세요.

허용 목록을 작게 유지하세요. 허용 목록에 있는 발신자는 도구 사용을 승인할 수 있습니다.

권한 요청에 대비하세요. 권한 릴레이가 있는 채널을 사용하거나, 세션이 일시 중지될 것을 예상하세요.

채팅으로 내린 결정을 기록하세요. 답장은 상대방 플랫폼에 저장됩니다.

변경 사항을 예상하세요. 채널은 리서치 프리뷰 단계입니다.

결론

채널을 사용하면 MCP 서버가 이미 실행 중인 Claude Code 세션으로 메시지, 알림 및 웹훅을 푸시할 수 있습니다. 메시지가 해당 세션에 합류하기 때문에 Claude는 이미 가지고 있는 파일, 명령 및 조사 내용을 바탕으로 답변하며, 이것이 휴대폰에서의 빠른 질문을 유용하게 만듭니다. 동일한 설계로 인해 이벤트는 세션이 열려 있는 동안에만 도착합니다.

채널을 통한 답장은 터미널이 아닌 상대방 플랫폼에 나타납니다. 발신자 허용 목록은 누가 메시지를 푸시할 수 있는지, 그리고 권한 릴레이를 통해 누가 도구 사용을 승인할 수 있는지를 제어합니다. Team 및 Enterprise 플랜에서는 소유자가 먼저 채널을 활성화해야 합니다. 필요할 때 세션을 계속 실행하고, 허용 목록을 엄격하게 관리하며, 채팅 브리지를 통해 내린 결정을 세션보다 오래 지속되는 곳에 기록하십시오.

자주 묻는 질문

Claude Code 채널이란 무엇인가요?

실행 중인 Claude Code 세션에 채팅 메시지나 웹훅과 같은 이벤트를 푸시하는 MCP 서버입니다.

어떤 채널을 사용할 수 있나요?

리서치 프리뷰에는 Telegram, Discord, iMessage가 포함되어 있으며, fakechat 데모도 제공됩니다.

왜 내 메시지가 Claude에게 전달되지 않았나요?

이벤트는 세션이 열려 있는 동안에만 도착합니다. 또한 채널이 --channels에 지정되었는지, 발신자 ID가 허용 목록에 있는지 확인하세요.

왜 터미널에서 Claude의 답장이 보이지 않나요?

터미널에는 수신 메시지와 확인 내용만 표시됩니다. 답장은 상대방 플랫폼에 나타납니다.

다른 사람이 내 세션에 메시지를 보낼 수 있나요?

플러그인의 허용 목록에 있는 발신자 ID만 가능합니다. 그 외에는 자동으로 무시됩니다.

Team 및 Enterprise 플랜에서 채널이 작동하나요?

네, 소유자가 조직 설정이나 관리 설정에서 활성화하면 작동합니다.

채널은 정식 출시(GA) 되었나요?

아니요. 리서치 프리뷰 단계이며, 플래그와 프로토콜이 변경될 수 있습니다.