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 चाचणी खाते आणि OAuth कॉन्फिगर करण्याचा अधिकार असलेला Cloud प्रकल्प वापरा. चार 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 अॅड-ऑन दुसऱ्या मार्गाने मान्यता घेऊन उघड्या फाइल्स संपादित करणे समजावते.