Slack의 Claude Code
Slack에서 코딩 작업을 위임합니다. 이 이전 버전은 Claude Tag에 연결되지 않은 워크스페이스에서 Pro 및 Max 계정의 채널 멘션에만 응답합니다.
Slack의 Claude Code는 Claude Code의 강력한 기능을 Slack 워크스페이스에 직접 가져옵니다. @Claude를 언급하여 코딩 작업을 요청하면, Claude는 자동으로 의도를 감지하고 Claude Code 클라우드 세션을 생성하여 팀 대화를 떠나지 않고도 개발 작업을 위임할 수 있습니다.
이 통합은 기존 Slack용 Claude 앱을 기반으로 하지만 코딩 관련 요청에 대해 Claude Code 클라우드 세션으로 지능형 라우팅을 추가합니다. 각 세션은 사용자의 Claude 계정에서 실행되며, 연결된 저장소와 사용자의 플랜 한도를 사용합니다.
사용 사례
- 버그 조사 및 수정: Claude에 Slack 채널에서 보고된 버그를 조사하고 수정하도록 요청합니다.
- 빠른 코드 검토 및 수정: Claude가 팀 피드백을 기반으로 작은 기능을 구현하거나 코드를 리팩토링하도록 합니다.
- 협업 디버깅: 팀 토론에서 중요한 컨텍스트(예: 오류 재현 또는 사용자 보고)를 제공할 때, Claude는 이 정보를 사용하여 디버깅 접근 방식을 알릴 수 있습니다.
- 병렬 작업 실행: Slack에서 코딩 작업을 시작하면서 다른 작업을 계속하고, 완료되면 알림을 받습니다.
필수 조건
Slack에서 Claude Code를 사용하기 전에 다음을 확인하세요:
| 요구 사항 | 세부 정보 |
|---|---|
| Claude 플랜 | Pro 또는 Max |
| Slack 워크스페이스 | 어떤 조직에서도 Claude Tag에 연결되어 있지 않아야 합니다. @Claude가 지원 종료 안내로 응답하면 해당 워크스페이스는 연결되어 있는 것입니다 |
| 클라우드 세션 | 클라우드 세션이 계정에 대해 활성화되어 있습니다 |
| GitHub 계정 | claude.ai/code에서 연결되어 있으며 최소 하나의 저장소가 인증됨 |
| Slack 인증 | Claude 앱을 통해 Claude 계정에 연결된 Slack 계정 |
Slack에서 Claude Code 설정
Slack에 Claude 앱 설치
워크스페이스 관리자는 Slack 앱 마켓플레이스에서 Claude 앱을 설치해야 합니다. Slack 앱 마켓플레이스를 방문하여 "Slack에 추가"를 클릭하여 설치 프로세스를 시작합니다.
Claude 계정 연결
앱이 설치된 후 개별 Claude 계정을 인증합니다:
- 앱 섹션에서 "Claude"를 클릭하여 Slack에서 Claude 앱을 엽니다
- 앱 홈 탭으로 이동합니다
- "연결"을 클릭하여 Slack 계정을 Claude 계정과 연결합니다
- 브라우저에서 인증 흐름을 완료합니다
클라우드 세션 구성
클라우드 세션이 계정에 대해 제대로 구성되어 있는지 확인합니다:
- claude.ai/code를 방문하여 Slack에 연결한 동일한 계정으로 로그인합니다
- 아직 연결되지 않은 경우 GitHub 계정을 연결합니다
- Claude가 작업할 수 있도록 최소 하나의 저장소를 인증합니다
라우팅 모드 선택
계정을 연결한 후 Claude가 Slack의 메시지를 처리하는 방식을 구성합니다. Slack의 Claude 앱 홈으로 이동하여 라우팅 모드 설정을 찾습니다.
| 모드 | 동작 |
|---|---|
| 코드만 | Claude는 모든 @mentions을 Claude Code 세션으로 라우팅합니다. Claude를 Slack에서 개발 작업 전용으로 사용하는 팀에 가장 적합합니다. |
| 코드 + 채팅 | Claude는 각 메시지를 분석하고 Claude Code(코딩 작업용)와 Claude Chat(작성, 분석 및 일반 질문용) 간에 지능형으로 라우팅합니다. 모든 유형의 작업에 대해 단일 @Claude 진입점을 원하는 팀에 가장 적합합니다. |
Claude를 채널에 추가
Claude는 설치 후 자동으로 채널에 추가되지 않습니다. 채널에서 Claude를 사용하려면 해당 채널에서 /invite @Claude를 입력하여 초대합니다. Claude는 추가된 채널에서만 @mentions에 응답할 수 있습니다.
작동 방식
자동 감지
Code + Chat 라우팅 모드에서 Slack 채널이나 스레드에서 @Claude를 언급하면, Claude는 자동으로 메시지가 코딩 작업인지 여부를 감지합니다. 코딩 작업은 Claude Code 클라우드 세션으로 이동합니다. 그 외의 모든 것은 일반 채팅 응답을 받습니다. Code only 모드에서는 모든 @mention이 Claude Code로 이동합니다.
자동으로 감지되지 않더라도 Claude에 요청을 코딩 작업으로 처리하도록 명시적으로 지시할 수 있습니다.
컨텍스트 수집
스레드에서: 스레드에서 @Claude를 언급하면 전체 대화를 이해하기 위해 해당 스레드의 모든 메시지에서 컨텍스트를 수집합니다.
채널에서: 채널에서 직접 언급되면 Claude는 관련 컨텍스트를 위해 최근 채널 메시지를 살펴봅니다.
이 컨텍스트는 Claude가 문제를 이해하고, 적절한 저장소를 선택하고, 작업에 대한 접근 방식을 알리는 데 도움이 됩니다.
세션 흐름
- 시작: @Claude를 코딩 요청과 함께 언급합니다
- 감지: Claude가 메시지를 분석하고 코딩 의도를 감지합니다
- 세션 생성: claude.ai/code에서 새로운 Claude Code 세션이 생성됩니다
- 진행 상황 업데이트: Claude는 작업이 진행됨에 따라 Slack 스레드에 상태 업데이트를 게시합니다
- 완료: 완료되면 Claude는 요약 및 작업 버튼과 함께 @mentions을 합니다
- 검토: "세션 보기"를 클릭하여 전체 기록을 보거나 "PR 생성"을 클릭하여 풀 요청을 엽니다
사용자 인터페이스 요소
메시지 작업
- 세션 보기: 수행된 모든 작업을 볼 수 있고, 세션을 계속하거나 추가 요청을 할 수 있는 브라우저에서 전체 Claude Code 세션을 엽니다.
- PR 생성: 세션의 변경 사항에서 직접 풀 요청을 생성합니다.
- 코드로 다시 시도: Claude가 처음에 채팅 어시스턴트로 응답했지만 코딩 세션을 원했다면 이 버튼을 클릭하여 요청을 Claude Code 작업으로 다시 시도합니다.
- 저장소 변경: Claude가 잘못 선택한 경우 다른 저장소를 선택할 수 있습니다.
저장소 선택
Claude는 Slack 대화의 컨텍스트를 기반으로 저장소를 자동으로 선택합니다. 여러 저장소가 적용될 수 있는 경우 Claude는 올바른 저장소를 선택할 수 있는 드롭다운을 표시할 수 있습니다.
액세스 및 권한
사용자 수준 액세스
| 액세스 유형 | 요구 사항 |
|---|---|
| Claude Code 세션 | 각 사용자는 자신의 Claude 계정에서 세션을 실행합니다 |
| 사용량 및 속도 제한 | 세션은 개별 사용자의 플랜 제한에 대해 계산됩니다 |
| 저장소 액세스 | 사용자는 개인적으로 연결한 저장소에만 액세스할 수 있습니다 |
| 세션 기록 | 세션은 claude.ai/code의 Claude Code 기록에 나타납니다 |
워크스페이스 수준 액세스
Slack 워크스페이스 관리자는 Claude 앱을 워크스페이스에서 사용할 수 있는지 여부를 제어합니다:
| 제어 | 설명 |
|---|---|
| 앱 설치 | 워크스페이스 관리자는 Slack 앱 마켓플레이스에서 Claude 앱을 설치할지 여부를 결정합니다 |
| Enterprise Grid 배포 | Enterprise Grid 조직의 경우 조직 관리자는 어떤 워크스페이스가 Claude 앱에 액세스할 수 있는지 제어할 수 있습니다 |
| 앱 제거 | 워크스페이스에서 앱을 제거하면 해당 워크스페이스의 모든 사용자에 대한 액세스가 즉시 취소됩니다 |
채널 기반 액세스 제어
앱을 설치해도 Claude가 자동으로 채널에 추가되지 않습니다. Claude는 /invite @Claude로 초대된 채널에서만 @mentions에 응답합니다. 공개 및 비공개 채널 모두에서 작동합니다. 관리자는 Claude가 초대된 채널과 해당 채널에 액세스할 수 있는 사용자를 관리하여 Claude Code 사용을 제어할 수 있습니다. 이는 워크스페이스 수준 권한 이상의 추가 액세스 제어 계층을 제공합니다.
어디서 액세스할 수 있는지
Slack에서: 상태 업데이트, 완료 요약 및 작업 버튼이 표시됩니다. 전체 기록은 보존되며 항상 액세스할 수 있습니다.
claude.ai/code에서: 전체 대화 기록, 모든 코드 변경 사항 및 파일 작업이 포함된 완전한 Claude Code 세션입니다. 세션은 claude.ai/code의 Claude Code 기록에 유지되므로 이전 세션을 계속하거나, 참조하거나, 풀 요청을 생성할 수 있습니다.
Enterprise 및 Team 계정의 경우 Slack의 Claude에서 생성된 세션은 조직에 자동으로 표시됩니다. 자세한 내용은 클라우드 세션 공유를 참조하세요.
모범 사례
효과적인 요청 작성
- 구체적으로: 관련이 있을 때 파일 이름, 함수 이름 또는 오류 메시지를 포함합니다.
- 컨텍스트 제공: 대화에서 명확하지 않은 경우 저장소 또는 프로젝트를 언급합니다.
- 성공 정의: "완료"가 무엇인지 설명합니다. Claude가 테스트를 작성해야 합니까? 문서를 업데이트합니까? PR을 생성합니까?
- 스레드 사용: 버그나 기능을 논의할 때 스레드에서 회신하여 Claude가 전체 컨텍스트를 수집할 수 있도록 합니다.
Slack과 웹 사용 시기
Slack을 사용할 때: 컨텍스트가 이미 Slack 토론에 있을 때, 작업을 비동기적으로 시작하려고 할 때, 또는 가시성이 필요한 팀원과 협업할 때입니다.
웹을 직접 사용할 때: 파일을 업로드해야 할 때, 개발 중 실시간 상호 작용을 원할 때, 또는 더 길고 복잡한 작업을 수행할 때입니다.
문제 해결
"This workspace isn't set up for Claude Tag yet"
다음 두 조건이 모두 충족되면 @Claude는 답변 대신 이 알림으로 스레드에 응답합니다.
- 어떤 조직도 Slack 워크스페이스를 Claude Tag에 연결하지 않았습니다.
- Slack에서 연결한 Claude 계정이 Pro 또는 Max 플랜이 아닙니다.
Claude Tag는 Team 및 Enterprise 플랜에서 사용할 수 있습니다. 워크스페이스를 연결하려면 알림에 명시된 @Claude connect 명령으로 시작한 다음 Claude Tag 설정을 따릅니다.
"The legacy Claude in Slack bot is retired"
알림은 The legacy Claude in Slack bot is retired effective October 5, 2026 and no longer responds in channels.로 시작합니다. Slack 워크스페이스가 Claude 조직에 연결되어 있지만, 해당 조직의 Claude Tag 설정에서 채널, 워크스페이스 또는 조직 기본값에 여전히 이전 버전이 선택되어 있는 상태입니다. 이 알림은 사용자 본인의 플랜과 무관하므로 Pro 및 Max 계정에도 표시됩니다.
해당 조직의 Owner라면 Claude 관리자 설정을 열고 채널에 대해 Claude Tag를 켭니다. 이 설정을 상속하는 모든 채널을 한 번에 수정하려면 대신 워크스페이스 또는 조직 기본값에서 변경합니다. 전체 전환 과정은 이전 Claude in Slack에서 마이그레이션을 참조하세요. Owner가 아닌 경우, 이 항목을 Owner에게 보냅니다.
"Claude Code is not enabled for your account"
이 오류는 Claude 계정에 아직 클라우드 환경이 없다는 의미입니다. Slack에 연결한 동일한 계정으로 claude.ai/code에 한 번 로그인하고 웹 온보딩을 완료합니다. 이는 기본 클라우드 환경을 생성하거나 생성하도록 요청합니다. 오류는 다음 언급 시 해결됩니다. 각 사용자는 개별적으로 이 작업을 수행해야 합니다.
세션이 시작되지 않음
- Claude 앱 홈에서 Claude 계정이 연결되어 있는지 확인합니다
- 클라우드 세션이 계정에 대해 활성화되어 있는지 확인합니다
- Claude Code에 연결된 GitHub 저장소가 최소 하나 있는지 확인합니다
Claude Tag 채널의 세션이 시작되지 않음
이 항목은 Claude Tag를 사용하는 워크스페이스에 적용되며, 여기서 Claude는 조직의 공유 ID로 채널에서 작동하며 어떤 멤버의 계정으로도 작동하지 않습니다. claude.ai/code에서 채널의 클라우드 환경을 생성한 경우, 이는 개인 계정에 속하며 Claude는 개인 환경에서 채널 세션을 시작할 수 없습니다. Claude Code는 세션을 즉시 실패하며, 재시도해도 도움이 되지 않습니다.
Owner인 경우 환경이 본인 것이면, 환경 선택기에서 조직과 공유합니다. 그렇지 않으면 Owner가 관리자 설정의 Cloud environments 페이지에서 조직 공유 환경으로 다시 생성합니다.
두 가지 방법으로 적용할 수 있습니다:
- claude.ai/admin-settings/claude-code에서 조직 기본값으로 설정합니다.
- Claude Tag 관리자 설정에서 채널에 설정합니다.
Owner가 아닌 경우, 이 항목을 Owner에게 보냅니다.
저장소가 표시되지 않음
- claude.ai/code에서 저장소를 연결합니다
- 해당 저장소에 대한 GitHub 권한을 확인합니다
- GitHub 계정을 연결 해제했다가 다시 연결해봅니다
잘못된 저장소 선택됨
- "저장소 변경" 버튼을 클릭하여 다른 저장소를 선택합니다
- 더 정확한 선택을 위해 요청에 저장소 이름을 포함합니다
인증 오류
- 앱 홈에서 Claude 계정을 연결 해제했다가 다시 연결합니다
- 브라우저에서 올바른 Claude 계정으로 로그인했는지 확인합니다
현재 제한 사항
- GitHub만: 저장소는 GitHub에 있어야 합니다.
- 한 번에 하나의 PR: 각 세션은 하나의 풀 리퀘스트를 생성할 수 있습니다.
- 클라우드 세션 액세스 필요: 사용자는 클라우드 세션에 액세스해야 합니다.