Skip to main content

Claude Code บน Claude Platform บน AWS

กำหนดค่า Claude Code ให้ใช้ Anthropic-operated Claude API พร้อม AWS authentication, IAM access control และ AWS Marketplace billing

Claude Platform on AWS คือ Anthropic-operated Claude API พร้อม AWS authentication, IAM access control และ AWS Marketplace billing Requests ถึง Anthropic API โดยตรง ดังนั้นคุณได้รับโมเดลและฟีเจอร์เดียวกับ Claude API ตาม release schedule เดียวกัน

ใช้คู่มือนี้เพื่อชี้ Claude Code ไปยัง workspace ที่คุณ provision ผ่าน Claude Platform on AWS แล้ว สำหรับการ subscribe ผ่าน AWS Marketplace และ workspace setup ดู Claude Platform on AWS documentation

note

การ subscribe ผ่าน AWS Marketplace จัดเตรียม Anthropic organization ใหม่ที่ผูกกับ AWS account ของคุณ Organization นี้แยกจาก organization ที่คุณมีกับ Anthropic อยู่แล้ว credentials ไม่โอนย้ายระหว่างกัน

ข้อกำหนดเบื้องต้น​

ก่อนกำหนดค่า Claude Code คุณต้องการ:

  • AWS Marketplace subscription สำหรับ Claude Platform on AWS ที่ active
  • Workspace ใน AWS-linked Anthropic organization พร้อม workspace ID
  • IAM principal ที่มีสิทธิ์ invoke Anthropic service หรือ API key ที่กำหนดขอบเขตสำหรับ workspace
  • AWS credentials ในสภาพแวดล้อมของคุณ ใน ~/.aws/credentials หรือจาก IAM role ที่แนบไว้

การตั้งค่า​

1. กำหนดค่า AWS credentials​

Claude Code รองรับสองวิธีการยืนยันตัวตนสำหรับ Claude Platform on AWS:

ตัวเลือก A: AWS credentials พร้อม SigV4

Claude Code ลงนาม requests ด้วย SigV4 โดยใช้ standard AWS credential chain

สำหรับการใช้งาน local ให้ login ด้วย AWS CLI ก่อนเริ่ม Claude Code:

aws sso login --profile my-profile
export AWS_PROFILE=my-profile

หาก SSO credentials หมดอายุระหว่าง session ให้กำหนดค่า awsAuthRefresh ใน settings.json:

{
  "awsAuthRefresh": "aws sso login --profile my-profile"
}

ตัวเลือก B: Workspace API key

export ANTHROPIC_AWS_API_KEY=sk-ant-xxxxx

2. กำหนดค่า Claude Code​

ตั้ง environment variables ที่ route Claude Code ผ่าน Claude Platform on AWS:

export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export AWS_REGION=us-east-1

3. Pin model versions​

export ANTHROPIC_DEFAULT_FABLE_MODEL=claude-fable-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-7
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

ใช้ Agent SDK​

Agent SDK อ่าน environment variables เดียวกับ CLI:

import { query } from "@anthropic-ai/claude-agent-sdk";

process.env.CLAUDE_CODE_USE_ANTHROPIC_AWS = "1";
process.env.ANTHROPIC_AWS_WORKSPACE_ID = "wrkspc_01ABCDEFGHIJKLMN";
process.env.AWS_REGION = "us-east-1";

for await (const msg of query({ prompt: "What's in this repo?" })) {
  console.log(msg);
}

Route ผ่าน corporate proxy​

export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export ANTHROPIC_AWS_BASE_URL=https://anthropic-proxy.example.com

หาก gateway ลงนาม requests เอง:

export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export ANTHROPIC_AWS_BASE_URL=https://anthropic-proxy.example.com

การแก้ไขปัญหา​

รัน /status เพื่อดู provider ที่ resolved และการกำหนดค่าอื่นๆ

403 Forbidden หรือ AccessDenied ทุก request​

IAM principal ที่ Claude Code resolved น่าจะไม่มีสิทธิ์ invoke Anthropic service ใน workspace ของคุณ ตรวจสอบ role และ permissions

Requests ล้มเหลวพร้อมข้อผิดพลาด missing-workspace​

ANTHROPIC_AWS_WORKSPACE_ID น่าจะไม่ได้ตั้งค่าหรือว่างเปล่า ทุก request ต้องมี workspace ID

Requests ยังคงไปที่ api.anthropic.com​

CLAUDE_CODE_USE_ANTHROPIC_AWS น่าจะไม่ได้ตั้งค่าหรือตั้งค่าเป็น value ที่ไม่ได้รับการตีความว่า truthy ตั้งเป็น 1 และรัน /status เพื่อยืนยัน

แหล่งข้อมูลเพิ่มเติม​