Mac·iPhone 유저라면 지금 당장 해보십시오
Claude에게 문자로 일을 시키는 시대가 열렸습니다

Claude Code iMessage 플러그인 공식 출시 — 완전 로컬, 외부 서버 없이 문자 한 통으로 AI가 내 맥에서 작업합니다

2026년 3월 26일 · KIMKJ.COM

Anthropic의 Claude Code 팀 멤버 Thariq Shihipar가 2026년 3월 25일 공식 발표했습니다. iMessage가 Claude Code의 커뮤니케이션 채널로 정식 지원됩니다. Mac에 플러그인을 설치하면, iPhone이나 iPad, Apple Watch 등 어떤 Apple 기기에서든 문자 앱을 열어 Claude에게 메시지를 보낼 수 있습니다. Claude는 로컬 Mac에서 직접 명령을 실행하고, 그 결과를 iMessage로 돌려보냅니다.

핵심은 이것입니다. 외부 서버가 없습니다. 토큰도 없습니다. macOS의 Messages 데이터베이스(chat.db)를 직접 읽고, AppleScript로 메시지를 보냅니다. 100% 로컬에서 돌아갑니다. 나 혼자 쓸 수도 있고, 가족이나 동료를 초대해서 함께 쓸 수도 있습니다. 현재 Research Preview 단계이며, Claude Code v2.1.80 이상이 필요합니다.

사전 준비 — 시작하기 전에 확인할 것들

운영체제는 macOS만 지원합니다. Windows나 Linux에서는 작동하지 않습니다. iMessage 자체가 Apple 생태계 전용이기 때문입니다.

Anthropic 유료 계정이 필요합니다. Claude Pro(월 $20), Claude Max(월 $100~$200), Teams, Enterprise, 또는 API 크레딧이 있는 Console 계정 중 하나면 됩니다. 무료 Claude.ai 플랜으로는 Claude Code를 쓸 수 없습니다.

Claude Code v2.1.80 이상이 설치되어 있어야 합니다. 터미널에서 claude --version으로 확인하십시오. 버전이 낮다면 claude update로 업데이트합니다.

Claude Code가 아예 설치되어 있지 않다면, 먼저 설치해야 합니다. 가장 빠른 방법은 네이티브 인스톨러입니다.

설치 후 claude를 실행하면 브라우저가 열리면서 Anthropic 계정 인증을 요청합니다. 로그인하면 준비 완료입니다.

Step 1 — Full Disk Access 권한 부여

이 플러그인은 macOS의 ~/Library/Messages/chat.db 파일을 직접 읽습니다. iMessage의 전체 대화 기록이 담긴 SQLite 데이터베이스입니다. macOS는 이 파일을 TCC(Transparency, Consent, and Control) 보호 대상으로 분류합니다. 터미널 앱이 이 파일에 접근하려면 "전체 디스크 접근 권한"이 필요합니다.

처음 플러그인이 chat.db를 읽으려 할 때 macOS가 팝업을 띄워 허용 여부를 물어봅니다. 이때 반드시 Allow를 클릭하십시오.

팝업이 뜨지 않거나 실수로 "Don't Allow"를 눌렀다면, 수동으로 설정해야 합니다.

•시스템 설정(System Settings)을 엽니다

•개인정보 보호 및 보안(Privacy & Security)으로 이동합니다

•전체 디스크 접근 권한(Full Disk Access)을 선택합니다

• 목록에서 사용 중인 터미널 앱(Terminal.app, iTerm, Ghostty 등)을 추가하고 토글을 켭니다

이 권한이 없으면 플러그인이 authorization denied 오류와 함께 즉시 종료됩니다.

Step 2 — iMessage 플러그인 설치

터미널에서 claude를 실행하여 Claude Code 세션을 시작합니다. 세션 안에서 아래 명령어를 입력합니다.

이것이 Anthropic 공식 플러그인 저장소(claude-plugins-official)에서 제공하는 iMessage 플러그인입니다. 환경변수 설정이나 별도의 토큰이 필요 없습니다. 명령어 하나로 설치가 끝납니다.

Step 3 — 채널 모드로 Claude Code 재실행

플러그인을 설치했다고 바로 작동하지 않습니다. 현재 세션을 종료하고, 채널 플래그를 붙여서 새로 시작해야 합니다.

세션이 시작되면 /imessage:configure를 타이핑해 보십시오. 탭 자동완성이 되면 플러그인이 정상적으로 로드된 것입니다.

Step 4 — 첫 번째 테스트: 나에게 문자 보내기

iPhone이나 다른 Apple 기기에서 자기 자신에게 iMessage를 보내 보십시오. 자기 자신에게 보내는 메시지(self-chat)는 접근 제어를 우회합니다. 별도의 허용 설정 없이도 즉시 Claude에게 도달합니다.

첫 번째 응답이 발송될 때 macOS가 한 번 더 권한을 요청합니다. "Terminal이 Messages를 제어하려고 합니다(Terminal wants to control Messages)"라는 자동화(Automation) 권한 팝업입니다. OK를 클릭하십시오.

이제 문자 앱에서 Claude의 응답이 도착합니다. 응답 끝에 "Sent by Claude"라는 서명이 자동으로 붙습니다.

Step 5 — 다른 사람 초대하기: 가족 AI 채팅방 만들기

기본 설정에서는 나 자신 이외의 메시지는 전부 무시됩니다. 자동 응답도 하지 않고, 조용히 버립니다. 다른 사람이 Claude를 사용하게 하려면 명시적으로 허용 목록(allowlist)에 추가해야 합니다.

전화번호(국가코드 포함, 예: +821012345678)나 Apple ID 이메일(예: family@icloud.com)로 지정합니다. 허용된 사람이 iMessage로 메시지를 보내면 Claude가 응답합니다.

그룹 채팅도 지원합니다. 그룹에서는 Claude가 모든 메시지에 반응하지 않도록 멘션 패턴을 설정할 수 있습니다. "Claude야"나 "@Claude" 같은 호출어를 포함한 메시지에만 응답하게 만드는 것입니다. 가족 단톡방에 Claude를 넣고, 필요할 때만 불러서 쓰는 형태가 됩니다.

보안 설계가 견고합니다. 접근 제어 변경(허용/차단)은 오직 터미널에서 직접 명령해야만 가능합니다. 수신 메시지를 통한 접근 제어 조작은 원천적으로 차단됩니다. 프롬프트 인젝션 공격을 방지하기 위한 설계입니다. 페어링 코드는 1시간 후 만료되고, 파일 전송 시 설정 디렉토리 경로는 차단됩니다.

작동 원리 — 내부에서 무슨 일이 벌어지는가

•수신(Inbound) — chat.db를 1초에 한 번 폴링하면서 새 메시지가 있는지 확인합니다. ROWID 워터마크 방식을 사용하여, 부팅 시점의 최대 ROWID 이후에 도착한 메시지만 처리합니다. 재시작해도 과거 메시지가 다시 재생되지 않습니다.

•발신(Outbound) — AppleScript의 tell application "Messages" to send 명령을 사용합니다. 텍스트와 채팅 GUID는 argv를 통해 전달되어 이스케이프 관련 보안 문제가 발생하지 않습니다.

•검색 및 이력(History & Search) — chat.db에 대한 직접 SQLite 쿼리입니다. 서버가 시작된 이후의 메시지만이 아니라, 전체 네이티브 iMessage 기록에 접근할 수 있습니다.

•첨부파일(Attachments) — chat.db에 저장된 파일시스템 절대경로를 통해 이미지와 파일을 주고받을 수 있습니다. 메시지당 첫 번째 이미지가 Claude에게 로컬 경로로 전달됩니다.

실전 활용 시나리오

iMessage를 통해 Claude Code에게 보내는 메시지는 단순한 대화가 아닙니다. Claude Code의 전체 기능에 접근하는 명령어입니다. 파일을 읽고, 코드를 실행하고, git을 관리하고, 다른 스킬과 도구를 사용할 수 있습니다.

• "오늘 회의록 정리해줘" — Mac에 저장된 녹취 파일을 읽고 정리된 문서를 생성합니다

• "이 파일 분석해줘" — 이미지나 문서를 첨부하면 Claude가 읽고 분석합니다

• "프로젝트 폴더의 버그 고쳐줘" — 로컬 코드베이스에 접근해서 직접 수정합니다

• "다음 주 Jake랑 커피 일정 잡아줘" — 캘린더를 확인하고 이벤트를 생성합니다

• "유튜브 댓글 수집해서 분석해줘" — 웹 스크레이핑과 데이터 분석을 자동 수행합니다

선택적 환경변수 설정

•IMESSAGE_APPEND_SIGNATURE — 기본값 true. 발신 메시지 끝에 "Sent by Claude"를 붙입니다. false로 설정하면 서명을 제거합니다

•IMESSAGE_ACCESS_MODE — static으로 설정하면 런타임 페어링이 비활성화되고 access.json 파일만 참조합니다. 무인 운영(unattended) 환경에 적합합니다

•IMESSAGE_STATE_DIR — access.json과 페어링 상태가 저장되는 디렉토리를 변경합니다. 기본값은 ~/.claude/channels/imessage입니다

세션 유지 — 터미널을 닫아도 계속 작동하게 하려면

iMessage 플러그인은 Claude Code 세션이 활성화되어 있는 동안만 작동합니다. 터미널을 닫거나 Mac이 잠자기 모드로 들어가면 메시지 수신이 중단됩니다. 24시간 상시 운영을 원한다면 세션을 유지하는 방법이 필요합니다.

•tmux 사용 — 터미널 멀티플렉서 tmux 안에서 Claude Code를 실행하면, 터미널 창을 닫아도 세션이 백그라운드에서 계속 살아 있습니다

•잠자기 방지 — 시스템 설정에서 Mac의 잠자기를 비활성화하거나, caffeinate -s 명령으로 잠자기를 방지합니다

알아둘 제한사항

• AppleScript는 메시지를 보낼 수 있지만, 탭백(tapback/리액션), 메시지 수정, 스레드 답장은 지원하지 않습니다. 이 기능들은 Apple의 비공개 API를 필요로 합니다

• Claude Code 세션이 종료되면 메시지 수신도 멈춥니다. 항상 활성 세션이 필요합니다

• 현재 Research Preview 단계입니다. 정식 출시 전까지 기능이 변경될 수 있습니다

전체 설치 흐름 요약

AI 어시스턴트를 부르기 위해 브라우저를 열거나 앱을 전환할 필요가 사라졌습니다. 이미 매일 쓰고 있는 문자 앱에서, 친구에게 메시지 보내듯 Claude에게 일을 맡기면 됩니다. Mac을 켜두기만 하면, iPhone에서든 iPad에서든 Apple Watch에서든, 문자 한 통이 곧 AI 작업 명령이 됩니다.