gws 세팅 — 클로드가 내 구글을 직접 다루게

💡 이 페이지로 할 수 있는 일

• 클로드(코드)가 내 지메일·드라이브·캘린더·시트를 명령으로 직접 다루게 연결
• 한 번 해두면 F4(메일 첨부 발송)·F7(캘린더 일괄 등록) 가이드를 바로 따라할 수 있음
• 터미널을 직접 안 열어도, 클로드 데스크탑 'Code 탭'에 시키면 됨

📌 왜 gws인가: 클로드 앱의 '커넥터'로도 메일 본문은 보내져요. 하지만 폴더에서 파일을 찾아 첨부하거나, 메일 여러 통의 약속을 한 번에 캘린더에 등록하거나, 시트에 기록하는 건 커넥터로는 안 됩니다. 그걸 가능하게 하는 게 gws(구글 워크스페이스 CLI)예요.

이 페이지는 F4·F7 가이드의 공용 세팅편이에요. 여기서 한 번 연결해두고, 각 가이드로 돌아가세요.

---

STEP 0. 클로드 '코드'부터 켜기 (공통)

이 가이드들은 터미널을 직접 열지 않아요. 클로드 데스크탑 앱의 'Code 탭'에서 클로드한테 시키면, 클로드가 설치·명령을 대신 실행하고 실행 전에 나한테 승인을 받습니다.

클로드 데스크탑 — 상단 탭

ChatCoworkCode ✓

실행 위치Local (내 컴퓨터)

폴더Select folder → 작업할 폴더 선택

나내 컴퓨터에 gws 설치하고 구글 연결해줘

클로드설치 명령을 실행할게요. 괜찮을까요? 실행 승인 거절

⚠️ 전제: 'Code 탭'은 유료 플랜(Pro·Max 등)이 필요해요. 처음이라면 먼저 → 왕초보 시작하기로 감 잡고 오셔도 좋아요.

---

STEP 1. gws 설치 (한 줄, 클로드가 대신)

Code 탭 입력칸에 그냥 이렇게 적으세요. 클로드가 명령을 제안하면 '실행 승인'만 누르면 됩니다.

gws(구글 워크스페이스 CLI)를 brew로 설치해줘.

클로드가 실제로 돌리는 명령은 이거예요(내가 외울 필요는 없어요).

클로드 코드가 실행 — 터미널

$ brew install googleworkspace-cli

... 설치 완료. 이제 gws 명령을 쓸 수 있어요.

💡 gws가 뭐예요? 구글이 공개한 오픈소스 명령 도구예요(공식 지원 제품은 아닙니다). 지메일·드라이브·캘린더·시트·문서를 명령 한 줄로 다룰 수 있게 해줘요.

---

STEP 2. 구글 계정 연결 — 쉬운 길 먼저

대부분은 이 한 줄로 끝나요. Code 탭에 이렇게 시키세요.

gws 인증해줘. gws auth setup --login 으로.

이 명령은 구글 클라우드 프로젝트 생성·필요한 권한 설정·로그인까지 자동으로 해줍니다. 중간에 브라우저가 열리면 내 구글 계정으로 로그인 → '허용'만 누르면 돼요.

클로드 코드가 실행 — 자동 인증

$ gws auth setup --login

구글 클라우드 프로젝트 준비 중... 브라우저에서 동의해주세요.

⚠️ gws auth setup은 'gcloud'라는 구글 클라우드 도구가 필요해요. 없으면 클로드가 같이 깔아주지만, 그래도 막히면 아래 **STEP 3(수동)**으로 가세요.

---

STEP 3. 막혔다면 — 수동 연결 (진짜 관문)

자동이 안 되면 여기서부터가 핵심이에요. 구글 클라우드 콘솔(console.cloud.google.com)에서 5가지를 직접 합니다. 천천히 하면 15분이면 돼요.

3-1. 프로젝트 만들기

콘솔 상단에서 새 프로젝트를 하나 만들어요 (이름 아무거나, 예: gws-cli).

3-2. 필요한 API 켜기

'API 및 서비스 → 라이브러리'에서 내가 쓸 것만 켜요.

가이드	켤 API
F4 메일 첨부	Gmail API · Google Drive API
F7 캘린더	Google Calendar API
(선택) 시트·문서	Google Sheets API · Google Docs API

3-3. OAuth 동의화면 = 'External(외부)'

'API 및 서비스 → OAuth 동의화면'에서 사용자 유형을 External(외부)로, 게시 상태는 테스트(Testing) 그대로 둡니다.

console.cloud.google.com · OAuth 동의화면

User typeExternal (외부)

게시 상태테스트 (Testing)

3-4. ★ 테스트 사용자에 '내 이메일' 추가 ★ (이거 빠뜨리면 막혀요)

동의화면의 '테스트 사용자(Test users)'에 본인 구글 이메일을 추가하세요. 이걸 안 하면 로그인할 때 아래처럼 막힙니다.

구글 로그인 — 차단 화면

접근 차단됨: 이 앱의 Google 인증이 완료되지 않았습니다

오류 403: access_denied

console.cloud.google.com · 테스트 사용자

Test users내 이메일 추가됨 ✓

+ ADD USERS

3-5. OAuth 클라이언트 = ★ '데스크톱 앱' ★

'사용자 인증 정보 → 사용자 인증 정보 만들기 → OAuth 클라이언트 ID'에서 유형을 반드시 '데스크톱 앱'으로 만들고, JSON을 내려받아요. (웹 애플리케이션으로 만들면 안 됩니다.)

console.cloud.google.com · OAuth 클라이언트 ID

애플리케이션 유형데스크톱 앱

이름gws cli

만들기 → JSON 다운로드

내려받은 JSON을 이 경로에 두라고 클로드에게 시키면 됩니다.

방금 받은 OAuth JSON을 ~/.config/gws/client_secret.json 으로 옮기고,
gws auth login 으로 로그인해줘. 스코프는 drive,gmail,calendar 만.

⚠️ 스코프 제한 주의: 검증 안 된 테스트 앱은 한 번에 약 25개 권한까지만 돼요. 기본값(85개 이상)으로 하면 실패합니다. 그래서 필요한 것만 (drive,gmail,calendar) 골라 로그인합니다.

---

STEP 4. 연결 확인

gws auth status 로 연결됐는지 확인해줘.

클로드 코드가 실행 — 확인

$ gws auth status

연결됨 — gmail, drive, calendar 사용 가능

---

안 될 때 — 빠른 점검표

증상	원인	해결
로그인 시 "접근 차단됨 / 403"	테스트 사용자 미등록	3-4에서 내 이메일 추가
gws auth login 실패·인식 안 됨	클라이언트가 '웹'으로 생성됨	3-5에서 데스크톱 앱으로 다시
권한 동의에서 에러	스코프 너무 많음	--scopes drive,gmail,calendar로 좁히기
자동(auth setup)이 안 돎	gcloud 없음/권한	STEP 3 수동으로

---

✅ 세팅 체크리스트

• 클로드 데스크탑 'Code 탭' 켜기 (Local + 폴더)
• brew install googleworkspace-cli
• gws auth setup --login (쉬운 길) 시도
• (막히면) GCP 프로젝트 + API + 동의화면 External
• 테스트 사용자에 내 이메일 추가 (403 방지)
• OAuth 클라이언트 데스크톱 앱 + JSON → ~/.config/gws/client_secret.json
• gws auth status 연결 확인

---

다음

세팅이 끝났으면 본편으로 →

• 📧 클로드가 메일 답장 + 파일 첨부까지
• 📅 메일 속 약속을 캘린더에 통째로 등록

🎬 막히는 건 **ai.crew 카톡방**에 화면 캡처와 함께 물어보세요 — 인증이 제일 자주 나오는 질문이라 같이 풀어드려요.