Slack의 Claude Code
Slack 워크스페이스에서 직접 코딩 작업을 위임합니다. Anthropic은 Team 및 Enterprise 워크스페이스를 위해 이 이전 버전을 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 플랜 | Claude Code 액세스가 있는 Pro, Max, Team 또는 Enterprise(프리미엄 시트 또는 Chat + Claude Code 시트) |
| 클라우드 세션 | 클라우드 세션이 계정에 대해 활성화되어 있습니다 |
| 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 토론에 있을 때, 작업을 비동기적으로 시작하려고 할 때, 또는 가시성이 필요한 팀원과 협업할 때입니다.
웹을 직접 사용할 때: 파일을 업로드해야 할 때, 개발 중 실시간 상호 작용을 원할 때, 또는 더 길고 복잡한 작업을 수행할 때입니다.
문제 해결
"Claude Code가 계정에서 활성화되지 않았습니다"
이 오류는 Claude 계정에 아직 클라우드 환경이 없다는 의미입니다. Slack에 연결한 동일한 계정으로 claude.ai/code에 한 번 로그인하고 웹 온보딩을 완료합니다. 이는 기본 클라우드 환경을 생성하거나 생성하도록 요청합니다. 오류는 다음 언급 시 해결됩니다. 각 사용자는 개별적으로 이 작업을 수행해야 합니다.
세션이 시작되지 않음
- Claude 앱 홈에서 Claude 계정이 연결되어 있는지 확인합니다
- 클라우드 세션이 계정에 대해 활성화되어 있는지 확인합니다
- Claude Code에 연결된 GitHub 저장소가 최소 하나 있는지 확인합니다
Claude Tag 채널의 세션이 시작되지 않음
이 항목은 Claude Tag를 사용하는 워크스페이스에 적용되며, 여기서 Claude는 조직의 공유 ID로 채널에서 작동하며 어떤 멤버의 계정으로도 작동하지 않습니다. claude.ai/code에서 채널의 클라우드 환경을 생성한 경우, 이는 개인 계정에 속하며 Claude는 개인 환경에서 채널 세션을 시작할 수 없습니다. Claude Code는 세션을 즉시 실패하며, 재시도해도 도움이 되지 않습니다.
Owner인 경우, admin settings의 Cloud environments 페이지에서 환경을 organization-shared environment로 다시 생성합니다. 두 가지 방법으로 적용할 수 있습니다:
- claude.ai/admin-settings/claude-code에서 조직 기본값으로 설정합니다.
- Claude Tag admin settings에서 채널에 설정합니다.
Owner가 아닌 경우, 이 항목을 Owner에게 보냅니다.
저장소가 표시되지 않음
- claude.ai/code에서 저장소를 연결합니다
- 해당 저장소에 대한 GitHub 권한을 확인합니다
- GitHub 계정을 연결 해제했다가 다시 연결해봅니다
잘못된 저장소 선택됨
- "저장소 변경" 버튼을 클릭하여 다른 저장소를 선택합니다
- 더 정확한 선택을 위해 요청에 저장소 이름을 포함합니다
인증 오류
- 앱 홈에서 Claude 계정을 연결 해제했다가 다시 연결합니다
- 브라우저에서 올바른 Claude 계정으로 로그인했는지 확인합니다
- Claude 플랜에 Claude Code 액세스가 포함되어 있는지 확인합니다
현재 제한 사항
- GitHub만: 저장소는 GitHub에 있어야 합니다.
- 한 번에 하나의 PR: 각 세션은 하나의 풀 요청을 생성할 수 있습니다.
- 클라우드 세션 액세스 필요: 사용자는 클라우드 세션에 액세스해야 합니다. 액세스 권한이 없으면 Claude는 표준 채팅 응답으로 회신합니다.