מדריך קלוד קוד בעברית
לאתר הראשי כל המדריכים קלאודפלייר קלוד דסקטופ גרוק CLI גרוק בוט MCP קרסור וואטסאפ OpenClaw n8n בענן n8n בהתקנה עצמית

תיעוד 103

Claude Code על Claude Platform on AWS

הגדר את Claude Code לשימוש ב-Claude API שמפעילה Anthropic, עם אימות AWS, בקרת גישה IAM, וחיוב דרך AWS Marketplace.

Claude Platform on AWS הוא ה-Claude API שמפעילה Anthropic, עם אימות AWS, בקרת גישה IAM, וחיוב דרך AWS Marketplace. הבקשות מגיעות ישירות ל-API של Anthropic, כך שאתה מקבל את אותם מודלים ואת אותן יכולות API כמו ב-Claude API, באותו לוח זמנים של שחרורים. אתה מאמת עם אישורי AWS או עם מפתח API של workspace, ואתה משלם דרך AWS Marketplace.

יכולות בצד הלקוח ש-Claude Code מפעיל דרך שירות ה-feature-flag של Anthropic כבויות כברירת מחדל, וכלי ה-advisor אינו זמין. ראה את מטריצת זמינות היכולות לרשימה המלאה.

השתמש במדריך הזה כדי לכוון את Claude Code אל workspace שכבר הקמת דרך Claude Platform on AWS. להגדרת המנוי ב-AWS וה-workspace שבאה לפני כן, ראה את התיעוד של Claude Platform on AWS.

[!NOTE]

הרשמה דרך AWS Marketplace מקימה ארגון Anthropic חדש הקשור לחשבון ה-AWS שלך. הארגון הזה נפרד מכל ארגון שכבר יש לך אצל Anthropic, והאישורים לא עוברים ביניהם. השתמש ב-workspace ID ובמפתחות ה-API מהארגון המקושר ל-AWS, ולא מחשבון Claude Console שכבר קיים.

#דרישות מוקדמות

לפני הגדרת Claude Code, אתה צריך:

  • מנוי פעיל ל-Claude Platform on AWS דרך AWS Marketplace
  • workspace בארגון Anthropic המקושר ל-AWS שלך, עם ה-workspace ID שלו
  • IAM principal עם הרשאה להפעיל את שירות Anthropic, או מפתח API שמוגבל ל-workspace
  • אישורי AWS בסביבה שלך, ב-~/.aws/credentials, או מתפקיד IAM מצורף אם אתה רוצה אימות SigV4. ה-AWS CLI נדרש רק לזרימת ההתחברות של SSO.

#הגדרה

#1. הגדר אישורי AWS

Claude Code תומך בשתי שיטות אימות ל-Claude Platform on AWS. בחר את השיטה שמתאימה לאופן שבו הצוות שלך מנהל גישה:

#שימוש באישורי AWS עם SigV4

Claude Code חותם על בקשות עם SigV4 באמצעות שרשרת האישורים הסטנדרטית של AWS: משתני סביבה, אישורים משותפים ב-~/.aws/credentials, תפקידי IAM, הפעלות AWS SSO, וכל מקור אחר שה-AWS SDK תומך בו.

לשימוש מקומי, התחבר עם AWS CLI לפני הפעלת Claude Code. הדוגמה למטה משתמשת בפרופיל SSO, אבל כל שיטה שמייצרת אישורים במיקומים הסטנדרטיים עובדת.

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

ל-CI ולאוטומציה, תן ל-runner תפקיד IAM עם הרשאה להפעיל את שירות Anthropic והגדר את AWS_REGION. שרשרת האישורים קולטת את התפקיד אוטומטית.

אם אישורי ה-SSO שלך פגים באמצע הפעלה, הגדר את awsAuthRefresh כדי ש-Claude Code יריץ מחדש את פקודת ההתחברות שלך וינסה שוב במקום להיכשל. הוסף את הפקודה לקובץ ההגדרות שלך, למשל ~/.claude/settings.json:

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

Claude Code גם מריץ את הפקודה הזו בהפעלה כשהוא לא יכול לאמת את אישורי ה-AWS הקיימים שלך, ומציג את פלט הפקודה בלוח Authentication עד שההתחברות מסתיימת.

כש-awsAuthRefresh מוגדר, הרץ /login, בחר 3rd-party platform, ואז בחר Claude Platform on AWS · refresh credentials תחת Using 3rd-party platforms. Claude Code מריץ את הפקודה המוגדרת וקורא מחדש את אישורי ה-AWS שלך בלי הפעלה מחדש.

#שימוש במפתח API של workspace

מפתח API של workspace הוא סוד ארוך טווח, שימושי כשאתה לא רוצה לנהל אישורי AWS מאוחדים. צור אחד ב-AWS Console תחת Claude Platform on AWS → API keys והגדר אותו כ-ANTHROPIC_AWS_API_KEY:

export ANTHROPIC_AWS_API_KEY=sk-ant-xxxxx

המפתח נשלח כ-x-api-key וגובר על SigV4, כך שכל אישורי AWS בסביבה שלך לא נלקחים בחשבון. מפתחות API מארגון Claude Console נפרד לא יעבדו כאן.

התייחס למפתחות API של workspace כמו לכל אישור ייצור אחר. בלוק env בקובץ הגדרות המשתמש הוא דרך נוחה לתחום את המפתח למכונה שלך בלי לייצא אותו גלובלית.

[!NOTE]

הפקודות /login ו-/logout לא מחברות אותך למנוי claude.ai עבור Claude Platform on AWS. האימות רץ דרך אישורי ה-AWS שלך או מפתח API של workspace.

#2. הגדר את Claude Code

הגדר את משתני הסביבה שמנתבים את Claude Code דרך Claude Platform on AWS במקום ה-API של Anthropic כברירת מחדל.

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

ANTHROPIC_AWS_WORKSPACE_ID נדרש. Claude Code שולח אותו בכל בקשה ככותרת anthropic-workspace-id. החלף את ערך הדוגמה wrkspc_01ABCDEFGHIJKLMN ב-workspace ID שלך מההגדרה של Claude Platform on AWS.

Claude Code מחשב את כתובת הבסיס כ-https://aws-external-anthropic.{region}.api.aws מאזור ה-AWS, שהוא פותר לפי אותה קדימות כמו Amazon Bedrock. כדי לעקוף את הכתובת ישירות, הגדר את ANTHROPIC_AWS_BASE_URL.

Claude Platform on AWS דורש הפעלה מפורשת גם כשאישורי AWS נמצאים בסביבה שלך. Amazon Bedrock ו-Microsoft Foundry גוברים בניתוב הספק, אז בטל את CLAUDE_CODE_USE_BEDROCK ו-CLAUDE_CODE_USE_FOUNDRY אם הם מוגדרים.

#3. נעץ גרסאות מודל

Claude Platform on AWS משתמש באותם מזהי מודל כמו Claude API הישיר.

כינויי ברירת המחדל fable, opus, sonnet ו-haiku נפתרים לברירות המחדל המובנות של Claude Code עבור Claude Platform on AWS, שיכולות לפגר אחרי המהדורה החדשה ביותר. בלי ANTHROPIC_DEFAULT_OPUS_MODEL, הכינוי opus נפתר ל-Opus 5.5. לפני v2.1.280, הוא נפתר ל-Opus 5 החל מ-v2.1.219.

אם אתה פורס את Claude Code לצוות, נעץ את מזהי המודל במפורש כדי שמהדורה חדשה לא תעביר את כולם בבת אחת:

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

לרשימה המלאה של מזהי מודל וכינויים, ראה סקירת מודלים. למשתנים אחרים שקשורים למודל, ראה הגדרת מודל.

שמירת פרומפט במטמון מופעלת אוטומטית. כדי לבקש TTL של מטמון לשעה אחת במקום ברירת המחדל של 5 דקות, הגדר ENABLE_PROMPT_CACHING_1H=1. ה-API מחייב כתיבות מטמון של שעה אחת בתעריף גבוה יותר. ראה תמחור prompt caching לתעריפים.

כדי להגדיר TTL שונים לשיחה הראשית שלך ולבקשות ש-Claude Code מבצע מחוץ לה, בחר את ה-TTL בעצמך.

#4. הפעל ואמת

הפעל את Claude Code ואשר את הניתוב:

claude

באנר ההפעלה מציג Claude Platform on AWS כשהספק פעיל. הרץ /status כדי לבדוק את הפרטים: שורת API provider מציגה Claude Platform on AWS, והפלט כולל את Workspace ID שלך, את AWS region, ואת Claude Platform on AWS base URL אם הגדרת עקיפה.

#שימוש ב-Agent SDK

ה-Agent SDK קורא את אותם משתני סביבה כמו ה-CLI, כך שכל תוכנית שמפעילה את תהליך המשנה של Claude Code יכולה לכוון ל-Claude Platform on AWS על ידי ייצוא CLAUDE_CODE_USE_ANTHROPIC_AWS, ANTHROPIC_AWS_WORKSPACE_ID, וגם ANTHROPIC_AWS_API_KEY או אישורי AWS לפני הקריאה.

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);
}

הדוגמה הזו נשענת על שרשרת אישורי AWS הזמינה בסביבה עבור SigV4. כדי לאמת עם מפתח API של workspace במקום זאת, הגדר את ANTHROPIC_AWS_API_KEY באותו אופן. למכלול הרחב יותר של Agent SDK, ראה סקירת Agent SDK.

#ניתוב דרך פרוקסי ארגוני

כדי לנתב תעבורה דרך פרוקסי או LLM gateway, הגדר את ANTHROPIC_AWS_BASE_URL לכתובת של הפרוקסי. Claude Code שולח בקשות לכתובת הזו עם אותן כותרות workspace ואימות, כך שכל gateway שמעביר אותן ללא שינוי עובד.

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 שלך חותם על בקשות בעצמו, הגדר CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1 כדי ש-Claude Code ישלח בקשות לא חתומות ויתן ל-gateway להוסיף כותרות SigV4 לפני ההעברה ל-AWS. אם ה-gateway דורש אסימון משלו, הגדר אותו ב-ANTHROPIC_AUTH_TOKEN.

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 כדי לראות את הספק שנפתר וכל workspace ID, אזור, עקיפת כתובת בסיס, והגדרת דילוג על אימות שהוגדרו במפורש. זו הדרך המהירה ביותר לאשר ש-Claude Code מכוון ל-Claude Platform on AWS בכלל.

#403 Forbidden או AccessDenied בכל בקשה

ה-IAM principal ש-Claude Code פתר כנראה חסר הרשאה להפעיל את שירות Anthropic ב-workspace שלך. בדוק את התפקיד המצורף לפרופיל ה-AWS שלך או ל-runner שהפעיל את Claude Code, ואמת שיש לו את פעולות aws-external-anthropic שמתועדות ב-הפניית פעולות IAM.

אם הגדרת ANTHROPIC_AWS_API_KEY, המפתח גובר על SigV4 ומפתח לא מעודכן מייצר את אותה שגיאה. צור מחדש את המפתח ב-AWS Console תחת Claude Platform on AWS → API keys או בטל את המשתנה כדי לחזור לאישורי ה-AWS שלך.

#בקשות נכשלות עם שגיאת workspace חסר

ANTHROPIC_AWS_WORKSPACE_ID כנראה לא מוגדר או ריק. כל בקשה ל-Claude Platform on AWS חייבת לכלול את ה-workspace ID. הוא לא משתמע מאישורי ה-AWS שלך. מצא את המזהה בהגדרה של Claude Platform on AWS וייצא אותו לפני הפעלת Claude Code.

#בקשות עדיין הולכות ל-api.anthropic.com

CLAUDE_CODE_USE_ANTHROPIC_AWS כנראה לא מוגדר או מוגדר לערך שלא מפורש כ-truthy. הגדר אותו ל-1 והרץ /status כדי לאשר את הספק שנפתר. אם CLAUDE_CODE_USE_BEDROCK או CLAUDE_CODE_USE_FOUNDRY גם מוגדרים, הם גוברים על Claude Platform on AWS.

#משאבים נוספים

מנוי Claude Platform on AWS, ה-workspace, והגדרת IAM שבאים לפני הגדרת Claude Code מכוסים בתיעוד הפלטפורמה: