옵시디언 구글 드라이브 동기화 및 Claude Code, AGY CLI 연동 가이드 (WSL)

Obsidian × Google Drive × Claude Code 완전 연동 가이드 (WSL 환경)

이 글에서 다루는 것
개인 지식 관리 도구 Obsidian을 Google Drive로 동기화하고, WSL(Windows Subsystem for Linux)에서 Claude Code를 붙여 AI 협업 환경을 구축하는 전 과정을 단계별로 정리한다.

 

---

왜 이 조합인가?

도구	역할
Obsidian	제2의 뇌 — 마크다운 기반 지식 관리
Google Drive	멀티 디바이스 동기화 + 오프라인 지원
WSL	윈도우에서 리눅스 개발 환경 사용
Claude Code	볼트 안에서 AI와 직접 협업

이 네 가지를 연결하면 비행기 안에서도, 스마트폰에서도, AI와 함께 지식을 관리할 수 있는 환경이 완성된다.

---

1단계: Google Drive 설정 — 오프라인 액세스 활성화

Obsidian을 "제2의 뇌"로 쓰려면 네트워크가 없는 환경에서도 동작해야 한다. Google Drive의 파일 스트림 모드는 선택한 폴더만 오프라인으로 사용할 수 있는 기능을 제공한다.

설치 및 설정 순서

1. Google Drive 공식 사이트에서 데스크톱 앱을 내려받아 설치한다.
2. 설치 중 별도 설정 없이 기본값으로 진행한다 (파일 스트림이 기본 모드로 설정된다).
3. 설치 완료 후 윈도우 탐색기에서 G: 드라이브에 Google Drive가 연결된 것을 확인한다.
4. G:\ → 내 드라이브를 더블클릭한다.
5. Obsidian 볼트로 쓸 폴더를 생성한다 (예: obsidian).
6. 해당 폴더에서 마우스 우클릭 → 추가 옵션 표시 → 오프라인 액세스 → 오프라인으로 사용을 선택한다.
7. 시스템 트레이의 Google Drive 아이콘에서 동기화 상태를 확인한다.

팁: 동기화가 완료되면 폴더 아이콘에 초록색 체크 표시가 나타난다.

---

2단계: WSL에서 Google Drive(G:) 마운트하기

WSL은 윈도우 환경에서 리눅스 터미널을 사용할 수 있게 해주는 도구이다. 리눅스 터미널이 익숙하지 않다면 PowerShell로도 동일한 작업을 할 수 있지만, Claude Code 등 리눅스 기반 CLI 도구를 쓰려면 WSL이 편리하다.

마운트 포인트 생성

sudo mkdir /mnt/g

WSL 자동 마운트 설정

/etc/wsl.conf 파일을 열어 아래 내용을 추가한다:

sudo vi /etc/wsl.conf

[automount]
enabled = true
mountFsTab = true

mountFsTab = true로 설정하면 WSL이 시작될 때 /etc/fstab 파일을 참조하여 드라이브를 자동으로 마운트한다.

fstab에 Google Drive 등록

sudo vi /etc/fstab

아래 한 줄을 추가한다:

G: /mnt/g drvfs defaults 0 0

윈도우의 G:\ 드라이브를 WSL 내 /mnt/g에 마운트하겠다는 선언이다.

WSL 재시작 및 확인

PowerShell에서:

wsl --shutdown

WSL을 다시 실행한 뒤 아래 명령어로 마운트를 확인한다:

ls /mnt/g/
# 출력 예시:
# '$RECYCLE.BIN'  '내 드라이브'  '다른 컴퓨터'

Google Drive 내 파일에 접근할 수 있으면 성공이다.

---

3단계: Claude Code 연결

WSL에서 Claude Code 공식 문서를 참고하여 Linux 설치 방법으로 Claude Code를 설치한 뒤, Obsidian 볼트 디렉토리에서 실행하면 된다.

cd '/mnt/g/내 드라이브/obsidian'
claude

이제 Obsidian 볼트 안에서 Claude Code와 직접 대화하며 노트를 작성·수정할 수 있다.

---

4단계: Antigravity CLI 연결

WSL에서 Antigravity CLI(agy)를 설치한 뒤, 마찬가지로 Obsidian 볼트 디렉토리에서 실행하여 AI 협업 세션을 시작할 수 있다. agy는 다양한 슬래시 명령어와 스킬 연동을 제공하여 문서 작성을 자동화하고 검증하는 데 매우 유용하다.

cd '/mnt/g/내 드라이브/obsidian'
agy

---

마무리

이 환경을 구성하고 나면:

• 오프라인 비행기 안에서도 Obsidian 노트를 편집할 수 있고
• 스마트폰에서도 Google Drive를 통해 동기화되며
• WSL 터미널에서 Claude Code 및 AGY CLI로 강력한 AI 협업이 가능하다.

데이터 구조화 팁 하나를 덧붙이자면, 노트는 아래에서 위로 쌓아가는 방식(원자적 노트 → 구조화 문서)이 AI 환각 현상을 줄이는 데 도움이 된다. 위에서 아래 방향으로 구조화하면 틀린 정보를 찾기가 매우 어려워진다.