Markdown издање

AI-translated from English; not yet reviewed by a fluent editor.

# Повежите Claude Code са Google Workspace кроз пет провера читања

> Документовано подешавање за проверу налога за Google Workspace CLI који користи Claude Code, OAuth овлашћења и захтева за дозволу помоћу ограниченог читања из Drive, Sheets, Docs и Gmail.

By BIG CHANGE Editorial

Published: 2026-10-20T09:34:40.461Z
Updated: 2026-10-20T09:34:40.461Z
Canonical: https://bigchange.ai/blog/claude-code-google-workspace-cli-read-checks

![Conceptual charcoal illustration of one person studying abstract command lines on a desktop monitor, with a plain folder, grid sheet, document and sealed envelope on the table.](https://bigchange.ai/api/media/file/gws-claude-read-check-workstation-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE.

Claude Code може да извршава команде Google Workspace CLI (`gws`) из локалног командног окружења, користећи Google налог пријављен у `gws`. Овлашћени власник налога може да провери везу помоћу по једног безазленог записа у Drive, Sheets, Docs и Gmail. Најпре потврдите налог и овлашћења. Водич прати документовани интерфејс CLI репозиторијума прегледан 20. октобра 2026. BIG CHANGE није инсталирао ниједан алат нити приступио налогу.

## Велика промена

- **Шта се променило:** Тренутни `gws` CLI излаже методе Google Workspace API-ја као команде које Claude Code може да изврши. Један пријављени налог може да омогући приступ различитим пословним сервисима, у границама стварних овлашћења и дозвола агента за командно окружење.
- **Зашто је важно:** Иста веза која агенту омогућава да прегледа одабрани фајл или поруку може да досегне и друге податке обухваћене OAuth опсезима. Власник налога може да упореди мале, познате резултате из терминала и из Claude Code пре него што одлучи да повери више посла.
- **На шта обратити пажњу:** Проверите генерисане команде инсталираног CLI-ја и стварно важећа правила дозвола у сесији кад год се подешавање промени. CLI још није достигао верзију 1.0; узак пример упита или маска поља не сужава овлашћење на нивоу целог налога.

## Пре повезивања

Користите наменски, одобрен Google налог за тестирање без осетљивог садржаја и Cloud пројекат у коме смете да подесите OAuth. Питајте администратора да ли су дозвољена четири API-ја и тражена овлашћења. Припремите постојећи Drive фајл јединственог назива, табелу са познатим вредностима у малом опсегу, кратак Google Doc са обичним текстом и једном картицом и безазлену Gmail поруку. За Gmail преузмите RFC идентификатор `Message-ID` из **Show original**. Ове оригинале ћете поредити са CLI резултатима. Ове провере ништа не стварају и не шаљу.

Инсталирајте Claude Code на рачунар који контролишете. Инсталирајте `gws` из [издања репозиторијума за ваш оперативни систем](https://github.com/googleworkspace/cli/releases) или, уз Node.js 18 или новији, употребите документовану команду:

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

Приватно забележите инсталиране верзије CLI-ја и Claude Code. CLI је још пре верзије 1.0, а команде гради из Google докумената за откривање API-ја. Пре извршавања примера проверите инсталирану помоћ и шеме метода наведене испод.

## 1. Подесите ограничену OAuth пријаву

У одобреном Cloud пројекту укључите API-је за Drive, Sheets, Docs и Gmail. Подесите OAuth публику и направите клијент типа **Desktop app**. Ако је апликација External и у тестирању, додајте одабрани налог као тест корисника. Преузети JSON клијента сачувајте на документованој локацији `~/.config/gws/client_secret.json` или користите засебан директоријум изабран помоћу `GOOGLE_WORKSPACE_CLI_CONFIG_DIR`. Тај директоријум држите ван Claude пројекта и доступним само власнику налога.

Пре пријаве приватно проверите да ли је постављено `GOOGLE_WORKSPACE_CLI_TOKEN` или `GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE`, укључујући кроз фајл `.env`. Ови извори имају предност над сачуваним OAuth акредитивима. Не исписујте њихове вредности и не тражите од Claude Code да чита фајлове са акредитивима. Користите чисто окружење и предвиђену конфигурацију клијента.

Изричито затражите ова четири опсега:

```bash
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
```

Избор налога и давање сагласности обавите лично. Изворни код CLI-ја у наведеној ревизији додаје и идентитетске опсеге `openid`, `userinfo.email` и `userinfo.profile`. Приватно упоредите сагласност и податке из `gws auth status` о налогу, овлашћењима и важности токена са намераваним; поље статуса које недостаје остаје непроверено. Зауставите се ако је налог погрешан или остаје неочекивано шире овлашћење. Бирање сервиса при пријави филтрира понуђене опције; само по себи не подешава ова четири опсега само за читање.

Опсези су шири од захтева из примера. Приступ Drive метаподацима обухвата метаподатке доступних фајлова; приступ само за читање за Sheets и Docs обухвата доступне табеле и документе; Gmail овлашћење само за читање може да приступи садржају поштанског сандучета. Називи, ID-јеви, опсези, упити и маске поља ограничавају појединачни одговор, не овлашћење токена. Алат командног окружења може да приступи и локалним акредитивима, па их скривена путања или инструкција у упиту не изолују.

## 2. Извршите ограничена читања директно

Најпре прегледајте сваки метод помоћу `gws schema drive.files.list` и одговарајућих назива шема за остале методе. Проверите генерисану помоћ `--help` ако се параметар разликује у инсталираној верзији. Следеће команде користе једноструке наводнике из Bash синтаксе; намерно прилагодите наводнике другом командном окружењу. Замените само тест идентификаторе и назив. Извршавајте по једну команду и приватно сачувајте стварни одговор или грешку, без токена и осетљивог садржаја.

Пронађите Drive фајл по називу. JSON секвенца `\u0027` неутралише посебно значење апострофа у Drive изразу за претрагу уз очување Bash наводника:

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

Упоредите ID и назив са фајлом у Drive. Непостојање подударања или `incompleteSearch` не доказује приступ намераваном фајлу.

Прочитајте познате ћелије користећи стварни ID табеле и назив картице:

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

Упоредите враћене вредности са табелом. Google може да изостави празне ћелије на крају, па припремите познате вредности које нису празне.

Прочитајте прву картицу кратког тест документа:

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

Проверите ID, наслов и познати текст. Овај ограничени одговор не проверава друге картице, коментаре ни целу структуру документа.

За Gmail претражите постојећу поруку према RFC идентификатору `Message-ID`, а затим враћени Gmail ID употребите да затражите два заглавља:

```bash
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)"}'
```

Упоредите враћени `Message-ID` и безазлени наслов поруке са оригиналом. Први позив враћа ID-јеве порука, не заглавља. Други тражи метаподатке заглавља, не тело поруке. Празан први одговор не омогућава другу проверу. Ужи Gmail OAuth опсег за метаподатке не дозвољава упит за претрагу који се овде користи; изричито Gmail овлашћење само за читање га дозвољава.

## 3. Поновите кроз Claude Code уз захтеве за дозволу

Покрените Claude Code у пројекту који контролишете, уз исту одобрену конфигурацију налога. У `/permissions` прегледајте стварно важећи режим и правила командног окружења. Користите Manual (такође назван `default`) и правило **Ask** за стварни алат командног окружења; решите шира правила дозвољавања или заобилажења у складу са политиком организације. Избегавајте општу дозволу за `gws *` или омотач командног окружења. Код сваког предложеног извршавања прегледајте целу команду и одобрите само намеравано ограничено читање.

Обичним језиком затражите од Claude Code да предложи пет горњих команди за исте тест објекте и да их извршава једну по једну тек после ваше одлуке о дозволи. Тражите излаз команде или грешке, без читања акредитива, проширивања упита или уписа. Затим сваки резултат упоредите и са директним резултатом и са оригиналним објектом. Пројектне инструкције могу да опишу задатак, али приступ одређују стварне дозволе алата и OAuth овлашћења.

| Сервис | Доказ завршетка кроз оба пута |
| --- | --- |
| Drive | Исти ID и назив фајла; претрага је потпуна. |
| Sheets | Очекивана картица, опсег и познате вредности ћелија. |
| Docs | Очекивани ID, наслов и текст прве картице. |
| Gmail | Листа проналази тест поруку; преузимање метаподатака потврђује њен `Message-ID` и наслов. |

У приватни образац упишите верзије, пријављени налог, стварна овлашћења, циљне ID-јеве, директни резултат, Claude резултат и грешке. Неуспешан захтев, успешан празан одговор и потврђен објекат различити су исходи. Завршите тек када су сва четири сервиса потврђена кроз оба пута.

## Ако провера не успе

Грешка **Access blocked** при пријави може да значи да тест налог недостаје на листи тест корисника OAuth апликације. Код грешке API-ја или опсега потврдите укључен API, изабрани налог и стварна овлашћења пре него што затражите одобрено поновно давање сагласности. Код празне листе проверите тачан објекат, упит и налог. Ако се инсталирана помоћ разликује од примера, користите важећу шему метода пре наставка. Ако Claude Code предложи команду која мења податке или шири приступ, одбијте је при захтеву за дозволу и вратите се ограниченом читању.

CLI репозиторијум је доступан без плаћеног пакета. Налог или Workspace план, Cloud квоте и Claude Code план или API потрошња могу да носе трошкове. Преузети садржај може да обради добављач подешен у Claude Code, па користите само одобрене тест податке који нису осетљиви. CLI наводи да није званично подржан Google производ и упозорава на промене пре верзије 1.0. BIG CHANGE није тестирао перформансе или компатибилност. Зауставите се пре сваког уписа, слања или промене налога. [Одвојени Claude додатак за Google Workspace](https://bigchange.ai/blog/claude-google-workspace-add-on-edit-open-files) обрађује уређивање отворених фајлова уз одобрење другим путем.

## Sources

- [README за Google Workspace CLI](https://github.com/googleworkspace/cli/blob/a3768d0e82ad83cca2da97724e46bea4ff0e6dbd/README.md) — Званични репозиторијум на одређеној ревизији, прегледан 20. октобра 2026. Потврђује инсталацију, ручно OAuth подешавање, динамичке команде, приоритет акредитива, нестабилност верзије и упозорење да производ није званично подржан. Не потврђује резултат извршавања које је обавио BIG CHANGE.
- [Контекст команди за Google Workspace CLI](https://github.com/googleworkspace/cli/blob/a3768d0e82ad83cca2da97724e46bea4ff0e6dbd/CONTEXT.md) — Званична упутства на одређеној ревизији за угнеждене методе, --params, преглед шема и ограничен избор поља; треба проверити стварно инсталирану помоћ.
- [Имплементација аутентификације за Google Workspace CLI](https://github.com/googleworkspace/cli/blob/a3768d0e82ad83cca2da97724e46bea4ff0e6dbd/crates/google-workspace-cli/src/auth_commands.rs) — Фиксирана ревизија аутентификационог кода потврђује прилагођене --scopes, одвојено понашање избора сервиса и придодате идентитетске опсеге. Преглед кода не показује стварно овлашћење читаоца.
- [Водич за укључивање Google Workspace API-ја](https://developers.google.com/workspace/guides/enable-apis) — Google упутства за укључивање API-ја у Cloud пројекту; приступ и даље одређују правила пројекта и администратора.
- [Референца за Drive files.list](https://developers.google.com/workspace/drive/api/reference/rest/v3/files/list) — Потврђује Drive q, pageSize и поља одговора која ограничавају претрагу метаподатака. Узак захтев не сужава OAuth овлашћење.
- [Референца за Sheets spreadsheets.values.get](https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get) — Потврђује читање помоћу ID-ја табеле и A1 опсега и облик одговора; празне ћелије на крају могу бити изостављене.
- [Референца за Docs documents.get](https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/get) — Потврђује преузимање документа и ограничење на прву картицу када је includeTabsContent false. Пример је намењен тест документу са обичним текстом и једном картицом.
- [Референце за Gmail messages.list и messages.get](https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages/list) — Референца list потврђује претрагу по ID-ју поруке и резултате који садрже само ID-јеве; q није доступан уз gmail.metadata. Повезана get референца је https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages/get и потврђује metadataHeaders у формату METADATA.
- [Дозволе за Claude Code](https://code.claude.com/docs/en/permissions) — Важећа Anthropic референца за режим Manual/default, правила Ask, стварне дозволе алата и захтеве за одобрење командног окружења. Не потврђује да одређена сесија читаоца има одређено правило.