Team 및 Enterprise 플랜에서 Claude Code 채널 활성화 방법 (단계별)

Claude Code를 채널(예: AgentRQ), Telegram 봇 또는 Discord 봇에 연결하고 휴대폰으로 메시지를 보냈습니다. 아무 일도 일어나지 않았습니다. Claude Code가 시작되고, MCP 서버가 연결되며, 도구들이 작동하지만, 메시지가 세션에 표시되지 않았습니다. 시작 경고에서는 관리자에게 문의하라고 합니다.

만약 claude.ai Team 또는 Enterprise 플랜을 사용하고 있다면, 이는 정상입니다. 채널은 조직용으로 기본적으로 **비활성화(off)**되어 있으며, 누군가 스위치를 켜야 아무도 사용할 수 있습니다.

이 가이드에서는 이 스위치 화면을 단계별로 안내하며, 관리형 설정 경로와 팀에서 어떤 채널 플러그인을 실행할지 제한하는 방법을 다룹니다.

요약 (TL;DR)

• Claude Code Channels는 연구 미리보기(research preview)이며, claude.ai Team 및 Enterprise 플랜에서는 기본적으로 차단되어 있습니다.
• **소유자(Owner)**가 조직 설정 → Claude Code → 채널(claude.ai/admin-settings/claude-code)에서 이를 활성화합니다.
• 대안은 관리형 설정에서 channelsEnabled: true로 설정하는 것입니다. 어떤 플러그인을 등록할지 지정하려면 allowedChannelPlugins를 추가하십시오.
• 채널이 활성화되면, 각 개발자는 여전히 세션별로 채널을 선택합니다. 4단계에서는 AgentRQ, Telegram 및 Discord를 설정하는 방법을 보여줍니다.

Claude Code Channels란 무엇이며, 왜 내 조직에서는 비활성화되어 있나요?

**채널(channel)**은 이미 실행 중인 Claude Code 세션으로 이벤트를 **푸시(pushes)**하는 MCP 서버입니다. 일반적인 MCP 도구는 Claude가 호출할 때만 응답합니다. 채널은 사용자가 터미널에서 벗어나 있는 동안에도 새로운 작업, 에이전트가 사용자에게 질문한 것에 대한 답장, CI 실패 또는 모니터링 경고를 세션으로 전달할 수 있습니다. Claude는 이 이벤트를 읽고 실제 파일에 대해 작업을 수행하며 동일한 채널을 통해 응답할 수 있습니다.

따라서 채널은 개발자의 장치로 들어오는 인바운드 경로(inbound path)가 되며, Anthropic은 이를 조직 관리자가 허용할지 여부를 결정하도록 맡겨둡니다. 기본값은 로그인 방식에 따라 다릅니다:

누가 Channels를 활성화할 수 있나요?

claude.ai 조직에서 Owner 역할을 가진 사용자만 가능합니다. Owner 역할이 아닌 관리자나 일반 멤버는 토글을 변경할 수 없습니다. 본인이 아니라면, 이 게시물을 Owner에게 전달하세요.

1단계: Organization 설정 열기

Team 또는 Enterprise 계정으로 claude.ai에 로그인합니다. 왼쪽 하단에 있는 이름을 클릭하여 계정 메뉴를 열고, 상단에서 조직(개인 계정이 아닌지 확인)이 선택되었는지 확인한 다음, Organization settings를 선택합니다.

2단계: Products → Claude Code로 이동하여 Channels 찾기

Organization settings의 왼쪽 사이드바에서 Products 그룹으로 스크롤하여 Claude Code (1)를 클릭합니다.

Claude Code 페이지는 길습니다. 설정에 가장 빨리 접근하는 방법은 브라우저의 검색창을 이용하는 것입니다: macOS에서는 Cmd+F, Windows 및 Linux에서는 Ctrl+F를 누르고 channels라고 입력합니다 (2). 이 기능은 Dynamic workflows 아래 Capabilities 섹션에 있습니다.

Channels 토글 (3)을 켭니다. 여기에는 Preview 배지가 붙어 있으며, 설명은 다음과 같습니다: "팀이 Claude Code 세션에서 MCP 서버로부터 인바운드 메시지를 수신하도록 허용합니다."

메뉴를 클릭하는 과정은 생략하고 다음 페이지로 직접 접속할 수 있습니다: claude.ai/admin-settings/claude-code.

3단계: "관리자가 설정함(Set by admin)" 문구 확인하기

토글을 켜면, 그 옆의 레이블이 **기본값(Default)**에서 **관리자가 설정함(Set by admin)**으로 변경됩니다. 이 레이블은 해당 설정이 조직 전체에 적용되며 멤버들이 이를 재정의할 수 없다는 것을 의미합니다.

이것이 관리자 측면의 모든 설정입니다.

4단계: 채널 연결하기 (AgentRQ, Telegram 또는 Discord)

설정을 켜는 것만으로는 아무것도 시작되지 않습니다. 각 개발자는 여전히 자신의 세션이 신뢰할 채널 서버를 선택해야 합니다. 일반적으로 사용되는 세 가지 설정은 다음과 같습니다: AgentRQ와 Anthropic의 공식 Telegram 및 Discord 플러그인입니다. 하나를 선택하거나 여러 개를 동시에 실행할 수 있습니다.

옵션 A: AgentRQ

AgentRQ는 Claude Code가 사용자의 컴퓨터에서 계속 실행되는 동안, 휴대폰이나 데스크톱을 통해 작업을 할당하고, 에이전트의 질문에 답변하며, 그 행동을 승인할 수 있게 해줍니다. 사용자가 봇이나 서버를 직접 실행하는 것은 아닙니다.

1. 워크스페이스 생성하기. app.agentrq.com에 로그인하여 프로젝트용 워크스페이스를 만들고 **MCP 토큰 생성(Generate MCP Token)**을 클릭합니다. 이 토큰은 한 번만 표시되므로 복사해 두세요. 워크스페이스 ID도 기록해 둡니다.

2. 서버를 프로젝트 루트의 .mcp.json에 추가하기. claude를 실행하는 곳입니다:

{

`.mcp.json`에 있는 서버만으로는 Claude가 AgentRQ 도구를 사용할 수 있게 하지만, 세션으로 아무것도 푸시할 수는 없습니다. 새로운 작업과 사용자의 답변은 서버가 채널로 이름 지어질 때만 도착합니다.

AgentRQ는 사용자 지정(custom) 채널입니다. 리서치 프리뷰 기간 동안에는 Anthropic의 허용 목록(allowlist)에 있는 플러그인만 `--channels`를 통해 로드되므로, 이와 같은 사용자 지정 채널은 `--dangerously-load-development-channels`를 통해 로드됩니다. 이 플래그는 확인 프롬프트 이후에 플러그인 허용 목록을 건너뜁니다. **이것은 채널 기능 자체가 꺼진 조직(organization)을 우회하지 못하므로**, 따라서 위에 있는 Owner 토글이 먼저 나오는 것입니다. `--name`은 단순히 세션에 레이블을 붙이는 것일 뿐입니다.

**4. 작업 전송하기.** AgentRQ 앱에서 작업을 생성합니다. 이 작업은 실행 중인 세션에 `<channel>` 이벤트로 도착하고, Claude가 이를 처리하며, 진행 상황 업데이트와 질문이 앱으로 다시 돌아옵니다.

### 옵션 B: Telegram

공식 플러그인은 [Bun](https://bun.sh)에서 실행되므로, 먼저 이것을 설치해야 합니다.

1. Telegram에서 [@BotFather](https://t.me/BotFather)를 열고 `/newbot`을 보내고, 이름과 `bot`으로 끝나는 사용자 이름을 선택한 후 반환되는 토큰을 복사합니다.
2. 플러그인을 설치하고 토큰을 저장합니다. Claude Code 내에서 다음 명령어를 실행합니다:

/plugin install telegram@claude-plugins-official
/telegram:configure <토큰>

3. Claude Code를 종료하고 채널과 함께 다시 시작합니다:

claude --channels plugin:telegram@claude-plugins-official

4. 봇에게 아무 메시지나 보냅니다. 그러면 페어링 코드와 함께 답장이 옵니다. 코드를 승인하고 계정에 대한 접근을 잠급니다:

/telegram:access pair <코드>
/telegram:access policy allowlist

### 옵션 C: Discord

1. [Discord Developer Portal](https://discord.com/developers/applications)에서 애플리케이션을 생성합니다. **Bot** 섹션에서 **Reset Token**을 클릭하고 복사합니다. **Privileged Gateway Intents** 아래에서 **Message Content Intent**를 켭니다.
2. **OAuth2 → URL Generator** 아래에서 `bot` 스코프를 선택하고 다음 권한들을 부여합니다: View Channels, Send Messages, Send Messages in Threads, Read Message History, Attach Files and Add Reactions. 생성된 URL을 열어 봇을 서버에 추가합니다.
3. 플러그인을 설치하고 토큰을 저장한 후, 채널과 함께 재시작합니다:

/plugin install discord@claude-plugins-official
/discord:configure <token>

claude --channels plugin:discord@claude-plugins-official

1. 봇에게 DM을 보냅니다. 봇이 페어링 코드를 담아 답장합니다. 이를 승인하고 접근을 잠급니다:

/discord:access pair <code>
/discord:access policy allowlist

세션에서 여러 채널을 실행하려면 모두 나열합니다. `--channels`는 공백으로 구분된 여러 플러그인을 받으며, 이를 `--dangerously-load-development-channels`와 함께 사용할 수 있습니다:

claude --channels plugin:telegram@claude-plugins-official plugin:discord@claude-plugins-official
--dangerously-load-development-channels server:agentrq-WORKSPACE_ID

두 플래그 모두 Channels가 미리 보기(preview) 상태일 때는 `claude --help`에 표시되지 않지만, 둘 다 작동합니다. 만약 org 설정이 여전히 꺼져 있다면, 모든 서버가 연결되고 그 도구들이 작동하지만 채널 메시지는 도착하지 않으며, 시작 시 경고 메시지가 사용자에게 관리자에게 문의하라고 알려줍니다.

## 관리형 설정(managed settings)으로도 Channels를 활성화할 수 있나요?

네. 이미 Claude Code [관리형 설정](https://code.claude.com/docs/en/settings)을 배포했다면, 그곳에서 마스터 스위치를 설정하세요:

{

기본적으로 Anthropic의 채널 허용 목록(allowlist)에 있는 모든 플러그인은 등록할 수 있습니다. 이는 claude-plugins-official에 있는 플러그인들을 의미합니다. Team 및 Enterprise 플랜에서는 이 목록을 allowedChannelPlugins로 대체할 수 있습니다. 각 항목은 플러그인의 이름과 해당 마켓플레이스를 지정합니다:

{
  "channelsEnabled": true,
  "allowedChannelPlugins": [
...

알아두면 좋은 몇 가지 규칙이 있습니다:

• allowedChannelPlugins는 channelsEnabled가 true일 때만 적용됩니다.
• 플러그인이 목록에 없으면 Claude Code는 여전히 시작되지만, 채널은 등록되지 않습니다. 시작 알림에는 해당 플러그인이 조직의 승인된 목록에 없다고 표시됩니다.
• 각 항목은 마켓플레이스뿐만 아니라 플러그인 이름과도 일치해야 합니다.
• **빈 배열(empty array)**을 지정하면 모든 허용 목록 플러그인이 차단됩니다. AgentRQ와 같이 --dangerously-load-development-channels로 로드된 서버는 여전히 실행될 수 있습니다. 채널을 완전히 비활성화하려면, 개발 플래그를 포함하여 channelsEnabled를 설정하지 마십시오.

관리자가 활성화하기 전에 고려해야 할 사항은 무엇인가요?

채널은 외부 이벤트가 세션에 도달할 수 있게 해주기 때문에 유용하며, 이 부분도 계획을 세워야 합니다:

• 누가 세션에 접근할 수 있나요. Telegram과 Discord는 페어링(pairing)을 통해 채우는 발신자 허용 목록(sender allowlist)을 유지하며, 다른 사람의 메시지는 조용히 삭제됩니다. 항상 access policy allowlist로 마무리해야 합니다. AgentRQ를 사용하는 경우, 워크스페이스 MCP 토큰이 핵심입니다. 이 토큰을 가진 사람은 누구나 워크스페이스에 연결할 수 있으므로, .mcp.json 파일을 공개 레포지토리에 두지 말고 유출된 경우 새 토큰을 생성하십시오.
• 누가 작업을 승인할 수 있나요. 채널이 권한 프롬프트를 전달하는 경우, 이를 통해 답변할 수 있는 사람은 누구나 해당 세션에서 도구 사용을 승인하거나 거부할 수 있습니다. 이 접근 권한은 키보드 앞에서 신뢰하는 사람에게만 부여하십시오.
• 비접속(Unattended) 세션. 채널에 --dangerously-skip-permissions를 페어링하는 사람은 자신이 신뢰하는 환경에서만 그렇게 해야 합니다.

FAQ

관리자가 채널을 활성화한 후 Claude Code를 다시 시작해야 하나요?
네. 해당 설정은 세션이 시작될 때 확인됩니다. 채널 플래그와 함께 종료했다가 다시 실행하세요.