카카오톡 초기 설정 가이드

KakaoTalk 연동을 위한 전제조건을 확인하고 설정합니다.

실행

bash

cd /Users/taehoje/space/kakao-terminal && python kakao_cli.py setup

초기 설정 (최초 1회)

1. 손쉬운 사용 권한 설정

터미널(또는 Claude Code)에서 카카오톡을 제어하려면 macOS 접근성 권한이 필요합니다.

설정 방법:

•시스템 설정 열기: Cmd + Space → "시스템 설정" 검색
•개인정보 보호 및 보안 클릭
•손쉬운 사용 클릭
•좌측 하단 자물쇠 클릭 → 비밀번호 입력
•
다음 앱에 체크 표시:
- •Terminal (터미널 사용시)
- •Claude (Claude Code 사용시)
- •iTerm (iTerm2 사용시)

권한 없으면:

code

✗ Accessibility permission denied

2. 카카오톡 실행 및 로그인

•Dock에서 카카오톡 아이콘 클릭
•로그인 (QR코드 또는 비밀번호)
•로그인 완료 후 메인 창 표시 확인

3. 채팅 목록 화면으로 이동

카카오톡 창에서:

•상단 탭 중 채팅 클릭 (친구/더보기 아님)
•채팅방 목록이 보이는 상태로 두기
•창을 최소화해도 됨 (숨겨둬도 동작)

주의: 개별 채팅방이 열린 상태가 아니라 채팅 목록이 보여야 합니다.

체크 항목

항목	설명	해결 방법
카카오톡 실행	앱이 실행되어 있어야 함	Dock에서 실행
접근성 권한	터미널에 권한 부여	위 "손쉬운 사용" 참고
창 열림	최소 하나의 창이 열려 있어야 함	Dock 아이콘 클릭
채팅 탭	채팅 탭이 활성화되어 있어야 함	채팅 탭 클릭

출력 예시

정상:

code

=== KakaoTalk Prerequisites Check ===

✓ KakaoTalk is running
✓ Accessibility permission granted
✓ KakaoTalk window found
✓ Chat list is visible

All checks passed! Ready to use.

문제 발생시:

code

=== KakaoTalk Prerequisites Check ===

✓ KakaoTalk is running
✗ Accessibility permission denied
  → System Settings > Privacy & Security > Accessibility
  → Add and enable Terminal or your IDE

다음 단계

설정 완료 후:

•/kakao-list - 채팅방 목록 보기
•/kakao-status - 연결 상태 확인