Wikimate (위키메이트)
AI 에이전트에게 "정리해줘" 라고 말하면, 흩어진 자료(웹 링크·PDF·대화 로그·텍스트)를 내 옵시디언 볼트에 노트로 정리하고, 관련 있는 노트끼리 연결하고, 분류하고, 요약까지 해 주고, 원하면 노션에 색인해주는 Claude Code 플러그인이에요. (Codex엔 "플러그인 설치(/plugin)"가 없어서, 대신 저장소를 받아 codex mcp add로 MCP 서버로 등록해 연동해요.)
English version (영문판) · HTML로 보기: README.html
📱 기기 안내: Wikimate는 윈도우 PC(데스크톱·노트북) 전용이에요. 스마트폰·태블릿에는 설치되지 않아요. (말로 명령하는 AI 프로그램인 Claude Code·Codex 자체가 PC용 프로그램이기 때문이에요.)
✅ 현재 상태 (2026-09-01 기준, 정직하게): 현재 버전 v0.10.1(2026-11-02 패치 반영). MCP 도구 8개 전부 main 브랜치에 병합·GitHub에 푸시 완료. 자동 테스트 241개 전부 통과(npm run verify), 실제 서버 프로토콜 검증, 실제 옵시디언 볼트로 직접 실행해 본 검증(E2E)까지 완료. main에 push할 때마다 GitHub 서버가 자동으로 같은 검증 + 보안 스캔을 한 번 더 돌려요(GitHub Actions). 세션 시작 자동 감지(hook)와 옵시디언 그래프뷰 반영은 실제 사용자 환경에서 화면으로 직접 확인 완료됐어요(스크린샷 근거). 노션 색인 왕복 연결·마켓플레이스 재설치도 실제 사용자 환경에서 라이브로 확인 완료됐어요(2026-09-01). 자세한 항목별 상태는 17. 현재 상태 정리를 보세요.
이 문서는 AI·컴퓨터·모바일기기·전자기기를 처음 다뤄보는 분도 위에서부터 순서대로 그대로 따라 하면 되도록 만들었어요. 어려운 말은 전부 풀어 썼습니다.
목차
- Wikimate가 뭐예요? (1분 이해)
- 30초 용어 사전
- 사전 준비물
- 필요 프로그램 다운로드 방법
- Wikimate 다운로드 방법
- 설치 방법
- 실행 방법
- 빠른 시작 (3분 따라 하기)
- 작동 방법 (안에서 무슨 일이 일어나나요?)
- 사용 방법 (7가지 기능)
- 워크플로우 (전체 흐름 한눈에)
- 명령어 모음
- 업데이트 내용 요약
- 파일·문서 위치 (폴더 구조)
1. Wikimate가 뭐예요? (1분 이해)
흩어진 자료를 정리해 주는 AI 비서예요.
비유로 설명하면 — 책상 위에 영수증·메모·링크가 잔뜩 쌓여 있을 때 "이것 좀 정리해줘"라고 말하면, 알아서 폴더에 분류해 노트로 정리해 주고, 관련 있는 노트끼리 실을 이어주고, 비슷한 주제끼리 목차까지 만들어 주고, 긴 노트는 한 줄로 요약까지 해 주는 비서라고 보면 돼요. 메신저(카카오톡 같은 채팅)로 비서에게 부탁하듯, 그냥 한국어로 말로 시키면 됩니다.
- 정리한 결과는 옵시디언(Obsidian) 이라는 메모 앱에 노트로 쌓여요. (내 컴퓨터 안에만 보관 = 외부로 안 나감)
- 원하면 노션(Notion) 표에도 목록으로 적어줘요. (선택 기능)
- 관련된 노트끼리는 자동으로 실을 이어주고(자동 링크), 비슷한 주제는 목차 노트(MOC) 로 묶어줘요.
- 아직 폴더·태그가 안 정해진 노트는 어디에 둘지·무슨 태그를 붙일지 판단해서 제안해줘요.
- 너무 긴 노트는 한 줄 요약을 붙여주거나, 핵심만 뽑은 원자 노트를 별도로 만들어줘요(원본은 절대 안 건드림).
- 함부로 지우거나 바꾸지 않아요. 항상 "이렇게 할게요" 먼저 보고하고, 내가 "응" 해야 실행해요.
한 줄 요약: "이거 정리해줘"라고 말하면, 내 메모 앱에 깔끔한 노트로 정리하고, 서로 연결하고, 분류하고, 요약까지 해 주는 도구.
2. 30초 용어 사전 (왕초보 필수)
처음 보는 낱말이 나와도 당황하지 마세요. 자주 쓰는 말만 쉬운 비유로 풀었어요.
| 낱말 | 쉬운 뜻 (비유) |
|---|
| AI 에이전트 | 사람 말을 알아듣고 대신 일해 주는 똑똑한 프로그램 (= 비서) |
| Claude Code (클로드 코드) | 내 컴퓨터에서 AI에게 말로 일을 시키는 프로그램 (채팅창처럼 생김) |
| Codex (코덱스) | Claude Code와 비슷한 다른 AI 도구 (둘 중 하나만 있으면 됨) |
| 플러그인 (plugin) | 프로그램에 새 기능을 끼워 넣는 부품 (스마트폰에 앱 하나 더 까는 것과 비슷) |
| 마켓플레이스 (marketplace) | 플러그인을 받아오는 앱 장터 (앱스토어 같은 것) |
| MCP | AI와 도구를 이어 주는 표준 통로(콘센트). Wikimate는 이 통로를 통해 일해요. |
| MCP 도구 | 그 통로로 AI가 누를 수 있는 기능 버튼 (Wikimate엔 8개, 12번 참고) |
슬래시 명령 /wikimate | "정리해줘"가 가끔 안 들을 때 확실하게 시키는 직접 명령 (100% 발동) |
| 옵시디언 (Obsidian) | 내 컴퓨터에 메모를 쌓는 노트 앱 (정리 결과가 여기 저장돼요) |
| 볼트 (Vault, 보관함) | 옵시디언에서 노트를 모아 두는 노트 보관 폴더. 만들 때 이름을 붙여요. |
| 노션 (Notion) | 표·문서를 정리하는 앱 (선택 — 목록표를 원할 때만) |
| 터미널 / cmd / CLI | 글자로 명령을 입력하는 검은 창 (윈도우 기본 제공) |
| Node.js (노드) | Wikimate가 돌아가게 해 주는 무료 엔진(받침대) — 한 번만 깔면 됨 |
| Git (깃) | 인터넷에 있는 폴더를 통째로 내려받는 도구 (고급/선택) |
| dry-run (드라이런) | 실제로 하기 전에 "계획만" 미리 보여주기 (= 미리보기) |
| frontmatter (프런트매터) | 노트 맨 위에 붙는 작은 정보표 (제목·태그·날짜 등) |
| source_hash | 같은 자료인지 알아보는 지문 (중복 방지용, 자동) |
| 99_Archive (보관함) | 노트를 지우지 않고 옮겨 두는 폴더 (되돌리기 쉬움) |
💡 다 외울 필요 없어요. 모르는 말이 나오면 이 표로 다시 오면 됩니다.
3. 사전 준비물
| 준비물 | 꼭 필요? | 설명 |
|---|
| 컴퓨터 (Windows) | ✅ 필수 | 이 문서는 Windows 11 기준이에요. (스마트폰·태블릿 불가) |
| Node.js 18 이상 | ✅ 필수 | Wikimate가 돌아가는 데 필요한 무료 프로그램. (4번에서 설치) |
| Claude Code 또는 Codex | ✅ 필수 | "정리해줘"라고 명령할 AI 도구. 둘 중 하나만 있으면 돼요. |
| 옵시디언(Obsidian) | 🔶 선택 | 정리된 노트를 눈으로 보고 싶으면 설치. 없어도 파일은 만들어져요(파일시스템 폴백). |
| 노션(Notion) | 🔶 선택 | 표로 목록을 보고 싶을 때만. 없어도 됩니다. |
| Git | 🔶 선택 | Codex로 쓰거나 개발자처럼 직접 받을 때만 필요해요. |
💡 꼭 필요한 건 딱 3개: Windows 컴퓨터 + Node.js + (Claude Code 또는 Codex). 나머지는 선택이에요.
4. 필요 프로그램 다운로드 방법
① Node.js (필수)
- 인터넷 주소창에 nodejs.org 입력 → 접속.
- LTS 라고 적힌 큰 초록색 버튼을 눌러 내려받기. (LTS = "오래 안정적으로 쓰는 버전")
- 내려받은 파일을 더블클릭 → "다음(Next)"만 계속 눌러 설치.
- 확인: 키보드
Win 키 → "cmd" 입력 → 검은 창에서 node -v 입력 → v18.x 이상 숫자가 나오면 성공.
② Claude Code (필수, 둘 중 하나)
- claude.com/claude-code 접속 → 안내대로 설치. (AI에게 말로 명령하는 프로그램)
② Codex (대안)
- Codex CLI를 쓰는 분은 Claude Code 대신 이걸로도 돼요. (6번에서 설명)
③ 옵시디언 (선택)
- obsidian.md 접속 → 다운로드 → 설치. 처음 켜면 "보관함(Vault)"을 하나 만들어요. 이 보관함 이름을 기억해 두세요(나중에 씁니다).
④ notesmd-cli (선택, 고급)
- 옵시디언을 켜지 않고도 노트를 만들고 싶을 때만. 설치는 Scoop으로:
scoop install notesmd-cli
5. Wikimate 다운로드 방법
두 가지 방법이 있어요. 대부분은 (A)면 충분합니다.
(A) 마켓플레이스로 설치 — 권장 (다운로드가 자동)
Claude Code 안에서 명령어 두 줄만 입력하면 GitHub에서 자동으로 내려받아 설치돼요. (6번 참고) 따로 파일을 받을 필요가 없어요. 마켓플레이스는 저장소의 최신 main 브랜치를 그대로 받아오므로, 이 문서에 적힌 도구 8개 전부가 설치돼요.
(B) 폴더로 직접 받기 — Codex용·개발용
GitHub에서 통째로 받는 방법이에요. Codex로 쓸 때는 이 방법이 필수입니다(Codex엔 마켓플레이스가 없어서요).
git clone https://github.com/sodam-ai/SoDam-WikiMate.git
以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗
