Slack DM으로 Codex 또는 Claude Code를 부르는 개인 AI 비서 만들기

Slack 앱을 새로 만듭니다

api.slack.com/apps에서 Create New App을 누르고 From scratch를 선택합니다.

• App Name: 예를 들어 `AI Assistant`
• Workspace: 사용할 Slack 워크스페이스

앱에게 DM을 보낼 수 있게 합니다

Features > App Home에서 Show Tabs > Messages Tab을 켭니다. 이어서 Allow users to send Slash commands and messages from the messages tab도 켭니다.

Socket Mode를 켭니다

Settings > Socket Mode에서 Enable Socket Mode를 켭니다. 이어서 App-Level Token을 만들 때 scope는 `connections:write`를 선택합니다.

DM 메시지 이벤트를 구독합니다

Features > Event Subscriptions에서 Enable Events를 켠 뒤, Subscribe to bot events에 아래 이벤트를 추가합니다.

• `message.im`: 비서와 1:1 DM을 주고받기 위한 필수 이벤트
• `app_mention`: 채널에서 `@비서`로 부를 때만 필요

Bot Token Scopes를 추가합니다

Features > OAuth & Permissions > Bot Token Scopes에서 아래 권한을 추가합니다.

• `chat:write`: 답장을 보내기 위해 필요
• `im:history`: DM 내용을 읽기 위해 필요
• `im:read`: DM 채널 정보를 읽기 위해 필요
• `im:write`: 필요할 때 DM 채널을 열기 위해 사용
• `app_mentions:read`: 채널 멘션까지 받을 때만 필요

앱을 워크스페이스에 설치합니다

OAuth & Permissions 화면의 Install to Workspace를 누릅니다. 설치 후 나오는 Bot User OAuth Token을 복사합니다.

이 저장소를 내려받습니다

Git이 설치되어 있으면 아래 명령을 씁니다. Git이 낯설면 GitHub 페이지에서 Code > Download ZIP으로 받아도 됩니다.

git clone https://github.com/joonan30/slack-ai-assistant-guide.git
cd slack-ai-assistant-guide

실행 폴더를 만들고 템플릿을 복사합니다

비서 프로그램은 `~/ai-slack-assistant` 폴더에서 실행합니다. 공개 저장소와 실제 토큰이 들어가는 실행 폴더를 분리해 두면 실수로 비밀값을 올릴 위험이 줄어듭니다.

mkdir -p ~/ai-slack-assistant ~/ai-slack-workspace
cp templates/bridge.py templates/env.example templates/requirements.txt templates/run.sh ~/ai-slack-assistant/
cd ~/ai-slack-assistant

Python 가상환경을 준비합니다

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt

비밀 토큰을 `.env`에 넣습니다

`env.example`을 `.env`로 복사한 뒤, Slack에서 받은 `xoxb-...`, `xapp-...` 값을 붙여 넣습니다.

cp env.example .env
nano .env

실행합니다

chmod +x run.sh
./run.sh

터미널이 켜져 있는 동안 Slack DM이 작동합니다. Slack에서 앱에게 “안녕”이라고 보내서 답장이 오면 성공입니다.