Claude API को सुरक्षित रूप से कैसे ऑथेंटिकेट करें
Claude API को Anthropic key, AWS IAM, Google ADC या Microsoft Entra के साथ सेटअप करना सीखें। इस गाइड में Linux सर्वर पर क्रेडेंशियल्स को सुरक्षित रखने के तरीके बताए गए हैं।
Claude API ऑथेंटिकेशन रूट
Claude API ऑथेंटिकेशन का निर्णय इस बात पर निर्भर करता है कि आपका क्लाइंट कौन सा क्रेडेंशियल उपयोग करता है। Anthropic सीधे Claude API के साथ-साथ पाँच क्लाउड प्लेटफॉर्म्स का समर्थन करता है: Amazon Bedrock, AWS पर Claude Platform, Google Cloud पर Claude Models (Google द्वारा प्रबंधित), Google Cloud पर Claude Models (Anthropic द्वारा प्रबंधित), और Microsoft Foundry। सीधा Anthropic API एक API key या Authorization: Bearer हेडर में एक अल्पकालिक टोकन स्वीकार करता है, और अभी भी लेगेसी x-api-key हेडर में API keys स्वीकार करता है। Amazon Bedrock AWS रिक्वेस्ट साइनिंग और Bedrock API keys का समर्थन करता है, और उस सेटअप में कहीं भी Anthropic key का उपयोग नहीं होता है। Google Cloud एक अल्पकालिक Google access token भेजता है। Microsoft Foundry एक Azure-जारी key या Microsoft Entra टोकन लेता है। नीचे दिए गए चार सेक्शन इन क्रेडेंशियल सेटअप्स को कवर करते हैं, जिसमें Anthropic-प्रबंधित AWS और Google Cloud पेशकशों को उनके क्लाउड समकक्षों के साथ समझाया गया है।
यह गाइड Linux सर्वर पर चल रही सर्विस में SDK (software development kit) को कॉन्फ़िगर करने के लिए है। यदि आप इसके बजाय Claude Code कमांड लाइन टूल को कॉन्फ़िगर कर रहे हैं, तो वेरिएबल्स और फ्लो अलग हैं: Bedrock या Vertex पर Claude Code को पॉइंट करना देखें। यदि सर्विस अभी तक मौजूद नहीं है, तो पहले इसे VPS पर पहली Claude API ऐप के साथ बनाएं और क्रेडेंशियल के लिए यहाँ वापस आएं।
नीचे दी गई हर जानकारी को अगस्त 2026 में Anthropic के प्लेटफॉर्म डॉक्यूमेंटेशन के साथ और 16 अक्टूबर 2026 को प्रत्येक प्रदाता के डॉक्यूमेंटेशन के साथ दोबारा जांचा गया था; Bedrock मॉडल एक्सेस विवरण को 19 अक्टूबर 2026 को AWS डॉक्यूमेंटेशन के साथ दोबारा जांचा गया था। सभी चार रूट्स, API keys और API वर्ज़न्स के लिए Anthropic के पेजों को 27 अक्टूबर 2026 को दोबारा जांचा गया था। Microsoft Foundry, दोनों Bedrock एंडपॉइंट्स, Google-प्रबंधित रूट, AWS पर Claude Platform, ऑथेंटिकेशन, Workload Identity Federation और API वर्ज़न्स के लिए Anthropic के पेजों को 10 नवंबर 2026 को Ruby SDK के changelog के साथ दोबारा जांचा गया था। मॉडल आइडेंटिफ़ायर, कीमतें, SDK वर्ज़न्स और एंडपॉइंट शेप्स बदलते रहते हैं, इसलिए यह गाइड उन मानों को प्रिंट करने के बजाय प्रदाता पेजों को लिंक करती है जो पुराने हो सकते हैं।
Route 1: एक Anthropic API key
यह सीधा रास्ता है, और केवल यही वह तरीका है जहाँ Anthropic secret जारी करता है। Requests Anthropic के API host पर Messages endpoint पर जाती हैं, और प्रत्येक request में तीन headers होते हैं।
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model": "MODEL_ID", "max_tokens": 64, "messages": [{"role": "user", "content": "Hello"}]}'MODEL_ID को Anthropic के models overview से एक वर्तमान identifier के साथ बदलें। एक सफल response वह JSON है जिसमें एक content array और एक usage object होता है। एक गलत या expired key HTTP 401 के साथ authentication_error लौटाती है। एक missing anthropic-version header एक अलग विफलता है, क्योंकि वह header हर request पर आवश्यक है; SDKs इसे आपके लिए set कर देते हैं। अक्टूबर 2026 तक, Anthropic का documentation Authorization: Bearer को key भेजने का मुख्य तरीका बताता है और x-api-key को legacy कहता है, लेकिन दोनों स्वीकार किए जाते हैं, इसलिए ऊपर दिया गया command अभी भी काम करता है। वर्तमान SDK major versions key को Authorization: Bearer के रूप में भी भेजते हैं, इसलिए जो proxy या gateway X-Api-Key को पढ़ता है, उसे upgrade करते समय बदलने की आवश्यकता होती है। command में 2023-06-01 version अभी भी स्वीकार्य है; Anthropic का नवीनतम API version 2026-10-21 है, जिसे वे SDK versions default रूप से भेजते हैं और जो temperature जैसे कुछ पुराने request parameters को reject कर देता है।
Client construction इन setups में सबसे छोटा है, क्योंकि इसमें construct करने के लिए कुछ भी नहीं है। प्रत्येक official SDK environment से ANTHROPIC_API_KEY को स्वयं पढ़ लेता है।
import os
from anthropic import Anthropic
client = Anthropic() # reads ANTHROPIC_API_KEY from the environment
message = client.messages.create(
model=os.environ["CLAUDE_MODEL"],
max_tokens=64,
messages=[{"role": "user", "content": "Hello"}],
)
print(message.usage)Key के साथ-साथ model identifier को environment में रखना उचित है। Model के नाम उस schedule पर बदलते हैं जिसे आप नियंत्रित नहीं करते, और केवल एक string को edit करने के लिए code को redeploy करना अनावश्यक काम है।
Keys Console में बनाई जाती हैं, जहाँ आप निर्माण के समय expiry चुनते हैं: 3 घंटे, 1 दिन, 7 दिन या 30 दिन के presets, एक custom अवधि, या Never, जो आपके organization की अधिकतम expiration policy के अधीन है। Expiry निर्माण के समय तय होती है और बाद में बदली नहीं जा सकती। Anthropic एक long-lived key के expire होने से पहले उसके creator को email करता है, लेकिन कम अवधि वाली key बिना किसी चेतावनी mail के expire हो जाती है। एक expired key 401 लौटाती है और उसे reactivate नहीं किया जा सकता, इसलिए समाधान हमेशा एक नई key बनाना ही है।
Direct API पर चुनने के लिए कोई region नहीं है, और बिल सीधे आपके Anthropic organization को जाता है। Workspaces एक key को एक project तक सीमित करते हैं, जो यह देखने का सबसे साफ तरीका है कि एक single service कितना खर्च करती है। किसी server की key को बनाते समय उसे उसके workspace तक सीमित करें: एक personal या service account key जो workspace तक सीमित नहीं है, उसे हर request पर एक anthropic-workspace-id header भेजना पड़ता है, अन्यथा API invalid_request_error के साथ 400 error देता है। Service के लिए, service account key चुनें, क्योंकि personal key तब काम करना बंद कर देती है जब उसे बनाने वाला व्यक्ति organization छोड़ देता है। उस बिल के पीछे के गणित के लिए, how per-token API pricing compares against a subscription देखें।
यहाँ एक और विकल्प शामिल है, क्योंकि यह static secret को पूरी तरह हटा देता है। Workload Identity Federation एक workload को एक ऐसे identity provider से OpenID Connect (OIDC) token का आदान-प्रदान करने देता है जिस पर आप पहले से भरोसा करते हैं, ताकि POST /v1/oauth/token पर एक short-lived Anthropic token प्राप्त हो सके, और SDK उस token को expire होने से पहले refresh कर देता है। कोई भी sk-ant-api... string कहीं भी नहीं बनाई या copy की जाती है। यह Kubernetes, GitHub Actions और cloud VMs के लिए उपयुक्त है, जिनके पास पहले से ही एक platform identity होती है। एक साधारण VPS के पास आमतौर पर ऐसा कोई issuer नहीं होता, इसलिए उस box पर एक file में API key रखना ही सही उत्तर है, और यह guide बाकी हिस्सों में इसी तरह व्यवहार करती है।
Route 2: Amazon Bedrock पर AWS credentials
Bedrock पर आपके पास कोई Anthropic key नहीं होती है। AWS credentials के साथ, SDK प्रत्येक HTTP request को AWS Signature Version 4 (SigV4) से sign करता है, और AWS यह तय करता है कि क्या वह caller model को invoke कर सकता है।
pip install -U "anthropic[bedrock]"
aws sts get-caller-identityaws sts get-caller-identity उस identity का account number और ARN (Amazon Resource Name) print करता है जिससे आपके credentials resolve होते हैं। SigV4 का उपयोग करते समय किसी भी अन्य कार्य से पहले इसे run करें। SigV4 के लिए, SDK constructor credentials, environment credentials और standard AWS credential chain को resolve करता है; region का चयन अलग होता है। Python के AnthropicBedrock client में, यदि आप aws_access_key, aws_secret_key, aws_session_token या aws_profile भी पास करते हैं, तो api_key के रूप में या AWS_BEARER_TOKEN_BEDROCK के माध्यम से दी गई Bedrock API key ValueError error देती है। उन explicit arguments के बिना, key AWS credential chain के बजाय bearer authentication को चुनती है। TypeScript client, Bedrock API key को explicit AWS credentials से अधिक प्राथमिकता देता है। STS command bearer authentication को test नहीं करती है।
Client construction में जो बदलता है वह class और एक argument है।
from anthropic import AnthropicBedrock
client = AnthropicBedrock(aws_region="us-east-1")AnthropicBedrock, Bedrock के InvokeModel integration को संचालित करता है। अक्टूबर 2026 तक, Anthropic ने Amazon Bedrock में Claude को भी document किया है, जो Claude Opus 4.7 और बाद के models के लिए https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages पर एक Messages API endpoint है, जिसे उसी package के AnthropicBedrockMantle client के माध्यम से access किया जाता है। यह AWS credentials और Bedrock bearer tokens को support करता है; दोनों endpoints के बीच model access की आवश्यकताएं भिन्न हैं, जैसा कि नीचे समझाया गया है।
उस pip install -U line में upgrade पर नज़र रखें। 27 अक्टूबर 2026 तक, नवीनतम SDK default रूप से API version 2026-10-21 भेजता है, जिसमें Bedrock भी शामिल है, और Anthropic यह document करता है कि Claude Opus 4.6 और उससे पहले के लिए सूचीबद्ध ARN-versioned model IDs Bedrock पर उस version को support नहीं करते हैं और 400 error दे सकते हैं। यदि कोई service उन models में से किसी एक को call करती है, तो SDK को उस version पर रखें जिस पर वह आज चल रहा है और उसे pin करें, या service को पहले Claude 4.7 या बाद के model पर ले जाएं।
यहाँ Region केवल सजावट नहीं है। Bedrock endpoints प्रति region होते हैं, उपलब्ध Claude models region-दर-region भिन्न होते हैं, और region, SigV4 signature का हिस्सा होता है, इसलिए एक region के लिए compute किया गया signature दूसरे द्वारा reject कर दिया जाता है। service environment में AWS_REGION को explicit रूप से set करें, क्योंकि SDKs इस बात पर सहमत नहीं हैं कि इसे खाली छोड़ने पर क्या होता है। जैसा कि अक्टूबर 2026 में document किया गया है, Python AnthropicBedrock client AWS_REGION या AWS_DEFAULT_REGION को पढ़ता है, फिर आपके boto3 session या AWS profile (~/.aws/config सहित) के region को पढ़ता है, और यदि कुछ भी resolve नहीं होता है तो ValueError error देता है। TypeScript client AWS_REGION को पढ़ता है, unset होने पर us-east-1 पर fall back करता है, और region के लिए ~/.aws/config को नहीं पढ़ता है। यही कारण है कि AWS CLI उसी box पर Claude models को सफलतापूर्वक list कर सकता है जहाँ एक Node process गलत region को call करती है: CLI ने आपकी config file पढ़ी और client ने नहीं।
EC2 instance पर आप एक IAM (identity and access management) role attach करते हैं और disk पर कोई secret नहीं रहता, क्योंकि instance metadata service SDK को temporary credentials प्रदान करती है। AWS के बाहर एक VPS में न तो instance role होता है और न ही metadata service। तब आप box पर मौजूद IAM user की long-lived access key pair (जो Anthropic key के समान ही secret का प्रकार है) और federation के बीच चयन कर रहे होते हैं: अपनी identity provider के खिलाफ authenticate करें, AWS STS (security token service) को call करें, और इसके द्वारा लौटाए गए temporary credentials का उपयोग करें। Bedrock, Bedrock API keys को भी स्वीकार करता है, जो AWS_BEARER_TOKEN_BEDROCK के माध्यम से pass किए गए bearer tokens हैं, और AWS दो प्रकार की keys document करता है। एक short-term key 12 घंटे तक, या उसे generate करने वाले session की अवधि तक (जो भी कम हो) चलती है, उस IAM identity की permissions को inherit करती है जिसने इसे generate किया है, और यह वह प्रकार है जिसकी AWS production के लिए अनुशंसा करता है। एक long-term key उस expiry तक चलती है जिसे आप इसे बनाते समय चुनते हैं (उदाहरण के लिए --credential-age-days के साथ 30 या 90 दिन), या यदि वह API parameter छोड़ दिया जाए तो expire नहीं होती है; Console इसके पीछे एक IAM user बनाता है, और AWS केवल अन्वेषण (exploration) के लिए इसकी अनुशंसा करता है। एक long-term key केवल उसी region में काम करती है जहाँ इसे generate किया गया था; इसे दूसरे region में उपयोग करने पर Credential should be scoped to a valid region error मिलता है।
बिल Anthropic के बजाय आपके AWS account पर आता है, जो आमतौर पर यहाँ होने का मुख्य कारण है। अक्टूबर 2026 में document किए अनुसार, regional endpoints पर global endpoint की तुलना में 10% अधिक शुल्क लगता है। AWS पर Claude Platform एक अलग product है: Anthropic इसे संचालित करता है, AWS इसे AWS Marketplace के माध्यम से bill करता है, और यह SigV4 या AWS Console में generate की गई API key (Claude Console की keys यहाँ काम नहीं करती हैं) के साथ authenticate करता है, जिसे Anthropic एक AnthropicAWS client के माध्यम से beta के रूप में चिह्नित करता है। एक Bedrock error को पहचानना महत्वपूर्ण है क्योंकि यह permissions की समस्या जैसा दिखता है लेकिन है नहीं: Invocation of model ID ... with on-demand throughput isn't supported. Retry your request with the ID or ARN of an inference profile that contains this model. यह model routing है, और कोई भी credential परिवर्तन इसे ठीक नहीं करेगा।
Route 3: Vertex AI पर Google credentials
Anthropic का documentation अब इस route को Claude Models on Google Cloud (Google managed) कहता है, जिसे Google अपने Agent Platform के हिस्से के रूप में चलाता है। यह Agent Platform वही है जो Vertex AI से विकसित हुआ है। नीचे दिखाए गए aiplatform.googleapis.com host, anthropic[vertex] extra और AnthropicVertex class अपरिवर्तित हैं।
Google Cloud, Application Default Credentials (ADC) का उपयोग करता है। यह एक निश्चित search order है जिसका पालन Google auth libraries करती हैं ताकि बिना नाम बताए credential ढूंढा जा सके। ADC सबसे पहले GOOGLE_APPLICATION_CREDENTIALS की जाँच करता है, फिर gcloud auth application-default login द्वारा लिखी गई file की, और अंत में metadata server के माध्यम से जुड़े service account की।
pip install -U "anthropic[vertex]"
gcloud auth application-default loginएक workstation पर login करने से $HOME/.config/gcloud/application_default_credentials.json लिखा जाता है और आपका काम पूरा हो जाता है। सर्वर पर, किसी human user के credentials को store करने से बचें; यह command service account impersonation को भी support करती है। Google Cloud के बाहर कोई Google metadata server नहीं होता, इसलिए ADC को Workload Identity Federation configuration file या service account key file की ओर point करने के लिए GOOGLE_APPLICATION_CREDENTIALS का उपयोग करें। एक service account key JSON file एक long-lived secret है और इसे इस guide में बाद में बताए गए तरीके से ही handle करना चाहिए। Google Cloud के अंदर, VM से एक service account जोड़ें और फिर किसी file को सुरक्षित रखने की आवश्यकता नहीं रहती। ADC को जो भी identity मिलती है, उसके पास ऐसी IAM role होनी चाहिए जिसमें aiplatform.endpoints.predict permission शामिल हो, जैसे कि Agent Platform User (roles/aiplatform.user)।
from anthropic import AnthropicVertex
client = AnthropicVertex(project_id="my-project", region="global")यदि आप SDK से नीचे raw HTTP पर जाते हैं, तो दो चीजें बदल जाती हैं। Model identifier request body से हटकर URL path में चला जाता है, और anthropic_version header से हटकर body में चला जाता है। 27 October 2026 तक, Anthropic का documentation वहां vertex-2023-10-16 या नए API version 2026-10-21 दोनों को स्वीकार करता है। Credential एक सामान्य Google access token होता है। नीचे दी गई command में, gcloud auth print-access-token ADC के बजाय gcloud CLI के अपने login का उपयोग करता है, इसलिए जिस machine पर आप test कर रहे हैं, वहां पहले gcloud auth login या gcloud init चलाएं।
curl https://aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/global/publishers/anthropic/models/${MODEL_ID}:rawPredict \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{"anthropic_version": "vertex-2023-10-16", "max_tokens": 64, "messages": [{"role": "user", "content": "Hello"}]}'Region एक first-class argument है। global उपलब्धता के लिए dynamically route करता है, us और eu multi-region identifiers हैं, और us-east5 जैसा नाम एक single region को pin करता है। October 2026 तक, Anthropic केवल Claude Sonnet 4.6 और उससे पहले के models के लिए single-region endpoints का documentation देता है; नए models global या multi-region endpoints का उपयोग करते हैं। October 2026 में दर्ज जानकारी के अनुसार, multi-region और regional endpoints की लागत global से 10% अधिक है। Billing Google Cloud project के माध्यम से होती है, इसलिए quota और invoices Google के होते हैं।
27 October 2026 तक, Anthropic एक दूसरी Google Cloud पेशकश का भी documentation देता है, और उसका request shape अलग है। Claude Models on Google Cloud (Anthropic managed) में, Anthropic स्वयं claude.googleapis.com पर Claude API चलाता है, जिस तक AnthropicGoogleCloud client के माध्यम से पहुँचा जाता है। यह अभी भी Google Cloud credentials (ADC सहित) के साथ authenticate करता है, लेकिन request direct API जैसी दिखती है: model body में रहता है और version anthropic-version header में जाता है। Access इसकी अपनी IAM roles (roles/claude.user और संबंधित) से मिलता है, setup project के लिए एक नया Anthropic organization बनाता है, और usage की billing Google Cloud Marketplace के माध्यम से होती है। यदि आपके request URLs में aiplatform शामिल है और वे :rawPredict पर समाप्त होते हैं, तो आप उस Google-managed route पर हैं जिसका वर्णन इस section में किया गया है।
रूट 4: Microsoft Foundry ही Azure रूट है
यदि आपने Azure पर Claude खोजा है, तो यह वही सेक्शन है जिसे आप ढूंढ रहे थे, और एक समर्थित रूट वास्तव में मौजूद है। Claude, Microsoft Foundry (पूर्व में Azure AI Foundry) में चलता है, जिसका बिलिंग Azure Marketplace के माध्यम से Claude Consumption Units में होता है। आप एक Foundry रिसोर्स बनाते हैं, उसके अंदर एक Claude मॉडल डिप्लॉय करते हैं, और https://{resource}.services.ai.azure.com/anthropic/v1/* पर Azure-होस्टेड एंडपॉइंट को कॉल करते हैं।
दो क्रेडेंशियल काम करते हैं। पहला Foundry पोर्टल में डिप्लॉयमेंट के Details टैब से प्राप्त Azure-जारी key है, जिसे api-key या x-api-key हेडर में भेजा जाता है। दूसरा Microsoft Entra टोकन है, जो सर्वर पर बेहतर विकल्प है क्योंकि Azure रोल-आधारित एक्सेस कंट्रोल यह नियंत्रित करता है कि एंडपॉइंट को कौन कॉल कर सकता है।
ACCESS_TOKEN=$(az account get-access-token --resource https://ai.azure.com --query accessToken -o tsv)
curl https://${RESOURCE}.services.ai.azure.com/anthropic/v1/messages \
-H "content-type: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "anthropic-version: 2023-06-01" \
-d '{"model": "DEPLOYMENT_NAME", "max_tokens": 64, "messages": [{"role": "user", "content": "Hello"}]}'model फ़ील्ड में आपका डिप्लॉयमेंट नाम होता है, न कि मॉडल आइडेंटिफ़ायर। डिफ़ॉल्ट रूप से दोनों समान होते हैं, और जिस क्षण आप स्वयं डिप्लॉयमेंट का नाम रखते हैं, वे अलग हो जाते हैं, जो अन्यथा सही रिक्वेस्ट पर Deployment not found एरर का सामान्य कारण है। Python और TypeScript SDKs वातावरण से ANTHROPIC_FOUNDRY_API_KEY और ANTHROPIC_FOUNDRY_RESOURCE को पढ़ते हैं। 10 नवंबर 2026 को प्रलेखित अनुसार, Foundry सपोर्ट सभी सात आधिकारिक SDKs को कवर करता है: C#, Go, Java, PHP, Python, Ruby और TypeScript। Go एक समर्पित foundry पैकेज (go get github.com/anthropics/anthropic-sdk-go/v2/foundry) का उपयोग करता है, और Ruby को 4 नवंबर 2026 को जारी gem के वर्ज़न 2.5.0 में एक समर्पित Anthropic::FoundryClient मिला। उस रिलीज़ से पहले, Ruby कोड को जेनेरिक क्लाइंट को Foundry बेस URL पर पॉइंट करना पड़ता था।
जेनेरिक क्लाइंट को Foundry बेस URL पर पॉइंट करने में अभी भी जोखिम है, चाहे वह 2.5.0 से पहले लिखा गया Ruby कोड हो या ant CLI, जिसे Anthropic के अपने Foundry उदाहरण उसी तरह कॉल करते हैं। यदि आप जेनेरिक क्लाइंट को स्पष्ट रूप से क्रेडेंशियल पास नहीं करते हैं और वातावरण में ANTHROPIC_API_KEY या ANTHROPIC_AUTH_TOKEN सेट है, तो क्लाइंट उसे उठा लेता है और आपके Anthropic क्रेडेंशियल को Microsoft एंडपॉइंट पर भेज देता है। वेरिएबल को अनसेट करें, या क्लाइंट को Foundry key या टोकन स्पष्ट रूप से पास करें। Ruby में, Anthropic::FoundryClient पर जाना, जो Foundry key या Entra टोकन प्रदाता लेता है, एक बेहतर समाधान है। Entra एक्सेस टोकन का डिफ़ॉल्ट जीवनकाल 60 से 90 मिनट का होता है, इसलिए लंबे समय तक चलने वाली प्रोसेस को इसे शुरू में कैप्चर करने के बजाय रिफ्रेश करना पड़ता है।
आपके सर्वर पर क्रेडेंशियल कितने समय तक सक्रिय रहता है?
इस चार्ट के पीछे का डेटा
[
{
"label": "Anthropic key, 30-day preset",
"max_lifetime_hours": 720
},
{
"label": "Anthropic key, 7-day preset",
"max_lifetime_hours": 168
},
{
"label": "AWS STS assumed role",
"max_lifetime_hours": 12
},
{
"label": "Bedrock short-term API key",
"max_lifetime_hours": 12
},
{
"label": "Entra ID access token, default upper bound",
"max_lifetime_hours": 1.5
},
{
"label": "Federated Anthropic token, default",
"max_lifetime_hours": 1
}
]ये प्रत्येक प्रदाता द्वारा प्रकाशित अधिकतम सीमाएं और डिफ़ॉल्ट मान हैं जिन्हें अक्टूबर 2026 में पढ़ा गया था, न कि मापे गए आंकड़े। ये एक कारण से महत्वपूर्ण हैं: ये आपको बताते हैं कि लीक हुआ क्रेडेंशियल तब तक कितने समय तक काम करता रहेगा जब तक आप यह पता लगा रहे हैं कि वह लीक हो गया है। चार्ट के नीचे दिया गया फेडरेटेड Anthropic टोकन डिफ़ॉल्ट रूप से 1 घंटे तक चलता है, जो आइडेंटिटी प्रदाता के टोकन के शेष जीवनकाल के दोगुने तक सीमित होता है। Microsoft Entra एक्सेस टोकन का कोई एक डिफ़ॉल्ट मान नहीं है: Microsoft प्रत्येक को 60 से 90 मिनट के बीच (औसतन 75) का यादृच्छिक जीवनकाल देता है, जिसे चार्ट में इसकी 1.5 घंटे की ऊपरी सीमा पर दिखाया गया है, और यह डिफ़ॉल्ट क्लाइंट, संसाधन और इस बात पर भी निर्भर करता है कि टेनेंट में Conditional Access सक्षम है या नहीं। जब क्लाइंट और संसाधन दोनों Continuous Access Evaluation का समर्थन करते हैं, तो Entra जीवनकाल को 24 से 28 घंटे तक बढ़ा सकता है और खाता अक्षम होने जैसी घटनाओं पर टोकन को लगभग वास्तविक समय में रद्द कर सकता है। एक टेनेंट टोकन जीवनकाल नीति इसे 10 मिनट से 23:59:59 तक कहीं भी सेट कर सकती है। SDKs फेडरेटेड Anthropic टोकन को स्वचालित रूप से रिफ्रेश करते हैं; Foundry पर, एक निश्चित टोकन स्ट्रिंग पास करने के बजाय टोकन को रिफ्रेश करने के लिए Entra टोकन प्रदाता को कॉन्फ़िगर करें। एक फेडरेशन नियम अपना टोकन जीवनकाल एक मिनट से 24 घंटे तक कहीं भी सेट कर सकता है, और कंसोल का Connect वर्कलोड विज़ार्ड 10 मिनट पहले से भर देता है, इसलिए डिफ़ॉल्ट मान मानने के बजाय नियम को पढ़ें। एक अस्यूम्ड रोल (assumed role) और Bedrock शॉर्ट-टर्म API की (API key) दोनों 12 घंटों पर स्थित हैं। Bedrock लॉन्ग-टर्म API की का चार्ट पर कोई स्थान नहीं है क्योंकि इसकी कोई निश्चित ऊपरी सीमा नहीं है: यह निर्माण के समय चुनी गई समाप्ति तिथि तक चलता है, या यदि API कॉल से CredentialAgeDays को हटा दिया गया था तो यह समाप्त नहीं होता है, यही कारण है कि AWS इसे केवल अन्वेषण (exploration) के लिए उपयोग करने की सलाह देता है। 30-दिन के प्रीसेट के साथ बनाई गई एक की 720 घंटों तक वैध रहती है, और यही वह क्रेडेंशियल है जो एक महीने तक आपके सर्वर पर एक फाइल में रहता है।
VPS पर क्रेडेंशियल कहाँ रखें
सीक्रेट को ऐसी फाइल में रखें जिसे केवल root पढ़ सके, और systemd को इसे प्रोसेस तक पहुँचाने दें। यह तरीका हर SDK वर्जन से स्वतंत्र है, इसलिए इसे एक बार सही ढंग से करना फायदेमंद है।
sudo useradd --system --home /opt/claude-app --shell /usr/sbin/nologin claudeapp
sudo install -d -m 700 -o root -g root /etc/claude-app
sudo install -m 600 -o root -g root /dev/null /etc/claude-app/env
sudoedit /etc/claude-app/envफाइल में सादी KEY=value लाइनें होती हैं। इसमें कोई export, कोई कोट्स, और कोई शेल सिंटैक्स न रखें, क्योंकि systemd इसे शेल के माध्यम से चलाने के बजाय खुद पार्स करता है।
ANTHROPIC_API_KEY=sk-ant-api03-REPLACE-ME
CLAUDE_MODEL=REPLACE-ME[Unit]
Description=Claude API service
After=network-online.target
[Service]
User=claudeapp
EnvironmentFile=/etc/claude-app/env
ExecStart=/opt/claude-app/venv/bin/python -m claude_app
Restart=on-failure
[Install]
WantedBy=multi-user.targetsystemd, User=claudeapp पर स्विच होने से पहले root के रूप में EnvironmentFile= को पढ़ता है, इसलिए सर्विस अकाउंट को फाइल के लिए रीड एक्सेस की आवश्यकता नहीं होती। root के स्वामित्व वाली Mode 600 फाइल पर्याप्त है, इसीलिए ऊपर दिया गया install कमांड इसे इस तरह सेट करता है। इसे sudo systemctl enable --now claude-app से शुरू करें, फिर systemctl status claude-app के साथ पुष्टि करें कि यूनिट active (running) तक पहुँच गई है, न कि लूप में रीस्टार्ट हो रही है।
चार चीजें जिनसे बचें, प्रत्येक का कारण आप स्वयं जाँच सकते हैं:
- यूनिट फाइल के अंदर
Environment=के साथ की (key) न लिखें।/etc/systemd/systemके अंतर्गत यूनिट सभी के लिए रीडेबल होती है, इसलिएsystemctl cat claude-appकिसी भी लोकल यूजर को सीक्रेट दिखा सकता है। - इसे कमिट न करें।
.gitignoreएक नई फाइल को कमिट से बाहर रखता है, लेकिन पहले से कमिट की गई फाइल के लिए कुछ नहीं करता, क्योंकि git हिस्ट्री उसे दी गई हर चीज को सुरक्षित रखती है। - इसे कंटेनर इमेज में न डालें।
ENVवैल्यू इमेज कॉन्फ़िगरेशन में बनी रहती हैं, और बिल्ड आर्गुमेंट्स इमेज हिस्ट्री या प्रोवेनेंस मेटाडेटा में दिखाई देते हैं। बाद की लेयर में फाइल डिलीट करने से वह पिछली लेयर से नहीं हटती। सीक्रेट्स को रन टाइम पर--env-fileया माउंट की गई फाइल के जरिए पास करें। - प्रोसेस एनवायरनमेंट को root से निजी न मानें।
sudo cat /proc/$(pgrep -u claudeapp -f claude_app | head -1)/environ | tr '\0' '\n'की (key) को वापस प्रिंट कर देता है। फाइल-रीडिंग कमांड को स्वयंsudoकी आवश्यकता होती है; शेल इनपुट रीडायरेक्शनsudoसे पहले चलता है और आपके वर्तमान अकाउंट की अनुमतियों का उपयोग करता है। लक्ष्य सीक्रेट को बॉक्स पर मौजूद हर दूसरे अकाउंट से दूर रखना है, न कि root से, जो आपके कुछ भी करने पर इसे पढ़ सकता है।
यह अंतिम बिंदु उस सीमा को निर्धारित करता है जो यह डिज़ाइन आपको प्रदान करता है। केवल-root वाली फाइल स्टोर्ड की (key) की सुरक्षा करती है, लेकिन सर्विस अकाउंट के रूप में चलने वाला कोई भी कोड प्रोसेस एनवायरनमेंट को पढ़ सकता है, और चाइल्ड प्रोसेस इसे इनहेरिट करते हैं। जब प्रोसेस ऐसा कोड चलाता है जिसे आपने नहीं लिखा है, तो यह गलत कंटेनर है, क्योंकि प्रोसेस जो कुछ भी निष्पादित कर सकता है वह अपने स्वयं के एनवायरनमेंट को पढ़ सकता है। सीक्रेट्स को AI एजेंट की पहुँच से दूर रखना इस मामले को कवर करता है, जो एक अलग समस्या है और जिसका उत्तर भी अलग है।
बिना डाउनटाइम के की (key) को रोटेट कैसे करें?
आगे की ओर रोटेट करें और पिछली की को रद्द (revoke) करें। नीचे दिया गया सिंगल-सर्विस रीस्टार्ट संक्षिप्त रूप से सर्विस को बाधित करता है; निर्बाध उपलब्धता के लिए रीस्टार्ट के दौरान अनुरोधों को संभालने हेतु एक अन्य इंस्टेंस की आवश्यकता होती है।
- कंसोल में, पुरानी की वाले वर्कस्पेस में ही नई की बनाएँ।
- इसे
/etc/claude-app/envमेंsudoeditके साथ लिखें। sudo systemctl restart claude-appचलाएँ।- पुष्टि करें कि सर्विस अनुरोधों का उत्तर दे रही है, फिर कंसोल में पुरानी की को रद्द कर दें।
EnvironmentFile को यूनिट शुरू होने पर पढ़ा जाता है, इसलिए एक रनिंग प्रोसेस उसी वैल्यू को बनाए रखती है जो उसे लॉन्च के समय दी गई थी। systemctl daemon-reload यूनिट फाइलों को फिर से पढ़ता है और रनिंग प्रोसेस के एनवायरनमेंट को नहीं छूता है, इसलिए केवल रीस्टार्ट ही नई की को लागू करता है। चरण 4 के बजाय चरण 1 में रद्द करने से आप एक आउटेज को आमंत्रित करते हैं जो चरण 3 तक बना रहता है।
क्लाउड रूट्स प्रोवाइडर स्तर पर रोटेट होते हैं। एक IAM यूजर एक साथ दो सक्रिय एक्सेस की (access keys) का समर्थन करता है, इसलिए दूसरी की बनाएँ, उसे डिप्लॉय करें, फिर पहली को हटा दें। Google सर्विस अकाउंट की भी इसी तरह रोटेट होती है। एक Foundry रिसोर्स में दो की होती हैं, और एक को रीजेनरेट करने से उसकी पुरानी वैल्यू तुरंत काम करना बंद कर देती है, इसलिए जिस की का सर्विस उपयोग कर रही थी उसे रीजेनरेट करने से पहले सर्विस को दूसरी की पर ले जाएँ। Entra टोकन और फेडरेटेड Anthropic टोकन को मैन्युअल टोकन रोटेशन की आवश्यकता नहीं होती है, और जहाँ संभव हो वहाँ इनका उपयोग करना सबसे मजबूत तर्क है।
जब आप कंसोल में हों, तो वर्कस्पेस पर खर्च की सीमा (spend limit) निर्धारित करें। लीक हुई की किसी भी अन्य समस्या से पहले महंगी साबित होती है, और VPS पर एजेंट कितना खर्च कर सकता है, इसकी सीमा तय करना उन कंट्रोल्स के बारे में विस्तार से बताता है।
मेरा client 401 या 403 error क्यों देता है?
Direct API पर authentication_error के साथ 401 error। key गलत है, रद्द कर दी गई है, या उसकी समय-सीमा समाप्त हो चुकी है। लोग अक्सर expiry को नजरअंदाज कर देते हैं, क्योंकि code में कोई बदलाव नहीं हुआ होता और request कल तक काम कर रही थी। Console में key के expiry column की जाँच करें, या Admin API से expires_at पढ़ें, जहाँ बिना expiry वाली keys के लिए यह null होता है। जब किसी personal key का मालिक संगठन छोड़ देता है, तो वह key भी काम करना बंद कर देती है।
SDK आपके federation setup को अनदेखा करके key का उपयोग करता है। credential प्राथमिकता क्रम में ANTHROPIC_API_KEY और ANTHROPIC_AUTH_TOKEN, federation से ऊपर होते हैं, इसलिए इनमें से कोई भी उसे shadow कर सकता है। इसका एक सटीक उदाहरण यह है: एक variable जिसे empty string के रूप में export किया गया है, वह भी अपनी जगह घेरता है, इसलिए ANTHROPIC_API_KEY="" SDK को fall through करने के बजाय एक empty key के साथ authenticate करने के लिए मजबूर करता है। unset ANTHROPIC_API_KEY का उपयोग करें।
Federation पर Authentication failed संदेश के साथ 401 error। यह संदेश जानबूझकर हर संभावित कारण के लिए एक जैसा रखा गया है, ताकि कोई caller error text पढ़कर आपके rule configuration का पता न लगा सके। वास्तविक कारण Console में authentication history page पर दर्ज होता है। JWT के बारे में अनुमान लगाने के बजाय वहीं से शुरुआत करें।
Foundry पर 403 error। token authenticate हो गया है, लेकिन आपके Azure account में ऐसी कोई role नहीं है जो उस call की अनुमति दे। request करने वाली identity को Azure RBAC role जैसे कि Foundry User (पूर्व में Azure AI User) या Cognitive Services User असाइन करें।
Bedrock पर कोई भी error। SigV4 authentication के लिए, पहले service user के रूप में aws sts get-caller-identity चलाएँ। यह बताता है कि क्या machine के पास उपयोग करने योग्य AWS credentials हैं या नहीं, जो credential की समस्या को model access की समस्या या region mismatch से अलग करता है। 29 October 2026 तक, AWS आवश्यक AWS Marketplace अनुमतियों के साथ commercial regions में पहली बार उपयोग करने पर कई models तक पहुँच सक्षम करता है, लेकिन कुछ models के लिए अलग से account-level access की आवश्यकता होती है। InvokeModel route के माध्यम से call किए जाने वाले Anthropic models के लिए प्रति account एक बार use case form की आवश्यकता होती है (या पूरे AWS Organization के लिए एक बार, हालाँकि opt-in regions में इसकी फिर से आवश्यकता होती है), और जब तक यह clear नहीं होता, call AccessDeniedException लौटाती है। AWS के दस्तावेज़ों के अनुसार यह form bedrock-mantle endpoint पर लागू नहीं होता है। किसी account में model की पहली call Bedrock को background में AWS Marketplace subscription शुरू करने के लिए भी प्रेरित करती है, और उस subscription के लिए ऐसी identity की आवश्यकता होती है जिसके पास aws-marketplace:Subscribe, aws-marketplace:Unsubscribe और aws-marketplace:ViewSubscriptions अनुमतियाँ हों। अनुमतियों की कमी के कारण पहली call जरूरी नहीं कि विफल ही हो: AWS के दस्तावेज़ों के अनुसार, subscription सेट अप होने के दौरान calls 15 मिनट तक सफल हो सकती हैं, और एक बार subscription विफल हो जाने पर, बाद की calls वही AccessDeniedException लौटाती हैं। यदि कोई service पहले कुछ मिनटों तक काम करती है और फिर विफल होने लगती है, तो समस्या credentials के बजाय यहीं होती है। अनुमतियाँ देने के बाद, AWS subscription पूरा होने के लिए 2 मिनट तक का समय लेता है। यदि कोई model उस region में उपलब्ध नहीं है जिसे आप call कर रहे हैं, तो credentials कितने भी सही क्यों न हों, call विफल हो जाएगी।
FAQ
क्या Bedrock या Vertex पर Claude का उपयोग करने के लिए मुझे Anthropic API key की आवश्यकता है?
नहीं। Amazon Bedrock पर SDK, SigV4 का उपयोग करके AWS credentials के साथ requests को sign करता है या Bedrock API key भेजता है। Google Cloud पर, यह Application Default Credentials के माध्यम से प्राप्त Google access token भेजता है। इन दोनों सेटअप में Anthropic द्वारा जारी कोई secret नहीं होता है, और उपयोग का बिल Anthropic के बजाय cloud account पर आता है। यही कारण है कि ANTHROPIC_API_KEY में छोड़ी गई Anthropic key उन hosts पर एक खतरा है: cloud endpoint पर पॉइंट किया गया एक सामान्य client उसे खुशी-खुशी वहाँ भेज देगा।
क्या Claude Azure पर उपलब्ध है?
हाँ, Microsoft Foundry (जिसे पहले Azure AI Foundry कहा जाता था) के माध्यम से। आप एक Foundry resource बनाते हैं, उसमें एक Claude model deploy करते हैं, और https://{resource}.services.ai.azure.com/anthropic/v1/messages को या तो Azure द्वारा जारी key के साथ api-key header में, या Microsoft Entra bearer token के साथ कॉल करते हैं। उपयोग का बिल Azure Marketplace के माध्यम से Claude Consumption Units में आता है। request body में model field में आपका deployment name होना चाहिए। यह model identifier से केवल तभी मेल खाता है यदि आपने deployment बनाते समय default name रखा हो; deployment के बाद नाम बदला नहीं जा सकता।
मुझे Linux सर्वर पर Claude API key कहाँ store करनी चाहिए?
इसे root के स्वामित्व वाली और 600 mode वाली एक file में रखें, जिसे systemd unit में EnvironmentFile= के माध्यम से load किया जाए। systemd unit के User= पर स्विच करने से पहले ही root के रूप में उस file को पढ़ लेता है, इसलिए service account को उस तक पहुँच की आवश्यकता नहीं होती। इसे repository से बाहर रखें, unit file (जो world readable होती है और systemctl cat द्वारा print की जाती है) से बाहर रखें, और container image configuration, layers तथा build metadata से भी दूर रखें।
मेरी Claude API request ने 401 error देना क्यों शुरू कर दिया, जबकि कुछ भी नहीं बदला?
जो key बनाए जाते समय निर्धारित expiry तक पहुँच जाती है, वह 401 error देती है। Expiry creation के समय सेट की जाती है, जिसे बाद में edit नहीं किया जा सकता, और अल्पकालिक (short-lived) keys बिना किसी चेतावनी ईमेल के expire हो जाती हैं। एक expired key को reactivate नहीं किया जा सकता, इसलिए एक नई key बनाएँ, उसे environment file में लिखें, service को restart करें, और उसके बाद पुरानी key को revoke कर दें। यदि key निश्चित रूप से current है, तो जाँचें कि कोई पुरानी credential उसे shadow तो नहीं कर रही है: खाली string पर सेट ANTHROPIC_API_KEY, उसके नीचे मौजूद federation और profile sources पर प्राथमिकता ले लेती है।