ตั้งค่า Claude API ด้วย key, Bedrock, Vertex และ Foundry
คู่มือยืนยันตัวตน Claude API บน VPS ด้วย Anthropic key, AWS IAM, Google ADC หรือ Microsoft Entra พร้อมแนวทางเก็บ credential ฝั่งเซิร์ฟเวอร์อย่างปลอดภัย
เส้นทางการยืนยันตัวตนของ Claude API
การยืนยันตัวตนของ Claude API ขึ้นอยู่กับการตัดสินใจเพียงเรื่องเดียว คือข้อมูลประจำตัว (credential) ที่ไคลเอนต์ของคุณส่งผ่านเครือข่าย Anthropic ระบุช่องทางการใช้งาน Claude API โดยตรงและผ่านแพลตฟอร์มคลาวด์อีก 5 แห่ง ได้แก่ Amazon Bedrock, Claude Platform on AWS, Claude Models on Google Cloud (จัดการโดย Google), Claude Models on Google Cloud (จัดการโดย Anthropic) และ Microsoft Foundry โดย Anthropic API แบบโดยตรงจะรับ API key หรือ token อายุสั้นใน header Authorization: Bearer และยังคงรองรับ API key ใน header แบบเดิมคือ x-api-key ส่วน Amazon Bedrock รองรับการลงลายมือชื่อคำขอ AWS และ Bedrock API key โดยไม่มีการใช้ Anthropic key ในการตั้งค่านี้ สำหรับ Google Cloud จะใช้ Google access token อายุสั้น ส่วน Microsoft Foundry จะใช้ key ที่ออกโดย Azure หรือ Microsoft Entra token ทั้ง 4 ส่วนด้านล่างนี้จะครอบคลุมการตั้งค่าข้อมูลประจำตัวเหล่านี้ โดยมีการอธิบายบริการ AWS และ Google Cloud ที่จัดการโดย Anthropic แยกต่างหากควบคู่ไปกับบริการหลักของคลาวด์นั้นๆ
คู่มือนี้มีไว้สำหรับการเชื่อมต่อ SDK (software development kit) เข้ากับบริการที่ทำงานบนเซิร์ฟเวอร์ Linux หากคุณกำลังตั้งค่าเครื่องมือบรรทัดคำสั่ง Claude Code ตัวแปรและขั้นตอนการทำงานจะแตกต่างออกไป โปรดดู การชี้ Claude Code ไปที่ Bedrock หรือ Vertex หากบริการยังไม่มีอยู่ ให้สร้างขึ้นก่อนด้วย แอป Claude API แอปแรกบน VPS แล้วจึงกลับมาที่นี่เพื่อตั้งค่าข้อมูลประจำตัว
ข้อมูลทั้งหมดด้านล่างได้รับการตรวจสอบกับเอกสารแพลตฟอร์มของ Anthropic ในเดือนสิงหาคม 2026 และตรวจสอบซ้ำกับเอกสารของผู้ให้บริการแต่ละรายเมื่อวันที่ 16 ตุลาคม 2026 ส่วนรายละเอียดการเข้าถึงโมเดล Bedrock ได้รับการตรวจสอบซ้ำกับเอกสารของ AWS เมื่อวันที่ 19 ตุลาคม 2026 หน้าเว็บของ Anthropic สำหรับทั้ง 4 เส้นทาง รวมถึง API key และเวอร์ชันของ API ได้รับการตรวจสอบซ้ำเมื่อวันที่ 27 ตุลาคม 2026 หน้าเว็บของ Anthropic สำหรับ Microsoft Foundry, endpoint ของ Bedrock ทั้งสองแห่ง, เส้นทางที่จัดการโดย Google, Claude Platform on AWS, การยืนยันตัวตน, Workload Identity Federation และเวอร์ชันของ API ได้รับการตรวจสอบซ้ำเมื่อวันที่ 10 พฤศจิกายน 2026 พร้อมกับบันทึกการเปลี่ยนแปลงของ Ruby SDK เนื่องจากตัวระบุโมเดล ราคา เวอร์ชัน SDK และรูปแบบของ endpoint มีการเปลี่ยนแปลงอยู่เสมอ คู่มือนี้จึงเชื่อมโยงไปยังหน้าเว็บของผู้ให้บริการแทนการระบุค่าที่อาจล้าสมัย
เส้นทางที่ 1: Anthropic API key
นี่คือเส้นทางโดยตรง และเป็นเส้นทางเดียวที่ Anthropic เป็นผู้ออก secret คำขอจะส่งไปยัง Messages endpoint บน API host ของ Anthropic และทุกคำขอจะมี header 3 รายการ
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 ด้วย identifier ปัจจุบันจาก models overview ของ Anthropic หากทำงานปกติ response จะเป็น JSON ที่มี array content และ object usage หาก key ไม่ถูกต้องหรือหมดอายุ จะได้ HTTP 401 พร้อม authentication_error หากไม่มี header anthropic-version จะเป็นความผิดพลาดอีกกรณีหนึ่ง เพราะ header นี้จำเป็นสำหรับทุกคำขอ โดย SDK จะกำหนดให้โดยอัตโนมัติ ณ เดือน October 2026 เอกสารของ Anthropic ระบุว่า Authorization: Bearer เป็นวิธีหลักในการส่ง key และเรียก x-api-key ว่าเป็นแบบ legacy แต่ทั้งสองแบบยังใช้งานได้ ดังนั้นคำสั่งข้างต้นจึงยังใช้ได้ SDK major version ปัจจุบันจะส่ง key เป็น Authorization: Bearer เช่นกัน ดังนั้น proxy หรือ gateway ที่อ่าน X-Api-Key จะต้องแก้ไขเมื่ออัปเกรด 2023-06-01 ในคำสั่งยังคงใช้งานได้ ส่วน API version ล่าสุดของ Anthropic คือ 2026-10-21 ซึ่ง SDK version เหล่านั้นจะส่งเป็นค่าเริ่มต้น และจะปฏิเสธ request parameter รุ่นเก่าบางรายการ เช่น temperature
การสร้าง client เป็นการตั้งค่าที่สั้นที่สุดในบรรดาวิธีเหล่านี้ เพราะไม่มีสิ่งใดที่ต้องสร้าง SDK อย่างเป็นทางการทุกตัวจะอ่าน ANTHROPIC_API_KEY จาก environment ให้เอง
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)ควรกำหนด model identifier ไว้ใน environment ร่วมกับ key ชื่อ model มีการเปลี่ยนแปลงตามกำหนดเวลาที่คุณควบคุมไม่ได้ ดังนั้นการ deploy code ใหม่เพื่อแก้ไข string เพียงรายการเดียวจึงเป็นงานที่หลีกเลี่ยงได้
สร้าง key ใน Console โดยเลือกระยะเวลาหมดอายุตั้งแต่ตอนสร้าง ได้แก่ preset 3 hours, 1 day, 7 days หรือ 30 days, ระยะเวลาแบบกำหนดเอง หรือ Never ทั้งนี้ขึ้นอยู่กับนโยบายระยะเวลาหมดอายุสูงสุดขององค์กร กำหนดวันหมดอายุแล้วจะไม่สามารถเปลี่ยนแปลงภายหลังได้ Anthropic จะส่งอีเมลแจ้งผู้สร้าง key ก่อนที่ key อายุยาวจะหมดอายุ แต่ key ที่มีอายุสั้นจะหมดอายุโดยไม่มีอีเมลแจ้งเตือนเลย key ที่หมดอายุจะตอบกลับด้วย 401 และไม่สามารถเปิดใช้งานอีกครั้งได้ ดังนั้นวิธีแก้มีเพียงสร้าง key ใหม่
Direct API ไม่มี region ให้เลือก และค่าใช้จ่ายจะเรียกเก็บโดยตรงจาก Anthropic organization ของคุณ Workspaces จะกำหนดขอบเขตของ key ให้อยู่ใน project เดียว ซึ่งเป็นวิธีที่ชัดเจนที่สุดในการดูว่าบริการหนึ่งมีค่าใช้จ่ายเท่าใด ควรกำหนดขอบเขต key ของ server ให้อยู่ใน workspace ตั้งแต่ตอนสร้าง หาก key ของ personal account หรือ service account ไม่ได้กำหนดขอบเขตไว้ใน workspace จะต้องส่ง header anthropic-workspace-id ไปกับทุกคำขอ มิฉะนั้น API จะตอบกลับ 400 พร้อม invalid_request_error สำหรับ service ควรเลือก service account key เพราะ personal key จะหยุดทำงานเมื่อบุคคลที่สร้าง key ออกจากองค์กร สำหรับรายละเอียดการคำนวณค่าใช้จ่าย โปรดดู การเปรียบเทียบราคาของ API แบบต่อ token กับ subscription
มีอีกทางเลือกหนึ่งที่ควรกล่าวถึง เพราะช่วยตัด static secret ออกทั้งหมด Workload Identity Federation ช่วยให้ workload นำ OpenID Connect (OIDC) token จาก identity provider ที่คุณเชื่อถืออยู่แล้ว มาแลกเป็น Anthropic token อายุสั้นที่ POST /v1/oauth/token และ SDK จะ refresh token ก่อนหมดอายุ จะไม่มีการสร้างหรือคัดลอก string sk-ant-api... ไว้ที่ใดเลย วิธีนี้เหมาะกับ Kubernetes, GitHub Actions และ cloud VM ซึ่งมี platform identity อยู่แล้ว โดยทั่วไป VPS ธรรมดาจะไม่มี issuer ดังกล่าว ดังนั้นบนเครื่องนั้นการเก็บ API key ไว้ในไฟล์จึงเป็นทางเลือกที่ตรงไปตรงมา และคู่มือนี้จะถือว่าใช้วิธีดังกล่าวสำหรับส่วนที่เหลือ
เส้นทางที่ 2: การใช้ AWS credentials บน Amazon Bedrock
บน Bedrock คุณไม่จำเป็นต้องใช้ Anthropic key เลย เมื่อใช้ AWS credentials ตัว SDK จะลงนามในแต่ละ HTTP request ด้วย AWS Signature Version 4 (SigV4) และ AWS จะเป็นผู้ตัดสินใจว่าผู้เรียกรายนั้นได้รับอนุญาตให้เรียกใช้โมเดลหรือไม่
pip install -U "anthropic[bedrock]"
aws sts get-caller-identityaws sts get-caller-identity จะแสดงหมายเลขบัญชีและ ARN (Amazon Resource Name) ของตัวตนที่ credentials ของคุณอ้างอิงถึง ให้รันคำสั่งนี้ก่อนดำเนินการอื่นใดเมื่อใช้ SigV4 สำหรับ SigV4 นั้น SDK จะตรวจสอบ credentials จาก constructor, environment variables และ AWS credential chain มาตรฐาน ส่วนการเลือก region จะแยกต่างหาก ในไคลเอนต์ AnthropicBedrock ของ Python หากคุณระบุ Bedrock API key ผ่าน api_key หรือ AWS_BEARER_TOKEN_BEDROCK จะเกิดข้อผิดพลาด ValueError หากคุณส่งค่า aws_access_key, aws_secret_key, aws_session_token หรือ aws_profile ไปด้วย หากไม่มีอาร์กิวเมนต์เหล่านั้น คีย์จะเลือกใช้ bearer authentication แทน AWS credential chain ส่วนไคลเอนต์ TypeScript จะให้ความสำคัญกับ Bedrock API key เหนือกว่า AWS credentials ที่ระบุไว้ชัดเจน และคำสั่ง STS จะไม่ทดสอบ bearer authentication
สิ่งที่เปลี่ยนไปในการสร้างไคลเอนต์คือคลาสและอาร์กิวเมนต์หนึ่งตัว
from anthropic import AnthropicBedrock
client = AnthropicBedrock(aws_region="us-east-1")AnthropicBedrock ทำหน้าที่จัดการการเชื่อมต่อ InvokeModel ของ Bedrock ณ เดือนตุลาคม 2026 Anthropic ได้จัดทำเอกสารเกี่ยวกับ Claude in Amazon Bedrock ซึ่งเป็น Messages API endpoint ที่ https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages สำหรับ Claude Opus 4.7 และรุ่นใหม่กว่า โดยเรียกผ่านไคลเอนต์ AnthropicBedrockMantle จากแพ็กเกจเดียวกัน ซึ่งรองรับทั้ง AWS credentials และ Bedrock bearer tokens โดยข้อกำหนดในการเข้าถึงโมเดลจะแตกต่างกันไปในแต่ละ endpoint ตามที่อธิบายไว้ด้านล่าง
โปรดสังเกตการอัปเกรดในบรรทัด pip install -U ณ วันที่ 27 ตุลาคม 2026 SDK รุ่นล่าสุดจะส่ง API version 2026-10-21 เป็นค่าเริ่มต้น รวมถึงการส่งผ่าน Bedrock ด้วย และ Anthropic ระบุว่า model ID ที่ระบุเวอร์ชันด้วย ARN สำหรับ Claude Opus 4.6 และรุ่นก่อนหน้า ไม่รองรับเวอร์ชันดังกล่าวบน Bedrock และอาจส่งคืนข้อผิดพลาด 400 หากบริการของคุณเรียกใช้โมเดลเหล่านั้น ให้คงเวอร์ชัน SDK ที่ใช้งานอยู่ในปัจจุบันไว้และล็อกเวอร์ชัน (pin) หรือย้ายบริการไปใช้โมเดล Claude 4.7 หรือใหม่กว่าก่อน
ในกรณีนี้ region ไม่ใช่แค่ข้อมูลประกอบ แต่ Bedrock endpoint จะแยกตาม region และโมเดล Claude ที่ให้บริการในแต่ละ region ก็แตกต่างกัน อีกทั้ง region ยังเป็นส่วนหนึ่งของลายเซ็น SigV4 ดังนั้นลายเซ็นที่คำนวณสำหรับ region หนึ่งจะถูกปฏิเสธโดยอีก region หนึ่ง ให้ตั้งค่า AWS_REGION ไว้ใน environment ของบริการอย่างชัดเจน เนื่องจาก SDK แต่ละตัวมีพฤติกรรมต่างกันเมื่อไม่ได้ระบุค่านี้ ตามเอกสาร ณ เดือนตุลาคม 2026 ไคลเอนต์ AnthropicBedrock ของ Python จะอ่านค่าจาก AWS_REGION หรือ AWS_DEFAULT_REGION จากนั้นจึงอ่าน region จาก boto3 session หรือ AWS profile ของคุณ (รวมถึง ~/.aws/config) และจะแจ้งข้อผิดพลาด ValueError หากไม่พบค่าใดเลย ส่วนไคลเอนต์ TypeScript จะอ่านค่าจาก AWS_REGION และใช้ us-east-1 เป็นค่าสำรองเมื่อไม่ได้ตั้งค่าไว้ แต่จะไม่ตรวจสอบ ~/.aws/config สำหรับ region นี่คือเหตุผลที่ AWS CLI สามารถแสดงรายการโมเดล Claude ได้สำเร็จบนเครื่องเดียวกับที่ Node process เรียกใช้ผิด region เพราะ CLI อ่านไฟล์ config ของคุณในขณะที่ไคลเอนต์ไม่ได้อ่าน
บน EC2 instance คุณสามารถแนบ IAM (identity and access management) role ได้โดยไม่ต้องมี secret ใดๆ เก็บไว้บนดิสก์ เนื่องจาก instance metadata service จะส่งมอบ temporary credentials ให้กับ SDK ส่วน VPS ที่อยู่นอก AWS จะไม่มีทั้ง instance role และ metadata service คุณจึงต้องเลือกระหว่างการใช้ access key pair ระยะยาวของ IAM user ที่เก็บไว้บนเครื่อง ซึ่งถือเป็น secret ประเภทเดียวกับ Anthropic key หรือการใช้ federation: คือการยืนยันตัวตนกับ identity provider ของคุณ จากนั้นเรียกใช้ AWS STS (security token service) และใช้ temporary credentials ที่ได้รับมา Bedrock ยังรองรับ Bedrock API keys ซึ่งเป็น bearer tokens ที่ส่งผ่าน AWS_BEARER_TOKEN_BEDROCK โดย AWS มีเอกสารระบุไว้สองประเภท: คีย์ระยะสั้น (short-term key) มีอายุสูงสุด 12 ชั่วโมง หรือตามระยะเวลาของ session ที่สร้างขึ้น (แล้วแต่ระยะเวลาใดสั้นกว่า) โดยจะได้รับสิทธิ์ตาม IAM identity ที่สร้างมันขึ้นมา ซึ่งเป็นประเภทที่ AWS แนะนำสำหรับ production ส่วนคีย์ระยะยาว (long-term key) จะมีอายุจนถึงวันที่คุณกำหนดเมื่อสร้าง (เช่น 30 หรือ 90 วันด้วย --credential-age-days) หรือไม่มีวันหมดอายุหากละเว้นพารามิเตอร์ API นั้น โดย Console จะสร้าง IAM user เบื้องหลังคีย์นี้ ซึ่ง AWS แนะนำให้ใช้สำหรับการทดสอบเท่านั้น คีย์ระยะยาวจะทำงานได้เฉพาะใน region ที่สร้างขึ้นมาเท่านั้น การนำไปใช้ใน region อื่นจะส่งคืนข้อผิดพลาด Credential should be scoped to a valid region
ค่าใช้จ่ายจะถูกเรียกเก็บไปยังบัญชี AWS ของคุณแทนที่จะเป็น Anthropic ซึ่งมักเป็นเหตุผลหลักในการใช้งานที่นี่ Regional endpoints จะมีค่าธรรมเนียมเพิ่มขึ้น 10% เมื่อเทียบกับ global endpoint ตามเอกสาร ณ เดือนตุลาคม 2026 ส่วน Claude Platform on AWS เป็นผลิตภัณฑ์แยกต่างหาก: Anthropic เป็นผู้ดำเนินการ AWS เป็นผู้เรียกเก็บเงินผ่าน AWS Marketplace และยืนยันตัวตนด้วย SigV4 หรือ API key ที่สร้างใน AWS Console (คีย์จาก Claude Console จะใช้ที่นี่ไม่ได้) ผ่านไคลเอนต์ AnthropicAWS ซึ่ง Anthropic ระบุว่าเป็นรุ่นเบต้า มีข้อผิดพลาดหนึ่งของ Bedrock ที่ควรทราบเพราะดูเหมือนปัญหาเรื่องสิทธิ์แต่ไม่ใช่: 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 จะไม่ช่วยแก้ไขปัญหานี้
เส้นทางที่ 3: ข้อมูลรับรอง Google บน Vertex AI
เอกสารของ Anthropic เรียกเส้นทางนี้ในปัจจุบันว่า Claude Models on Google Cloud (Google managed) ซึ่ง Google ดำเนินการเป็นส่วนหนึ่งของ Agent Platform ซึ่งเป็นชื่อใหม่ของ Google สำหรับบริการที่พัฒนาต่อมาจาก Vertex AI โดย aiplatform.googleapis.com host, anthropic[vertex] extra และ AnthropicVertex class ที่แสดงด้านล่างยังคงเหมือนเดิม
Google Cloud ใช้ Application Default Credentials (ADC) ซึ่งเป็นลำดับการค้นหาแบบตายตัวที่ไลบรารี Google auth ใช้ค้นหาข้อมูลรับรองโดยไม่ต้องระบุข้อมูลรับรองเอง ADC จะตรวจสอบ GOOGLE_APPLICATION_CREDENTIALS ก่อน จากนั้นตรวจสอบไฟล์ที่ gcloud auth application-default login เขียนไว้ แล้วจึงตรวจสอบ service account ที่แนบผ่าน metadata server
pip install -U "anthropic[vertex]"
gcloud auth application-default loginบน workstation การ login จะเขียน $HOME/.config/gcloud/application_default_credentials.json และถือว่าเสร็จสิ้น บน server ให้หลีกเลี่ยงการเก็บข้อมูลรับรองของผู้ใช้บุคคล คำสั่งนี้ยังรองรับการสวมสิทธิ์ service account ด้วย ภายนอก Google Cloud จะไม่มี Google metadata server เช่นกัน ดังนั้นให้ใช้ GOOGLE_APPLICATION_CREDENTIALS เพื่อชี้ ADC ไปยังไฟล์ configuration ของ Workload Identity Federation หรือไฟล์ service account key ไฟล์ JSON ของ service account key เป็น secret ที่มีอายุยาวนาน และต้องจัดการตามแนวทางที่อธิบายไว้ภายหลังในคู่มือนี้ ภายใน Google Cloud ให้แนบ service account เข้ากับ VM ซึ่งจะไม่ต้องมีไฟล์ให้ปกป้อง identity ใดก็ตามที่ ADC พบต้องมี IAM role ซึ่งรวม permission aiplatform.endpoints.predict เช่น Agent Platform User (roles/aiplatform.user)
from anthropic import AnthropicVertex
client = AnthropicVertex(project_id="my-project", region="global")มี 2 จุดที่เปลี่ยนไปเมื่อใช้ raw HTTP แทน SDK ตัวระบุ model จะย้ายจาก request body ไปอยู่ใน URL path และ anthropic_version จะย้ายจาก header ไปอยู่ใน body ณ วันที่ 27 October 2026 เอกสารของ Anthropic รองรับทั้ง vertex-2023-10-16 และ API version ใหม่กว่าอย่าง 2026-10-21 ในตำแหน่งดังกล่าว credential เป็น Google access token ทั่วไป ในคำสั่งด้านล่าง gcloud auth print-access-token ใช้การ login ของ gcloud CLI โดยตรงแทน ADC ดังนั้นให้เรียกใช้ 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 เป็น argument สำคัญ global จะกำหนดเส้นทางแบบไดนามิกเพื่อความพร้อมใช้งาน ส่วน us และ eu เป็นตัวระบุ multi-region และชื่ออย่าง us-east5 จะล็อกการใช้งานไว้ที่ region เดียว ณ October 2026 Anthropic ระบุ single-region endpoint เฉพาะ Claude Sonnet 4.6 และรุ่นก่อนหน้าเท่านั้น ส่วน model รุ่นใหม่กว่าจะใช้ global หรือ multi-region endpoint ค่าใช้บริการของ multi-region และ regional endpoint สูงกว่า global 10% ตามเอกสาร ณ October 2026 การเรียกเก็บเงินดำเนินการผ่าน Google Cloud project ดังนั้น quota และ invoice จึงเป็นของ Google
ณ วันที่ 27 October 2026 Anthropic ยังระบุข้อเสนอ Google Cloud อีกแบบหนึ่ง ซึ่งมีรูปแบบ request แตกต่างกัน ใน Claude Models on Google Cloud (Anthropic managed) Anthropic เป็นผู้ให้บริการ Claude API เองที่ claude.googleapis.com โดยเข้าถึงผ่าน client แบบ AnthropicGoogleCloud ระบบยัง authenticate ด้วย Google Cloud credentials รวมถึง ADC แต่ request มีรูปแบบเหมือน direct API คือ model ยังคงอยู่ใน body และ version จะอยู่ใน anthropic-version header การเข้าถึงใช้ IAM role ของบริการนี้เอง (roles/claude.user และ role ที่เกี่ยวข้อง) การตั้งค่าจะสร้าง Anthropic organization ใหม่ให้กับ project และการใช้งานจะเรียกเก็บเงินผ่าน Google Cloud Marketplace หาก URL ของ request มี aiplatform และลงท้ายด้วย :rawPredict แสดงว่าคุณกำลังใช้ Google-managed route ที่อธิบายไว้ใน section นี้
เส้นทางที่ 4: Microsoft Foundry คือเส้นทางของ Azure
หากคุณค้นหา Claude บน Azure นี่คือส่วนที่คุณต้องการ และมีเส้นทางที่รองรับอยู่จริง Claude ทำงานใน Microsoft Foundry (เดิมคือ Azure AI Foundry) โดยเรียกเก็บเงินผ่าน Azure Marketplace ในรูปแบบ Claude Consumption Units คุณต้องสร้างทรัพยากร Foundry, deploy โมเดล Claude ไว้ภายใน และเรียกใช้งาน endpoint ที่โฮสต์บน Azure ที่ https://{resource}.services.ai.azure.com/anthropic/v1/*
ข้อมูลประจำตัวที่ใช้งานได้มีสองแบบ แบบแรกคือ key ที่ออกโดย Azure จากแท็บ Details ของการ deployment ในพอร์ทัล Foundry ซึ่งส่งใน header api-key หรือ x-api-key แบบที่สองคือ Microsoft Entra token ซึ่งเป็นตัวเลือกที่ดีกว่าบนเซิร์ฟเวอร์ เนื่องจาก Azure role-based access control จะเป็นตัวควบคุมว่าใครสามารถเรียกใช้ endpoint ได้
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 (deployment name) ของคุณ ไม่ใช่ตัวระบุโมเดล โดยปกติทั้งสองค่าจะตรงกัน แต่จะเริ่มไม่ตรงกันทันทีที่คุณตั้งชื่อการ deployment เอง ซึ่งเป็นสาเหตุทั่วไปที่ทำให้เกิดข้อผิดพลาด Deployment not found ในคำขอที่ถูกต้องในส่วนอื่น SDK ของ Python และ TypeScript จะอ่านค่า ANTHROPIC_FOUNDRY_API_KEY และ ANTHROPIC_FOUNDRY_RESOURCE จาก environment ตามที่ระบุไว้เมื่อวันที่ 10 พฤศจิกายน 2026 การรองรับ Foundry ครอบคลุม SDK อย่างเป็นทางการทั้ง 7 ภาษา ได้แก่ C#, Go, Java, PHP, Python, Ruby และ TypeScript โดย Go ใช้แพ็กเกจ foundry (go get github.com/anthropics/anthropic-sdk-go/v2/foundry) โดยเฉพาะ และ Ruby ได้เพิ่ม Anthropic::FoundryClient เฉพาะในเวอร์ชัน 2.5.0 ของ gem ซึ่งปล่อยออกมาเมื่อวันที่ 4 พฤศจิกายน 2026 ก่อนหน้านั้น โค้ด Ruby ต้องชี้ไคลเอนต์ทั่วไปไปยัง base URL ของ Foundry
การชี้ไคลเอนต์ทั่วไปไปยัง base URL ของ Foundry ยังคงมีความเสี่ยง ไม่ว่าจะเป็นโค้ด Ruby ที่เขียนก่อนเวอร์ชัน 2.5.0 หรือ ant CLI ซึ่งตัวอย่าง Foundry ของ Anthropic เองก็ใช้วิธีนั้น หากคุณไม่ได้ส่งข้อมูลประจำตัวไปยังไคลเอนต์ทั่วไปอย่างชัดเจนและยังมีการตั้งค่า ANTHROPIC_API_KEY หรือ ANTHROPIC_AUTH_TOKEN ไว้ใน environment ไคลเอนต์จะดึงค่าดังกล่าวไปใช้และส่งข้อมูลประจำตัว Anthropic ของคุณไปยัง endpoint ของ Microsoft ให้ยกเลิกการตั้งค่าตัวแปรดังกล่าว หรือส่ง key หรือ token ของ Foundry ไปยังไคลเอนต์โดยตรง ใน Ruby การเปลี่ยนไปใช้ Anthropic::FoundryClient ซึ่งรับ key ของ Foundry หรือตัวให้บริการ Entra token เป็นวิธีแก้ไขที่สะอาดกว่า โดย Entra access token จะมีอายุการใช้งานสุ่มเริ่มต้นที่ 60 ถึง 90 นาที ดังนั้นกระบวนการที่ทำงานต่อเนื่องยาวนานจะต้องทำการรีเฟรช token แทนการดึงค่าเพียงครั้งเดียวตอนเริ่มต้นทำงาน
Credential บนเซิร์ฟเวอร์ของคุณมีอายุการใช้งานนานเท่าใด
ข้อมูลเบื้องหลังแผนภูมินี้
[
{
"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 ไม่ใช่ค่าที่วัดผลได้จริง ข้อมูลนี้มีความสำคัญด้วยเหตุผลเดียวคือ ช่วยให้คุณทราบว่าหาก credential รั่วไหลออกไป มันจะยังคงใช้งานได้นานเท่าใดในระหว่างที่คุณกำลังตรวจสอบการรั่วไหลนั้น Federated Anthropic token ที่อยู่ด้านล่างของแผนภูมิมีอายุการใช้งานสูงสุด 1 ชั่วโมงโดยค่าเริ่มต้น และยังถูกจำกัดด้วยระยะเวลาที่เหลืออยู่ของ token จาก identity provider อีกไม่เกินสองเท่า Microsoft Entra access token ไม่มีค่าเริ่มต้นเพียงค่าเดียว โดย Microsoft จะสุ่มอายุการใช้งานให้แต่ละ token อยู่ระหว่าง 60 ถึง 90 นาที (เฉลี่ย 75 นาที) ซึ่งแสดงในแผนภูมิที่เพดานสูงสุด 1.5 ชั่วโมง และค่าเริ่มต้นนี้ยังแปรผันตาม client, resource และการเปิดใช้งาน Conditional Access ใน tenant นั้นๆ เมื่อทั้ง client และ resource รองรับ Continuous Access Evaluation ทาง Entra อาจขยายอายุการใช้งานเป็น 24 ถึง 28 ชั่วโมง และเพิกถอน token แบบเกือบเรียลไทม์เมื่อเกิดเหตุการณ์ เช่น การปิดใช้งานบัญชี นโยบายอายุการใช้งานของ tenant token สามารถกำหนดได้ตั้งแต่ 10 นาที ถึง 23:59:59 ชั่วโมง SDK จะรีเฟรช federated Anthropic token โดยอัตโนมัติ สำหรับบน Foundry ให้กำหนดค่า Entra token provider เพื่อรีเฟรช token แทนการส่งค่า token string แบบคงที่ กฎการเชื่อมต่อ (federation rule) สามารถกำหนดอายุการใช้งาน token ของตนเองได้ตั้งแต่หนึ่งนาทีถึง 24 ชั่วโมง และตัวช่วยสร้าง workload ใน Console's Connect จะกำหนดค่าเริ่มต้นไว้ที่ 10 นาที ดังนั้นควรตรวจสอบกฎแทนการคาดเดาจากค่าเริ่มต้น Assumed role และ Bedrock short-term API key มีอายุการใช้งานอยู่ที่ 12 ชั่วโมง Bedrock long-term API key ไม่มีระบุในแผนภูมิเนื่องจากไม่มีเพดานที่แน่นอน โดยจะมีอายุจนถึงวันหมดอายุที่เลือกไว้ตอนสร้าง หรือไม่มีวันหมดอายุหากละเว้น CredentialAgeDays ในการเรียก API ซึ่งเป็นเหตุผลที่ AWS แนะนำให้ใช้สำหรับการทดสอบเท่านั้น Key ที่สร้างด้วยค่าเริ่มต้น 30 วันจะมีอายุการใช้งาน 720 ชั่วโมง และนั่นคือ credential ที่จะถูกเก็บไว้ในไฟล์บนเซิร์ฟเวอร์ของคุณเป็นเวลาหนึ่งเดือน
ตำแหน่งที่เก็บ credential บน VPS
เก็บ secret ไว้ในไฟล์ที่มีเฉพาะ root เท่านั้นที่อ่านได้ แล้วให้ systemd ส่งค่าให้ process ส่วนนี้ไม่ขึ้นกับ SDK version ดังนั้นควรตั้งค่าให้ถูกต้องเพียงครั้งเดียว
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 แบบ plain text ไม่ใช้ export ไม่ใส่เครื่องหมายคำพูด และไม่ใช้ shell syntax เพราะ systemd จะ parse ไฟล์เอง โดยไม่ส่งผ่าน shell
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 อ่าน EnvironmentFile= ในฐานะ root ก่อนลดสิทธิ์เป็น User=claudeapp ดังนั้น service account จึงไม่จำเป็นต้องมีสิทธิ์อ่านไฟล์นี้ กำหนด mode เป็น 600 และให้ root เป็นเจ้าของก็เพียงพอ นี่คือเหตุผลที่คำสั่ง install ด้านบนกำหนดค่าไว้เช่นนั้น ให้เริ่ม service ด้วย sudo systemctl enable --now claude-app จากนั้นยืนยันด้วย systemctl status claude-app ว่า unit อยู่ในสถานะ active (running) แทนที่จะ restart วนซ้ำ
มี 4 สิ่งที่ควรหลีกเลี่ยง โดยแต่ละข้อมีเหตุผลที่ตรวจสอบได้:
- อย่าเขียน key ด้วย
Environment=ไว้ใน unit file unit ที่อยู่ภายใต้/etc/systemd/systemสามารถอ่านได้โดยผู้ใช้ทุกคน ดังนั้นsystemctl cat claude-appจึงแสดง secret ให้ local user ทุกคนเห็น - อย่า commit secret นั้น
.gitignoreใช้ป้องกันไม่ให้ไฟล์ใหม่ถูกนำเข้า commit แต่ไม่มีผลกับไฟล์ที่ถูก commit ไปแล้ว เพราะ git history จะเก็บข้อมูลที่ได้รับไว้ - อย่าใส่ secret ลงใน container image ค่า
ENVจะคงอยู่ใน image configuration และ build arguments จะปรากฏใน image history หรือ provenance metadata การลบไฟล์ใน layer ภายหลังไม่ได้ลบไฟล์นั้นออกจาก layer ก่อนหน้า ให้ส่ง secret ตอน runtime ด้วย--env-fileหรือใช้ไฟล์ที่ mount แทน - อย่าถือว่า process environment เป็นข้อมูลส่วนตัวจาก root
sudo cat /proc/$(pgrep -u claudeapp -f claude_app | head -1)/environ | tr '\0' '\n'จะแสดง key กลับออกมา คำสั่งที่อ่านไฟล์เองต้องใช้sudoส่วน shell input redirection จะทำงานก่อนsudoและใช้สิทธิ์ของ account ปัจจุบัน เป้าหมายคือเก็บ secret ให้ห่างจาก account อื่นทุก account บนเครื่อง ไม่ใช่ป้องกัน root เพราะ root สามารถอ่าน secret ได้ไม่ว่าจะตั้งค่าอย่างไร
ประเด็นสุดท้ายนี้เป็นขอบเขตของสิ่งที่การออกแบบนี้ช่วยป้องกัน ไฟล์ที่มีเฉพาะ root เท่านั้นที่อ่านได้ช่วยปกป้อง key ที่จัดเก็บไว้ แต่ code ใดก็ตามที่ทำงานในฐานะ service account สามารถอ่าน process environment ได้ และ child process จะรับค่าเหล่านี้สืบต่อไปด้วย วิธีนี้ไม่เหมาะเมื่อ process ทำงานกับ code ที่คุณไม่ได้เขียนเอง เพราะทุกสิ่งที่ process สามารถ execute ได้ก็สามารถอ่าน environment ของ process เองได้ การเก็บ secret ให้พ้นจากการเข้าถึงของ AI agent อธิบายกรณีนี้ ซึ่งเป็นคนละปัญหาและต้องใช้แนวทางแก้ไขคนละแบบ
จะหมุนเวียน key โดยไม่ทำให้บริการหยุดทำงานได้อย่างไร
ให้หมุนเวียนไปข้างหน้าก่อน แล้วจึง revoke key เดิมเป็นขั้นตอนสุดท้าย การ restart บริการเพียงตัวเดียวตามด้านล่างจะทำให้บริการหยุดชะงักชั่วครู่ หากต้องการให้บริการพร้อมใช้งานต่อเนื่อง ต้องมีอีก instance รับคำขอระหว่างการ restart
- สร้าง key ใหม่ใน Console โดยใช้ workspace เดียวกับ key เดิม
- เขียน key ลงใน
/etc/claude-app/envด้วยsudoedit - รัน
sudo systemctl restart claude-app - ยืนยันว่าบริการตอบคำขอได้แล้ว จากนั้น revoke key เดิมใน Console
EnvironmentFile จะถูกอ่านเมื่อ unit เริ่มทำงาน ดังนั้น process ที่กำลังทำงานจะยังคงใช้ค่าที่ได้รับตอนเริ่มต้น systemctl daemon-reload จะอ่าน unit files ใหม่อีกครั้ง แต่จะไม่เปลี่ยน environment ของ process ที่กำลังทำงานอยู่ ดังนั้นต้อง restart เท่านั้นจึงจะนำ key ใหม่มาใช้ หาก revoke ในขั้นตอนที่ 1 แทนขั้นตอนที่ 4 คุณจะทำให้บริการหยุดทำงานจนกว่าจะถึงขั้นตอนที่ 3
เส้นทางไปยัง cloud จะหมุนเวียน key ที่ฝั่ง provider ผู้ใช้ IAM รองรับ access keys ที่ active พร้อมกันได้ 2 รายการ ดังนั้นให้สร้างรายการที่สอง deploy แล้วจึงลบรายการแรก key ของ Google service account ก็หมุนเวียนด้วยวิธีเดียวกัน ส่วน Foundry resource มี key 2 รายการ และการ regenerate key รายการหนึ่งจะทำให้ค่าก่อนหน้าใช้ไม่ได้ทันที ดังนั้นให้ย้ายบริการไปใช้ key อีกรายการก่อน แล้วจึง regenerate key ที่บริการกำลังใช้อยู่ Entra tokens และ federated Anthropic tokens ไม่ต้องหมุนเวียนด้วยตนเอง และนี่เป็นเหตุผลสำคัญที่สุดที่ควรใช้ token เหล่านี้เมื่อทำได้
ขณะที่อยู่ใน Console ให้ตั้ง spend limit ของ workspace ด้วย key ที่รั่วไหลสร้างค่าใช้จ่ายได้ก่อนที่จะก่อปัญหาอื่น และ การจำกัดค่าใช้จ่ายที่ agent บน VPS ใช้ได้ อธิบายการควบคุมเหล่านี้โดยละเอียด
เหตุใด client จึงส่งคืน 401 หรือ 403?
401 พร้อม authentication_error เมื่อเรียก direct API key ไม่ถูกต้อง ถูกยกเลิก หรือหมดอายุ ปัญหาเรื่องวันหมดอายุมักถูกมองข้าม เพราะ code ไม่ได้เปลี่ยนและ request ยังทำงานได้เมื่อวาน ตรวจสอบคอลัมน์วันหมดอายุของ key ใน Console หรืออ่าน expires_at จาก Admin API โดยค่าดังกล่าวเป็น null สำหรับ key ที่ไม่มีวันหมดอายุ personal key จะหยุดทำงานเมื่อเจ้าของออกจาก organization ด้วย
SDK ไม่ใช้การตั้งค่า federation และใช้ key แทน ANTHROPIC_API_KEY และ ANTHROPIC_AUTH_TOKEN อยู่เหนือ federation ในลำดับความสำคัญของ credential ดังนั้นรายการใดรายการหนึ่งจะบดบัง federation กรณีที่มักทำให้สับสนคือ ตัวแปรที่ export เป็น empty string ยังคงใช้ตำแหน่งของตนอยู่ ดังนั้น ANTHROPIC_API_KEY="" จะทำให้ SDK authenticate ด้วย key ว่าง แทนที่จะเลื่อนไปใช้วิธีถัดไป ใช้ unset ANTHROPIC_API_KEY
401 พร้อมข้อความเปล่า Authentication failed เมื่อใช้ federation ข้อความนี้ถูกทำให้เหมือนกันโดยตั้งใจสำหรับทุกสาเหตุที่เป็นไปได้ เพื่อไม่ให้ caller ตรวจสอบการตั้งค่า rule ได้จากข้อความ error สาเหตุจริงจะถูกบันทึกไว้ในหน้า authentication history ใน Console ให้เริ่มตรวจสอบจากหน้านั้น แทนการคาดเดาจาก JWT
403 บน Foundry token authenticate สำเร็จแล้ว แต่ Azure account ของคุณไม่มี role ที่อนุญาตให้เรียกดังกล่าว Assign Azure RBAC role เช่น Foundry User (เดิมคือ Azure AI User) หรือ Cognitive Services User ให้กับ identity ที่ใช้ส่ง request
กรณีใดก็ตามบน Bedrock สำหรับการ authenticate ด้วย SigV4 ให้รัน aws sts get-caller-identity ในฐานะ service user ก่อน คำสั่งนี้จะตรวจว่าเครื่องมี AWS credentials ที่ใช้งานได้จริงหรือไม่ จึงช่วยแยกปัญหา credential ออกจากปัญหาสิทธิ์เข้าถึง model หรือ region ไม่ตรงกันได้ ณ วันที่ 29 October 2026 AWS เปิดให้เข้าถึงหลาย model เมื่อใช้งานครั้งแรกใน commercial region หากมี AWS Marketplace permission ที่จำเป็น แต่บาง model ต้องขอสิทธิ์ระดับ account แยกต่างหาก Anthropic model ที่เรียกผ่าน InvokeModel route ต้องกรอก use case form หนึ่งครั้งต่อ account หรือกรอกครั้งเดียวสำหรับทั้ง AWS Organization แต่ opt-in region ต้องกรอกอีกครั้งก่อน และจนกว่าจะดำเนินการเสร็จ การเรียกจะส่งคืน AccessDeniedException AWS ระบุว่า form นี้ไม่มีผลกับ endpoint bedrock-mantle การเรียก model ครั้งแรกใน account ยังทำให้ Bedrock เริ่ม subscription ของ AWS Marketplace ในเบื้องหลังด้วย subscription ดังกล่าวต้องใช้ identity ที่มี permission aws-marketplace:Subscribe, aws-marketplace:Unsubscribe และ aws-marketplace:ViewSubscriptions หากขาด permission การเรียกครั้งแรกอาจไม่ล้มเหลวทันที AWS ระบุว่า call อาจสำเร็จได้นานถึง 15 นาทีระหว่างที่กำลังตั้งค่า subscription และเมื่อ subscription ล้มเหลว call ในภายหลังจะส่งคืน AccessDeniedException เช่นเดิม หาก service ทำงานได้ในช่วงไม่กี่นาทีแรกแล้วเริ่มล้มเหลว ให้ตรวจสอบประเด็นนี้ก่อน ไม่ใช่ตรวจเฉพาะ credential หลังจาก grant permission แล้ว AWS อาจใช้เวลาสูงสุด 2 นาทีเพื่อดำเนินการ subscription ให้เสร็จ model ที่ไม่มีให้บริการใน region ที่เรียกจะล้มเหลวไม่ว่า credential จะถูกต้องเพียงใด
FAQ
ฉันต้องมี Anthropic API key เพื่อใช้ Claude บน Bedrock หรือ Vertex หรือไม่
ไม่ต้องใช้ บน Amazon Bedrock SDK จะลงนามคำขอด้วย AWS credentials โดยใช้ SigV4 หรือส่ง Bedrock API key ส่วนบน Google Cloud จะส่ง Google access token ที่ค้นหาผ่าน Application Default Credentials การตั้งค่าทั้งสองแบบไม่มี secret ที่ออกโดย Anthropic และค่าใช้จ่ายจะเรียกเก็บจาก cloud account แทนที่จะเรียกเก็บจาก Anthropic นี่เป็นเหตุผลที่การมี Anthropic key ค้างอยู่ใน ANTHROPIC_API_KEY บนโฮสต์เหล่านั้นจึงเป็นความเสี่ยง เพราะ generic client ที่ชี้ไปยัง cloud endpoint จะส่ง key ดังกล่าวไปที่นั่นโดยไม่ตรวจสอบ
Claude ใช้งานบน Azure ได้หรือไม่
ได้ โดยใช้งานผ่าน Microsoft Foundry ซึ่งเดิมเรียกว่า Azure AI Foundry คุณสร้าง Foundry resource, deploy Claude model เข้าไป แล้วเรียก https://{resource}.services.ai.azure.com/anthropic/v1/messages ด้วย Azure-issued key ใน header api-key หรือ Microsoft Entra bearer token ค่าใช้จ่ายจะเรียกเก็บผ่าน Azure Marketplace ในรูป Claude Consumption Units ฟิลด์ model ใน request body ต้องระบุ deployment name ของคุณ ซึ่งจะตรงกับ model identifier ก็ต่อเมื่อคุณใช้ชื่อเริ่มต้นขณะสร้าง deployment ชื่อนี้ไม่สามารถเปลี่ยนภายหลังได้
ควรเก็บ Claude API key ไว้ที่ใดบน Linux server
ให้เก็บไว้ในไฟล์ที่ root เป็นเจ้าของและมี mode 600 จากนั้นโหลดผ่าน EnvironmentFile= ใน systemd unit systemd จะอ่านไฟล์ดังกล่าวในฐานะ root ก่อนเปลี่ยนไปใช้ User= ของ unit ดังนั้น service account จึงไม่จำเป็นต้องมีสิทธิ์เข้าถึงไฟล์นี้ อย่าเก็บ key ไว้ใน repository, ใน unit file เอง ซึ่งผู้ใช้ทุกคนอ่านได้และจะแสดงโดย systemctl cat หรือใน container image configuration, layers และ build metadata
เหตุใด Claude API request ของฉันจึงเริ่มตอบกลับด้วย 401 ทั้งที่ไม่มีการเปลี่ยนแปลงใด
Key ที่ถึงวันหมดอายุซึ่งกำหนดไว้ตอนสร้างจะตอบกลับด้วย 401 วันหมดอายุถูกกำหนดตอนสร้างและไม่สามารถแก้ไขภายหลังได้ ส่วน key ที่มีอายุสั้นจะหมดอายุโดยไม่มีอีเมลแจ้งเตือน Key ที่หมดอายุแล้วไม่สามารถเปิดใช้งานอีกครั้งได้ ให้สร้าง key ทดแทน เขียนลงใน environment file แล้ว restart service จากนั้น revoke key เดิม หากยืนยันได้ว่า key ยังใช้งานได้ ให้ตรวจสอบว่า credential เก่าไม่ได้บัง credential ดังกล่าวอยู่: ANTHROPIC_API_KEY ที่กำหนดเป็นค่าว่างยังคงมีลำดับความสำคัญสูงกว่า federation และ profile sources ที่อยู่ถัดลงไป