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లో అమర్చిన ప్రదాత ప్రాసెస్ చేయవచ్చు; ఆమోదించిన అసున్నిత పరీక్ష డేటానే వాడండి. ఇది Google అధికారికంగా మద్దతిచ్చే ఉత్పత్తి కాదని CLI చెబుతుంది, 1.0కు ముందు మార్పులపై హెచ్చరిస్తుంది. BIG CHANGE పనితీరు లేదా అనుకూలతను పరీక్షించలేదు. ఏ రాయడం, పంపడం లేదా ఖాతా మార్పు చేయడానికి ముందే ఆపండి. Claude ప్రత్యేక Google Workspace యాడ్-ఆన్ వేరే మార్గంలో ఆమోదంతో తెరిచిన ఫైళ్ల సవరణను వివరిస్తుంది.