준비
강의 전 현재 폴더, 계정, 설치 상태를 확인합니다.
Phase 1313-3
제2의 두뇌: 옵시디언 볼트 + Claude Code CLI 지식관리
옵시디언(Obsidian) 마크다운 볼트를 노무사의 '제2의 두뇌'로 구축하고, Claude Code CLI가 볼트를 직접 읽고·쓰는 지식관리 워크플로우를 배웁니다. 판례·취업규칙·자문 노하우를 AI가 검색·활용할 수 있는 지식 자산으로 만듭니다.
Execution Kit
실습 중 막히지 않기 위한 진행표
실행
옵시디언 볼트는 마크다운 파일의 집합이므로 Claude Code가 직접 읽고 쓸 수 있습니다. 추가 설정 없이 볼트 폴더에서 claude 명령만 실행하면 됩니다.
검증
명령 결과, 파일 변화, 브라우저 화면 중 하나로 성공 여부를 확인합니다.
기록
잘 된 명령과 막힌 지점을 다음 실습을 위한 로그로 남깁니다.
막혔을 때 Claude Code에 붙여넣을 양식
나는 코딩 경험이 많지 않은 실무자입니다. "제2의 두뇌: 옵시디언 볼트 + Claude Code CLI 지식관리" 강의를 따라 하고 있습니다.
현재 상태:
- 사용하는 컴퓨터:
- 방금 실행한 명령:
- 화면에 나온 결과 또는 오류:
- 내가 만들고 싶은 업무 결과물:
요청:
1. 지금 상황을 초보자 기준으로 진단해줘.
2. 다음에 실행할 명령을 한 줄씩 제시해줘.
3. 각 명령이 무엇을 하는지 쉬운 말로 설명해줘.
4. 성공 여부를 확인할 체크 포인트를 정리해줘.
5. 실패하면 다시 붙여넣을 오류 보고 양식을 만들어줘.왜 옵시디언 + Claude Code인가
[기존 방식] 노무사의 지식은 개인 머릿속이나 분산된 워드 파일에 있었습니다. 3년 전 비슷한 사건의 처리 방식, 특정 병원 업종의 교대근무 판례, 건설현장 안전 자문 노하우가 필요할 때 어디에 있는지도 불분명했습니다. 후임 노무사에게 지식을 전달하는 것도 어려웠습니다.
[옵시디언 + Claude Code 이후] 옵시디언은 모든 노트를 마크다운(.md) 파일로 저장합니다. 마크다운 파일은 Claude Code가 직접 읽을 수 있는 형식입니다. 따라서 옵시디언 볼트 폴더를 그대로 Claude Code의 작업 디렉터리로 사용하면, AI가 노무사의 모든 지식 자산에 직접 접근할 수 있습니다.
핵심 원리: 옵시디언 볼트는 그냥 마크다운 파일이 모인 폴더입니다. Claude Code는 파일을 읽고 쓸 수 있습니다. 따라서 볼트 안의 모든 노트가 Claude의 참고 자료가 됩니다. 복잡한 세팅이 필요 없습니다.
TIP: 현재 박실로 노무사님처럼 이미 옵시디언을 활용 중이라면 추가 설치 없이 바로 적용 가능합니다. Claude Code를 볼트 폴더에서 실행하면 됩니다.
노무사 지식 볼트 구조 설계
효과적인 노무사 지식 볼트는 "Claude Code가 잘 읽을 수 있는 구조"를 먼저 고려해야 합니다. 사람이 편한 구조와 AI가 잘 검색하는 구조는 다를 수 있습니다.
권장 폴더 구조:
/판례·행정해석/
업종별/ (병원·건설·제조·서비스)
주제별/ (해고·임금·산재·괴롭힘·안전)
연도별/ (2024·2025·2026)
/취업규칙·규정/
업종 표준/ (병원형·건설형·일반 제조)
자문 사업장/ (A병원·B건설사 등 가명)
개정 이력/
/사건 처리 노하우/
전략 패턴/ (해고유지·복직·합의)
증거 수집/ (유형별)
쟁점 정리/ (통상임금·평균임금·근로자성)
/CLAUDE.md (볼트 루트)
Claude Code가 볼트를 열 때마다 적용되는 지침.
"이 볼트는 한동노무법인 지식 자산. 사건번호는 반드시 검증."
이 구조에서 "3년 전 교대근무 관련 병원 사건 자료 찾아줘"라고 하면 Claude Code가 볼트 전체를 검색해서 관련 노트를 모아 보여줍니다.
# 옵시디언 볼트에서 Claude Code 실행
# 1. 볼트 루트에서 Claude Code 시작
cd /Users/노무사/Documents/노무법인볼트
claude
# 2. CLAUDE.md (볼트 루트에 위치)
# --- 내용 예시 ---
# 이 볼트는 한동노무법인 지식 자산입니다.
# 폴더 구조: 판례·취업규칙·사건노하우·스킬
# 규칙: 사건번호 검색 시 korean-law MCP 우선 확인
# 가명 처리: 의뢰인 실명 → A씨, B사 형식
# 3. 볼트 내 검색·활용 예시
> "병원 교대근무 관련 판례와 자문 노하우 노트를 찾아서
> 오늘 새로 접수된 요양병원 간호사 연장근무 사건에 적용해줘"
# 4. 볼트에 새 노트 자동 생성
> "오늘 처리한 A정형외과 부당해고 사건 노하우를
> /사건처리노하우/해고/의료기관_2026.md 파일로 저장해줘"Claude Code가 볼트를 읽고 쓰는 방법
옵시디언 볼트에서 Claude Code를 실행하면 두 가지 방식으로 볼트와 상호작용합니다.
[읽기: 지식 검색]
볼트 안의 마크다운 파일을 직접 읽어서 현재 작업에 맥락을 제공합니다. 예를 들어 "통상임금 관련 판례 정리된 거 있어?"라고 하면 /판례·행정해석/주제별/임금 폴더를 탐색해서 관련 노트를 요약해줍니다.
[쓰기: 지식 축적]
작업 결과를 자동으로 볼트에 노트로 저장합니다. 새로운 판례를 분석하면 자동으로 분류해서 저장하고, 자문 사건의 처리 노하우를 구조화된 노트로 만들어 저장합니다.
[MCP 연동: 더 강력한 통합]
obsidian-claude-code-mcp 플러그인을 설치하면, Claude Code가 볼트의 링크 구조(백링크, 태그)까지 활용할 수 있습니다. 단순 파일 검색을 넘어 지식 그래프 탐색이 가능합니다.
개발자 @Atenov_D의 말처럼: "수동 옵시디언은 일주일이면 방치됩니다. AI 에이전트가 루틴을 맡을 때만 볼트가 진짜 제2의 두뇌가 됩니다."
# MCP로 옵시디언 볼트 연결 (고급)
# ~/.claude/settings.json 또는 CLAUDE.md에 추가
{
"mcpServers": {
"obsidian": {
"command": "npx",
"args": ["-y", "obsidian-claude-code-mcp"],
"env": {
"VAULT_PATH": "/Users/노무사/Documents/노무법인볼트"
}
}
}
}
# 연결 후 활용 예시:
claude
> "볼트에서 '직장내 괴롭힘'과 연결된 모든 노트를 찾아서
> 현재 접수 중인 B병원 사건에 적용 가능한 전략을 정리해줘"
> "오늘 처리한 C건설 산재 사건 분석을 볼트에 저장하되,
> 기존 '건설현장 산재' 노트와 자동으로 연결해줘"TIP: 볼트 루트의 CLAUDE.md는 옵시디언에서도 보이는 일반 마크다운 파일입니다. 'AI 지침'과 '참고 노트' 두 가지 역할을 동시에 합니다. 처음에는 간단한 지침만 적어두고, 사용하면서 보완하세요.
노무사 지식 자산화: 실전 워크플로우
19년 경력의 노무사가 가진 지식을 어떻게 볼트에 쌓고 Claude Code가 활용하게 만들지, 구체적인 워크플로우를 보겠습니다.
[판례 수집 자동화]
새로운 판례를 발견하면 Claude Code에 붙여넣습니다. "이 판례를 볼트에 저장해줘. 업종(병원), 주제(교대근무), 핵심 법리(근로시간 특례 적용 여부)로 분류해줘." → 자동으로 적절한 폴더에 구조화된 노트로 저장.
[사건 처리 후 노하우 기록]
사건이 마무리되면 "이번 A병원 사건에서 배운 점을 볼트에 노하우 노트로 저장해줘. 사실관계는 가명 처리해서." → 다음 유사 사건 때 참고 자료로 활용.
[자문 사업장 지식 관리]
자문 계약 사업장별 폴더에 취업규칙 변경 이력, 자문 이력, 특수 사항을 누적합니다. 새로운 이슈가 발생하면 "B종합병원 폴더에서 과거 자문 내용 불러와서 이번 이슈에 적용해줘."
[주간 지식 정리]
매주 금요일: "이번 주 새로 쌓인 노트를 정리하고, 기존 노트와 연결 관계를 점검해줘." → 볼트가 살아있는 지식 자산으로 유지됩니다.
TIP: 처음에는 기존 파일(취업규칙 샘플, 자주 쓰는 판례 목록)을 볼트로 옮기는 것부터 시작하세요. 처음부터 완벽한 구조를 만들려 하지 말고, 쓰면서 정리하는 방식이 더 오래 유지됩니다.
핵심 정리
- ✓옵시디언 볼트는 마크다운 파일의 집합이므로 Claude Code가 직접 읽고 쓸 수 있습니다. 추가 설정 없이 볼트 폴더에서 claude 명령만 실행하면 됩니다.
- ✓판례·취업규칙·사건 노하우를 볼트에 누적하면 AI가 과거 지식을 현재 사건에 자동으로 적용합니다.
- ✓MCP 연동(obsidian-claude-code-mcp)으로 볼트의 링크 구조까지 활용하면 지식 그래프 탐색이 가능합니다.
- ✓AI 에이전트가 볼트 루틴(분류·저장·연결)을 맡을 때만 볼트가 진짜 '제2의 두뇌'로 기능합니다.