Claude Code स्थानीय शेल से Google Workspace CLI (gws) की कमांड चला सकता है। वह gws में प्रमाणित Google खाते का उपयोग करता है। अधिकृत खाता-मालिक Drive, Sheets, Docs और Gmail में एक-एक गैर-संवेदनशील रिकॉर्ड से कनेक्शन जाँच सकता है। पहले खाते और मिली अनुमतियों की पुष्टि करें। यह गाइड 20 अक्टूबर 2026 को जाँचे गए CLI रिपॉज़िटरी के दस्तावेज़ित इंटरफ़ेस पर आधारित है। 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 को अपने OS के लिए रिपॉज़िटरी की रिलीज़ से इंस्टॉल करें या Node.js 18 अथवा बाद का संस्करण हो तो दस्तावेज़ित कमांड इस्तेमाल करें:

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

इंस्टॉल किए गए CLI और Claude Code के संस्करण निजी रूप से लिखें। CLI अभी 1.0 से पहले का है और इसकी कमांड Google के API खोज दस्तावेज़ों से बनती हैं। उदाहरण चलाने से पहले इंस्टॉल की गई सहायता और नीचे दिए विधि-स्कीमा जाँचें।

1. सीमित OAuth लॉगिन कॉन्फ़िगर करें

स्वीकृत Cloud प्रोजेक्ट में Drive, Sheets, Docs और Gmail API चालू करें। 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 से क्रेडेंशियल फ़ाइलें पढ़ने को न कहें। साफ़ परिवेश और इच्छित क्लाइंट कॉन्फ़िगरेशन लें।

इन चार दायरों को स्पष्ट रूप से माँगें:

Terminal
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 उद्धरण सुरक्षित रखता है:

Terminal
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 और टैब नाम से ज्ञात सेल पढ़ें:

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

लौटे मान स्प्रेडशीट से मिलाएँ। Google अंत के खाली सेल छोड़ सकता है, इसलिए ज्ञात गैर-खाली मान रखें।

छोटे परीक्षण Doc का पहला टैब पढ़ें:

Terminal
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 से दो हेडर माँगें:

Terminal
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 ऐड-ऑन दूसरे रास्ते से स्वीकृति लेकर खुली फ़ाइलों का संपादन समझाता है।