28. Slack에서 Claude Code 사용하기
Slack @Claude 연동·코딩 위임·접근 권한 설정 등 협업 가이드
Slack에서 Claude Code 사용하기
Slack 워크스페이스에서 직접 코딩 작업을 위임하세요
Slack에서의 Claude Code는 Claude Code의 강력한 기능을 Slack 워크스페이스에 직접 제공합니다. 코딩 작업과 함께 @Claude를 멘션하면, Claude가 자동으로 의도를 감지하고 웹에서 Claude Code 세션을 생성하여 팀 대화를 떠나지 않고도 개발 작업을 위임할 수 있습니다.
이 통합은 기존 Claude for Slack 앱을 기반으로 구축되었으며, 코딩 관련 요청에 대해 웹의 Claude Code로 지능적 라우팅을 추가합니다.
사용 사례
- 버그 조사 및 수정: Slack 채널에 버그가 보고되는 즉시 Claude에게 조사 및 수정을 요청하세요.
- 빠른 코드 리뷰 및 수정: 팀 피드백을 기반으로 Claude에게 소규모 기능 구현이나 코드 리팩토링을 맡기세요.
- 협업 디버깅: 팀 논의에서 중요한 컨텍스트(예: 에러 재현 또는 사용자 보고)가 제공되면, Claude가 해당 정보를 활용하여 디버깅에 접근할 수 있습니다.
- 병렬 작업 실행: Slack에서 코딩 작업을 시작하고 다른 작업을 계속하면서, 완료 시 알림을 받을 수 있습니다.
사전 요구 사항
Slack에서 Claude Code를 사용하기 전에 다음 사항을 확인하세요:
| 요구 사항 | 세부 내용 |
|---|---|
| Claude 플랜 | Pro, Max, Teams 또는 Enterprise(Claude Code 접근이 포함된 프리미엄 시트 필요) |
| 웹의 Claude Code | 웹의 Claude Code 접근이 활성화되어 있어야 합니다 |
| GitHub 계정 | 웹의 Claude Code에 연결되어 있으며, 최소 하나의 리포지토리가 인증되어 있어야 합니다 |
| Slack 인증 | Claude 앱을 통해 Slack 계정이 Claude 계정과 연결되어 있어야 합니다 |
Slack에서 Claude Code 설정하기
Step 1: Slack에 Claude 앱 설치
워크스페이스 관리자가 Slack App Marketplace에서 Claude 앱을 설치해야 합니다. Slack App Marketplace를 방문하여 "Add to Slack"을 클릭하면 설치가 시작됩니다.
Step 2: Claude 계정 연결
앱이 설치된 후, 개별 Claude 계정을 인증하세요:
- Slack의 Apps 섹션에서 "Claude"를 클릭하여 Claude 앱을 여세요
- App Home 탭으로 이동하세요
- "Connect"를 클릭하여 Slack 계정과 Claude 계정을 연결하세요
- 브라우저에서 인증 과정을 완료하세요
Step 3: 웹의 Claude Code 구성
웹의 Claude Code가 올바르게 구성되어 있는지 확인하세요:
- claude.ai/code를 방문하여 Slack에 연결한 것과 동일한 계정으로 로그인하세요
- GitHub 계정이 아직 연결되지 않았다면 연결하세요
- Claude가 작업할 리포지토리를 최소 하나 인증하세요
Step 4: 라우팅 모드 선택
계정을 연결한 후, Slack에서 Claude가 메시지를 처리하는 방식을 구성하세요. Slack의 Claude App Home에서 Routing Mode 설정을 찾을 수 있습니다.
| 모드 | 동작 |
|---|---|
| Code only | Claude가 모든 @멘션을 Claude Code 세션으로 라우팅합니다. Slack에서 Claude를 개발 작업에만 사용하는 팀에 적합합니다. |
| Code + Chat | Claude가 각 메시지를 분석하여 Claude Code(코딩 작업)와 Claude Chat(작문, 분석, 일반 질문) 사이에서 지능적으로 라우팅합니다. 모든 유형의 작업에 단일 @Claude 진입점을 원하는 팀에 적합합니다. |
참고:
Code + Chat 모드에서 Claude가 메시지를 Chat으로 라우팅했지만 코딩 세션을 원했다면, "Retry as Code"를 클릭하여 Claude Code 세션을 생성할 수 있습니다. 마찬가지로, Code로 라우팅되었지만 Chat 세션을 원했다면, 해당 스레드에서 해당 옵션을 선택할 수 있습니다.
Step 5: 채널에 Claude 추가
설치 후 Claude는 어떤 채널에도 자동으로 추가되지 않습니다. 채널에서 Claude를 사용하려면 해당 채널에서 /invite @Claude를 입력하여 초대하세요. Claude는 추가된 채널에서만 @멘션에 응답할 수 있습니다.
작동 방식
자동 감지
Slack 채널이나 스레드에서 @Claude를 멘션하면, Claude가 자동으로 메시지를 분석하여 코딩 작업인지 판단합니다. 코딩 의도가 감지되면 일반 채팅 어시스턴트로 응답하는 대신 웹의 Claude Code로 요청을 라우팅합니다.
자동 감지되지 않더라도 Claude에게 코딩 작업으로 처리하도록 명시적으로 지시할 수도 있습니다.
참고:
Slack에서의 Claude Code는 채널(공개 또는 비공개)에서만 작동합니다. 다이렉트 메시지(DM)에서는 작동하지 않습니다.
컨텍스트 수집
스레드에서: 스레드에서 @Claude를 멘션하면, 전체 대화를 이해하기 위해 해당 스레드의 모든 메시지에서 컨텍스트를 수집합니다.
채널에서: 채널에서 직접 멘션하면, Claude가 관련 컨텍스트를 위해 최근 채널 메시지를 확인합니다.
이 컨텍스트는 Claude가 문제를 이해하고, 적절한 리포지토리를 선택하며, 작업에 대한 접근 방식을 결정하는 데 도움을 줍니다.
주의:
Slack에서 @Claude가 호출되면, Claude는 요청을 더 잘 이해하기 위해 대화 컨텍스트에 접근합니다. Claude는 컨텍스트에 있는 다른 메시지의 지시를 따를 수 있으므로, 신뢰할 수 있는 Slack 대화에서만 Claude를 사용해야 합니다.
세션 흐름
- 시작: @Claude를 멘션하여 코딩 요청을 합니다
- 감지: Claude가 메시지를 분석하고 코딩 의도를 감지합니다
- 세션 생성: claude.ai/code에서 새로운 Claude Code 세션이 생성됩니다
- 진행 상황 업데이트: 작업이 진행됨에 따라 Claude가 Slack 스레드에 상태 업데이트를 게시합니다
- 완료: 완료되면 Claude가 요약과 액션 버튼과 함께 사용자를 @멘션합니다
- 리뷰: "View Session"을 클릭하여 전체 트랜스크립트를 보거나, "Create PR"을 클릭하여 풀 리퀘스트를 열 수 있습니다
사용자 인터페이스 요소
App Home
App Home 탭은 연결 상태를 표시하며, Slack에서 Claude 계정을 연결하거나 연결 해제할 수 있습니다.
메시지 액션
- View Session: 브라우저에서 전체 Claude Code 세션을 열어 수행된 모든 작업을 확인하고, 세션을 계속하거나, 추가 요청을 할 수 있습니다.
- Create PR: 세션의 변경 사항으로부터 직접 풀 리퀘스트를 생성합니다.
- Retry as Code: Claude가 처음에 채팅 어시스턴트로 응답했지만 코딩 세션을 원했다면, 이 버튼을 클릭하여 Claude Code 작업으로 재시도할 수 있습니다.
- Change Repo: Claude가 잘못된 리포지토리를 선택한 경우 다른 리포지토리를 선택할 수 있습니다.
리포지토리 선택
Claude는 Slack 대화의 컨텍스트를 기반으로 자동으로 리포지토리를 선택합니다. 여러 리포지토리가 해당될 수 있는 경우, Claude가 드롭다운을 표시하여 올바른 리포지토리를 선택할 수 있도록 합니다.
접근 권한 및 권한
사용자 수준 접근
| 접근 유형 | 요구 사항 |
|---|---|
| Claude Code 세션 | 각 사용자는 자신의 Claude 계정으로 세션을 실행합니다 |
| 사용량 및 속도 제한 | 세션은 개별 사용자의 플랜 한도에 포함됩니다 |
| 리포지토리 접근 | 사용자는 본인이 직접 연결한 리포지토리에만 접근할 수 있습니다 |
| 세션 기록 | 세션은 claude.ai/code의 Claude Code 기록에 표시됩니다 |
워크스페이스 수준 접근
Slack 워크스페이스 관리자가 워크스페이스에서 Claude 앱의 사용 가능 여부를 제어합니다:
| 제어 항목 | 설명 |
|---|---|
| 앱 설치 | 워크스페이스 관리자가 Slack App Marketplace에서 Claude 앱 설치 여부를 결정합니다 |
| Enterprise Grid 배포 | Enterprise Grid 조직의 경우, 조직 관리자가 Claude 앱에 접근할 수 있는 워크스페이스를 제어할 수 있습니다 |
| 앱 제거 | 워크스페이스에서 앱을 제거하면 해당 워크스페이스의 모든 사용자에 대한 접근이 즉시 취소됩니다 |
채널 기반 접근 제어
설치 후 Claude는 어떤 채널에도 자동으로 추가되지 않습니다. 사용자가 Claude를 사용하려는 채널에 명시적으로 초대해야 합니다:
- 초대 필요: 채널에 Claude를 추가하려면
/invite @Claude를 입력하세요 - 채널 멤버십으로 접근 제어: Claude는 추가된 채널에서만 @멘션에 응답할 수 있습니다
- 채널을 통한 접근 제한: 관리자는 Claude가 초대된 채널과 해당 채널에 접근할 수 있는 사용자를 관리하여 Claude Code 사용을 제어할 수 있습니다
- 비공개 채널 지원: Claude는 공개 및 비공개 채널 모두에서 작동하여 팀이 가시성을 유연하게 제어할 수 있습니다
이 채널 기반 모델을 통해 팀은 Claude Code 사용을 특정 채널로 제한할 수 있으며, 워크스페이스 수준 권한 외에 추가적인 접근 제어 계층을 제공합니다.
어디에서 무엇에 접근할 수 있는가
Slack에서: 상태 업데이트, 완료 요약 및 액션 버튼을 볼 수 있습니다. 전체 트랜스크립트는 보존되며 항상 접근할 수 있습니다.
웹에서: 전체 대화 기록, 모든 코드 변경 사항, 파일 작업을 포함한 완전한 Claude Code 세션을 확인할 수 있으며, 세션을 계속하거나 풀 리퀘스트를 생성할 수 있습니다.
Enterprise 및 Teams 계정의 경우, Slack에서의 Claude를 통해 생성된 세션은
조직에 자동으로 표시됩니다. 자세한 내용은 웹의 Claude Code 세션 공유를
참조하세요.
모범 사례
효과적인 요청 작성법
- 구체적으로 작성하세요: 관련이 있는 경우 파일 이름, 함수 이름 또는 에러 메시지를 포함하세요.
- 컨텍스트를 제공하세요: 대화에서 명확하지 않은 경우 리포지토리나 프로젝트를 언급하세요.
- 성공 기준을 정의하세요: "완료"가 어떤 상태인지 설명하세요 — Claude가 테스트를 작성해야 하나요? 문서를 업데이트해야 하나요? PR을 생성해야 하나요?
- 스레드를 활용하세요: 버그나 기능을 논의할 때 스레드에서 답글을 달아 Claude가 전체 컨텍스트를 수집할 수 있도록 하세요.
Slack vs. 웹 사용 시점
Slack을 사용할 때: Slack 논의에 이미 컨텍스트가 존재할 때, 비동기적으로 작업을 시작하고 싶을 때, 또는 가시성이 필요한 팀원과 협업할 때.
웹을 직접 사용할 때: 파일을 업로드해야 할 때, 개발 중 실시간 상호작용이 필요할 때, 또는 더 길고 복잡한 작업을 수행할 때.
문제 해결
세션이 시작되지 않는 경우
- Claude App Home에서 Claude 계정이 연결되어 있는지 확인하세요
- 웹의 Claude Code 접근이 활성화되어 있는지 확인하세요
- Claude Code에 최소 하나의 GitHub 리포지토리가 연결되어 있는지 확인하세요
리포지토리가 표시되지 않는 경우
- claude.ai/code에서 웹의 Claude Code에 리포지토리를 연결하세요
- 해당 리포지토리에 대한 GitHub 권한을 확인하세요
- GitHub 계정을 연결 해제한 후 다시 연결해 보세요
잘못된 리포지토리가 선택된 경우
- "Change Repo" 버튼을 클릭하여 다른 리포지토리를 선택하세요
- 더 정확한 선택을 위해 요청에 리포지토리 이름을 포함하세요
인증 오류
- App Home에서 Claude 계정을 연결 해제한 후 다시 연결하세요
- 브라우저에서 올바른 Claude 계정으로 로그인되어 있는지 확인하세요
- Claude 플랜에 Claude Code 접근이 포함되어 있는지 확인하세요
세션 만료
- 세션은 웹의 Claude Code 기록에서 계속 접근할 수 있습니다
- claude.ai/code에서 이전 세션을 계속하거나 참조할 수 있습니다
현재 제한 사항
- GitHub만 지원: 현재 GitHub의 리포지토리만 지원합니다.
- 한 번에 하나의 PR: 각 세션에서 하나의 풀 리퀘스트만 생성할 수 있습니다.
- 속도 제한 적용: 세션은 개별 Claude 플랜의 속도 제한을 사용합니다.
- 웹 접근 필요: 사용자는 웹의 Claude Code 접근 권한이 있어야 합니다. 그렇지 않으면 일반 Claude 채팅 응답만 받게 됩니다.
관련 리소스
- 웹의 Claude Code - 웹의 Claude Code에 대해 자세히 알아보기
- Claude for Slack - Claude for Slack 일반 문서
- Slack App Marketplace - Slack Marketplace에서 Claude 앱 설치하기
- Claude 도움말 센터 - 추가 지원 받기