Content is user-generated and unverified.

Obsidian + Gemini CLI로 AI 글쓰기 환경 만들기

🎯 목표

Obsidian에서 AI의 도움을 받아 글을 쓰고, 자료를 정리하고, 연구할 수 있는 환경을 만들어보겠습니다.

🔧 사전 준비사항

필요한 것들

  • macOS 컴퓨터 (Windows/Linux도 비슷하게 가능)
  • Obsidian 앱 (무료 다운로드 가능)
  • Google 계정 (Gemini 사용을 위해)
  • 기본적인 터미널 사용법 (복사&붙여넣기 정도)

왜 이 조합을 사용하나요?

  • Obsidian: 마크다운 파일들을 연결해서 관리하는 최고의 노트 앱
  • Gemini CLI: 구글의 AI를 터미널에서 바로 사용할 수 있는 도구
  • 조합의 장점: AI가 직접 파일을 읽고 수정할 수 있어서 강력함

1단계: Gemini CLI 설치하기

1-1. Node.js 설치

Gemini CLI는 Node.js가 필요합니다.

  1. Homebrew 설치 (없다면)
bash
   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  1. Node.js 설치
bash
   brew install node
  1. 설치 확인
bash
   node --version
   npm --version

버전 정보가 나오면 성공!

1-2. Gemini CLI 설치

  1. NPM으로 설치
bash
   npm install -g @google/generative-ai-cli
  1. 설치 확인
bash
   gemini --version

1-3. Gemini API 키 설정

  1. Google AI Studio 접속
  2. API 키 생성
    • "Create API Key" 버튼 클릭
    • 생성된 키를 복사 (안전한 곳에 보관!)
  3. API 키 설정
bash
   gemini config set api-key YOUR_API_KEY_HERE

YOUR_API_KEY_HERE 부분에 복사한 API 키를 붙여넣기

  1. 설정 확인
bash
   gemini models list

모델 목록이 나오면 성공!

2단계: Obsidian Terminal 플러그인 설치

2-1. Obsidian에서 플러그인 찾기

  1. Obsidian 실행
  2. 설정 열기
    • 좌측 하단의 ⚙️ 아이콘 클릭
    • 또는 Cmd + , (맥) / Ctrl + , (윈도우)
  3. 커뮤니티 플러그인 활성화
    • 좌측 메뉴에서 "Community plugins" 클릭
    • "Turn on community plugins" 버튼 클릭 (처음이라면)
  4. 플러그인 찾기
    • "Browse" 버튼 클릭
    • 검색창에 "Terminal" 입력

2-2. Terminal 플러그인 설치

  1. 올바른 플러그인 찾기
    • 작성자가 "polyipseity"인 "Terminal" 플러그인 선택
    • 다운로드 수가 많은 것을 선택하세요
  2. 설치하기
    • "Install" 버튼 클릭
    • 설치가 완료되면 "Enable" 버튼이 나타남
  3. 활성화하기
    • "Enable" 버튼 클릭
    • ⚠️ 중요: 설치만으로는 작동하지 않습니다!

3단계: Terminal 플러그인 설정하기

3-1. 기본 설정

  1. 옵션 페이지 열기
    • 플러그인 목록에서 Terminal의 "Options" 버튼 클릭
  2. 프로필 설정
    • 좌측 메뉴에서 "Profiles" 클릭
    • 여러 프로필이 보일 텐데, 우리는 darwinIntegratedDefault만 사용
  3. 불필요한 프로필 삭제 (선택사항)
    • 다른 프로필들의 휴지통 🗑️ 아이콘 클릭해서 삭제
    • darwinIntegratedDefault만 남겨두기

3-2. 터미널 실행 테스트

  1. 터미널 패널 열기
    • Obsidian 메인 화면에서 좌측 사이드바에 있는 터미널 아이콘 📟 클릭
  2. 프로필 선택
    • 드롭다운에서 "darwinIntegratedDefault" 선택
  3. 터미널 작동 확인
    • 검은 터미널 창이 나타나면 성공!
    • pwd 명령어를 입력해서 현재 폴더 위치 확인

4단계: 환경변수 설정 (에러가 날 때만)

터미널에서 gemini 명령어가 작동하지 않는다면 이 단계를 따라하세요.

4-1. Node 경로 확인

  1. 기본 터미널 열기
    • Spotlight 검색 (Cmd + Space)에서 "Terminal" 입력
  2. Node 위치 찾기
bash
   which node
  • 결과 예시: /opt/homebrew/bin/node
  • 이 경로에서 /node 부분을 제외한 폴더 경로를 기억하세요
  • 예: /opt/homebrew/bin

4-2. 환경변수 설정

  1. zshrc 파일 편집
bash
   nano ~/.zshrc

VS Code가 있다면: code ~/.zshrc

  1. 경로 추가
    • 파일 맨 위에 다음 줄 추가:
bash
   export PATH="/opt/homebrew/bin:$PATH"

/opt/homebrew/bin 부분을 앞서 확인한 경로로 바꾸세요

  1. 파일 저장
    • nano 사용시: Ctrl + X, Y, Enter
    • VS Code 사용시: Cmd + S
  2. Obsidian 재시작
    • Obsidian을 완전히 종료하고 다시 실행

5단계: 실제 사용해보기

5-1. 기본 사용법

  1. Obsidian에서 터미널 열기
    • 터미널 아이콘 📟 클릭
    • darwinIntegratedDefault 선택
  2. Gemini 실행
bash
   gemini
  • 프롬프트가 나타나면 성공!
  1. 간단한 질문 테스트
   안녕하세요. 테스트입니다.

5-2. 파일과 함께 작업하기

  1. 새 노트 만들기
markdown
   # AI 안경 리스트
   
   - Apple Vision Pro
   - Meta Ray-Ban
   - Magic Leap 2
   
   각 제품에 대해 자세히 조사해주세요.
  1. 파일 경로 확인
    • Obsidian에서 파일을 우클릭 → "Copy path"
  2. AI에게 파일 수정 요청
bash
   gemini "이 파일을 읽고 각 AI 안경 제품에 대한 상세한 정보를 추가해주세요: /path/to/your/file.md"

5-3. 고급 활용 예시

파일 제목 자동 생성:

bash
gemini "이 파일의 내용을 바탕으로 적절한 제목을 제안해주세요: /path/to/file.md"

자료 정리:

bash
gemini "이 폴더의 모든 마크다운 파일을 읽고 주제별로 분류해주세요: /path/to/folder/"

연구 보고서 작성:

bash
gemini "이 자료들을 바탕으로 종합적인 연구 보고서를 작성해주세요: file1.md file2.md file3.md"

🔧 문제 해결

자주 발생하는 문제들

1. gemini: command not found

  • Node.js가 제대로 설치되었는지 확인
  • 환경변수 설정 다시 확인
  • Obsidian 재시작

2. API 키 오류

  • Google AI Studio에서 키가 유효한지 확인
  • 키 설정 명령어 다시 실행
  • 키에 특수문자가 있다면 따옴표로 감싸기

3. 터미널이 열리지 않음

  • Terminal 플러그인이 활성화되어 있는지 확인
  • Obsidian 재시작
  • 다른 보안 소프트웨어가 방해하는지 확인

4. 한글이 깨짐

  • 터미널 인코딩을 UTF-8로 설정
  • Obsidian의 언어 설정 확인

💡 활용 팁

효과적인 사용법

  1. 구체적인 지시사항 제공
    • "파일을 수정해줘" ❌
    • "이 파일의 각 항목에 가격 정보와 출시일을 추가해줘" ✅
  2. 파일 경로 정확히 지정
    • Obsidian에서 복사한 정확한 경로 사용
    • 파일명에 공백이 있으면 따옴표로 감싸기
  3. 단계별 작업
    • 한 번에 모든 것을 요청하지 말고 단계별로 진행
    • 결과를 확인하고 다음 단계로

추천 워크플로우

  1. 아이디어 정리 → Obsidian에서 간단한 메모 작성
  2. 자료 조사 → AI에게 세부 정보 추가 요청
  3. 구조화 → AI에게 내용 정리 및 구조화 요청
  4. 최종 다듬기 → AI와 함께 문체와 완성도 개선

🎉 마무리

이제 Obsidian에서 AI의 도움을 받아 효율적으로 글을 쓰고 자료를 정리할 수 있습니다!

다음 단계로는:

  • 다른 AI 도구들과의 연동 시도
  • 자신만의 커스텀 명령어 만들기
  • 팀 협업을 위한 워크플로우 구축

참고: Claude Code를 사용하면 비슷한 기능을 더 쉽게 구현할 수도 있습니다.

즐거운 Obsidian + AI 라이프 되세요! 🚀

Content is user-generated and unverified.
    Obsidian + Gemini CLI 연동 가이드 | Claude