메일
메일함 목록·검색·읽기, 첨부를 폴더에 저장, 보내기. 네이버·Gmail·다음·iCloud·네이트·직접 입력(IMAP/SMTP). 읽어도 ‘안 읽음’ 그대로이고, 실행 파일 첨부는 저장하지 않으며 매크로 문서는 경고합니다.
itda-hyve
Claude Desktop(Cowork)이 내 PC 의 네트워크로 웹을 읽고, 메일·캘린더·공공데이터 API 를 쓰게 해 주는 작은 프로그램입니다. 계정과 API 키는 내 PC 에만 두고, Claude 는 그 값을 보지 못합니다.
Windows 10/11 · macOS 12 이상 · 무료 · 받아서 두 번 누르면 설치 · 새 판으로 스스로 업데이트
속도는 실측(itda-hyve 처리 시간) — 자세히
Cowork 는 내 컴퓨터가 아니라 격리된 작업 공간에서 돌아서, 메일 서버나 공공 API 에 직접 닿지 못하는 경우가 많습니다. 비밀번호·API 키를 대화에 붙여 넣으면 Claude 에게 보이고 기록에도 남습니다. itda-hyve 는 내 PC 에서 도는 작은 프로그램으로, Claude 의 부탁을 받아 내 PC 의 네트워크로 대신 다녀옵니다. 열쇠(비밀번호·API 키)는 itda-hyve 만 갖고 있습니다.
격리된 작업 공간
Claude · Cowork
“첨부 받아서 요약해줘”
키는 이름만 압니다
내 PC
itda-hyve
작은 프로그램 하나 · 늘 대기
암호화 금고에서 키를 꺼내
허용된 주소로만 채워 보냅니다
바깥
메일 · 캘린더 · API · 웹
네이버·Gmail·iCloud…
공공데이터포털·OpenDART…
결과는 Claude 에게 돌려주거나, 첨부·응답처럼 큰 것은 내 PC 의 연결 폴더에 파일로 남깁니다.
Claude 에게 평소 말투로 부탁하면, 스킬팩의 스킬이 itda-hyve 를 거쳐 아래 일을 합니다. 명령어를 외울 필요가 없습니다.
메일함 목록·검색·읽기, 첨부를 폴더에 저장, 보내기. 네이버·Gmail·다음·iCloud·네이트·직접 입력(IMAP/SMTP). 읽어도 ‘안 읽음’ 그대로이고, 실행 파일 첨부는 저장하지 않으며 매크로 문서는 경고합니다.
일정 조회·만들기·고치기·지우기. 네이버·iCloud 는 메일 계정 그대로 씁니다. 다른 곳에서 바뀐 일정은 덮어쓰지 않고, 참석자가 있는 일정은 고치거나 지우지 않습니다.
공공데이터포털·OpenDART·KOSIS·ECOS·법령·네이버 검색 등의 키를 한 번만 넣어 둡니다. 넣는 순간 실제로 한 번 불러 유효한지 알려 주고, Claude 는 키 값을 보지 못합니다.
내 PC 의 네트워크로 웹페이지를 받아 메뉴·광고를 걷어 낸 본문만 Claude 에게 줍니다. 보도자료·게시판 목록은 날짜 붙은 목록으로, 큰 응답은 파일로 저장합니다.
“여기 날씨 알려줘” 처럼 위치가 필요한 부탁에 시·군·구 수준의 대략적인 위치만 알려 줍니다. 정밀 좌표는 넘기지 않고 기록에도 남기지 않습니다.
Claude 가 만든 마크다운(md) 문서를 기업 문서 모양의 A4 쪽으로 보고, PDF 로 저장하거나 인쇄합니다. 같은 문서를 슬라이드로 나눠 발표할 수도 있습니다. md 파일을 두 번 눌러 바로 열 수도 있습니다 — 설정 방법.
Aside 브라우저를 쓰고 있다면 itda-hyve 가 찾아서 Claude Desktop 에 함께 등록합니다. 브라우저에서 사이트를 열고 읽고 누르는 브라우저 자동화가 필요한 스킬이 이 연결을 씁니다. 등록과 해제는 설정 › 연결 한 곳에서 합니다.
스킬.잇다의 최신 스킬팩(itda-work·itda-gov·itda-web·itda-travel)이 몇 판인지, 이 PC 에 설치된 판이 최신인지 보여 줍니다. 파일을 Claude Desktop 으로 끌어다 놓으면 설치됩니다. 새 판은 ↑ 로 알려 줄 뿐 저절로 바꾸지 않습니다.
itda-hyve 는 새 판이 나오면 받아 서명을 확인하고, 10초 알린 뒤 바꿔서 다시 엽니다. 바뀐 뒤에는 Claude Desktop 을 한 번 다시 시작해야 새 판이 쓰입니다. Claude Desktop 에 올린 스킬팩은 저절로 바뀌지 않습니다 — ↑ 가 붙으면 그 파일을 다시 올립니다.
글자가 작거나 크면 Ctrl + / − / 0(macOS 는 ⌘)이나 Ctrl 을 누른 채 마우스 휠로 화면 크기를 바꿉니다. 고른 크기는 다음에 열 때도 그대로이고, Ctrl+0 이면 원래 크기로 돌아갑니다.
버튼을 누르면 최신판 설치 파일(Windows 는 압축 파일 zip, macOS 는 디스크 이미지 dmg)을 바로 받습니다. 받은 뒤에는 아래 설치 순서대로 하면 됩니다.
최신판 0.17.6
이 컴퓨터용
itda-hyve-windows-amd64.zip
Windows 10/11 의 대부분 PC. 어느 쪽인지 모르면 이쪽을 받으세요 — ARM PC 에서도 돌아갑니다.
내려받기0.17.6이 컴퓨터용
itda-hyve-windows-arm64.zip
Snapdragon 등 ARM PC·Mac 의 Parallels. 설정 > 시스템 > 정보 > 시스템 종류에 ‘ARM 기반 프로세서’ 가 보이면 이쪽입니다.
내려받기0.17.6이 컴퓨터용
itda-hyve-darwin-arm64.dmg
M1 이후의 Mac. 왼쪽 위 사과 메뉴 > 이 Mac 에 관하여 > ‘칩’ 항목에 Apple M… 이 보이면 이쪽입니다.
내려받기0.17.6이 컴퓨터용
itda-hyve-darwin-amd64.dmg
‘칩’ 대신 ‘프로세서’ 에 Intel 이 보이는 Mac. macOS 12 이상.
내려받기0.17.6받은 파일을 두 번 누르면 됩니다. 명령을 입력할 일은 없습니다. 아직 코드 서명을 하지 않은 판이라 처음 한 번 Windows·macOS 가 경고합니다 — 아래처럼 한 번만 넘기면 됩니다.
zip 받기
위 내려받기에서 Windows (Intel·AMD) 를 받습니다. Snapdragon 같은 ARM PC 라면 Windows on ARM 판이 조금 더 빠르지만, 모르면 Intel·AMD 판으로 충분합니다. 받은 파일은 보통 다운로드 폴더에 있습니다.
zip 압축 풀기
받은 zip 을 오른쪽 단추로 눌러 압축을 풉니다 — Windows 기본 메뉴는 모두 압축 풀기, 반디집 같은 압축 프로그램은 … 에 풀기. 같은 이름의 폴더가 생기고, 그 안에itda-hyve.exe 와 설명서(README.txt·LICENSE.txt)가 있습니다. (압축을 풀지 않고 탐색기에서 zip 을 열어 itda-hyve.exe 를 눌러도 됩니다.)
itda-hyve.exe 두 번 누르기 — “Windows 의 PC 보호” 창 넘기기
풀린 폴더의itda-hyve.exe 를 두 번 누릅니다. 파란 “Windows 의 PC 보호” 창이 뜨면 추가 정보를 누르고, 아래에 나오는 실행을 누릅니다(창이 뜨지 않으면 다음 단계로).
“이 PC 에 설치할까요?” 에서 설치
설치를 누르면 itda-hyve 가 스스로 설치되고(관리자 권한 필요 없음) 시작 메뉴에 itda-hyve 가 생긴 뒤 창이 열립니다. 이제itda-hyve.exe 는 사용자 폴더 안의 설치 위치에서 돌고, 받은 파일은 더 쓰지 않습니다.
마지막으로 받은 설치 파일 지우기
itda-hyve 창이 열렸으면 받은 zip 과 풀린 폴더(itda-hyve.exe·README.txt·LICENSE.txt)를 지웁니다. 남겨 두면 나중에 그 itda-hyve.exe 를 눌러 이미 설치한 것과 헷갈립니다. 다음부터는 시작 메뉴에서 itda-hyve 를 검색해 엽니다.
dmg 받기
위 내려받기에서 내 Mac 에 맞는 판을 받습니다 — M1 이후 Mac 은 Apple Silicon, 그 전 Mac 은 Intel.dmg 를 열고 Applications 로 끌어다 놓기
받은 dmg 를 두 번 눌러 엽니다. 나온 창에서itda-hyve 를 같은 창의 Applications(응용 프로그램) 폴더로 끌어다 놓은 뒤 창을 닫습니다. 응용 프로그램 폴더에 있어야 새 판으로 스스로 바뀝니다.
처음 열면 뜨는 경고 — 완료
응용 프로그램 폴더에서 itda-hyve 를 두 번 눌러 처음 열면 “‘itda-hyve’을(를) 열지 않음 — 악성 코드가 없음을 확인할 수 없습니다” 창이 뜹니다 (macOS 14 이하는 “확인되지 않은 개발자”). 아직 Apple 공증을 받지 않은 판이라 그렇습니다 — 휴지통으로 이동이 아니라 완료(또는 취소)를 누릅니다.
시스템 설정에서 그래도 열기
시스템 설정 › 개인정보 보호 및 보안을 열고 아래로 내리면 보안 칸에 “Mac 을 보호하기 위해 ‘itda-hyve’을(를) 차단했습니다” 줄이 있습니다. 그 옆의 그래도 열기를 누릅니다.
한 번 더 그래도 열기 → Touch ID·암호
“‘itda-hyve’을(를) 열겠습니까?” 창이 다시 뜨면 그래도 열기를 누르고, 이어지는 창에서 Touch ID 를 대거나 암호 사용… 으로 Mac 암호를 넣습니다. itda-hyve 창이 열리면 끝입니다 — 이 과정은 처음 한 번만 합니다. 창의 “Claude Desktop 미등록” 은 아래 처음 설정에서 잇습니다.
받은 dmg 꺼내고 지우기
설치가 끝나면 Finder 왼쪽 목록의 itda-hyve 디스크 옆 ⏏ 를 눌러 꺼낸 뒤, 받은 dmg 파일을 지워 주세요. 다음부터는 응용 프로그램 폴더·Launchpad·Spotlight(⌘ 스페이스)에서 itda-hyve 를 찾아 엽니다. 받은 파일을 다시 누르면 이미 설치한 것과 헷갈릴 수 있습니다.itda-hyve 를 설치했으면 바로 이어서 1~4 를 합니다. 10분이면 됩니다. itda-hyve 는 메일·일정·웹 같은 도구를 Claude 에 붙여 주고, 스킬팩은 Claude 에게 그 도구를 언제·어떻게 쓰는지 알려 줍니다 — 둘 다 있어야 합니다. itda-hyve 의 설정은 창 왼쪽 아래 설정(⚙)에 모여 있습니다.
교육에서 스킬팩 파일을 받았다면 같은 업로드 화면에 올립니다.
Claude 가 만든 마크다운(md) 문서를 파일을 두 번 눌러 바로 itda-hyve 문서 창(A4 쪽 보기·PDF 저장·인쇄)으로 열 수 있습니다. itda-hyve 를 설치하면 함께 들어 있고, 한 번만 정해 두면 됩니다.
md 연결 등록
itda-hyve 의 설정(⚙) › 일반에 있는 md 파일 연결 카드에서 md 연결 등록을 누릅니다. 관리자 권한은 필요 없습니다. 카드에 “기본 앱 아님” 이 보이면 다음 단계로 넘어갑니다.Windows 설정에서 기본 앱으로 정하기
같은 카드의 기본 앱으로 정하기… 를 누르면 Windows 설정의 앱 › 기본 앱 › itda-hyve 문서 페이지가 열립니다. .md 줄을 누르고 itda-hyve 문서 › 기본값 설정을 고릅니다..markdown 파일도 쓰면 .markdown 줄도 똑같이 고릅니다. 줄에 이미 “itda-hyve 문서” 가 보여도 한 번 눌러 골라야 합니다 — 고르기 전에는 파일을 두 번 누를 때 앱 고르는 창이 뜹니다.
설정이 열리지 않으면 — 연결 프로그램 — 2 가 안 될 때
md 파일을 오른쪽 단추로 눌러 연결 프로그램 › 다른 앱 선택에서 itda-hyve 문서를 고르고 항상을 누릅니다. 한 번만 열 때는 연결 프로그램 › itda-hyve 문서를 고릅니다 — 파일마다 창이 따로 뜹니다.정보 가져오기에서 모두 변경
md 파일 하나를 고르고 ⌘I(정보 가져오기)를 누릅니다. 다음으로 열기에서 itda-hyve 문서를 고른 뒤 모두 변경… 을 누릅니다.한 번만 열 때
md 파일을 오른쪽 클릭 › 다음으로 열기 › itda-hyve 문서. 이미 창이 떠 있어도 파일마다 새 창으로 열립니다.itda-hyve 는 스스로 기본 앱을 바꾸지 않습니다. 원래 앱으로 되돌릴 때도 같은 곳에서 고릅니다. 문서 창만 열려면 시작 메뉴(Windows)나 Spotlight(macOS)에서 itda-hyve 문서를 찾습니다. Windows 에서 연결을 그만 쓰려면 카드의 해제를 누릅니다 — itda-hyve 가 등록한 것만 지워지고 다른 앱의 연결은 그대로입니다.
새 판이 나오면 itda-hyve 가 받아 서명을 확인하고, “새 판으로 바꿉니다” 를 10초 알린 뒤 스스로 바꿔 다시 엽니다(Windows·macOS). 설정과 저장한 계정·키는 그대로입니다. 사용자가 할 일은 Claude Desktop 다시 시작 하나입니다.
바뀐 뒤에는 Claude Desktop 을 완전히 종료했다가 다시 여세요. 그 전까지 Claude 는 옛 판 itda-hyve 를 계속 씁니다(멈추지는 않습니다). itda-hyve 대시보드의 Claude Desktop 칩이 “재시작 대기” 로 알려 줍니다.
서두르면 알림의 지금 바꾸기, 곤란하면 나중에(다음에 itda-hyve 를 열 때 다시 합니다). 저장하지 않은 문서가 있거나 Claude 가 itda-hyve 를 쓰는 중이면 끝날 때까지 기다립니다.
Claude Desktop 에 올린 스킬팩은 저절로 바뀌지 않습니다. itda-hyve 의 스킬팩에서 팩 옆에 ↑ 가 붙으면, 처음 설정 4 처럼 새 파일을 Claude Desktop 에 다시 올립니다.
저절로 바뀌지 않았다면(회사 PC 의 쓰기 제한 등) 손으로 바꿉니다 — 위 내려받기에서 새 판을 받아, 벌 아이콘 › 종료로 itda-hyve 를 끈 뒤 Windows 는 새 itda-hyve.exe 를 두 번 눌러 “바꿀까요?” 에서 바꾸기, macOS 는 itda-hyve 를 Applications 로 끌어다 놓고 대치.
수업처럼 판을 고정해야 하면 설정 › 정보에서 “새 판 확인” 을 끕니다. 끄면 묻지도 바꾸지도 않습니다.
아니요. 값은 내 PC 의 암호화 파일에만 있고, 값을 읽어 가는 기능이 itda-hyve 에 아예 없습니다. 대화에서 Claude 가 키를 물어보면 알려 주지 말고 itda-hyve 설정에 넣으세요.
메일 프로그램 전용으로 따로 만드는 비밀번호입니다. 로그인 비밀번호가 아닙니다. 네이버는 메일 › 환경설정 › POP3/IMAP 설정에서 IMAP 을 켜고(2단계 인증을 쓰면 ‘애플리케이션 비밀번호’), Gmail 은 Google 계정 › 보안 › 2단계 인증 › 앱 비밀번호(16자리), 다음은 메일 환경설정 › IMAP/POP3 의 IMAP 전용 비밀번호, iCloud 는 appleid.apple.com › 로그인 및 보안 › 앱 암호에서 만듭니다. 네이트는 IMAP 사용을 켜고 일반 비밀번호를 씁니다.
Windows 는 ‘Windows (Intel·AMD)’ 를 받으세요 — ARM PC 에서도 돌아갑니다. Mac 은 사과 메뉴 › 이 Mac 에 관하여에서 ‘칩’ 에 Apple M… 이 보이면 Apple Silicon, ‘프로세서’ 에 Intel 이 보이면 Intel 판입니다.
아니요. 창을 닫으면 화면 오른쪽 아래 알림 영역(Windows — ^ 안에 숨어 있을 수 있습니다)이나 화면 위 메뉴 막대(macOS)의 벌 아이콘으로 숨습니다. 다시 열 때는 아이콘 › itda-hyve 열기, 끝낼 때는 아이콘 › 종료. 켤 때마다 띄워 두려면 설정 › 일반의 ‘로그인 시 자동 실행’ 을 켭니다.
Ctrl+0(macOS 는 ⌘0)을 누르면 원래 크기로 돌아옵니다. 크기는 Ctrl + / − 로 바꿉니다.
Claude Desktop 에 연결한 뒤 Claude Desktop 을 완전히 종료했다가 다시 열었는지 확인하세요. 창만 닫으면 안 됩니다 — Windows 는 알림 영역 아이콘에서 종료, macOS 는 ⌘Q. itda-hyve 의 설정 › 연결 › Claude 연결에서 ‘등록됨’ 인지, Claude Desktop 채팅 입력칸의 + › 커넥터에서 itda-hyve 가 켜져 있는지도 봅니다.
아직 코드 서명을 하지 않은 판이라, 실행 정책이 엄격한 회사·학교 PC 와 ‘Smart App Control’ 이 켜진 Windows 11 PC 일부에서는 열 수 없습니다. 개인 PC 에서 써 주세요.
‘항상 허용’ 을 권합니다. 메일 보내기·일정 지우기처럼 되돌릴 수 없는 일은 itda-hyve 가 따로 미리보기를 보여 주고 한 번 더 확인을 받습니다.
itda-hyve 의 설정 › 정보 맨 아래 itda-hyve 제거… 를 누르고, 지울 것을 보여 주는 창에서 제거를 누릅니다. Claude Desktop 연결·로그인 시 자동 실행·바로가기를 정리하고 앱을 지운 뒤 끝내기로 마칩니다(macOS 는 앱을 휴지통으로 옮깁니다). 저장한 메일 계정·API 키까지 지우려면 그 창에서 ‘내 설정·계정·비밀 정보도 지우기’ 를 켭니다. 다 되면 Claude Desktop 을 다시 시작하세요. Claude Desktop 에 설치한 스킬팩은 Claude Desktop 에서 지웁니다.
Windows 는 설정 › 앱 › 설치된 앱에서 itda-hyve 를 찾아 제거를 눌러도 같은 창이 뜹니다.
앱이 열리지 않으면 손으로 지웁니다. 설정 › 연결 › Claude 연결에서 ‘등록 해제’, 설정 › 일반의 ‘로그인 시 자동 실행’ 을 끈 뒤 아이콘 › 종료로 끝냅니다. 그다음 macOS 는 응용 프로그램 폴더의 itda-hyve 를 휴지통으로, Windows 는 설치 폴더 %LOCALAPPDATA%\Programs\itda-hyve 와 시작 메뉴의 itda-hyve 바로가기를 지웁니다. 저장한 계정·키까지 지우려면 사용자 폴더의 .itda\hyve 폴더도 지웁니다 — 그 옆의 master.key 는 다른 itda 앱도 쓰는 열쇠라 남겨 두세요.
실제로 돌려 본 예시, 잰 속도, 설계를 더 자세히 보고 싶다면 펼쳐 보세요.
메일 첨부
naver 받은편지함에서 제목 "첨부 테스트" 메일의 첨부를 연결 폴더에 받아서, 내용을 세 줄로 요약해줘.
폴더에 「3분기 영업 보고서.pdf」「월별 매출 현황.xlsx」가 한글 이름 그대로 생기고, 메일은 여전히 ‘안 읽음’입니다.
공시 조회
삼성전자 최근 공시 3건 알려줘
Claude 는 키 값을 한 번도 보지 않았습니다. 키가 없으면 ‘설정 창에 넣으세요’라고만 안내하고, 넣는 즉시 재시작 없이 됩니다.
공공데이터
강남구 2026년 1월 아파트 매매 실거래를 받아서 요약해줘.
원본 응답 파일이 내 PC 폴더에 남습니다. 요약은 그 파일에서 나오므로 언제든 다시 확인할 수 있습니다.
일정
내일 오후 3시에 "주간 회의" 30분 일정 만들어줘 → 방금 만든 일정 지워줘
네이버·iCloud 캘린더를 메일 계정 그대로 씁니다. 지우기와 메일 보내기는 언제나 한 번 더 묻습니다.
메일 한 통 열기 네이버
0.06~0.07초
공시 조회 OpenDART
0.07~0.1초
메일 검색 네이버
0.2~0.7초
첨부 저장 네이버
0.09~1.9초
캘린더 조회 네이버
0.4초
캘린더 조회 iCloud
1.2~3.3초
스크립트로 직접 처리할 때
itda-hyve 를 거칠 때
0개
파이썬도 패키지도 필요 없는 실행 파일 하나입니다. 예를 들어 캘린더는 예전 스킬이 caldav·icalendar 를 설치해야 했지만, 이제 itda-hyve 안에 들어 있습니다.
25~33초
Cowork 에서 실제로 잰 설치 시간입니다(도구 하나 첫 설치 25.5초, 다른 도구는 대화마다 151MB·약 33초 재설치). itda-hyve 가 맡은 일에는 이 대기가 없습니다.
1.9초 → 0.09초
늘 떠 있는 프로그램이라 메일 서버 연결을 다시 씁니다. 같은 메일함에서 이어 받은 첨부 저장이 1.9초에서 0.09초로 줄었습니다.
메일 앱 비밀번호와 API 키는 ~/.itda/hyve/vault.enc 에 AES-256-GCM 으로 암호화해 둡니다. 설정 파일에는 비밀값이 없습니다. 값이 PC 밖으로 나가는 때는 그 값을 쓰는 요청이 허용된 주소로 갈 때뿐입니다.
값을 읽어 가는 도구가 아예 없습니다. 스킬은 {{secret:이름}} 같은 자리표시자만 쓰고, 요청이 나가는 순간 itda-hyve 가 채워 넣습니다. 응답에 값이 되비치면 •••• 로 가립니다. 대화에서 Claude 가 키를 물어보면 알려 주지 말고 설정 창에 넣으세요.
키마다 쓸 수 있는 호스트가 정해져 있습니다. 다른 주소로 가는 요청이면 값을 채우지 않고 요청 자체를 보내지 않습니다. 메일 비밀번호도 그 계정의 메일·캘린더 서버로만 갑니다.
첫 호출은 미리보기만 보여 주고 아무것도 보내지 않습니다. 확인한 뒤에야 보냅니다. 확인은 10분 안에 한 번만 쓸 수 있고, 수신자·제목·본문·첨부 중 하나라도 바뀌면 무효가 됩니다. 발송 횟수 제한 같은 다른 장치는 없으니 미리보기를 꼭 읽고 확인하세요.
감사 로그에 시각·도구·대상·결과가 남습니다(본문·수신자·비밀번호는 남기지 않습니다). Claude Desktop 과는 표준 입출력(stdio)으로만 이어지고 로컬 포트를 열지 않습니다 — 같은 PC 의 다른 프로그램이 포트로 도구를 부를 길을 만들지 않기 위해서입니다.
스스로 업데이트할 때 받은 파일의 서명을 확인하고, 맞을 때만 바꿉니다. 판을 고정해야 하면 설정 › 정보에서 ‘새 판 확인’ 을 끕니다.
설치나 사용 중에 막히면 문의 폼으로 알려 주세요. itda-hyve 대시보드의 맨 위 카드(“지금 무슨 일이 일어나고 있나” — 연결 상태)와 최근 1시간 요약, 그리고 화면에 뜬 오류 메시지를 캡처해 함께 보내면 빠릅니다(이 화면에는 메일 본문·비밀번호가 나오지 않습니다).