6 6
7> Slack에서 코딩 작업을 위임합니다. 이 이전 버전은 Claude Tag에 연결되지 않은 워크스페이스에서 Pro 및 Max 계정의 채널 멘션에만 응답합니다.7> Slack에서 코딩 작업을 위임합니다. 이 이전 버전은 Claude Tag에 연결되지 않은 워크스페이스에서 Pro 및 Max 계정의 채널 멘션에만 응답합니다.
8 8
9<Warning>9> [!WARNING]
10 이 페이지는 각 세션이 개별 사용자의 계정에서 실행되는 이전 버전의 Slack의 Claude Code를 문서화합니다. 이 버전은 Pro 및 Max 계정의 채널 @멘션에만 응답하며, 어떤 조직도 [Claude Tag](https://claude.com/product/tag)에 연결하지 않은 Slack 워크스페이스에서만 응답합니다. Claude Tag는 @Claude를 조직의 공유 ID로 실행하며 관리자가 구성한 액세스 권한을 가집니다.10>
11 11> 이 페이지는 각 세션이 개별 사용자의 계정에서 실행되는 이전 버전의 Slack의 Claude Code를 문서화합니다. 이 버전은 Pro 및 Max 계정의 채널 @멘션에만 응답하며, 어떤 조직도 [Claude Tag](https://claude.com/product/tag)에 연결하지 않은 Slack 워크스페이스에서만 응답합니다. Claude Tag는 @Claude를 조직의 공유 ID로 실행하며 관리자가 구성한 액세스 권한을 가집니다.
12 * **Pro 및 Max 플랜:** Claude Tag는 개별 플랜에서 사용할 수 없으므로, Claude Tag에 연결되지 않은 워크스페이스에서는 이 페이지가 설정 경로로 유지됩니다.12>
13 * **Team 및 Enterprise 플랜:** 기존 Slack 앱과 @Claude 핸들이 유지됩니다. 새 워크스페이스의 경우 [Claude Tag 설정](https://claude.com/docs/claude-tag/overview)을 참조하고, 이미 이 버전을 사용 중인 워크스페이스를 이동하려면 [이전 Slack의 Claude에서 마이그레이션](https://claude.com/docs/claude-tag/admins/migrate-from-earlier)을 참조하십시오.13> * **Pro 및 Max 플랜:** Claude Tag는 개별 플랜에서 사용할 수 없으므로, Claude Tag에 연결되지 않은 워크스페이스에서는 이 페이지가 설정 경로로 유지됩니다.
14 * **답변 대신 알림을 받은 경우:** @Claude가 응답한 [설정 알림](#this-workspace-isnt-set-up-for-claude-tag-yet) 또는 [지원 종료 알림](#the-legacy-claude-in-slack-bot-is-retired)을 확인하십시오.14> * **Team 및 Enterprise 플랜:** 기존 Slack 앱과 @Claude 핸들이 유지됩니다. 새 워크스페이스의 경우 [Claude Tag 설정](https://claude.com/docs/claude-tag/overview)을 참조하고, 이미 이 버전을 사용 중인 워크스페이스를 이동하려면 [이전 Slack의 Claude에서 마이그레이션](https://claude.com/docs/claude-tag/admins/migrate-from-earlier)을 참조하십시오.
15</Warning>15> * **답변 대신 알림을 받은 경우:** @Claude가 응답한 [설정 알림](#this-workspace-isnt-set-up-for-claude-tag-yet) 또는 [지원 종료 알림](#the-legacy-claude-in-slack-bot-is-retired)을 확인하십시오.
16 16
17Slack의 Claude Code는 Claude Code의 강력한 기능을 Slack 워크스페이스에 직접 가져옵니다. `@Claude`를 언급하여 코딩 작업을 요청하면, Claude는 자동으로 의도를 감지하고 Claude Code 클라우드 세션을 생성하여 팀 대화를 떠나지 않고도 개발 작업을 위임할 수 있습니다.17Slack의 Claude Code는 Claude Code의 강력한 기능을 Slack 워크스페이스에 직접 가져옵니다. `@Claude`를 언급하여 코딩 작업을 요청하면, Claude는 자동으로 의도를 감지하고 Claude Code 클라우드 세션을 생성하여 팀 대화를 떠나지 않고도 개발 작업을 위임할 수 있습니다.
18 18
19이 통합은 기존 Slack용 Claude 앱을 기반으로 하지만 코딩 관련 요청에 대해 Claude Code 클라우드 세션으로 지능형 라우팅을 추가합니다. 각 세션은 사용자의 Claude 계정에서 실행되며, 연결된 저장소와 사용자의 플랜 한도를 사용합니다.19이 통합은 기존 Slack용 Claude 앱을 기반으로 하지만 코딩 관련 요청에 대해 Claude Code 클라우드 세션으로 지능형 라우팅을 추가합니다. 각 세션은 사용자의 Claude 계정에서 실행되며, 연결된 저장소와 사용자의 플랜 한도를 사용합니다.
20 20
21<h2 id="use-cases">21## 사용 사례
22 사용 사례
23</h2>
24 22
25* **버그 조사 및 수정**: Claude에 Slack 채널에서 보고된 버그를 조사하고 수정하도록 요청합니다.23* **버그 조사 및 수정**: Claude에 Slack 채널에서 보고된 버그를 조사하고 수정하도록 요청합니다.
26* **빠른 코드 검토 및 수정**: Claude가 팀 피드백을 기반으로 작은 기능을 구현하거나 코드를 리팩토링하도록 합니다.24* **빠른 코드 검토 및 수정**: Claude가 팀 피드백을 기반으로 작은 기능을 구현하거나 코드를 리팩토링하도록 합니다.
27* **협업 디버깅**: 팀 토론에서 중요한 컨텍스트(예: 오류 재현 또는 사용자 보고)를 제공할 때, Claude는 이 정보를 사용하여 디버깅 접근 방식을 알릴 수 있습니다.25* **협업 디버깅**: 팀 토론에서 중요한 컨텍스트(예: 오류 재현 또는 사용자 보고)를 제공할 때, Claude는 이 정보를 사용하여 디버깅 접근 방식을 알릴 수 있습니다.
28* **병렬 작업 실행**: Slack에서 코딩 작업을 시작하면서 다른 작업을 계속하고, 완료되면 알림을 받습니다.26* **병렬 작업 실행**: Slack에서 코딩 작업을 시작하면서 다른 작업을 계속하고, 완료되면 알림을 받습니다.
29 27
30<h2 id="prerequisites">28## 필수 조건
31 필수 조건
32</h2>
33 29
34Slack에서 Claude Code를 사용하기 전에 다음을 확인하세요:30Slack에서 Claude Code를 사용하기 전에 다음을 확인하세요:
35 31
41| GitHub 계정 | [claude.ai/code](https://claude.ai/code)에서 연결되어 있으며 최소 하나의 저장소가 인증됨 |37| GitHub 계정 | [claude.ai/code](https://claude.ai/code)에서 연결되어 있으며 최소 하나의 저장소가 인증됨 |
42| Slack 인증 | Claude 앱을 통해 Claude 계정에 연결된 Slack 계정 |38| Slack 인증 | Claude 앱을 통해 Claude 계정에 연결된 Slack 계정 |
43 39
44<h2 id="setting-up-claude-code-in-slack">40## Slack에서 Claude Code 설정
45 Slack에서 Claude Code 설정41
46</h2>42**1. Slack에 Claude 앱 설치**
43
44워크스페이스 관리자는 Slack 앱 마켓플레이스에서 Claude 앱을 설치해야 합니다. [Slack 앱 마켓플레이스](https://slack.com/marketplace/A08SF47R6P4)를 방문하여 "Slack에 추가"를 클릭하여 설치 프로세스를 시작합니다.
45
46**2. Claude 계정 연결**
47 47
48<Steps>48앱이 설치된 후 개별 Claude 계정을 인증합니다:
49 <Step title="Slack에 Claude 앱 설치">
50 워크스페이스 관리자는 Slack 앱 마켓플레이스에서 Claude 앱을 설치해야 합니다. [Slack 앱 마켓플레이스](https://slack.com/marketplace/A08SF47R6P4)를 방문하여 "Slack에 추가"를 클릭하여 설치 프로세스를 시작합니다.
51 </Step>
52 49
53 <Step title="Claude 계정 연결">501. 앱 섹션에서 "Claude"를 클릭하여 Slack에서 Claude 앱을 엽니다
54 앱이 설치된 후 개별 Claude 계정을 인증합니다:512. 앱 홈 탭으로 이동합니다
523. "연결"을 클릭하여 Slack 계정을 Claude 계정과 연결합니다
534. 브라우저에서 인증 흐름을 완료합니다
55 54
56 1. 앱 섹션에서 "Claude"를 클릭하여 Slack에서 Claude 앱을 엽니다55**3. 클라우드 세션 구성**
57 2. 앱 홈 탭으로 이동합니다
58 3. "연결"을 클릭하여 Slack 계정을 Claude 계정과 연결합니다
59 4. 브라우저에서 인증 흐름을 완료합니다
60 </Step>
61 56
62 <Step title="클라우드 세션 구성">57클라우드 세션이 계정에 대해 제대로 구성되어 있는지 확인합니다:
63 클라우드 세션이 계정에 대해 제대로 구성되어 있는지 확인합니다:
64 58
65 * [claude.ai/code](https://claude.ai/code)를 방문하여 Slack에 연결한 동일한 계정으로 로그인합니다59* [claude.ai/code](https://claude.ai/code)를 방문하여 Slack에 연결한 동일한 계정으로 로그인합니다
66 * 아직 연결되지 않은 경우 GitHub 계정을 연결합니다60* 아직 연결되지 않은 경우 GitHub 계정을 연결합니다
67 * Claude가 작업할 수 있도록 최소 하나의 저장소를 인증합니다61* Claude가 작업할 수 있도록 최소 하나의 저장소를 인증합니다
68 </Step>
69 62
70 <Step title="라우팅 모드 선택">63**4. 라우팅 모드 선택**
71 계정을 연결한 후 Claude가 Slack의 메시지를 처리하는 방식을 구성합니다. Slack의 Claude 앱 홈으로 이동하여 **라우팅 모드** 설정을 찾습니다.64
65계정을 연결한 후 Claude가 Slack의 메시지를 처리하는 방식을 구성합니다. Slack의 Claude 앱 홈으로 이동하여 **라우팅 모드** 설정을 찾습니다.
66
67| 모드 | 동작 |
68| :- | :- |
69| **코드만** | Claude는 모든 @mentions을 Claude Code 세션으로 라우팅합니다. Claude를 Slack에서 개발 작업 전용으로 사용하는 팀에 가장 적합합니다. |
70| **코드 + 채팅** | Claude는 각 메시지를 분석하고 Claude Code(코딩 작업용)와 Claude Chat(작성, 분석 및 일반 질문용) 간에 지능형으로 라우팅합니다. 모든 유형의 작업에 대해 단일 @Claude 진입점을 원하는 팀에 가장 적합합니다. |
72 71
73 | 모드 | 동작 |72> [!NOTE]
74 | :- | :- |73>
75 | **코드만** | Claude는 모든 @mentions을 Claude Code 세션으로 라우팅합니다. Claude를 Slack에서 개발 작업 전용으로 사용하는 팀에 가장 적합합니다. |74> 코드 + 채팅 모드에서 Claude가 메시지를 채팅으로 라우팅했지만 코딩 세션을 원했다면 "코드로 다시 시도"를 클릭하여 Claude Code 세션을 대신 생성할 수 있습니다. 마찬가지로 코드로 라우팅되었지만 채팅 세션을 원했다면 해당 스레드에서 해당 옵션을 선택할 수 있습니다.
76 | **코드 + 채팅** | Claude는 각 메시지를 분석하고 Claude Code(코딩 작업용)와 Claude Chat(작성, 분석 및 일반 질문용) 간에 지능형으로 라우팅합니다. 모든 유형의 작업에 대해 단일 @Claude 진입점을 원하는 팀에 가장 적합합니다. |
77 75
78 <Note>76**5. Claude를 채널에 추가**
79 코드 + 채팅 모드에서 Claude가 메시지를 채팅으로 라우팅했지만 코딩 세션을 원했다면 "코드로 다시 시도"를 클릭하여 Claude Code 세션을 대신 생성할 수 있습니다. 마찬가지로 코드로 라우팅되었지만 채팅 세션을 원했다면 해당 스레드에서 해당 옵션을 선택할 수 있습니다.
80 </Note>
81 </Step>
82 77
83 <Step title="Claude를 채널에 추가">78Claude는 설치 후 자동으로 채널에 추가되지 않습니다. 채널에서 Claude를 사용하려면 해당 채널에서 `/invite @Claude`를 입력하여 초대합니다. Claude는 추가된 채널에서만 @mentions에 응답할 수 있습니다.
84 Claude는 설치 후 자동으로 채널에 추가되지 않습니다. 채널에서 Claude를 사용하려면 해당 채널에서 `/invite @Claude`를 입력하여 초대합니다. Claude는 추가된 채널에서만 @mentions에 응답할 수 있습니다.
85 </Step>
86</Steps>
87 79
88<h2 id="how-it-works">80## 작동 방식
89 작동 방식
90</h2>
91 81
92<h3 id="automatic-detection">82### 자동 감지
93 자동 감지
94</h3>
95 83
96Code + Chat 라우팅 모드에서 Slack 채널이나 스레드에서 @Claude를 언급하면, Claude는 자동으로 메시지가 코딩 작업인지 여부를 감지합니다. 코딩 작업은 Claude Code 클라우드 세션으로 이동합니다. 그 외의 모든 것은 일반 채팅 응답을 받습니다. Code only 모드에서는 모든 @mention이 Claude Code로 이동합니다.84Code + Chat 라우팅 모드에서 Slack 채널이나 스레드에서 @Claude를 언급하면, Claude는 자동으로 메시지가 코딩 작업인지 여부를 감지합니다. 코딩 작업은 Claude Code 클라우드 세션으로 이동합니다. 그 외의 모든 것은 일반 채팅 응답을 받습니다. Code only 모드에서는 모든 @mention이 Claude Code로 이동합니다.
97 85
98자동으로 감지되지 않더라도 Claude에 요청을 코딩 작업으로 처리하도록 명시적으로 지시할 수 있습니다.86자동으로 감지되지 않더라도 Claude에 요청을 코딩 작업으로 처리하도록 명시적으로 지시할 수 있습니다.
99 87
100<Note>88> [!NOTE]
101 Slack의 Claude Code는 채널(공개 또는 비공개)에서만 작동합니다. 직접 메시지(DM)에서는 작동하지 않습니다.89>
102</Note>90> Slack의 Claude Code는 채널(공개 또는 비공개)에서만 작동합니다. 직접 메시지(DM)에서는 작동하지 않습니다.
103 91
104<h3 id="context-gathering">92### 컨텍스트 수집
105 컨텍스트 수집
106</h3>
107 93
108**스레드에서**: 스레드에서 @Claude를 언급하면 전체 대화를 이해하기 위해 해당 스레드의 모든 메시지에서 컨텍스트를 수집합니다.94**스레드에서**: 스레드에서 @Claude를 언급하면 전체 대화를 이해하기 위해 해당 스레드의 모든 메시지에서 컨텍스트를 수집합니다.
109 95
111 97
112이 컨텍스트는 Claude가 문제를 이해하고, 적절한 저장소를 선택하고, 작업에 대한 접근 방식을 알리는 데 도움이 됩니다.98이 컨텍스트는 Claude가 문제를 이해하고, 적절한 저장소를 선택하고, 작업에 대한 접근 방식을 알리는 데 도움이 됩니다.
113 99
114<Warning>100> [!WARNING]
115 Slack에서 @Claude가 호출되면 Claude는 요청을 더 잘 이해하기 위해 대화 컨텍스트에 액세스할 수 있습니다. Claude는 컨텍스트의 다른 메시지의 지시를 따를 수 있으므로 사용자는 Claude를 신뢰할 수 있는 Slack 대화에서만 사용해야 합니다.101>
116</Warning>102> Slack에서 @Claude가 호출되면 Claude는 요청을 더 잘 이해하기 위해 대화 컨텍스트에 액세스할 수 있습니다. Claude는 컨텍스트의 다른 메시지의 지시를 따를 수 있으므로 사용자는 Claude를 신뢰할 수 있는 Slack 대화에서만 사용해야 합니다.
117 103
118<h3 id="session-flow">104### 세션 흐름
119 세션 흐름
120</h3>
121 105
1221. **시작**: @Claude를 코딩 요청과 함께 언급합니다1061. **시작**: @Claude를 코딩 요청과 함께 언급합니다
1232. **감지**: Claude가 메시지를 분석하고 코딩 의도를 감지합니다1072. **감지**: Claude가 메시지를 분석하고 코딩 의도를 감지합니다
1265. **완료**: 완료되면 Claude는 요약 및 작업 버튼과 함께 @mentions을 합니다1105. **완료**: 완료되면 Claude는 요약 및 작업 버튼과 함께 @mentions을 합니다
1276. **검토**: "세션 보기"를 클릭하여 전체 기록을 보거나 "PR 생성"을 클릭하여 풀 요청을 엽니다1116. **검토**: "세션 보기"를 클릭하여 전체 기록을 보거나 "PR 생성"을 클릭하여 풀 요청을 엽니다
128 112
129<h2 id="user-interface-elements">113## 사용자 인터페이스 요소
130 사용자 인터페이스 요소
131</h2>
132 114
133<h3 id="message-actions">115### 메시지 작업
134 메시지 작업
135</h3>
136 116
137* **세션 보기**: 수행된 모든 작업을 볼 수 있고, 세션을 계속하거나 추가 요청을 할 수 있는 브라우저에서 전체 Claude Code 세션을 엽니다.117* **세션 보기**: 수행된 모든 작업을 볼 수 있고, 세션을 계속하거나 추가 요청을 할 수 있는 브라우저에서 전체 Claude Code 세션을 엽니다.
138* **PR 생성**: 세션의 변경 사항에서 직접 풀 요청을 생성합니다.118* **PR 생성**: 세션의 변경 사항에서 직접 풀 요청을 생성합니다.
139* **코드로 다시 시도**: Claude가 처음에 채팅 어시스턴트로 응답했지만 코딩 세션을 원했다면 이 버튼을 클릭하여 요청을 Claude Code 작업으로 다시 시도합니다.119* **코드로 다시 시도**: Claude가 처음에 채팅 어시스턴트로 응답했지만 코딩 세션을 원했다면 이 버튼을 클릭하여 요청을 Claude Code 작업으로 다시 시도합니다.
140* **저장소 변경**: Claude가 잘못 선택한 경우 다른 저장소를 선택할 수 있습니다.120* **저장소 변경**: Claude가 잘못 선택한 경우 다른 저장소를 선택할 수 있습니다.
141 121
142<h3 id="repository-selection">122### 저장소 선택
143 저장소 선택
144</h3>
145 123
146Claude는 Slack 대화의 컨텍스트를 기반으로 저장소를 자동으로 선택합니다. 여러 저장소가 적용될 수 있는 경우 Claude는 올바른 저장소를 선택할 수 있는 드롭다운을 표시할 수 있습니다.124Claude는 Slack 대화의 컨텍스트를 기반으로 저장소를 자동으로 선택합니다. 여러 저장소가 적용될 수 있는 경우 Claude는 올바른 저장소를 선택할 수 있는 드롭다운을 표시할 수 있습니다.
147 125
148<h2 id="access-and-permissions">126## 액세스 및 권한
149 액세스 및 권한
150</h2>
151 127
152<h3 id="user-level-access">128### 사용자 수준 액세스
153 사용자 수준 액세스
154</h3>
155 129
156| 액세스 유형 | 요구 사항 |130| 액세스 유형 | 요구 사항 |
157| :- | :- |131| :- | :- |
160| 저장소 액세스 | 사용자는 개인적으로 연결한 저장소에만 액세스할 수 있습니다 |134| 저장소 액세스 | 사용자는 개인적으로 연결한 저장소에만 액세스할 수 있습니다 |
161| 세션 기록 | 세션은 claude.ai/code의 Claude Code 기록에 나타납니다 |135| 세션 기록 | 세션은 claude.ai/code의 Claude Code 기록에 나타납니다 |
162 136
163<h3 id="workspace-level-access">137### 워크스페이스 수준 액세스
164 워크스페이스 수준 액세스
165</h3>
166 138
167Slack 워크스페이스 관리자는 Claude 앱을 워크스페이스에서 사용할 수 있는지 여부를 제어합니다:139Slack 워크스페이스 관리자는 Claude 앱을 워크스페이스에서 사용할 수 있는지 여부를 제어합니다:
168 140
172| Enterprise Grid 배포 | Enterprise Grid 조직의 경우 조직 관리자는 어떤 워크스페이스가 Claude 앱에 액세스할 수 있는지 제어할 수 있습니다 |144| Enterprise Grid 배포 | Enterprise Grid 조직의 경우 조직 관리자는 어떤 워크스페이스가 Claude 앱에 액세스할 수 있는지 제어할 수 있습니다 |
173| 앱 제거 | 워크스페이스에서 앱을 제거하면 해당 워크스페이스의 모든 사용자에 대한 액세스가 즉시 취소됩니다 |145| 앱 제거 | 워크스페이스에서 앱을 제거하면 해당 워크스페이스의 모든 사용자에 대한 액세스가 즉시 취소됩니다 |
174 146
175<h3 id="channel-based-access-control">147### 채널 기반 액세스 제어
176 채널 기반 액세스 제어
177</h3>
178 148
179앱을 설치해도 Claude가 자동으로 채널에 추가되지 않습니다. Claude는 `/invite @Claude`로 초대된 채널에서만 @mentions에 응답합니다. 공개 및 비공개 채널 모두에서 작동합니다. 관리자는 Claude가 초대된 채널과 해당 채널에 액세스할 수 있는 사용자를 관리하여 Claude Code 사용을 제어할 수 있습니다. 이는 워크스페이스 수준 권한 이상의 추가 액세스 제어 계층을 제공합니다.149앱을 설치해도 Claude가 자동으로 채널에 추가되지 않습니다. Claude는 `/invite @Claude`로 초대된 채널에서만 @mentions에 응답합니다. 공개 및 비공개 채널 모두에서 작동합니다. 관리자는 Claude가 초대된 채널과 해당 채널에 액세스할 수 있는 사용자를 관리하여 Claude Code 사용을 제어할 수 있습니다. 이는 워크스페이스 수준 권한 이상의 추가 액세스 제어 계층을 제공합니다.
180 150
181<h2 id="what’s-accessible-where">151## 어디서 액세스할 수 있는지
182 어디서 액세스할 수 있는지
183</h2>
184 152
185**Slack에서**: 상태 업데이트, 완료 요약 및 작업 버튼이 표시됩니다. 전체 기록은 보존되며 항상 액세스할 수 있습니다.153**Slack에서**: 상태 업데이트, 완료 요약 및 작업 버튼이 표시됩니다. 전체 기록은 보존되며 항상 액세스할 수 있습니다.
186 154
188 156
189Enterprise 및 Team 계정의 경우 Slack의 Claude에서 생성된 세션은 조직에 자동으로 표시됩니다. 자세한 내용은 [클라우드 세션 공유](/docs/ko/claude-code-on-the-web#share-sessions)를 참조하세요.157Enterprise 및 Team 계정의 경우 Slack의 Claude에서 생성된 세션은 조직에 자동으로 표시됩니다. 자세한 내용은 [클라우드 세션 공유](/docs/ko/claude-code-on-the-web#share-sessions)를 참조하세요.
190 158
191<h2 id="best-practices">159## 모범 사례
192 모범 사례
193</h2>
194 160
195<h3 id="writing-effective-requests">161### 효과적인 요청 작성
196 효과적인 요청 작성
197</h3>
198 162
199* **구체적으로**: 관련이 있을 때 파일 이름, 함수 이름 또는 오류 메시지를 포함합니다.163* **구체적으로**: 관련이 있을 때 파일 이름, 함수 이름 또는 오류 메시지를 포함합니다.
200* **컨텍스트 제공**: 대화에서 명확하지 않은 경우 저장소 또는 프로젝트를 언급합니다.164* **컨텍스트 제공**: 대화에서 명확하지 않은 경우 저장소 또는 프로젝트를 언급합니다.
201* **성공 정의**: "완료"가 무엇인지 설명합니다. Claude가 테스트를 작성해야 합니까? 문서를 업데이트합니까? PR을 생성합니까?165* **성공 정의**: "완료"가 무엇인지 설명합니다. Claude가 테스트를 작성해야 합니까? 문서를 업데이트합니까? PR을 생성합니까?
202* **스레드 사용**: 버그나 기능을 논의할 때 스레드에서 회신하여 Claude가 전체 컨텍스트를 수집할 수 있도록 합니다.166* **스레드 사용**: 버그나 기능을 논의할 때 스레드에서 회신하여 Claude가 전체 컨텍스트를 수집할 수 있도록 합니다.
203 167
204<h3 id="when-to-use-slack-vs-web">168### Slack과 웹 사용 시기
205 Slack과 웹 사용 시기
206</h3>
207 169
208**Slack을 사용할 때**: 컨텍스트가 이미 Slack 토론에 있을 때, 작업을 비동기적으로 시작하려고 할 때, 또는 가시성이 필요한 팀원과 협업할 때입니다.170**Slack을 사용할 때**: 컨텍스트가 이미 Slack 토론에 있을 때, 작업을 비동기적으로 시작하려고 할 때, 또는 가시성이 필요한 팀원과 협업할 때입니다.
209 171
210**웹을 직접 사용할 때**: 파일을 업로드해야 할 때, 개발 중 실시간 상호 작용을 원할 때, 또는 더 길고 복잡한 작업을 수행할 때입니다.172**웹을 직접 사용할 때**: 파일을 업로드해야 할 때, 개발 중 실시간 상호 작용을 원할 때, 또는 더 길고 복잡한 작업을 수행할 때입니다.
211 173
212<h2 id="troubleshooting">174## 문제 해결
213 문제 해결
214</h2>
215 175
216<h3 id="this-workspace-isnt-set-up-for-claude-tag-yet">176### "This workspace isn't set up for Claude Tag yet"
217 "This workspace isn't set up for Claude Tag yet"
218</h3>
219 177
220다음 두 조건이 모두 충족되면 @Claude는 답변 대신 이 알림으로 스레드에 응답합니다.178다음 두 조건이 모두 충족되면 @Claude는 답변 대신 이 알림으로 스레드에 응답합니다.
221 179
224 182
225Claude Tag는 Team 및 Enterprise 플랜에서 사용할 수 있습니다. 워크스페이스를 연결하려면 알림에 명시된 `@Claude connect` 명령으로 시작한 다음 [Claude Tag 설정](https://claude.com/docs/claude-tag/overview)을 따릅니다.183Claude Tag는 Team 및 Enterprise 플랜에서 사용할 수 있습니다. 워크스페이스를 연결하려면 알림에 명시된 `@Claude connect` 명령으로 시작한 다음 [Claude Tag 설정](https://claude.com/docs/claude-tag/overview)을 따릅니다.
226 184
227<h3 id="the-legacy-claude-in-slack-bot-is-retired">185### "The legacy Claude in Slack bot is retired"
228 "The legacy Claude in Slack bot is retired"
229</h3>
230 186
231알림은 `The legacy Claude in Slack bot is retired effective October 5, 2026 and no longer responds in channels.`로 시작합니다. Slack 워크스페이스가 Claude 조직에 연결되어 있지만, 해당 조직의 Claude Tag 설정에서 채널, 워크스페이스 또는 조직 기본값에 여전히 이전 버전이 선택되어 있는 상태입니다. 이 알림은 사용자 본인의 플랜과 무관하므로 Pro 및 Max 계정에도 표시됩니다.187알림은 `The legacy Claude in Slack bot is retired effective October 5, 2026 and no longer responds in channels.`로 시작합니다. Slack 워크스페이스가 Claude 조직에 연결되어 있지만, 해당 조직의 Claude Tag 설정에서 채널, 워크스페이스 또는 조직 기본값에 여전히 이전 버전이 선택되어 있는 상태입니다. 이 알림은 사용자 본인의 플랜과 무관하므로 Pro 및 Max 계정에도 표시됩니다.
232 188
233해당 조직의 Owner라면 [Claude 관리자 설정](https://claude.ai/admin-settings/claude-tag)을 열고 채널에 대해 Claude Tag를 켭니다. 이 설정을 상속하는 모든 채널을 한 번에 수정하려면 대신 워크스페이스 또는 조직 기본값에서 변경합니다. 전체 전환 과정은 [이전 Claude in Slack에서 마이그레이션](https://claude.com/docs/claude-tag/admins/migrate-from-earlier)을 참조하세요. Owner가 아닌 경우, 이 항목을 Owner에게 보냅니다.189해당 조직의 Owner라면 [Claude 관리자 설정](https://claude.ai/admin-settings/claude-tag)을 열고 채널에 대해 Claude Tag를 켭니다. 이 설정을 상속하는 모든 채널을 한 번에 수정하려면 대신 워크스페이스 또는 조직 기본값에서 변경합니다. 전체 전환 과정은 [이전 Claude in Slack에서 마이그레이션](https://claude.com/docs/claude-tag/admins/migrate-from-earlier)을 참조하세요. Owner가 아닌 경우, 이 항목을 Owner에게 보냅니다.
234 190
235<h3 id="claude-code-is-not-enabled-for-your-account">191### "Claude Code is not enabled for your account"
236 "Claude Code is not enabled for your account"
237</h3>
238 192
239이 오류는 Claude 계정에 아직 클라우드 환경이 없다는 의미입니다. Slack에 연결한 동일한 계정으로 [claude.ai/code](https://claude.ai/code)에 한 번 로그인하고 [웹 온보딩](/docs/ko/web-quickstart#connect-github)을 완료합니다. 이는 기본 클라우드 환경을 생성하거나 생성하도록 요청합니다. 오류는 다음 언급 시 해결됩니다. 각 사용자는 개별적으로 이 작업을 수행해야 합니다.193이 오류는 Claude 계정에 아직 클라우드 환경이 없다는 의미입니다. Slack에 연결한 동일한 계정으로 [claude.ai/code](https://claude.ai/code)에 한 번 로그인하고 [웹 온보딩](/docs/ko/web-quickstart#connect-github)을 완료합니다. 이는 기본 클라우드 환경을 생성하거나 생성하도록 요청합니다. 오류는 다음 언급 시 해결됩니다. 각 사용자는 개별적으로 이 작업을 수행해야 합니다.
240 194
241<h3 id="sessions-not-starting">195### 세션이 시작되지 않음
242 세션이 시작되지 않음
243</h3>
244 196
2451. Claude 앱 홈에서 Claude 계정이 연결되어 있는지 확인합니다1971. Claude 앱 홈에서 Claude 계정이 연결되어 있는지 확인합니다
2462. 클라우드 세션이 계정에 대해 활성화되어 있는지 확인합니다1982. 클라우드 세션이 계정에 대해 활성화되어 있는지 확인합니다
2473. Claude Code에 연결된 GitHub 저장소가 최소 하나 있는지 확인합니다1993. Claude Code에 연결된 GitHub 저장소가 최소 하나 있는지 확인합니다
248 200
249<h3 id="sessions-from-a-claude-tag-channel-fail-to-start">201### Claude Tag 채널의 세션이 시작되지 않음
250 Claude Tag 채널의 세션이 시작되지 않음
251</h3>
252 202
253이 항목은 [Claude Tag](https://claude.com/docs/claude-tag/overview)를 사용하는 워크스페이스에 적용되며, 여기서 Claude는 조직의 공유 ID로 채널에서 작동하며 어떤 멤버의 계정으로도 작동하지 않습니다. [claude.ai/code](https://claude.ai/code)에서 채널의 클라우드 환경을 생성한 경우, 이는 개인 계정에 속하며 Claude는 개인 환경에서 채널 세션을 시작할 수 없습니다. Claude Code는 세션을 즉시 실패하며, 재시도해도 도움이 되지 않습니다.203이 항목은 [Claude Tag](https://claude.com/docs/claude-tag/overview)를 사용하는 워크스페이스에 적용되며, 여기서 Claude는 조직의 공유 ID로 채널에서 작동하며 어떤 멤버의 계정으로도 작동하지 않습니다. [claude.ai/code](https://claude.ai/code)에서 채널의 클라우드 환경을 생성한 경우, 이는 개인 계정에 속하며 Claude는 개인 환경에서 채널 세션을 시작할 수 없습니다. Claude Code는 세션을 즉시 실패하며, 재시도해도 도움이 되지 않습니다.
254 204
261 211
262Owner가 아닌 경우, 이 항목을 Owner에게 보냅니다.212Owner가 아닌 경우, 이 항목을 Owner에게 보냅니다.
263 213
264<h3 id="repository-not-showing">214### 저장소가 표시되지 않음
265 저장소가 표시되지 않음
266</h3>
267 215
2681. [claude.ai/code](https://claude.ai/code)에서 저장소를 연결합니다2161. [claude.ai/code](https://claude.ai/code)에서 저장소를 연결합니다
2692. 해당 저장소에 대한 GitHub 권한을 확인합니다2172. 해당 저장소에 대한 GitHub 권한을 확인합니다
2703. GitHub 계정을 연결 해제했다가 다시 연결해봅니다2183. GitHub 계정을 연결 해제했다가 다시 연결해봅니다
271 219
272<h3 id="wrong-repository-selected">220### 잘못된 저장소 선택됨
273 잘못된 저장소 선택됨
274</h3>
275 221
2761. "저장소 변경" 버튼을 클릭하여 다른 저장소를 선택합니다2221. "저장소 변경" 버튼을 클릭하여 다른 저장소를 선택합니다
2772. 더 정확한 선택을 위해 요청에 저장소 이름을 포함합니다2232. 더 정확한 선택을 위해 요청에 저장소 이름을 포함합니다
278 224
279<h3 id="authentication-errors">225### 인증 오류
280 인증 오류
281</h3>
282 226
2831. 앱 홈에서 Claude 계정을 연결 해제했다가 다시 연결합니다2271. 앱 홈에서 Claude 계정을 연결 해제했다가 다시 연결합니다
2842. 브라우저에서 올바른 Claude 계정으로 로그인했는지 확인합니다2282. 브라우저에서 올바른 Claude 계정으로 로그인했는지 확인합니다
285 229
286<h2 id="current-limitations">230## 현재 제한 사항
287 현재 제한 사항
288</h2>
289 231
290* **GitHub만**: 저장소는 GitHub에 있어야 합니다.232* **GitHub만**: 저장소는 GitHub에 있어야 합니다.
291* **한 번에 하나의 PR**: 각 세션은 하나의 풀 리퀘스트를 생성할 수 있습니다.233* **한 번에 하나의 PR**: 각 세션은 하나의 풀 리퀘스트를 생성할 수 있습니다.
292* **클라우드 세션 액세스 필요**: 사용자는 [클라우드 세션](/docs/ko/claude-code-on-the-web)에 액세스해야 합니다.234* **클라우드 세션 액세스 필요**: 사용자는 [클라우드 세션](/docs/ko/claude-code-on-the-web)에 액세스해야 합니다.
293 235
294<h2 id="related-resources">236## 관련 리소스
295 관련 리소스
296</h2>
297 237
298<CardGroup>238> **[클라우드의 Claude Code](/docs/ko/claude-code-on-the-web)**
299 <Card title="클라우드의 Claude Code" icon="cloud" href="/docs/ko/claude-code-on-the-web">239>
300 클라우드 세션에 대해 자세히 알아보기240> 클라우드 세션에 대해 자세히 알아보기
301 </Card>
302 241
303 <Card title="Slack용 Claude" icon="slack" href="https://claude.com/claude-and-slack">242> **[Slack용 Claude](https://claude.com/claude-and-slack)**
304 일반 Slack용 Claude 문서243>
305 </Card>244> 일반 Slack용 Claude 문서
306 245
307 <Card title="Claude Tag" icon="users" href="https://claude.com/docs/claude-tag/overview">246> **[Claude Tag](https://claude.com/docs/claude-tag/overview)**
308 관리자가 구성한 액세스 권한이 있는 Slack의 조직 관리 @Claude247>
309 </Card>248> 관리자가 구성한 액세스 권한이 있는 Slack의 조직 관리 @Claude
310 249
311 <Card title="Slack 앱 마켓플레이스" icon="store" href="https://slack.com/marketplace/A08SF47R6P4">250> **[Slack 앱 마켓플레이스](https://slack.com/marketplace/A08SF47R6P4)**
312 Slack 마켓플레이스에서 Claude 앱 설치251>
313 </Card>252> Slack 마켓플레이스에서 Claude 앱 설치
314 253
315 <Card title="Claude 도움말 센터" icon="circle-question" href="https://support.claude.com">254> **[Claude 도움말 센터](https://support.claude.com)**
316 추가 지원 받기255>
317 </Card>256> 추가 지원 받기
318</CardGroup>
