Claude Code channels: Telegram, Discord, iMessage로 Claude Code에 메시지 보내기

Claude Code channels란

채널은 실행 중인 Claude Code 세션으로 이벤트를 밀어 넣는 MCP 서버예요. 양방향도 돼요. Claude가 메시지를 읽고 채팅 브리지처럼 같은 채널로 답해요. 이벤트는 세션이 열려 있을 때만 도착해요.

• 공식 채널 플러그인: Telegram, Discord, iMessage, 그리고 localhost에서 도는 데모 채팅 fakechat.
• 모두 claude-plugins-official의 플러그인이고 Bun이 설치돼 있어야 해요.
• CI 실패나 오류 알림을 받는 웹훅 수신기처럼 채널을 직접 만들 수도 있어요.
• Channels는 리서치 프리뷰예요. --channels 플래그는 claude --help에 나오지 않고, 문법이 바뀔 수 있어요.
• 터미널에는 들어온 메시지와 “sent” 같은 확인만 보이고, 답장 내용은 채팅 앱에 나타나요.

Telegram 채널 설정하는 법

1. 봇 만들기

   Telegram에서 BotFather를 열고 /newbot을 보낸 다음, 봇 이름과 “bot”으로 끝나는 사용자 이름을 정하고 토큰을 복사하세요.

   # Claude Code에서 공식 플러그인 설치 (user scope 선택)
   /plugin install telegram@claude-plugins-official
   
   # BotFather가 준 토큰 저장
   /telegram:configure <token>
   
   # 채널을 켜고 Claude Code 다시 시작
   claude --channels plugin:telegram@claude-plugins-official
   
   # 봇에 메시지를 보낸 뒤, 답장으로 온 코드로 페어링
   /telegram:access pair <code>
   /telegram:access policy allowlist

2. 플러그인 설치하고 설정하기

   Claude Code에서 /plugin install telegram@claude-plugins-official을 실행하고 user scope를 고르세요. 마켓플레이스를 찾을 수 없다고 나오면 /plugin marketplace add anthropics/claude-plugins-official로 추가하세요. 그다음 /telegram:configure <token>으로 토큰을 저장하거나, Claude Code를 시작하기 전에 TELEGRAM_BOT_TOKEN을 설정하세요.

3. 채널을 켜고 다시 시작하기

   Claude Code를 종료하고 --channels plugin:telegram@claude-plugins-official로 다시 시작하세요. 채널 플러그인은 공백으로 구분해 여러 개 넘길 수 있어요.

4. 페어링하고 잠그기

   봇에 아무 메시지나 보내면 페어링 코드로 답해요. /telegram:access pair <code>로 승인한 다음 /telegram:access policy allowlist를 실행하면 내 계정만 세션에 닿을 수 있어요.

출처: Anthropic의 Claude Code 문서, channels

Discord와 iMessage

• Discord: Discord Developer Portal에서 애플리케이션을 만들고, 봇 토큰을 복사하고, Message Content Intent를 켠 다음, bot scope로 봇을 초대하세요. 그리고 /plugin install discord@claude-plugins-official, /discord:configure <token>을 실행하고, --channels plugin:discord@claude-plugins-official로 다시 시작한 뒤, 봇에 DM을 보내고 /discord:access pair <code>로 페어링하세요.
• iMessage: macOS 전용이고 봇이나 토큰이 필요 없어요. 메시지 데이터베이스를 읽으니 터미널에 전체 디스크 접근 권한을 주세요. imessage@claude-plugins-official을 설치하고 --channels plugin:imessage@claude-plugins-official로 다시 시작한 다음 나 자신에게 문자를 보내세요. 다른 사람은 /imessage:access allow <전화번호 또는 Apple ID 이메일>로 추가해요.
• Slack: 채널이 아니에요. Claude in Slack은 로컬 세션에 메시지를 보내는 대신 @Claude 멘션으로 클라우드 세션을 시작해요.
• WhatsApp과 다른 앱: 공식 채널 플러그인이 없어요. channels 레퍼런스를 보고 직접 만들어야 해요.

채널을 쓸 수 없거나 작동하지 않나요?

• 계정 유형: channels는 claude.ai 로그인이나 Console API 키가 필요해요. Amazon Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry로는 작동하지 않아요.
• 조직: Claude Team과 Enterprise에서는 Owner가 Organization settings > Claude Code > Channels에서 켤 때까지 막혀 있어요. 시작할 때 경고가 떠요. 조직이 없는 Pro, Max, Ultra 계정은 이 확인을 건너뛰어요.
• 승인되지 않은 플러그인: 프리뷰 기간에는 --channels가 Anthropic(또는 조직)의 허용 목록에 있는 플러그인만 받아요. 그 밖의 플러그인은 채널 없이 시작되고, 시작 안내에 이유가 나와요.
• 봇이 답하지 않음: Claude Code가 --channels로 실행 중이어야 해요. 봇은 채널이 활성화된 동안에만 답할 수 있어요.
• 작업 도중 멈춤: 권한 확인 창이 뜨면 누군가 답할 때까지 세션이 멈춰요. 일부 채널은 그 확인 요청을 휴대폰으로 전달할 수 있어요.

낯선 사람 막기

• 모든 공식 채널은 발신자 허용 목록을 두고, 그 밖의 사람이 보낸 메시지는 조용히 버려요. Telegram과 Discord는 페어링으로 나를 추가하고, iMessage는 내가 보낸 메시지를 통과시켜요.
• --channels에 이름을 적은 서버만 메시지를 밀어 넣을 수 있어요. .mcp.json에 있는 것만으로는 안 돼요.
• 채널이 권한 확인 요청을 전달한다면, 허용 목록에 있는 누구든 내 세션의 도구 사용을 승인하거나 거부할 수 있어요. 그만큼 믿을 수 있는 사람만 추가하세요.

Channels vs Remote Control vs Claude in Slack

Claude Code가 답만 하지 말고 먼저 메시지를 보내게 하기

채널은 켜 둔 세션과 대화하는 방법이에요. Crewmark는 그 세션을 AI 직원으로 바꿔 줘요. 근무 시간 동안 하트비트에 맞춰 깨어나 보드에서 다음 이슈를 가져가고, 막히면 내가 먼저 문자를 보내지 않아도 Crewmark에서 메시지를 보내요.

1. 내 Claude Code로 직원 채용하기

   Claude Code 대화에서 설정 명령을 실행하면 그 대화가 직원이 돼요. AI 직원이란을 참고하세요.

2. 근무 시간과 하트비트 주기

   근무 시간과 깨어나는 간격을 15~240분 사이에서 고르세요. Claude Code를 능동적으로 만드는 법을 참고하세요.

3. 필요할 때 답하기

   결정할 일은 다이렉트 메시지로 오고, 한 번 답하면 계속 진행해요. 밤샘 작업은 Claude Code를 24시간 돌리는 법을 참고하세요.

FAQ