Feishu 그룹에서 코딩 에이전트를 멘션한다는 것은 그룹 멤버가 Feishu(중국 외 지역에서는 Lark)에서 메시지를 작성하면, 그 메시지가 누군가의 머신에서 실행 중인 Claude Code 또는 Codex 에이전트로 전달되고, 실행 과정과 결과가 동일한 스레드로 돌아오며, 위험한 작업은 먼저 머신 소유자를 위한 승인 카드로 전달됨을 의미합니다. 에이전트는 클라우드로 이동하지 않으며, 자격 증명은 컴퓨터 밖으로 절대 나가지 않고, 그룹의 누구도 별도의 프로그램을 설치할 필요가 없습니다.
이 글에서는 바인딩, 라우팅, 승인 및 스로틀링을 포함한 muti의 Feishu 커넥터 설계와 정식 출시 전에 미리 설정할 수 있는 사항을 다룹니다. 커넥터는 현재 개발 중이며, 아래 내용은 오늘 바로 활성화할 수 있는 기능이 아닌 동작 사양에 대한 설명입니다. 중국어 원문은 /zh-CN/blog/feishu-lark-claude-code에서 확인할 수 있습니다.
별도의 클라이언트 대신 채팅 앱을 사용하는 이유
에이전트를 공유받는 사람은 에이전트를 한 번 쓰려고 계정을 만들고 새 클라이언트를 설치하는 일을 가장 원치 않습니다. 중국 내 팀의 경우 업무 대화가 이미 Feishu에서 이루어지고 있습니다. 사람들을 에이전트 쪽으로 데려오는 것보다 에이전트를 그들이 있는 곳으로 가져가는 것이 훨씬 쉽습니다.
Feishu는 이 작업에 아주 적합합니다. 장시간 연결(long-connection) 이벤트 구독 방식 덕분에 퍼블릭 콜백 URL이 필요 없고, 메시지 카드는 그 자리에서 업데이트되며, 스레드 답글을 통해 하나의 작업 트래픽을 한곳에 모아둘 수 있고, 이미지를 다운로드하여 에이전트의 입력값으로 활용할 수도 있습니다.
두 가지 바인딩
그룹 ↔ 룸. 룸은 muti의 경계입니다. 누가 무엇을 볼 수 있고 어떤 에이전트를 사용할 수 있는지를 결정합니다. Feishu 그룹을 룸에 바인딩하면 룸의 멤버십과 권한 부여가 해당 그룹에 그대로 적용됩니다. 룸 설정에서 “connect a Feishu group”을 선택하고 6자리 코드를 받은 뒤, 그룹에 @muti bind 123456을 입력하면 됩니다.
개인 ↔ 계정. 멤버가 처음으로 봇을 멘션하면 봇이 개인 채팅으로 유효 기간이 짧은 코드를 보냅니다. 이를 muti에 입력하면 신원이 연동됩니다. 바인딩되지 않은 사람은 기본적으로 무시됩니다. 룸에서 게스트 모드를 활성화하면 질문은 가능하지만 실행을 트리거할 수는 없도록 설정할 수 있습니다.
바인딩의 핵심은 다음과 같습니다. 실행 권한은 그룹에서 누가 무엇을 말했는지가 아니라, 룸의 권한 부여와 소유자의 승인에서만 나옵니다. 채팅 메시지는 신뢰할 수 없는 입력으로 취급됩니다.
하나의 작업, 하나의 스레드: 접수, 승인 카드, 진행 상황, 결과가 모두 한곳에 표시됩니다.
하나의 작업, 하나의 스레드
멤버가 @muti @api rerun the failing tests and open a PR이라고 올립니다. 봇은 해당 메시지 아래에 스레드를 열고 순서대로 답글을 남깁니다.
- 요청 접수:
R20260906-03과 같은 요청 ID 및 상태 안내. - 승인 상태: 해당 사용자가 이 에이전트에 대한 상시 권한을 가지고 있지 않은 경우, 소유자에게만 보이는 승인 카드가 소유자에게 전송됩니다.
- 진행 상황 카드: 단계별로 또는 30초마다 제자리에서 업데이트됩니다. 변경된 파일, 지금까지의 테스트 결과, 명령 출력의 마지막 줄 등이 표시되며, 단계마다 새 메시지를 보내지 않습니다.
- 결과: 에이전트가 생성한 파일, 이미지, 링크와 함께 최종 답변이 전달됩니다.
메인 채널은 조용하게 유지되며, 세부 정보를 보고 싶은 사람만 스레드를 열어봅니다.
승인 카드
실행 중 위험한 작업에 도달하면 소유자에게 카드가 전송됩니다. 요청자, 대상 에이전트, 수행하려는 작업, 위반된 규칙이 표시됩니다. 세 개의 버튼이 제공됩니다: approve / reject / run read-only. 요청과 동일한 효력을 갖는 메모를 선택적으로 덧붙일 수 있습니다.
템플릿에 관계없이 네 가지 유형의 작업은 무조건 일시 정지됩니다. 공유 브랜치로 푸시, 삭제, 비용 발생, 자격 증명 접근. 로그인이나 2단계 인증 코드와 같은 보호된 입력은 요청자가 아닌 항상 소유자에게 전달됩니다. 승인은 기본적으로 24시간 후에 만료됩니다. Feishu, 웹, 모바일 어디서 결정하든 모든 환경에 동일하게 적용됩니다.
그룹에 표시되는 내용과 머신 밖으로 절대 나가지 않는 내용
지금 설정할 수 있는 것
- 룸에 에이전트 배치하기. 머신을 연결하고 공유하려는 디렉터리당 에이전트를 하나씩 생성한 뒤, 모델명이 아닌 작업 목적(
api,site,notes)에 맞게 이름을 지정하세요. - 그룹보다 룸을 먼저 구성하기. 나중에 바인딩할 그룹에 속할 사람들을 초대하고, 누가 읽기 전용이고 누가 편집할 수 있는지 설정하세요. 커넥터는 그룹 ↔ 해당 룸을 바인딩하여 이러한 규칙을 그대로 재사용합니다.
muti service install로 daemon을 서비스로 설치하기. 노트북 덮개를 닫았을 때 Feishu에서 온 작업이 실패하는 대신 머신을 대기하도록 합니다.- 팀 내부 스타일 문서화하기. STYLE.md, 프레젠테이션 템플릿, 지난주 리포트 SQL 등 에이전트가 참고해야 할 모든 것을 작업 디렉터리에 넣어 두세요.
자주 묻는 질문
Feishu 관리자의 승인이 필요한가요? muti 클라우드는 모든 사용자를 위해 하나의 Feishu 앱을 실행하므로, 테넌트에 설치할 때 일반적으로 한 번의 관리자 동의가 필요합니다. 셀프 호스팅 모드에서는 소유자가 자체 앱 자격 증명을 사용할 수 있습니다.
글로벌 버전인 Lark도 지원되나요? Feishu와 Lark는 동일한 오픈 플랫폼을 공유하므로 커넥터는 둘 다 지원합니다.
Slack과 DingTalk은 어떻게 되나요? Slack 커넥터는 이미 출시되었습니다. 에이전트당 1개의 봇이 제공되며 DM이나 멘션으로 호출하고, 승인은 소유자의 DM으로 전달됩니다. Feishu/Lark가 다음 순서이며, DingTalk(Stream 모드)이 그 뒤를 잇습니다. 세 가지 모두 동일한 룸과 권한 체계를 공유합니다. 푸시하기 전에 확인하는 Claude Code용 Slack 봇을 확인해 보세요.
그룹에 muti 사용자가 아닌 사람이 있으면 어떻게 되나요? 기본적으로 무시됩니다. 룸에서 게스트 모드를 열 수 있으며, 이 경우 게스트는 질문은 할 수 있지만 실행을 트리거할 수는 없습니다.
먼저 에이전트에 룸을 만들어 주세요. 그룹은 그곳에 연결됩니다. 여기서 시작하기.
게시일 · 수정일