Povežite Claude Code sa Google Workspace kroz pet provera čitanja

Claude Code može da izvršava komande Google Workspace CLI (gws) iz lokalnog komandnog okruženja, koristeći Google nalog prijavljen u gws. Ovlašćeni vlasnik naloga može da proveri vezu pomoću po jednog bezazlenog zapisa u Drive, Sheets, Docs i Gmail. Najpre potvrdite nalog i ovlašćenja. Vodič prati dokumentovani interfejs CLI repozitorijuma pregledan 20. oktobra 2026. BIG CHANGE nije instalirao nijedan alat niti pristupio nalogu.

Velika promena

• Šta se promenilo: Trenutni gws CLI izlaže metode Google Workspace API-ja kao komande koje Claude Code može da izvrši. Jedan prijavljeni nalog može da omogući pristup različitim poslovnim servisima, u granicama stvarnih ovlašćenja i dozvola agenta za komandno okruženje.
• Zašto je važno: Ista veza koja agentu omogućava da pregleda odabrani fajl ili poruku može da dosegne i druge podatke obuhvaćene OAuth opsezima. Vlasnik naloga može da uporedi male, poznate rezultate iz terminala i iz Claude Code pre nego što odluči da poveri više posla.
• Na šta obratiti pažnju: Proverite generisane komande instaliranog CLI-ja i stvarno važeća pravila dozvola u sesiji kad god se podešavanje promeni. CLI još nije dostigao verziju 1.0; uzak primer upita ili maska polja ne sužava ovlašćenje na nivou celog naloga.

Pre povezivanja

Koristite namenski, odobren Google nalog za testiranje bez osetljivog sadržaja i Cloud projekat u kome smete da podesite OAuth. Pitajte administratora da li su dozvoljena četiri API-ja i tražena ovlašćenja. Pripremite postojeći Drive fajl jedinstvenog naziva, tabelu sa poznatim vrednostima u malom opsegu, kratak Google Doc sa običnim tekstom i jednom karticom i bezazlenu Gmail poruku. Za Gmail preuzmite RFC identifikator Message-ID iz Show original. Ove originale ćete porediti sa CLI rezultatima. Ove provere ništa ne stvaraju i ne šalju.

Instalirajte Claude Code na računar koji kontrolišete. Instalirajte gws iz izdanja repozitorijuma za vaš operativni sistem ili, uz Node.js 18 ili noviji, upotrebite dokumentovanu komandu:

npm install -g @googleworkspace/cli
gws --version
gws --help
gws auth login --help

Privatno zabeležite instalirane verzije CLI-ja i Claude Code. CLI je još pre verzije 1.0, a komande gradi iz Google dokumenata za otkrivanje API-ja. Pre izvršavanja primera proverite instaliranu pomoć i šeme metoda navedene ispod.

1. Podesite ograničenu OAuth prijavu

U odobrenom Cloud projektu uključite API-je za Drive, Sheets, Docs i Gmail. Podesite OAuth publiku i napravite klijent tipa Desktop app. Ako je aplikacija External i u testiranju, dodajte odabrani nalog kao test korisnika. Preuzeti JSON klijenta sačuvajte na dokumentovanoj lokaciji ~/.config/gws/client_secret.json ili koristite zaseban direktorijum izabran pomoću GOOGLE_WORKSPACE_CLI_CONFIG_DIR. Taj direktorijum držite van Claude projekta i dostupnim samo vlasniku naloga.

Pre prijave privatno proverite da li je postavljeno GOOGLE_WORKSPACE_CLI_TOKEN ili GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE, uključujući kroz fajl .env. Ovi izvori imaju prednost nad sačuvanim OAuth akreditivima. Ne ispisujte njihove vrednosti i ne tražite od Claude Code da čita fajlove sa akreditivima. Koristite čisto okruženje i predviđenu konfiguraciju klijenta.

Izričito zatražite ova četiri opsega:

gws auth login --scopes 'https://www.googleapis.com/auth/drive.metadata.readonly,https://www.googleapis.com/auth/spreadsheets.readonly,https://www.googleapis.com/auth/documents.readonly,https://www.googleapis.com/auth/gmail.readonly'
gws auth status

Izbor naloga i davanje saglasnosti obavite lično. Izvorni kod CLI-ja u navedenoj reviziji dodaje i identitetske opsege openid, userinfo.email i userinfo.profile. Privatno uporedite saglasnost i podatke iz gws auth status o nalogu, ovlašćenjima i važnosti tokena sa nameravanim; polje statusa koje nedostaje ostaje neprovereno. Zaustavite se ako je nalog pogrešan ili ostaje neočekivano šire ovlašćenje. Biranje servisa pri prijavi filtrira ponuđene opcije; samo po sebi ne podešava ova četiri opsega samo za čitanje.

Opsezi su širi od zahteva iz primera. Pristup Drive metapodacima obuhvata metapodatke dostupnih fajlova; pristup samo za čitanje za Sheets i Docs obuhvata dostupne tabele i dokumente; Gmail ovlašćenje samo za čitanje može da pristupi sadržaju poštanskog sandučeta. Nazivi, ID-jevi, opsezi, upiti i maske polja ograničavaju pojedinačni odgovor, ne ovlašćenje tokena. Alat komandnog okruženja može da pristupi i lokalnim akreditivima, pa ih skrivena putanja ili instrukcija u upitu ne izoluju.

2. Izvršite ograničena čitanja direktno

Najpre pregledajte svaki metod pomoću gws schema drive.files.list i odgovarajućih naziva šema za ostale metode. Proverite generisanu pomoć --help ako se parametar razlikuje u instaliranoj verziji. Sledeće komande koriste jednostruke navodnike iz Bash sintakse; namerno prilagodite navodnike drugom komandnom okruženju. Zamenite samo test identifikatore i naziv. Izvršavajte po jednu komandu i privatno sačuvajte stvarni odgovor ili grešku, bez tokena i osetljivog sadržaja.

Pronađite Drive fajl po nazivu. JSON sekvenca \u0027 neutrališe posebno značenje apostrofa u Drive izrazu za pretragu uz očuvanje Bash navodnika:

gws drive files list --params '{"pageSize":5,"q":"trashed = false and name = \u0027GWS connection check\u0027","fields":"files(id,name,mimeType),nextPageToken,incompleteSearch"}'

Uporedite ID i naziv sa fajlom u Drive. Nepostojanje podudaranja ili incompleteSearch ne dokazuje pristup nameravanom fajlu.

Pročitajte poznate ćelije koristeći stvarni ID tabele i naziv kartice:

gws sheets spreadsheets values get --params '{"spreadsheetId":"SPREADSHEET_ID","range":"Sheet1!A1:C3","fields":"range,majorDimension,values"}'

Uporedite vraćene vrednosti sa tabelom. Google može da izostavi prazne ćelije na kraju, pa pripremite poznate vrednosti koje nisu prazne.

Pročitajte prvu karticu kratkog test dokumenta:

gws docs documents get --params '{"documentId":"DOCUMENT_ID","includeTabsContent":false,"fields":"documentId,title,body(content(paragraph(elements(textRun(content)))))"}'

Proverite ID, naslov i poznati tekst. Ovaj ograničeni odgovor ne proverava druge kartice, komentare ni celu strukturu dokumenta.

Za Gmail pretražite postojeću poruku prema RFC identifikatoru Message-ID, a zatim vraćeni Gmail ID upotrebite da zatražite dva zaglavlja:

gws gmail users messages list --params '{"userId":"me","maxResults":1,"q":"rfc822msgid:MESSAGE_ID_FROM_SHOW_ORIGINAL","fields":"messages(id,threadId),nextPageToken,resultSizeEstimate"}'
gws gmail users messages get --params '{"userId":"me","id":"GMAIL_MESSAGE_ID","format":"metadata","metadataHeaders":["Message-ID","Subject"],"fields":"id,threadId,payload(headers)"}'

Uporedite vraćeni Message-ID i bezazleni naslov poruke sa originalom. Prvi poziv vraća ID-jeve poruka, ne zaglavlja. Drugi traži metapodatke zaglavlja, ne telo poruke. Prazan prvi odgovor ne omogućava drugu proveru. Uži Gmail OAuth opseg za metapodatke ne dozvoljava upit za pretragu koji se ovde koristi; izričito Gmail ovlašćenje samo za čitanje ga dozvoljava.

3. Ponovite kroz Claude Code uz zahteve za dozvolu

Pokrenite Claude Code u projektu koji kontrolišete, uz istu odobrenu konfiguraciju naloga. U /permissions pregledajte stvarno važeći režim i pravila komandnog okruženja. Koristite Manual (takođe nazvan default) i pravilo Ask za stvarni alat komandnog okruženja; rešite šira pravila dozvoljavanja ili zaobilaženja u skladu sa politikom organizacije. Izbegavajte opštu dozvolu za gws * ili omotač komandnog okruženja. Kod svakog predloženog izvršavanja pregledajte celu komandu i odobrite samo nameravano ograničeno čitanje.

Običnim jezikom zatražite od Claude Code da predloži pet gornjih komandi za iste test objekte i da ih izvršava jednu po jednu tek posle vaše odluke o dozvoli. Tražite izlaz komande ili greške, bez čitanja akreditiva, proširivanja upita ili upisa. Zatim svaki rezultat uporedite i sa direktnim rezultatom i sa originalnim objektom. Projektne instrukcije mogu da opišu zadatak, ali pristup određuju stvarne dozvole alata i OAuth ovlašćenja.

U privatni obrazac upišite verzije, prijavljeni nalog, stvarna ovlašćenja, ciljne ID-jeve, direktni rezultat, Claude rezultat i greške. Neuspešan zahtev, uspešan prazan odgovor i potvrđen objekat različiti su ishodi. Završite tek kada su sva četiri servisa potvrđena kroz oba puta.

Ako provera ne uspe

Greška Access blocked pri prijavi može da znači da test nalog nedostaje na listi test korisnika OAuth aplikacije. Kod greške API-ja ili opsega potvrdite uključen API, izabrani nalog i stvarna ovlašćenja pre nego što zatražite odobreno ponovno davanje saglasnosti. Kod prazne liste proverite tačan objekat, upit i nalog. Ako se instalirana pomoć razlikuje od primera, koristite važeću šemu metoda pre nastavka. Ako Claude Code predloži komandu koja menja podatke ili širi pristup, odbijte je pri zahtevu za dozvolu i vratite se ograničenom čitanju.

CLI repozitorijum je dostupan bez plaćenog paketa. Nalog ili Workspace plan, Cloud kvote i Claude Code plan ili API potrošnja mogu da nose troškove. Preuzeti sadržaj može da obradi dobavljač podešen u Claude Code, pa koristite samo odobrene test podatke koji nisu osetljivi. CLI navodi da nije zvanično podržan Google proizvod i upozorava na promene pre verzije 1.0. BIG CHANGE nije testirao performanse ili kompatibilnost. Zaustavite se pre svakog upisa, slanja ili promene naloga. Odvojeni Claude dodatak za Google Workspace obrađuje uređivanje otvorenih fajlova uz odobrenje drugim putem.