아무튼 카카오톡 - Codex 연결 하기
2026.08.10
아무튼 카카오톡 - Codex 연결 하기
Windows 카카오톡을 Codex의 명령 입력창이자 작업 완료 알림창으로 연결한 개인 자동화 사례입니다.
1. 문제 제기
Codex로 작업을 시켜놓고 결과를 확인하려면 폰으로 원격 화면에 자주 들어가야 했습니다. 작업이 끝났는지 확인하려고 Codex를 반복해서 여는 일이 생각보다 번거로웠습니다.
그래서 평소 자주 사용하는 카카오톡을 Codex와 연결하기로 했습니다. 목표는 카카오톡을 단순한 알림창이 아니라 Codex의 명령 입력창과 결과 확인창으로 바꾸는 것이었습니다.
카카오톡에서 명령 보내기
→ Codex가 작업하기
→ 작업 결과를 카카오톡으로 받기2. Windows 카카오톡을 Codex와 연결하기
Codex가 설치된 Windows 환경에 PC 카카오톡을 설치하고, macOS용 CLI를 Windows에서 동작하도록 바꾼 버전을 붙였습니다. 이번 사례의 범위는 Windows 카카오톡으로 한정했습니다.
나와 Codex만 사용하는 전용 대화방을 만들고 자동화 대상 방으로 고정했습니다. 임의의 대화방을 고르게 하지 않은 이유는 오발송을 막기 위해서입니다.
카카오톡이 실행되지 않았거나 로그아웃된 경우에는 자동 로그인을 시도하지 않습니다. 실행 안 됨, 로그아웃, 전용방을 열 수 없음 상태를 구분해 실패로 반환하도록 했습니다.
3. Send 구현: 작업 완료 알림 보내기
처음에는 카카오톡 창에 메시지를 입력하고 전송 버튼을 누르면 끝이라고 생각했습니다. 하지만 프로그램이 정상 종료됐다는 것과 실제 UI가 메시지를 받아들였다는 것은 달랐습니다.
그래서 Send를 다음처럼 검증하도록 만들었습니다.
전용방 찾기
→ 메시지 입력
→ Send 버튼 클릭
→ 입력창이 비었는지 확인
→ 전송 결과 검증
→ 전용 대화창만 닫기전송 결과에는 sent, verified, accepted_by_ui 같은 상태를 남깁니다. 전송 후 입력창이 비었는지 확인해 카카오톡 UI가 메시지를 실제로 소비했는지 검증합니다. 서버 측 배달 영수증이 아니라, Windows UI가 입력을 받아들였는지를 확인하는 방식입니다.
전송이 성공한 뒤에는 카카오톡 본체를 종료하지 않고 전용 대화창만 닫습니다. 미전송 초안이 있으면 창을 닫지 않도록 했습니다.
완료 알림은 Codex의 최종 응답에 다음과 같은 완료 marker가 있을 때만 보냅니다.
CODEX_KAKAO_COMPLETE_V1일반 질문, 진행 메시지, 실패, 취소에는 완료 알림을 보내지 않습니다.
Send를 검증하는 과정에서는 Windows RichEdit가 줄바꿈을 CR, LF, CRLF 중 다른 형태로 돌려주는 문제가 발견됐습니다. 내용은 같은데 멀티라인 메시지가 실패한 것으로 판정되고 초안이 남는 문제였습니다. 줄바꿈만 동등하게 비교하고 나머지 문자는 정확하게 비교하도록 수정했습니다. 이후 멀티라인과 이모지 메시지의 Send·Read 검증이 통과했습니다.
4. Read와 명령 watchdog 구현
Read도 Send와 같은 Windows용 CLI로 구현했습니다. 카카오톡에서 최근 메시지를 읽고, watchdog이 그 결과를 확인해 Codex 명령인지 판별합니다. Read의 내부 파싱 방식보다 중요한 것은 일반 대화와 실제 Codex 명령을 구분하는 계약을 만든 점입니다.
모든 메시지를 Codex로 보내면 위험하기 때문에 특정 문자열로 시작하는 메시지만 명령으로 인정합니다.
코덱스 N: 기존 작업에 보낼 명령
코덱스: 새 작업으로 보낼 명령일반 대화와 Codex가 보낸 완료 알림은 명령으로 처리하지 않습니다. 기존 작업번호가 있으면 연결된 세션을 재개하고, 작업번호가 없으면 새로운 Codex 작업을 생성합니다.
watchdog은 Windows 작업 스케줄러에 주기 실행 작업으로 등록했습니다. 중복 메시지는 다시 실행하지 않고, 알 수 없는 작업번호는 거부합니다. 일시적인 실패만 정해진 정책에 따라 재시도하며, 이미 완료된 작업은 다시 실행하지 않습니다.
Read와 Send가 동시에 카카오톡 UI를 조작하면 클릭과 클립보드가 서로 섞일 수 있기 때문에 공용 Windows mutex로 UI 조작을 직렬화했습니다.
Read의 초기 구현에서는 Ctrl+C가 실패했는데도 이전 클립보드 내용이 새 결과인 것처럼 읽힐 가능성이 있었습니다. 이를 실제 실패로 확인한 뒤, 복사 전후 Windows clipboard sequence가 바뀌었을 때만 새 결과로 인정하도록 보강했습니다.
창 열기와 닫기에도 안전장치를 추가했습니다.
로그인 상태를 먼저 확인
전용방이 실제로 열렸는지 확인
읽기 결과가 실제 UI에서 복사된 것인지 확인
미전송 초안이 있으면 닫기 거부
닫은 뒤 실제 대화창이 사라졌는지 재확인
실제 UI에서 방 열기, 메시지 읽기, 임시 초안 주입, 초안이 있을 때 닫기 거부, 초안 삭제 후 대화창 닫기까지 검증했습니다. 즉, 읽기에 성공하는 경우뿐 아니라 안전하게 닫을 수 없는 경우도 실패로 판정하도록 했습니다.
5. 작업번호와 세션 ID 브릿지
Codex session ID는 정확하지만 사람이 직접 사용하기에는 너무 깁니다. 그래서 사용자는 숫자 작업번호를 사용하고, 내부적으로는 작업번호와 session ID를 연결했습니다.
작업번호 12
→ Codex session_id
→ 실행 중인 Codex 작업task bridge는 SQLite schema v2를 사용합니다. 작업번호와 session_id는 서로 하나씩만 연결되며, 같은 세션을 다시 등록하면 기존 작업번호를 재사용합니다. 다른 세션과 충돌하는 매핑은 거부합니다.
Read와 Send, watchdog 실행 이력은 JSONL 메타데이터 로그로 분리했습니다.
read.jsonl
send.jsonl
watchdog.jsonl로그에는 상태, 시간, 작업번호, 세션 ID, 검증 결과 같은 정보만 남깁니다. 메시지 본문과 발신자명은 저장하지 않습니다. Hook 로그에서도 완료 요약이나 메시지 본문 대신 길이와 짧은 SHA-256 식별자만 남기도록 redaction했습니다.
개인정보 회귀 검사에서는 금지 키와 금지된 메시지 원문이 0건으로 확인됐습니다.
6. 실패와 해결
잘못된 작업 폴더를 물려받은 문제
기존 Codex 세션을 resume하는 과정에서 watchdog을 실행한 현재 폴더를 그대로 물려받아 파일을 찾지 못하는 문제가 발생했습니다.
세션 ID에 연결된 원래 작업 폴더를 로컬 Codex 메타데이터에서 읽고, codex exec resume -C와 subprocess의 cwd에 적용하도록 수정했습니다. 이후 같은 작업번호로 파일 수정, 재읽기, 완료 알림까지 통과했습니다. 실행을 시작한 폴더가 아니라 해당 Codex 세션의 작업 폴더를 복원한 것입니다.
Desktop Stop Hook이 자동으로 호출되지 않은 문제
Windows의 codex exec가 Codex Desktop의 Stop Hook을 자동으로 호출하지 않는 사실을 실제 E2E에서 확인했습니다.
그래서 worker가 Codex JSON 이벤트에서 마지막 assistant 메시지를 읽고, 완료 marker가 있을 때만 completion hook을 직접 호출하도록 보강했습니다. 완료 알림은 작업 실행의 부수 효과가 아니라 별도의 검증된 단계로 다뤘습니다.
완료 marker가 없으면 작업을 다시 실행하지 않고 completed_without_marker로 종결합니다. 작업은 끝났지만 알림만 실패한 경우에는 completed_notification_failed로 별도 기록합니다.
로그에 메시지 본문이 남을 위험
초기 Hook 로그와 state에 완료 요약이나 sender payload가 남을 수 있는 문제가 발견됐습니다.
read·send·watchdog 로그와 같은 기준을 적용해 메시지 본문을 제거하고, 길이와 짧은 SHA-256만 남기도록 바꿨습니다. 기존 레코드도 같은 형식으로 정리하고 개인정보 검사를 다시 실행했습니다.
이전 클립보드를 새 메시지로 오인한 문제
카카오톡에서 복사 자체가 실패해도 이전 클립보드에 유니코드 텍스트가 남아 있으면 Read가 성공한 것처럼 보일 수 있었습니다.
복사 전후 clipboard sequence를 확인하는 검증을 추가해 실제 복사가 발생한 경우에만 메시지를 반환하도록 해결했습니다.
한글과 멀티라인 메시지 문제
Windows 기본 코드페이지 때문에 테스트 과정에서 한글이 ?로 바뀌는 문제가 있었습니다. 테스트 입력을 UTF-8로 전달하도록 수정해 해결했습니다.
또한 RichEdit의 줄바꿈 정규화 때문에 멀티라인 메시지가 거짓 실패하는 문제가 있었습니다. 줄바꿈만 동등하게 비교하도록 수정한 뒤 멀티라인과 이모지 Send·Read가 정상적으로 통과했습니다.
7. 검증 결과와 최종 변화
최종 단위·회귀 테스트는 다음과 같이 총 30개가 통과했습니다.
영역 | 통과 수 |
|---|---|
Read | 9개 |
Task bridge·watchdog | 14개 |
Send | 4개 |
Completion Hook 개인정보 검사 | 3개 |
합계 | 30개 |
실제 KakaoTalk UI에서는 최근 메시지 읽기, 전용방 확인, 창 열기와 닫기, 초안 보호, 멀티라인과 이모지 Send·Read를 확인했습니다.
실제 E2E에서는 다음 흐름을 확인했습니다.
신규 Codex 작업 생성
기존 작업 resume
기존 작업의 완료 알림
일회성 Windows 예약 작업의 자연 실행
알 수 없는 작업번호 거부
중복 poll 무시
완료 marker가 없는 작업의 비재실행 종결
현재 운영 watchdog 작업은 Ready 상태이며, 최종 상태 검사와 개인정보 검사를 통과했습니다.
Before와 After를 비교하면 변화는 다음과 같습니다.
Before | After |
|---|---|
Codex 화면을 직접 반복 확인 | 완료 시 카카오톡 알림 확인 |
카카오톡 메시지를 수동으로 읽음 | 명령 문자열만 Codex로 전달 |
긴 session ID를 직접 관리 | 숫자 작업번호로 라우팅 |
전송 성공 여부를 감으로 판단 | UI 상태로 전송 검증 |
로그에 메시지 원문이 남을 위험 | 메타데이터와 해시만 기록 |
결국 카카오톡은 단순한 알림 수단이 아니라 Codex의 작업 접수창이자 결과 확인창이 되었습니다.
중요했던 것은 카카오톡으로 메시지를 보내는 기능 하나가 아니었습니다. 실제 UI가 메시지를 받아들였는지 확인하고, 특정 명령만 Codex로 보내고, 작업번호와 세션 ID를 연결하고, 실패한 작업을 함부로 재실행하지 않도록 운영 계약을 만든 것이 핵심이었습니다.




카카오톡 UI가 메시지를 받아들였는지를 입력창이 비었는지로 검증한 접근이 인상적이었어요. "프로그램이 정상 종료됐다는 것과 UI가 소비했다는 건 다르다"는 구분을 코드로 옮긴 거잖아요.
CODEX_KAKAO_COMPLETE_V1marker로 완료 알림만 선별하고, clipboard sequence 변화 감지까지 넣어서 이전 클립보드를 새 메시지로 오인하는 문제도 잡은 게 꼼꼼했습니다. Read와 Send가 동시에 UI를 건드릴 때 mutex로 직렬화한 부분은 카카오톡 자동화 특유의 난관인데 깔끔하게 풀어내셨어요.단위·회귀 테스트 30개에 개인정보 redaction(메시지 본문 대신 길이+SHA-256)까지 챙긴 덕분에 운영 의식이 느껴지는 글이었어요. 꼬리 탁! 치고 응원하고 갈게요 🐈⬛