채널은 실행 중인 Claude Code 세션으로 이벤트를 푸시하는 MCP 서버이므로 Claude는 터미널에 없을 때 발생하는 일에 반응할 수 있습니다. 채널은 양방향일 수 있습니다. Claude는 이벤트를 읽고 동일한 채널을 통해 다시 회신합니다(채팅 브리지처럼). 이벤트는 세션이 열려 있는 동안에만 도착하므로 항상 켜진 설정의 경우 Claude를 백그라운드 프로세스 또는 지속적인 터미널에서 실행합니다.
새로운 클라우드 세션을 생성하거나 폴링될 때까지 기다리는 통합과 달리 이벤트는 이미 열려 있는 세션에 도착합니다. 채널이 어떻게 비교되는지 참조하세요.
채널을 플러그인으로 설치하고 자신의 자격증명으로 구성합니다. Telegram, Discord 및 iMessage는 연구 미리보기에 포함되어 있습니다.
Claude가 채널을 통해 회신할 때 터미널에서 인바운드 메시지를 볼 수 있지만 회신 텍스트는 볼 수 없습니다. 터미널에는 도구 호출과 확인(예: “전송됨”)이 표시되고 실제 회신은 다른 플랫폼에 나타납니다.
이 페이지에서 다루는 내용:
- 지원되는 채널: Telegram, Discord 및 iMessage 설정
- 채널 설치 및 실행: localhost 데모인 fakechat 사용
- 메시지를 푸시할 수 있는 사람: 발신자 허용 목록 및 페어링 방법
- 조직에 대해 채널 활성화: Team 및 Enterprise
- 채널이 어떻게 비교되는지: 웹 세션, Slack, MCP 및 Remote Control과 비교
지원되는 채널
각 지원되는 채널은 Bun이 필요한 플러그인입니다. 실제 플랫폼을 연결하기 전에 플러그인 흐름의 실습 데모를 보려면 fakechat 빠른 시작을 시도하세요.- Telegram
- Discord
- iMessage
전체 Telegram 플러그인 소스를 확인하세요.
Telegram 봇 만들기
Telegram에서 BotFather를 열고
/newbot을 보냅니다. 표시 이름과 bot으로 끝나는 고유한 사용자 이름을 지정합니다. BotFather가 반환하는 토큰을 복사합니다.플러그인 설치
Claude Code에서 다음을 실행합니다:Claude Code가 플러그인을 어떤 마켓플레이스에서도 찾을 수 없다고 보고하면 마켓플레이스가 누락되었거나 오래되었습니다.
/plugin marketplace update claude-plugins-official을 실행하여 새로 고치거나 이전에 추가하지 않았다면 /plugin marketplace add anthropics/claude-plugins-official을 실행합니다. 그런 다음 설치를 다시 시도합니다.설치 후 /reload-plugins을 실행하여 플러그인의 구성 명령을 활성화합니다.토큰 구성
BotFather의 토큰으로 구성 명령을 실행합니다:이것은
~/.claude/channels/telegram/.env에 저장됩니다. Claude Code를 시작하기 전에 셸 환경에서 TELEGRAM_BOT_TOKEN을 설정할 수도 있습니다.빠른 시작
Fakechat은 localhost에서 채팅 UI를 실행하는 공식적으로 지원되는 데모 채널이며 인증할 것도 없고 구성할 외부 서비스도 없습니다. fakechat을 설치하고 활성화한 후 브라우저에서 입력하면 메시지가 Claude Code 세션에 도착합니다. Claude가 회신하면 회신이 브라우저로 돌아옵니다. fakechat 인터페이스를 테스트한 후 Telegram, Discord 또는 iMessage를 시도해 보세요. fakechat 데모를 시도하려면 다음이 필요합니다:- Claude Code 설치 및 인증: claude.ai 계정 사용
- Bun 설치됨. 사전 구축된 채널 플러그인은 Bun 스크립트입니다.
bun --version으로 확인하세요. 실패하면 Bun 설치하세요. - Team/Enterprise 사용자: 조직 관리자가 관리 설정에서 채널을 활성화해야 합니다.
fakechat 채널 플러그인 설치
Claude Code 세션을 시작하고 설치 명령을 실행합니다:Claude Code가 플러그인을 어떤 마켓플레이스에서도 찾을 수 없다고 보고하면 마켓플레이스가 누락되었거나 오래되었습니다.
/plugin marketplace update claude-plugins-official을 실행하여 새로 고치거나 이전에 추가하지 않았다면 /plugin marketplace add anthropics/claude-plugins-official을 실행합니다. 그런 다음 설치를 다시 시도합니다.채널이 활성화된 상태로 다시 시작
Claude Code를 종료한 다음 fakechat 서버가 자동으로 시작됩니다.
--channels로 다시 시작하고 설치한 fakechat 플러그인을 전달합니다:메시지 푸시
http://localhost:8787에서 fakechat UI를 열고 메시지를 입력합니다:메시지는 Claude Code 세션에
<channel source="fakechat"> 이벤트로 도착합니다. Claude가 읽고 작업을 수행한 다음 fakechat의 reply 도구를 호출합니다. 답변이 채팅 UI에 나타납니다.--dangerously-skip-permissions는 프롬프트를 완전히 우회하지만 신뢰하는 환경에서만 사용하세요.
보안
승인된 모든 채널 플러그인은 발신자 허용 목록을 유지합니다. 추가한 ID만 메시지를 푸시할 수 있으며 다른 모든 것은 자동으로 삭제됩니다. Telegram 및 Discord는 페어링으로 목록을 부트스트랩합니다:- Telegram 또는 Discord에서 봇을 찾고 메시지를 보냅니다.
- 봇이 페어링 코드로 회신합니다.
- Claude Code 세션에서 메시지가 표시될 때 코드를 승인합니다.
- 발신자 ID가 허용 목록에 추가됩니다.
/imessage:access allow로 다른 연락처를 핸들로 추가합니다.
그 위에 --channels로 각 세션에서 활성화된 서버를 제어하고 Team 및 Enterprise 계획에서 조직은 channelsEnabled로 가용성을 제어합니다.
.mcp.json에 있는 것만으로는 메시지를 푸시하기에 충분하지 않습니다. 서버도 --channels에서 명명되어야 합니다.
허용 목록은 채널이 선언하는 경우 권한 릴레이도 게이트합니다. 채널을 통해 회신할 수 있는 모든 사람이 세션에서 도구 사용을 승인하거나 거부할 수 있으므로 해당 권한을 신뢰하는 발신자만 허용 목록에 추가하세요.
Enterprise 제어
Team 및 Enterprise 계획에서 채널은 기본적으로 꺼져 있습니다. 관리자는 사용자가 재정의할 수 없는 두 가지 관리 설정을 통해 가용성을 제어합니다:| 설정 | 목적 | 구성되지 않은 경우 |
|---|---|---|
channelsEnabled | 마스터 스위치. 채널이 메시지를 전달하려면 true여야 합니다. claude.ai Admin 콘솔 토글을 통해 또는 관리 설정에서 직접 설정합니다. 꺼져 있을 때 개발 플래그를 포함한 모든 채널을 차단합니다. | 채널 차단됨 |
allowedChannelPlugins | 채널이 활성화되면 등록할 수 있는 플러그인. 설정되면 Anthropic 유지 관리 목록을 대체합니다. channelsEnabled가 true일 때만 적용됩니다. | Anthropic 기본 목록 적용 |
--channels로 세션당 옵트인합니다.
조직에 대해 채널 활성화
관리자는 claude.ai → Admin settings → Claude Code → Channels에서 채널을 활성화하거나 관리 설정에서channelsEnabled를 true로 설정할 수 있습니다.
활성화되면 조직의 사용자는 --channels를 사용하여 개별 세션에 채널 서버를 옵트인할 수 있습니다. 설정이 비활성화되었거나 설정되지 않은 경우 MCP 서버는 여전히 연결되고 해당 도구가 작동하지만 채널 메시지는 도착하지 않습니다. 시작 경고는 사용자에게 관리자가 설정을 활성화하도록 합니다.
실행할 수 있는 채널 플러그인 제한
기본적으로 Anthropic 유지 관리 허용 목록의 모든 플러그인이 채널로 등록할 수 있습니다. Team 및 Enterprise 계획의 관리자는 관리 설정에서allowedChannelPlugins을 설정하여 해당 허용 목록을 자신의 목록으로 바꿀 수 있습니다. 이를 사용하여 허용되는 공식 플러그인을 제한하거나 자신의 내부 마켓플레이스에서 채널을 승인하거나 둘 다 수행합니다. 각 항목은 플러그인과 그것이 나오는 마켓플레이스의 이름을 지정합니다:
allowedChannelPlugins이 설정되면 Anthropic 허용 목록을 완전히 대체합니다. 나열된 플러그인만 등록할 수 있습니다. 기본 Anthropic 허용 목록으로 돌아가려면 설정하지 않은 상태로 두세요. 빈 배열은 허용 목록의 모든 채널 플러그인을 차단하지만 --dangerously-load-development-channels는 여전히 로컬 테스트를 위해 이를 우회할 수 있습니다. 개발 플래그를 포함한 채널을 완전히 차단하려면 대신 channelsEnabled를 설정하지 않은 상태로 두세요.
이 설정에는 channelsEnabled: true가 필요합니다. 사용자가 --channels에 조직 목록에 없는 플러그인을 전달하면 Claude Code가 정상적으로 시작되지만 채널이 등록되지 않으며 시작 알림이 플러그인이 조직의 승인된 목록에 없음을 설명합니다.
연구 미리보기
채널은 연구 미리보기 기능입니다. 가용성은 점진적으로 출시되고 있으며--channels 플래그 구문 및 프로토콜 계약은 피드백에 따라 변경될 수 있습니다.
미리보기 중에 --channels는 Anthropic 유지 관리 허용 목록의 플러그인만 허용하거나 관리자가 allowedChannelPlugins을 설정한 경우 조직의 허용 목록에서만 허용합니다. claude-plugins-official의 채널 플러그인은 기본 승인된 집합입니다. 유효한 허용 목록에 없는 것을 전달하면 Claude Code가 정상적으로 시작되지만 채널이 등록되지 않으며 시작 알림이 이유를 알려줍니다.
구축 중인 채널을 테스트하려면 --dangerously-load-development-channels를 사용합니다. 구축하는 사용자 정의 채널 테스트에 대한 정보는 연구 미리보기 중 테스트를 참조하세요.
Claude Code GitHub 저장소에서 문제 또는 피드백을 보고합니다.
채널이 어떻게 비교되는지
여러 Claude Code 기능이 터미널 외부의 시스템에 연결되며 각각 다른 종류의 작업에 적합합니다:| 기능 | 수행하는 작업 | 좋은 점 |
|---|---|---|
| 웹의 Claude Code | GitHub에서 복제된 새로운 클라우드 샌드박스에서 작업 실행 | 나중에 확인하는 자체 포함된 비동기 작업 위임 |
| Slack의 Claude | 채널 또는 스레드의 @Claude 언급에서 웹 세션 생성 | 팀 대화 컨텍스트에서 직접 작업 시작 |
| 표준 MCP 서버 | Claude는 작업 중에 쿼리합니다. 세션으로 푸시되는 것은 없습니다. | Claude에게 시스템을 읽거나 쿼리하기 위한 온디맨드 액세스 제공 |
| Remote Control | claude.ai 또는 Claude 모바일 앱에서 로컬 세션을 운전합니다. | 책상에서 멀리 있을 때 진행 중인 세션 조종 |
- 채팅 브리지: Telegram, Discord 또는 iMessage를 통해 휴대폰에서 Claude에 무언가를 물어보고 답변이 같은 채팅으로 돌아오는 동안 작업이 기계에서 실제 파일에 대해 실행됩니다.
- 웹훅 수신기: CI, 오류 추적기, 배포 파이프라인 또는 기타 외부 서비스의 웹훅이 Claude가 이미 파일을 열고 있고 디버깅 중인 것을 기억하는 곳에 도착합니다.
다음 단계
채널이 실행 중이면 다음 관련 기능을 살펴보세요:- 자신의 채널 구축: 아직 플러그인이 없는 시스템의 경우
- Remote Control: 이벤트를 전달하는 대신 휴대폰에서 로컬 세션을 운전하기
- 예약된 작업: 푸시된 이벤트에 반응하는 대신 타이머에서 폴링하기