Vibebook 설치와 설정
Agent Sueño
Vibebook은 ChatGPT, Gemini, Grok, Claude, Claude Code 같은 AI와 나눈 대화를 내 컴퓨터에 기록하고 새 대화를 시작하면 지난 기록을 AI에게 다시 건네줍니다. 기록은 내 컴퓨터의 로컬 AI가 주제별 문서로 정리합니다. 이 안내는 맥과 윈도우에서 처음 설치부터 AI마다 연결하는 방법까지 순서대로 설명합니다.
1. Vibebook이 하는 일
기록: 대화 원문을 그대로 남깁니다. Chrome 확장, Claude 앱 플러그인, AI 앱 설정 같은 연결 프로그램이 말이 오갈 때마다 옮기고 요약하거나 고치지 않습니다.
정리: 내 컴퓨터의 로컬 AI(Ollama)가 원문을 읽고 주제별 문서와 결정, 남은 일을 씁니다. 대화하는 AI는 Vibebook에 쓰지 않고 읽기만 합니다.
읽기: 새 대화를 시작하거나 지난 일을 물으면 Vibebook이 관련 기록을 찾아 AI에게 건넵니다.
기록장은 하나입니다. 어느 AI와 나눈 대화인지, 어느 프로젝트 이야기인지는 기록장 안의 분류로 나뉩니다.
2. 준비물
맥(macOS) 또는 윈도우 컴퓨터. Agent Bridge가 켜져 있는 동안 기록합니다. 컴퓨터가 꺼져 있거나 잠들어 있으면 기록하지 않습니다.
Agent Bridge. Vibebook이 들어 있어 따로 설치하지 않습니다.
Chrome. ChatGPT, Gemini, Grok, Claude를 웹에서 쓸 때 필요합니다.
Ollama와 Gemma 4 모델. 기록을 문서로 정리할 때 씁니다. Agent Bridge에서 터미널 없이 설치합니다.
3. Agent Bridge 설치
1단계. Web OS에 로그인해 [환경설정] › [로컬 (NAS)]을 엽니다. 「Agent Bridge 설치」에서 내 컴퓨터에 맞는 설치 파일(맥, 윈도우)을 내려받습니다.
2단계. 맥은 dmg 파일을 열어 Agent Bridge를 응용 프로그램 폴더로 끌어다 놓습니다. 윈도우는 exe 파일을 실행해 설치합니다. 처음 실행할 때 경고 창이 뜨면 사용 안내의 「오피스와 설치판」과 같은 방법으로 엽니다.
3단계. Agent Bridge 창에서 「Web OS로 로그인해서 연결」을 누르고 브라우저에서 로그인합니다. 연결하면 기록이 2분마다 Web OS 클라우드에 올라가 다른 컴퓨터에서도 볼 수 있습니다.


4단계. Vibebook이 켜지면 Agent Bridge 아이콘이 달에서 책을 든 달로 바뀝니다. 맥은 화면 위쪽 메뉴 막대, 윈도우는 화면 오른쪽 아래 알림 영역에 있습니다.
4. 정리할 로컬 AI 설치
Agent Bridge 창의 「로컬 AI」 탭에서 「Ollama 설치」를 누르고 모델 목록에서 Gemma 4 모델의 「다운로드」를 누릅니다. 터미널을 쓰지 않습니다.

설치가 끝나면 Agent Bridge가 설치된 Gemma 4 모델 가운데 가장 큰 것을 골라 기록을 정리합니다. 모델이 클수록 정리가 자세하고 문장이 자연스럽습니다. 쌓인 기록은 10분마다 살펴 저절로 정리하고 정리한 문서에는 어느 모델이 썼는지 남습니다.
5. AI 앱 연결 (Claude Code, Codex 등)
Agent Bridge는 이 컴퓨터에 설치된 AI 앱을 찾아 Vibebook에 저절로 연결합니다. 나중에 새로 설치한 앱도 10분 안에 연결합니다. 대상은 Claude Code, Codex, Gemini CLI, GitHub Copilot CLI, Cursor, VS Code, LM Studio입니다.

1단계. Agent Bridge 창의 「로컬 AI」 탭에서 「Vibebook 설정하기」를 펼칩니다. 앱마다 「자동 기록 중」인지, 등록만 되고 아직 기록이 없는지 보입니다.

2단계. Claude Code가 아닌 앱은 연결한 뒤 그 앱을 한 번 다시 시작합니다.
3단계. Codex는 처음 한 번 Codex 안에서 /hooks 를 열어 Vibebook 훅을 허용합니다. 허용해야 새 대화에 지난 기록을 받습니다.
4단계. 「점검」을 누르면 Agent Bridge가 등록한 설정을 직접 불러 실제로 기록되는지 확인하고 빠진 것이 있으면 무엇을 하면 되는지 알려 줍니다.
6. 웹 AI 연결 (ChatGPT, Gemini, Grok, Claude)
Chrome에서 쓰는 ChatGPT, Gemini, Grok, Claude는 Vibebook Chrome 확장이 기록합니다. 새 대화의 첫 말을 보낼 때 지난 기록을 그 말 앞에 붙여 함께 보냅니다. 맥과 윈도우 모두 순서가 같습니다.
1단계. 「Vibebook 설정하기」의 「웹 AI」 줄에서 「확장 받기」를 누릅니다. 다운로드 폴더에 「Vibebook for Chrome」 폴더가 생깁니다.
2단계. Chrome 주소창에 chrome://extensions 를 열고 오른쪽 위 「개발자 모드」를 켭니다. 「압축해제된 확장 프로그램을 로드합니다」를 누르고 다운로드 폴더의 「Vibebook for Chrome」 폴더를 고릅니다.
3단계. 「웹 AI」 줄에서 「연결 코드」를 누르면 6자리 숫자가 나옵니다. Chrome 오른쪽 위의 Vibebook 아이콘을 눌러 그 숫자를 넣고 「연결하기」를 누릅니다. 코드는 10분 동안 쓸 수 있습니다.

4단계. ChatGPT, Gemini, Grok, Claude에서 새 대화를 열어 질문합니다. 보낸 말 맨 앞에 「[Vibebook 지난 기록」이 붙어 있으면 연결이 끝났습니다. Vibebook 아이콘 창의 「마지막 붙이기」에서도 확인합니다.

확장의 새 판을 받은 뒤에는 chrome://extensions 에서 Vibebook의 새로고침 단추를 누르고 열어 둔 AI 탭도 새로고침합니다.
Claude 웹은 긴 대화도 처음부터 기록합니다. 화면에 다 보이지 않는 앞부분까지 확장이 함께 기록합니다.
7. Claude 앱 연결
Agent Bridge가 Claude 앱 설정에 Vibebook 커넥터를 저절로 등록합니다. Agent Bridge를 켠 뒤 Claude 앱을 한 번 다시 시작합니다.
Cowork 대화: 기록 플러그인을 한 번 설치하면 기록과 읽기가 저절로 됩니다. 「Vibebook 설정하기」의 「Cowork (Claude 앱)」 줄에서 「설치 파일 받기」를 누르고 Claude 앱에서 Customize › Plugins › Add › Upload plugin으로 받은 파일을 올립니다.

일반 채팅: Claude가 스스로 Vibebook을 골라야 지난 기록을 읽습니다. 「Vibebook 설정하기」의 「Claude 앱 일반 채팅」 줄에서 「문장 복사」를 누릅니다. Claude 앱 왼쪽 아래 내 이름 › Settings › 「Instructions for Claude」에 붙여 넣으면 모든 대화에 적용됩니다.
더 잘 부르게 하려면 대화 입력칸 왼쪽 아래 + › Connectors › Tool access에서 「Always available」을 고릅니다. 이 설정은 그 대화에만 적용됩니다.
일반 채팅 대화는 Claude 앱이 서버에만 남겨 Vibebook에 기록되지 않습니다. 기록이 필요하면 Cowork나 Chrome의 Claude 웹을 씁니다.
8. 기록 보기
Agent Bridge가 켜져 있으면 브라우저에서 http://127.0.0.1:4787 을 열거나 Agent Bridge의 「기록 보기」를 누릅니다. 이 컴퓨터에서만 열립니다.
로컬 AI는 주제 하나에 문서 하나를 씁니다. 제목은 「StageG 수에노 AI 대화창 구현 건」처럼 무슨 일인지 보이게 짓고 파일 이름도 같습니다.
제목 아래 「문서 개요」 상자에서 주제, 문서 종류(작업 기록, 작업 규칙, 가져온 문서, 주제 정리), AI 요약, 읽을 때, 정리한 모델, 기간을 한눈에 봅니다. AI 요약과 읽을 때는 로컬 AI가 쓰고 나머지는 프로그램이 기록에서 그대로 가져옵니다.

본문은 세 칸입니다. 「대화 흐름과 작업 방향」은 대화마다 무엇을 요청했고 작업이 어느 쪽으로 갔는지 표로 보여 줍니다. 「결과와 결정」은 지금 유효한 결정과 만든 결과물이고 「파일과 코드」는 다룬 파일과 꼭 필요한 명령입니다.
항목마다 1.1, 2.1 같은 번호가 붙습니다. [1] 같은 각주는 그 내용이 나온 원문 대화이고 문서 맨 아래 「각주」에 모입니다. 마우스를 올리면 어느 AI와 언제 나눈 대화인지 보이고 「원문 보기」를 누르면 그 대화로 갑니다. 스크롤하면 오른쪽 목차가 지금 읽는 칸을 짙게 표시합니다.
![결과와 결정 칸. 줄마다 2.1 같은 번호가 있고 [1] 각주에 마우스를 올리면 근거 대화가 뜬다](/manual/vibebook-wiki-notes.webp)
「역사」에서는 문서가 고쳐진 판(r1, r2 …)과 바뀐 글자 수를 보고 두 판을 골라 비교합니다. 「분류」에서는 ChatGPT, Claude Code 같은 AI 도구나 프로젝트별로 문서와 대화를 모아 봅니다.

오른쪽 위 톱니바퀴에서 화면 밝기(자동, 밝게, 어둡게)와 언어(한국어, English, 日本語, 中文)를 고릅니다. 같은 곳의 「가리기」에서 비속어 가리기와 어려운 말 풀이를 켜고 끕니다. 비속어 가리기를 켜면 비속어를 흐리게 가리고 누를 때만 보여 줍니다. 어려운 말 풀이를 켜면 MCP, 임베딩 같은 말에 점선 밑줄을 긋고 마우스를 올리면 쉬운 풀이를 보여 줍니다.
9. 문서 고치기와 내보내기
「수정」을 누르면 제목, 한 줄 설명, 본문을 직접 고칩니다. 저장하면 새 판이 생기고 지금 판은 「역사」에 남습니다. 직접 고친 문서는 문서 개요의 「정리」 칸이 「직접 수정」으로 바뀝니다.
본문에 [* 내용]을 쓰면 그 자리에 각주 번호가 붙고 맨 아래 「각주」에 메모로 들어갑니다.
「공유」에서 내용 복사, Markdown 파일 받기, PDF로 저장, AI용 주소 복사를 고릅니다. PDF로 저장을 누르면 인쇄 창이 열리고 거기서 「PDF로 저장」을 고릅니다. AI용 주소는 다른 AI에게 이 문서 원문을 읽게 할 때 붙여 넣습니다.

10. 문서 넣기 (PDF, Markdown, 텍스트)
자동으로 기록되지 않은 자료는 직접 넣습니다. 위쪽 메뉴의 「문서 넣기」를 엽니다.
파일을 끌어 놓거나 눌러서 고릅니다. PDF, Markdown(.md), 텍스트(.txt) 파일을 한 파일에 20MB까지 넣습니다.

파일에 제목(#)이 있으면 절마다, 없으면 문단을 모아 조각으로 나눕니다. 로컬 AI가 조각마다 주제를 붙여 맞는 문서에 정리합니다. 주제 칸에 이름을 적으면 모든 조각이 그 주제 문서로 갑니다.
같은 파일을 두 번 넣으면 건너뜁니다. 넣은 파일은 아래 「넣은 파일」 목록에서 다시 봅니다.
11. 앱마다 되는 것
자동 기록과 자동 읽기: Claude Code, Claude 앱 Cowork(플러그인 설치 후), Chrome의 ChatGPT, Gemini, Grok, Claude(확장 설치 후)
자동 기록, 시작할 때 지난 기록 받기: Codex, Gemini CLI, GitHub Copilot CLI, Cursor
자동 기록, 읽기는 AI가 Vibebook을 부를 때: VS Code, LM Studio
Claude 앱 일반 채팅: 읽기는 Claude가 Vibebook을 부를 때만 하고 기록은 하지 않습니다.
기록하지 못하는 앱: ChatGPT 앱, Gemini 앱, Grok 앱, 휴대폰 앱. 대화가 각 회사 서버에만 있거나 컴퓨터에 암호화돼 있어 읽을 수 없습니다. 이 AI들은 Chrome에서 쓰면 기록됩니다.
12. 문제가 생겼을 때
Claude 앱에 「MCP vibebook: Server disconnected」가 뜹니다: Agent Bridge를 켠 뒤 Claude 앱을 다시 시작합니다. 그래도 같으면 Agent Bridge를 최신 판으로 업데이트합니다.
Chrome에서 지난 기록이 붙지 않습니다: Vibebook 아이콘 창을 엽니다. 「아직 연결되지 않았어요」가 보이면 연결 코드를 다시 넣고 「시간이 넘어 붙이지 못했어요」가 보이면 Agent Bridge가 켜져 있는지 확인합니다.
앱이 「등록됨 · 아직 기록이 없어요」에 머뭅니다: 그 앱을 한 번 다시 시작한 뒤 대화합니다. 「점검」을 누르면 빠진 것을 알려 줍니다.
문서가 생기지 않습니다: 「로컬 AI」 탭에서 Ollama와 모델이 설치됐는지 확인합니다. 정리는 기록이 쌓이면 10분마다 돕니다.