Beronica (AI-native 업무 시스템) 세팅 매뉴얼 — 개인 사용자 세팅

이 시스템의 핵심: Obsidian(노트앱) + Claudian(AI 플러그인)을 결합하여, 개인 업무 관리를 하나의 체계로 운영합니다. AI가 당신의 업무 맥락을 기억하고, GTD 워크플로우를 자동으로 실행합니다.

---

1.1 시스템 개요 — 이게 뭔가요?

이 시스템은 두 가지 방법론 + AI 어시스턴트를 결합합니다:

GTD는 업무를 수행하는 방법론입니다. PARA는 업무를 수행하면서 산출되는 결과 문서와 데이터를 저장하고 재사용하는 방법론입니다.

이 두가지를 잘 쓰면 매우 강력한 생산성을 보이지만 그만큼 복잡하고 익숙해지는데 어려움이 있습니다. 그것을 AI 어시스턴트가 해결해줍니다.

또한 계속해서 사용자와의 작업가운데 맥락(Context)을 별도로 기억, 업데이트하면서 사용하면 사용할 수록 정확하고 고도화된 결과물을 산출합니다.

• Project -> 단발 프로젝트
• Areas -> 지속 관리 업무
• Resources -> 참고자료
• Archive -> 완료 프로젝트 및 업무

사용 예시:

• 채팅창에 "다음 주까지 분기 보고서 작성해야 해" → AI가 자동으로 인박스에 캡처 → 분류 제안
• "거래처 A 담당자 연락처 알려줘" → AI가 30_참고자료/인맥관리/에서 찾아서 답변
• 매주 월요일 → AI가 이번 주 루틴 업무 자동 안내

---

1.2 기본 설치 (필수)

1.2.1 필요한 소프트웨어

왜 Claude Code CLI가 필수인가요? Claudian이 파일 읽기/쓰기, 폴더 생성, 검색, 터미널 실행 등 핵심 기능을 수행하려면 Claude Code CLI가 필요합니다. CLI 없이는 단순 채팅만 가능하고, GTD 자동 분류, 데일리 노트 생성 등 이 시스템의 핵심 기능이 동작하지 않습니다.

1.2.2 Step-by-step 설치

Step 1: Obsidian 설치

1. https://obsidian.md 접속
2. 운영체제에 맞는 설치파일 다운로드 (Windows / Mac / Linux)
3. 설치 후 실행
4. "Create new vault" 선택
   • 볼트 이름: 원하는 이름 (예: MyWorkspace, 업무관리 등)
   • 저장 위치: 원하는 곳

Tip: 볼트 = 하나의 폴더입니다. 이 폴더 안에 모든 노트와 설정이 들어갑니다.

Step 2: Node.js 설치

Node.js는 다음 단계에서 설치할 Claude Code CLI를 실행하기 위해 필요한 프로그램입니다. 직접 사용할 일은 없지만, Claude Code CLI가 내부적으로 Node.js 위에서 동작합니다.

Windows에서 설치

1. https://nodejs.org 접속

2. 화면 중앙의 초록색 "LTS" 버튼 클릭 → 설치파일(.msi) 다운로드

3. 다운로드된 파일 더블클릭 → 설치 마법사 진행
   - "Next" 계속 클릭
   - "I accept the terms" 체크 → Next
   - 설치 경로는 기본값 그대로 → Next
   - ⚠️ "Automatically install the necessary tools" 체크박스가 나오면 체크 → Next
   - "Install" 클릭 → 완료까지 대기 → "Finish"

4. 설치 확인 — 터미널(명령 프롬프트) 열기:
   - 키보드에서 Windows키 누르기 (또는 좌측 하단 시작 버튼 클릭)
   - "cmd" 입력 → "명령 프롬프트" 클릭

명령 프롬프트 창이 열리면 아래 명령어를 입력하고 Enter:

node -v

v18.x.x 이상 숫자가 나오면 성공입니다. (예: v22.14.0)

npm -v

9.x.x 이상 숫자가 나오면 성공입니다. (예: 10.9.2)

⚠️ "node은(는) 내부 또는 외부 명령... 이 아닙니다" 에러가 나오면: 명령 프롬프트를 닫고 PC를 재시작한 뒤 다시 시도하세요. 설치 직후에는 재시작이 필요할 수 있습니다.

Mac에서 설치

1. https://nodejs.org 접속

2. 화면 중앙의 초록색 "LTS" 버튼 클릭 → 설치파일(.pkg) 다운로드

3. 다운로드된 파일 더블클릭 → 설치 진행
   - "계속" 클릭 → 약관 동의 → "설치"
   - Mac 비밀번호 입력 → 완료까지 대기 → "닫기"

4. 설치 확인 — 터미널 열기:
   - Cmd(⌘) + Space 눌러서 Spotlight 열기
   - "터미널" 입력 → Enter (또는 "Terminal" 입력)

터미널 창이 열리면 아래 명령어를 입력하고 Enter:

node -v

v18.x.x 이상 숫자가 나오면 성공입니다. (예: v22.14.0)

npm -v

9.x.x 이상 숫자가 나오면 성공입니다. (예: 10.9.2)

---

Step 3: Claude Code CLI 설치

Claude Code CLI는 Claudian의 핵심 엔진입니다. Claudian이 파일을 읽고 쓰고, 폴더를 만들고, 검색하는 등의 기능이 모두 이 엔진을 통해 동작합니다.

💡 Step 2에서 열어둔 터미널(명령 프롬프트)을 그대로 사용합니다. 닫았다면 다시 열어주세요.

3-1. 설치 명령어 실행

터미널에 아래 명령어를 그대로 복사해서 붙여넣고 Enter:

npm install -g @anthropic-ai/claude-code

설치에 1~2분 정도 걸립니다. 화면에 텍스트가 쭉 나오다가 멈추면 완료입니다.

⚠️ Mac에서 "permission denied" 또는 "EACCES" 에러가 나오면: 명령어 앞에 sudo를 붙여서 다시 실행하세요. Mac 비밀번호를 물어봅니다.

sudo npm install -g @anthropic-ai/claude-code

3-2. 설치 확인

claude --version

버전 번호가 나오면 설치 성공입니다. (예: 1.0.12)

⚠️ Windows에서 "'claude'은(는) 내부 또는 외부 명령... 이 아닙니다" 에러가 나오면: 명령 프롬프트를 닫고 새 명령 프롬프트를 열어서 다시 시도하세요.

3-3. 최초 로그인 (인증)

Claude Code CLI를 처음 사용하려면 Anthropic 계정으로 로그인해야 합니다.

claude

위 명령어를 입력하면 자동으로 웹 브라우저가 열리며 로그인 화면이 나타납니다.

1. 브라우저에서 Anthropic 계정으로 로그인
   - 계정이 없으면 "Sign up"으로 가입 먼저

2. "Allow" 또는 "허용" 버튼 클릭 → 인증 완료

3. 터미널로 돌아오면 "Welcome to Claude Code!" 같은 메시지가 나타남

4. 터미널에서 /exit 입력하여 종료 (이후 Claudian에서 사용할 것이므로)

인증 방법 (택 1):

💡 무료(Free) 요금제는 Claude Code CLI를 사용할 수 없습니다. Pro 이상 구독이 필요합니다.

Step 4: Claudian 플러그인 설치 (BRAT 경유)

⚠️ Claudian은 현재 Obsidian 커뮤니티 플러그인 스토어에 등록되어 있지 않습니다. BRAT(Beta Reviewers Auto-update Tester) 플러그인을 먼저 설치한 뒤, BRAT를 통해 Claudian을 설치합니다.

Step 4-1: BRAT 플러그인 설치

1. Obsidian 열기 → 설정(⚙️) → 커뮤니티 플러그인
2. 제한 모드 해제 → 찾아보기
3. "BRAT" 검색 → 설치 → 활성화

Step 4-2: BRAT로 Claudian 설치

1. 설정(⚙️) → BRAT (좌측 메뉴)
2. "Add Beta Plugin" 클릭
3. GitHub 저장소 URL 입력: https://github.com/YishenTu/claudian
4. "Add Plugin" 클릭 → 설치 완료까지 대기
5. 설정 → 커뮤니티 플러그인 → Claudian 토글을 켜서 활성화

Step 4-3: Claudian 세팅값 입력

1. 설정(⚙️) → Claudian (좌측 메뉴)
2. API Provider 선택:
   • 개인 구독자 : Claude Pro/Max 는 구글 메일 인증(OAuth)
   • Anthropic API 별도 이용자 — (https://console.anthropic.com 에서 API Key 발급)
   • API Key 입력 (Anthropic API 선택 시): https://console.anthropic.com → API Keys → Create Key → 복사
   • Claudian 설정의 API Key 필드에 붙여넣기
3. Model 선택: 기본값(claude-sonnet-4-20250514) 권장, 필요에 따라 변경 가능
4. Claude CLI Path (필수):
   • Claudian 설정에서 Claude CLI Path에 Step 3에서 설치한 Claude Code CLI 경로를 입력
   • 터미널에서 경로 확인: which claude (Mac/Linux) 또는 where claude (Windows)
   • 예시: /usr/local/bin/claude (Mac), C:\Users\{사용자}\AppData\Roaming\npm\claude.cmd (Windows)
   • 이 설정으로 Claudian이 파일 조작, 터미널 실행 등 핵심 기능을 사용할 수 있습니다
5. 나머지 설정은 기본값 유지 (추후 필요 시 조정)

Tip: BRAT를 통해 설치하면 Claudian 업데이트도 자동으로 감지됩니다. BRAT 설정에서 "Auto-update plugins at startup"을 켜두면 편리합니다.

Step 5: 권장 추가 플러그인 (선택)

Step 6: 기본 설정

1. 설정 → 코어 플러그인 → 데일리 노트 활성화
   • 새 파일 위치: 00_데일리
   • 날짜 형식: YYYY-MM-DD
2. 설정 → 파일 및 링크
   • 새 노트 생성 위치: 01_인박스
   • 위키링크 사용: ON

---

---

1.3 환경 세팅 — Claudian 자동 생성

여기서부터는 Claudian이 자동으로 해줍니다. 아래 첨부된 프롬프트 문서 "Beronica 자동 세팅 프롬프트"를 Claudian 채팅창에 붙여넣으면, AI가 폴더 생성 → 파일 생성 → 개인 정보 질문 → CLAUDE.md 생성 → 검증까지 전부 자동으로 진행합니다.

진행 방법

Step 1: 아래 문서를 열기
        → 30_참고자료/AI-Driven 메뉴얼들/Beronica 자동 세팅 프롬프트.md

Step 2: "붙여넣기 시작 ▼" ~ "▲ 붙여넣기 끝" 사이의 내용을 전체 복사

Step 3: Claudian 채팅창에 붙여넣기 → 전송

Step 4: Claude의 질문에 답변하며 세팅 완료 (약 10~15분)

프롬프트 문서: https://beronica.vercel.app/get-started (자동설치프롬프트 참조)

자동으로 생성되는 것들

(필수) 자동 세팅 후 확인할 것

세팅이 끝나면 Claude가 체크리스트를 보여줍니다. 추가로 아래 테스트를 해보세요:

테스트 1: 프로필 인식 확인

"내가 누구인지 알아?" → AI가 이름, 역할, 목표를 말하면 성공

테스트 2: GTD 캡처 테스트

"다음 주까지 분기 보고서 작성해야 해" → AI가 01_인박스/에 노트를 생성하고, 분류를 제안하면 성공

테스트 3: 분류 이동 테스트

"프로젝트로 분류해줘" → 노트가 10_단발 프로젝트/로 이동하고 status가 active로 변경되면 성공

일상 사용 패턴

시스템 구조 참고 (이해용)

자동 세팅으로 만들어지는 전체 구조를 이해하고 싶다면 [[#부록 A — 전체 파일/폴더 체크리스트 (개인 볼트)]]를 참고하세요.

---

부록

---

부록 A — 전체 파일/폴더 체크리스트 (개인 볼트)

최종 볼트 구조 (Part 1 완료 상태):

볼트 루트/
│
├── CLAUDE.md                         ★ AI 지시 파일
│
├── _me/                          ★ AI 컨텍스트 (개인 메모리)
│   ├── 1_identity/                   — 나는 누구인가
│   │   ├── profile.md                  기본 정보, 성격, 강점/약점
│   │   ├── communication-pref.md       대화 스타일 선호
│   │   ├── work-style.md               업무 패턴, 습관
│   │   └── my-job.md                   소속, 직책, 담당 업무, 거래처
│   ├── 2_context/                    — 지금 무엇을 하고 있는가
│   │   ├── current-focus.md            현재 집중 업무, 진행 상황
│   │   ├── routine-system.md           루틴 체계 설정
│   │   └── tools-stack.md              사용 중인 도구/서비스
│   ├── 3_knowledge/                  — 축적된 판단 기준
│   │   ├── decisions-log.md            중요 결정 기록
│   │   ├── lessons-learned.md          교훈, 인사이트
│   │   └── preferences.md             도구/방식 선호도
│   └── 4_interaction/                — AI와의 소통 기록
│       ├── feedback-log.md             AI 피드백/개선 사항
│       └── useful-prompts.md           유용한 프롬프트 모음
│
├── 00_데일리/
├── 01_인박스/
├── 10_단발 프로젝트/
├── 20_지속 관리 업무/
│   ├── {영역1}/
│   ├── {영역2}/
│   └── {영역3}/
├── 30_참고자료/
│   ├── 업무매뉴얼/
│   ├── 서류양식/
│   ├── 템플릿/
│   └── (기타 필요한 하위 폴더)
├── 40_완료 프로젝트 및 업무/
├── 첨부파일/

---

FAQ

Q: 개발자가 아니어도 사용할 수 있나요? A: 네. 기본 시스템은 마크다운 텍스트 파일 기반이므로 코딩 지식이 없어도 됩니다. 폴더 만들고 텍스트 채우면 끝입니다. bkit(1.3)은 개발자 전용이므로 건너뛰세요.

Q: Claude Code CLI가 필수인 이유가 뭔가요? A: Claudian이 파일 읽기/쓰기, 폴더 생성, 검색, 터미널 실행 등의 기능을 수행하려면 Claude Code CLI가 필요합니다. CLI 없이는 단순 채팅만 가능하고, GTD 자동 분류, 데일리 노트 생성 등 이 시스템의 핵심 기능이 동작하지 않습니다.

Q: Claudian과 Claude Code는 뭐가 다른가요? A: Claude Code CLI는 AI 엔진(백엔드)이고, Claudian은 그 위에서 동작하는 Obsidian 인터페이스(프론트엔드)입니다. Claudian으로 Obsidian 안에서 업무 관리를 하고, 개발 작업이 필요하면 bkit을 추가로 설치하여 터미널에서 PDCA 기반 개발을 합니다.

Q: 모든 파일을 다 채워야 하나요? A: 아닙니다. profile.md, communication-pref.md, work-style.md + CLAUDE.md만 있으면 시스템은 동작합니다. 나머지는 점진적으로 채웁니다.

Q: _me/ 폴더 이름을 바꿔도 되나요? A: 바꿀 수 있지만, CLAUDE.md의 경로도 함께 수정해야 합니다. 표준을 유지하는 것을 강력히 권장합니다. 통일된 사용법 안내가 목적이니까요.

Q: 20_지속 관리 업무/ 하위 폴더는 어떻게 정하나요? A: 본인이 지속적으로 관리하는 업무 영역별로 만듭니다. 재무담당→재무회계/인사노무/총무, 마케터→콘텐츠/광고/SNS, 개발자→프론트엔드/백엔드/인프라 등.

Q: 팀원과 Obsidian 볼트를 공유할 수 있나요? A: Obsidian 볼트는 개인용입니다. _me/에 개인 정보가 있고, 동시 편집 시 파일 충돌이 발생합니다. 팀 공유 문서는 Google 공유 드라이브를 사용하세요 (관리자 세팅 문서 참조).

Q: bkit 없이 개발 작업도 Claudian으로 할 수 있나요? A: 간단한 코드 질문이나 스니펫은 Claudian으로 가능합니다. 하지만 프로젝트 전체 파일을 읽고 코드를 직접 작성/수정하는 작업은 Claude Code + bkit이 훨씬 효과적입니다.

---