Google Drive 스트리밍 환경에서 Cowork 및 Claude Code 연동 가이드

실용적 조언

Google Drive 폴더를 우클릭하여 '오프라인에서 사용 가능'으로 설정하여 로컬 미러링을 활성화한다.
.gdoc 대신 .md, .docx 등 표준 파일 형식을 사용하여 AI 도구의 호환성을 높인다.
Claude 채팅 커넥터와 로컬 파일 시스템 접근 도구의 차이점을 인지하고 워크플로에 맞는 도구를 선택한다.

섹션별 상세

Google Drive for Desktop의 스트리밍 모드와 AI 도구 간의 호환성 문제를 확인했다. macOS에서 파일을 스트리밍 방식으로 설정하면 Finder에는 파일이 보이지만 실제 데이터는 디스크에 존재하지 않는 플레이스홀더 상태가 된다. Cowork와 같은 AI 도구는 파일을 분석하기 위해 로컬 디스크의 실제 바이트 데이터를 필요로 하므로 이 상태에서는 파일을 읽지 못한다. 따라서 클라우드 전용 설정은 로컬 파일 접근이 필요한 AI 워크플로에서 작동하지 않는다.

특정 폴더를 오프라인으로 전환하여 AI 도구의 접근성을 확보하는 해결책을 제시했다. 전체 저장 공간을 절약하기 위해 기본은 스트리밍으로 유지하되, AI가 접근해야 하는 특정 폴더만 Finder에서 '오프라인에서 사용 가능'으로 설정하여 로컬에 미러링한다. 이렇게 하면 해당 폴더의 데이터가 물리적으로 디스크에 저장되어 AI 도구가 정상적으로 파일을 인식하고 처리할 수 있다. 이 방식은 저장 공간 효율성과 AI 도구의 성능 요구 사항을 동시에 충족한다.

파일 형식에 따른 AI 도구의 인식 차이를 분석했다. .gdoc이나 .gsheet와 같은 Google 네이티브 형식은 실제 문서가 아니라 브라우저로 연결되는 바로가기 파일에 불과하여 로컬 파일 시스템 도구가 내용을 읽을 수 없다. 대신 .md, .docx, .txt, .xlsx와 같은 표준 파일 형식을 사용해야 AI 에이전트가 파일 내부의 텍스트와 데이터를 파악한다. Claude 채팅의 기본 커넥터는 클라우드 API를 통해 네이티브 문서를 읽지만, 로컬 도구는 반드시 표준 형식을 갖춰야 한다.

용어 해설

스트리밍 모드(Streaming Mode): — 클라우드 저장소의 파일을 로컬에 다운로드하지 않고 필요할 때만 네트워크를 통해 불러오는 방식이다. 디스크 공간을 절약할 수 있지만 인터넷 연결이 필수적이며 로컬 파일 접근 도구와 충돌할 수 있다.
플레이스홀더(Placeholder): — 파일의 이름, 크기 등 메타데이터만 로컬에 표시하고 실제 내용은 클라우드에 있는 가상 파일이다. 사용자가 파일을 열기 전까지는 디스크에 실제 데이터 바이트가 존재하지 않아 AI 도구가 내용을 읽지 못할 수 있다.
미러링(Mirroring): — 클라우드의 데이터를 로컬 저장소에 1:1로 복제하여 항상 동일한 상태를 유지하는 방식이다. 오프라인에서도 파일 접근이 가능하며 로컬 파일 시스템을 사용하는 AI 도구에 적합하다.
파일 시스템 접근(File System Access): — 애플리케이션이 운영체제의 파일 저장소에 직접 접근하여 데이터를 읽거나 쓰는 기능이다. 보안과 성능을 위해 로컬에 실제 데이터가 존재해야 원활하게 작동한다.

언급된 도구

Google Drive for Desktop중립

클라우드 저장소 서비스 및 파일 시스템 통합

Cowork추천

파일 시스템 접근 기반 AI 도구

Claude Code중립

CLI 기반 코딩 에이전트