Claude Code와 옵시디언으로 구축하는 리서치 자동화 환경

터미널 권한 오류 없이 Claude Code 설치하기

터미널은 익숙해지기 전까지는 불친절한 도구입니다. Claude Code를 설치하다 보면 EACCES 같은 권한 오류를 마주하기 십상인데, 이건 보통 노드 모듈이 관리자 영역에 발을 걸치려다 차단당해서 생기는 일입니다. 앤스로픽은 이런 골치 아픈 상황을 피하려고 사용자 홈 디렉토리 내에 독립적인 공간을 만드는 방식을 권장합니다.

단순히 설치만 한다고 끝이 아닙니다. NVM 같은 노드 버전 관리자를 쓰고 있다면 버전이 바뀔 때마다 경로가 꼬여 실행이 안 되는 짜증스러운 상황이 벌어집니다. 아래 세 줄을 순서대로 복사해서 붙여넣으세요. 이 과정만 거쳐도 설정하느라 날리는 시간을 매일 2시간은 아낄 수 있습니다.

1. nvm install --lts && nvm use --lts 명령어로 가장 안정적인 노드 환경을 먼저 잡으세요.
2. npm config set prefix '~/.npm-global' 명령어를 쳐서 설치 경로를 사용자 폴더로 돌려버리세요. 이제 권한 때문에 막힐 일은 없습니다.
3. npm install -g @anthropic-ai/claude-code && claude doctor를 실행해 설치와 네트워크 상태를 최종 점검합니다.

---

NotebookLM 데이터를 옵시디언 규격으로 자동 교정하기

구글 NotebookLM에서 뽑아낸 마크다운 파일은 그대로 쓰기엔 좀 엉성합니다. 메타데이터가 빠진 데이터는 시간이 지나면 검색도 안 되고 어디서 온 건지도 모르는 쓰레기가 됩니다. 저는 이 데이터를 옵시디언이 읽기 편한 YAML 구조로 바로 바꿔버립니다. 파일 상단에 type, source-url, tags, created-date, status 다섯 가지는 반드시 박아둬야 나중에 찾을 때 고생 안 합니다.

Claude Code에게 노가다를 시키면 수천 개의 파일도 금방 정돈됩니다.

1. Claude Code 세션을 열고 해당 폴더로 들어갑니다.
2. "상단에 YAML 프로퍼티를 추가하고 본문에서 키워드 3개를 뽑아 태그 리스트에 넣어줘"라고 명령하세요.
3. 이어서 "출처 URL은 별도 필드로 옮기고 위키링크 형식은 그대로 살려줘"라고 붙이면 끝입니다.

이렇게 정리해두면 5초 안에 필요한 정보를 찾아낼 수 있는 지식 베이스가 완성됩니다.

---

API 비용을 80% 줄이는 Claude Code 스킬 설정

Claude Code는 유능하지만 시키는 대로 다 읽어대면 지갑이 금방 털립니다. 제약 조건 없이 명령을 내리면 관련도 없는 파일까지 훑으면서 토큰을 낭비하거든요. 앤스로픽의 가이드에 따르면 SKILL.md 파일에 에이전트의 행동 반경을 명확히 써주는 것만으로도 비용 지출을 80%까지 막을 수 있습니다.

월 비용을 5만 원 선에서 방어하면서 리서치 효율을 뽑아내는 설정법입니다.

• 파일 범위 제한: SKILL.md 파일 안에 리서치용 폴더(예: 01_Research)만 보라고 딱 잘라 말하세요.
• 추론 토큰 억제: MAX_THINKING_TOKENS=8000 이하로 걸어두세요. 단순 요약 작업에 고사양 모델이 너무 깊게 생각할 필요는 없습니다.
• 도구 권한 통제: allowed-tools에서 웹 검색은 꺼두고 파일 읽고 쓰기만 허용하는 게 안전합니다.

---

매주 일요일 수행하는 데이터 정제 루틴

자동화로 정보를 긁어모으기만 하면 그건 그냥 쓰레기 더미입니다. 이걸 돈이 되는 콘텐츠로 바꾸려면 정기적인 관리가 필요합니다. 저는 매주 일요일마다 Claude Code를 돌려 MOC(Map of Content)를 만듭니다. 지식 조각들을 서로 연결해 지도를 그리는 작업입니다.

1. 지난 7일 동안 새로 생긴 마크다운 파일을 전부 찾아 주제별로 묶어달라고 하세요.
2. 각 주제별 인덱스 파일에 새 노트들의 링크를 중요도에 따라 자동 삽입합니다.
3. 기존 노트들과의 연결 고리를 찾아 위키링크를 추가하면 파편화된 메모들이 강의 커리큘럼이나 아티클 초안으로 진화합니다.

---

실시간 사용량 확인으로 비용 폭탄 막기

클로드 코드는 큰 파일을 읽을 때 토큰을 엄청나게 먹습니다. 정신 놓고 있다가는 결제 문자에 놀랄 수 있죠. 앤스로픽 콘솔에서 한 달 한도를 40달러 정도로 묶어두는 게 가장 확실한 방어선입니다. 그게 불안하다면 더 촘촘하게 관리해야 합니다.

• 수시로 확인: 작업 중에 /cost 명령어를 쳐보세요. 지금 이 대화에 얼마가 들었는지 바로 나옵니다.
• 맥락 정리: 비용이 좀 나온다 싶으면 /clear로 이전 대화 내용을 날리거나 /compact로 대화 기록을 압축해서 토큰 소모를 줄이세요.
• 모델 분리: 대단한 추론이 필요 없는 일은 /model 명령으로 저렴한 모델로 바꿔서 시키는 게 영리한 방법입니다.

모니터링 지표	측정 목적	대응 조치
실시간 토큰 사용량	비용 급증 확인	이상 발생 시 작업 중단
모델별 비용 비중	운영 효율 최적화	단순 작업은 저비용 모델로 전환
프롬프트 캐싱 효율	중복 비용 절감	캐싱 가능한 구조로 프롬프트 설계