AWS 上の Claude Platform での Claude Code

AWS 認証、IAM アクセス制御、AWS Marketplace 請求を使用して、Anthropic が運営する Claude API を使用するように Claude Code を設定します。

AWS 上の Claude Platform は、AWS 認証、IAM アクセス制御、AWS Marketplace 請求を備えた Anthropic が運営する Claude API です。リクエストは Anthropic の API に直接到達するため、Claude API と同じモデルと API 機能を同じリリーススケジュールで取得できます。AWS 認証情報またはワークスペース API キーで認証し、AWS Marketplace を通じて支払います。

Claude Code が Anthropic の機能フラグサービスを通じてオンにするクライアント側機能はデフォルトではオフであり、アドバイザーツールは利用できません。完全なリストについては、機能可用性マトリックスを参照してください。

このガイドを使用して、AWS 上の Claude Platform を通じてすでにプロビジョニングしたワークスペースに Claude Code をポイントします。このガイドの前に行う AWS サブスクリプションとワークスペースのセットアップについては、AWS 上の Claude Platform ドキュメントを参照してください。

[!NOTE]

AWS Marketplace を通じてサブスクリプションすると、AWS アカウントに関連付けられた新しい Anthropic 組織がプロビジョニングされます。この組織は、Anthropic で既に持っている組織とは別であり、認証情報はそれらの間で転送されません。AWS にリンクされた組織のワークスペース ID と API キーを使用してください。既存の Claude Console アカウントからではなく。

前提条件

Claude Code を設定する前に、以下が必要です。

AWS Marketplace を通じた有効な AWS 上の Claude Platform サブスクリプション
AWS にリンクされた Anthropic 組織内のワークスペース（ワークスペース ID 付き）
Anthropic サービスを呼び出す権限を持つ IAM プリンシパル、またはワークスペースにスコープされた API キー
環境内、~/.aws/credentials 内、または SigV4 認証が必要な場合は接続された IAM ロールからの AWS 認証情報。AWS CLI は SSO ログインフローにのみ必要です。

セットアップ

AWS 認証情報を設定する

Claude Code は AWS 上の Claude Platform に対して 2 つの認証方法をサポートしています。チームがアクセスを管理する方法に合った方法を選択してください。

SigV4 を使用した AWS 認証情報: 標準的な AWS 認証情報チェーンから取得した認証情報を使用し、IAM プリンシパルとして認証します
ワークスペース API キー: AWS Console で生成した長期間有効なキーで認証します

SigV4 を使用した AWS 認証情報を使用する

Claude Code は標準的な AWS 認証情報チェーンを使用して SigV4 でリクエストに署名します。環境変数、~/.aws/credentials の共有認証情報、IAM ロール、AWS SSO セッション、および AWS SDK がサポートするその他のソース。

ローカル使用の場合、Claude Code を開始する前に AWS CLI でログインしてください。以下の例は SSO プロファイルを使用していますが、標準的な場所に認証情報を生成する任意の方法が機能します。

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

CI と自動化の場合、Anthropic サービスを呼び出す権限を持つ IAM ロールをランナーに付与し、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 を選択してから、Using 3rd-party platforms の下で Claude Platform on AWS · refresh credentials を選択します。Claude Code は設定されたコマンドを実行し、再起動せずに AWS 認証情報を再度読み込みます。

ワークスペース API キーを使用する

ワークスペース API キーは長期間有効なシークレットで、フェデレーション 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 認証情報は無視されます。別の Claude Console 組織からの API キーはここでは機能しません。

ワークスペース API キーは他の本番認証情報と同様に扱ってください。ユーザー設定ファイルの env ブロックは、グローバルにエクスポートせずにキーをマシンにスコープするための便利な方法です。

[!NOTE]

/login および /logout コマンドは Claude.ai サブスクリプションに対して Claude Platform on AWS にサインインしません。認証は AWS 認証情報またはワークスペース API キーを通じて実行されます。

Claude Code を設定する

Claude Code をデフォルトの Anthropic API ではなく AWS 上の Claude Platform を通じてルーティングする環境変数を設定します。

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 値を AWS 上の Claude Platform セットアップから取得した独自のワークスペース ID に置き換えます。

Claude Code はベース URL を AWS リージョンから https://aws-external-anthropic.{region}.api.aws として計算します。これは Amazon Bedrock と同じ優先度で解決されます。URL を直接オーバーライドするには、ANTHROPIC_AWS_BASE_URL を設定します。

AWS 上の Claude Platform は、環境に AWS 認証情報が存在する場合でもオプトインです。Amazon Bedrock と Microsoft Foundry はプロバイダールーティングで優先されるため、設定されている場合は CLAUDE_CODE_USE_BEDROCK と CLAUDE_CODE_USE_FOUNDRY をアンセットします。

モデルバージョンをピン留めする

AWS 上の Claude Platform は、直接 Claude API と同じモデル ID を使用します。

デフォルトのエイリアス fable、opus、sonnet、haiku は Claude Code の AWS 上の Claude Platform 用の組み込みデフォルトに解決されます。これは最新リリースより遅れる可能性があります。ANTHROPIC_DEFAULT_OPUS_MODEL がない場合、opus エイリアスは Opus 5.5 に解決されます。v2.1.280 より前は、v2.1.219 以降では Opus 5 に、v2.1.207 以降では Opus 4.8 に解決されていました。

Claude Code をチームにデプロイする場合、モデル ID を明示的にピン留めして、新しいリリースがすべてのユーザーを一度に移動しないようにします。

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

モデル ID とエイリアスの完全なリストについては、モデル概要を参照してください。その他のモデル関連の変数については、モデル設定を参照してください。

プロンプトキャッシングは自動的に有効になります。5 分のデフォルトの代わりに 1 時間のキャッシュ TTL をリクエストするには、ENABLE_PROMPT_CACHING_1H=1 を設定します。API は 1 時間のキャッシュ書き込みをより高いレートで請求します。レートについては、プロンプトキャッシング価格を参照してください。

メインの会話と Claude Code が実行するリクエストに異なる TTL を設定するには、TTL を自分で選択してください。

起動して検証する

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_CODE_USE_ANTHROPIC_AWS、ANTHROPIC_AWS_WORKSPACE_ID、および ANTHROPIC_AWS_API_KEY または AWS 認証情報をエクスポートすることで AWS 上の Claude Platform をターゲットにできます。

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

この例は SigV4 のアンビエント AWS 認証情報チェーンに依存しています。代わりにワークスペース API キーで認証するには、同じ方法で ANTHROPIC_AWS_API_KEY を設定します。より広い Agent SDK サーフェスについては、Agent SDK 概要を参照してください。

企業プロキシを通じてルーティングする

プロキシまたは LLM ゲートウェイを通じてトラフィックをルーティングするには、ANTHROPIC_AWS_BASE_URL をプロキシのアドレスに設定します。Claude Code は同じワークスペースと認証ヘッダーを使用してそのアドレスにリクエストを送信するため、それらを変更せずに転送するゲートウェイが機能します。

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

ゲートウェイがリクエストに自身で署名する場合、CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1 を設定して、Claude Code が署名なしのリクエストを送信し、ゲートウェイが AWS に転送する前に SigV4 ヘッダーを追加するようにします。ゲートウェイが独自のトークンを必要とする場合は、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 を実行して、解決されたプロバイダーと明示的に設定されたワークスペース ID、リージョン、ベース URL オーバーライド、および認証スキップ設定を確認します。これは Claude Code が AWS 上の Claude Platform をターゲットにしているかどうかを確認する最速の方法です。

すべてのリクエストで `403 Forbidden` または `AccessDenied`

Claude Code が解決した IAM プリンシパルは、ワークスペースで Anthropic サービスを呼び出す権限がない可能性があります。AWS プロファイルに接続されたロール、または Claude Code を開始したランナーを確認し、IAM アクション参照に記載されている aws-external-anthropic アクションがあることを確認します。

ANTHROPIC_AWS_API_KEY を設定した場合、キーは SigV4 よりも優先され、古いキーは同じエラーを生成します。AWS Console の Claude Platform on AWS → API keys でキーを再生成するか、変数をアンセットして AWS 認証情報にフォールバックします。

リクエストがワークスペース不足エラーで失敗する

ANTHROPIC_AWS_WORKSPACE_ID がアンセットまたは空の可能性があります。すべての AWS 上の Claude Platform リクエストにはワークスペース ID を含める必要があります。AWS 認証情報によって暗示されません。Claude Platform on AWS セットアップで ID を見つけ、Claude Code を開始する前にエクスポートします。

リクエストが依然として `api.anthropic.com` に送信される

CLAUDE_CODE_USE_ANTHROPIC_AWS がアンセットまたは truthy として解析されない値に設定されている可能性があります。1 に設定し、/status を実行して解決されたプロバイダーを確認します。CLAUDE_CODE_USE_BEDROCK または CLAUDE_CODE_USE_FOUNDRY も設定されている場合、それらは AWS 上の Claude Platform よりも優先されます。

追加リソース

Claude Code を設定する前に行う AWS 上の Claude Platform サブスクリプション、ワークスペース、IAM セットアップはプラットフォームドキュメントで説明されています。

AWS 上の Claude Platform 概要: サブスクリプション、ワークスペースセットアップ、製品リファレンス
IAM アクション参照: 権限とマネージドポリシー

claude-platform-on-aws.md +21 −233

6 6

7> AWS 認証、IAM アクセス制御、AWS Marketplace 請求を使用して、Anthropic が運営する Claude API を使用するように Claude Code を設定します。7> AWS 認証、IAM アクセス制御、AWS Marketplace 請求を使用して、Anthropic が運営する Claude API を使用するように Claude Code を設定します。

8 8

~~9export const ContactSalesCard = ({surface}) => {~~

~~10 const utm = content => `utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}`;~~

11 const iconArrowRight = (size = 13) => <svg width={size} height={size} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">

~~12 <line x1="5" y1="12" x2="19" y2="12" />~~

~~13 <polyline points="12 5 19 12 12 19" />~~

~~14 </svg>;~~

~~15 const STYLES = `~~

~~16.cc-cs {~~

~~17 --cs-slate: #141413;~~

~~18 --cs-clay: #d97757;~~

~~19 --cs-clay-deep: #c6613f;~~

~~20 --cs-gray-000: #ffffff;~~

~~21 --cs-gray-700: #3d3d3a;~~

~~22 --cs-border-default: rgba(31, 30, 29, 0.15);~~

~~23 font-family: inherit;~~

~~24}~~

~~25.dark .cc-cs {~~

~~26 --cs-slate: #f0eee6;~~

~~27 --cs-gray-000: #262624;~~

~~28 --cs-gray-700: #bfbdb4;~~

~~29 --cs-border-default: rgba(240, 238, 230, 0.14);~~

~~30}~~

~~31.cc-cs-card {~~

~~32 display: flex; align-items: center; justify-content: space-between;~~

~~33 gap: 16px; padding: 14px 16px; margin: 0;~~

~~34 background: var(--cs-gray-000); border: 0.5px solid var(--cs-border-default);~~

~~35 border-radius: 8px; flex-wrap: wrap;~~

~~36}~~

~~37.cc-cs-text { font-size: 13px; color: var(--cs-gray-700); line-height: 1.5; flex: 1; min-width: 240px; }~~

~~38.cc-cs-text strong { font-weight: 550; color: var(--cs-slate); }~~

~~39.cc-cs-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; }~~

~~40.cc-cs-btn-clay {~~

~~41 display: inline-flex; align-items: center; gap: 8px;~~

~~42 background: var(--cs-clay-deep); color: #fff; border: none;~~

~~43 border-radius: 8px; padding: 8px 14px;~~

~~44 font-size: 13px; font-weight: 500;~~

~~45 transition: background-color 0.15s; white-space: nowrap;~~

~~46}~~

~~47.cc-cs-btn-clay:hover { background: var(--cs-clay); }~~

~~48.cc-cs-btn-ghost {~~

~~49 display: inline-flex; align-items: center; gap: 8px;~~

~~50 background: transparent; color: var(--cs-gray-700);~~

~~51 border: 0.5px solid var(--cs-border-default);~~

~~52 border-radius: 8px; padding: 8px 14px;~~

~~53 font-size: 13px; font-weight: 500;~~

~~54}~~

~~55.cc-cs-btn-ghost:hover { background: rgba(0, 0, 0, 0.04); }~~

~~56.dark .cc-cs-btn-ghost:hover { background: rgba(255, 255, 255, 0.04); }~~

~~57@media (max-width: 720px) {~~

~~58 .cc-cs-actions { width: 100%; }~~

~~59}~~

~~60`;~~

~~61 return <div className="cc-cs not-prose">~~

~~62 <style>{STYLES}</style>~~

~~63 <div className="cc-cs-card">~~

~~64 <div className="cc-cs-text">~~

~~65 <strong>Deploying Claude Code across your organization?</strong> Talk to sales about enterprise plans, SSO, and centralized billing.~~

~~66 </div>~~

~~67 <div className="cc-cs-actions">~~

~~68 <a href={`https://claude.com/pricing?${utm('view_plans')}#plans-business`} className="cc-cs-btn-ghost">~~

~~69 View plans~~

~~70 </a>~~

~~71 <a href={`https://claude.com/contact-sales?${utm('contact_sales')}`} className="cc-cs-btn-clay">~~

~~72 Contact sales {iconArrowRight()}~~

~~73 </a>~~

~~74 </div>~~

~~75 </div>~~

~~76 </div>;~~

~~77};~~

~~79export const Experiment = ({flag, treatment, children}) => {~~

~~80 const VID_KEY = 'exp_vid';~~

81 const CONSENT_COUNTRIES = new Set(['AT', 'BE', 'BG', 'HR', 'CY', 'CZ', 'DK', 'EE', 'FI', 'FR', 'DE', 'GR', 'HU', 'IE', 'IT', 'LV', 'LT', 'LU', 'MT', 'NL', 'PL', 'PT', 'RO', 'SK', 'SI', 'ES', 'SE', 'RE', 'GP', 'MQ', 'GF', 'YT', 'BL', 'MF', 'PM', 'WF', 'PF', 'NC', 'AW', 'CW', 'SX', 'FO', 'GL', 'AX', 'GB', 'UK', 'AI', 'BM', 'IO', 'VG', 'KY', 'FK', 'GI', 'MS', 'PN', 'SH', 'TC', 'GG', 'JE', 'IM', 'CA', 'BR', 'IN']);

~~82 const fnv1a = s => {~~

~~83 let h = 0x811c9dc5;~~

~~84 for (let i = 0; i < s.length; i++) {~~

~~85 h ^= s.charCodeAt(i);~~

~~86 h += (h << 1) + (h << 4) + (h << 7) + (h << 8) + (h << 24);~~

~~87 }~~

~~88 return h >>> 0;~~

~~89 };~~

~~90 const bucket = (seed, vid) => fnv1a(fnv1a(seed + vid) + '') % 10000 < 5000 ? 'control' : 'treatment';~~

~~91 const [decision] = useState(() => {~~

~~92 const params = new URLSearchParams(location.search);~~

~~93 const preBucketed = document.documentElement.dataset['gb_' + flag.replace(/-/g, '_')];~~

~~94 const force = params.get('gb-force');~~

~~95 if (force) {~~

~~96 for (const p of force.split(',')) {~~

~~97 const [k, v] = p.split(':');~~

~~98 if (k === flag) return {~~

~~99 variant: v || 'treatment',~~

100 track: false

101 };

102 }

103 }

104 if (navigator.globalPrivacyControl) {

105 return {

106 variant: 'control',

107 track: false

108 };

109 }

110 const prefsMatch = document.cookie.match(/(?:^|; )anthropic-consent-preferences=([^;]+)/);

111 if (prefsMatch) {

112 try {

113 if (JSON.parse(decodeURIComponent(prefsMatch[1])).analytics !== true) {

114 return {

115 variant: 'control',

116 track: false

117 };

118 }

119 } catch {

120 return {

121 variant: 'control',

122 track: false

123 };

124 }

125 } else {

126 const country = params.get('country')?.toUpperCase() || (document.cookie.match(/(?:^|; )cf_geo=([A-Z]{2})/) || [])[1];

127 if (!country || CONSENT_COUNTRIES.has(country)) {

128 return {

129 variant: 'control',

130 track: false

131 };

132 }

133 }

134 let vid;

135 try {

136 const ajsMatch = document.cookie.match(/(?:^|; )ajs_anonymous_id=([^;]+)/);

137 if (ajsMatch) {

138 vid = decodeURIComponent(ajsMatch[1]).replace(/^"|"$/g, '');

139 } else {

140 vid = localStorage.getItem(VID_KEY);

141 if (!vid) {

142 vid = crypto.randomUUID();

143 }

144 document.cookie = `ajs_anonymous_id=${vid}; domain=.claude.com; path=/; Secure; SameSite=Lax; max-age=31536000`;

145 }

146 try {

147 localStorage.setItem(VID_KEY, vid);

148 } catch {}

149 } catch {

150 return {

151 variant: 'control',

152 track: false

153 };

154 }

155 const variant = preBucketed === '1' ? 'treatment' : preBucketed === '0' ? 'control' : bucket(flag, vid);

156 return {

157 variant,

158 track: true,

159 vid

160 };

161 });

162 useEffect(() => {

163 if (!decision.track) return;

164 fetch('https://api.anthropic.com/api/event_logging/v2/batch', {

165 method: 'POST',

166 headers: {

167 'Content-Type': 'application/json',

168 'x-service-name': 'claude_code_docs'

169 },

170 body: JSON.stringify({

171 events: [{

172 event_type: 'GrowthbookExperimentEvent',

173 event_data: {

174 device_id: decision.vid,

175 anonymous_id: decision.vid,

176 timestamp: new Date().toISOString(),

177 experiment_id: flag,

178 variation_id: decision.variant === 'treatment' ? 1 : 0,

179 environment: 'production'

180 }

181 }]

182 }),

183 keepalive: true

184 }).catch(() => {});

185 }, []);

186 return decision.variant === 'treatment' ? treatment : children;

187};

~~188~~

189<Experiment flag="docs-contact-sales-cta" treatment={<ContactSalesCard surface="claude_platform_on_aws" />} />

~~190~~

191AWS 上の Claude Platform は、AWS 認証、IAM アクセス制御、AWS Marketplace 請求を備えた Anthropic が運営する Claude API です。リクエストは Anthropic の API に直接到達するため、[Claude API](https://platform.claude.com/docs) と同じモデルと API 機能を同じリリーススケジュールで取得できます。AWS 認証情報またはワークスペース API キーで認証し、AWS Marketplace を通じて支払います。9AWS 上の Claude Platform は、AWS 認証、IAM アクセス制御、AWS Marketplace 請求を備えた Anthropic が運営する Claude API です。リクエストは Anthropic の API に直接到達するため、[Claude API](https://platform.claude.com/docs) と同じモデルと API 機能を同じリリーススケジュールで取得できます。AWS 認証情報またはワークスペース API キーで認証し、AWS Marketplace を通じて支払います。

192 10

193Claude Code が Anthropic の機能フラグサービスを通じてオンにするクライアント側機能はデフォルトではオフであり、[アドバイザーツール](/docs/ja/advisor)は利用できません。完全なリストについては、[機能可用性マトリックス](/docs/ja/feature-availability#summary-by-provider)を参照してください。11Claude Code が Anthropic の機能フラグサービスを通じてオンにするクライアント側機能はデフォルトではオフであり、[アドバイザーツール](/docs/ja/advisor)は利用できません。完全なリストについては、[機能可用性マトリックス](/docs/ja/feature-availability#summary-by-provider)を参照してください。

194 12

195このガイドを使用して、AWS 上の Claude Platform を通じてすでにプロビジョニングしたワークスペースに Claude Code をポイントします。このガイドの前に行う AWS サブスクリプションとワークスペースのセットアップについては、[AWS 上の Claude Platform ドキュメント](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws)を参照してください。13このガイドを使用して、AWS 上の Claude Platform を通じてすでにプロビジョニングしたワークスペースに Claude Code をポイントします。このガイドの前に行う AWS サブスクリプションとワークスペースのセットアップについては、[AWS 上の Claude Platform ドキュメント](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws)を参照してください。

196 14

197<Note>15> [!NOTE]

198 AWS Marketplace を通じてサブスクリプションすると、AWS アカウントに関連付けられた新しい Anthropic 組織がプロビジョニングされます。この組織は、Anthropic で既に持っている組織とは別であり、認証情報はそれらの間で転送されません。AWS にリンクされた組織のワークスペース ID と API キーを使用してください。既存の Claude Console アカウントからではなく。16>

199</Note>17> AWS Marketplace を通じてサブスクリプションすると、AWS アカウントに関連付けられた新しい Anthropic 組織がプロビジョニングされます。この組織は、Anthropic で既に持っている組織とは別であり、認証情報はそれらの間で転送されません。AWS にリンクされた組織のワークスペース ID と API キーを使用してください。既存の Claude Console アカウントからではなく。

200 18

201<h2 id="prerequisites">19## 前提条件

202 前提条件

203</h2>

204 20

205Claude Code を設定する前に、以下が必要です。21Claude Code を設定する前に、以下が必要です。

206 22

209* Anthropic サービスを呼び出す権限を持つ IAM プリンシパル、またはワークスペースにスコープされた API キー25* Anthropic サービスを呼び出す権限を持つ IAM プリンシパル、またはワークスペースにスコープされた API キー

210* 環境内、`~/.aws/credentials` 内、または SigV4 認証が必要な場合は接続された IAM ロールからの AWS 認証情報。AWS CLI は SSO ログインフローにのみ必要です。26* 環境内、`~/.aws/credentials` 内、または SigV4 認証が必要な場合は接続された IAM ロールからの AWS 認証情報。AWS CLI は SSO ログインフローにのみ必要です。

211 27

212<h2 id="setup">28## セットアップ

213 セットアップ

214</h2>

215 29

216<h3 id="1-configure-aws-credentials">30### AWS 認証情報を設定する

217 1. AWS 認証情報を設定する

218</h3>

219 31

220Claude Code は AWS 上の Claude Platform に対して 2 つの認証方法をサポートしています。チームがアクセスを管理する方法に合った方法を選択してください。32Claude Code は AWS 上の Claude Platform に対して 2 つの認証方法をサポートしています。チームがアクセスを管理する方法に合った方法を選択してください。

221 33

222* [SigV4 を使用した AWS 認証情報](#use-aws-credentials-with-sigv4): 標準的な AWS 認証情報チェーンから取得した認証情報を使用し、IAM プリンシパルとして認証します34* [SigV4 を使用した AWS 認証情報](#use-aws-credentials-with-sigv4): 標準的な AWS 認証情報チェーンから取得した認証情報を使用し、IAM プリンシパルとして認証します

223* [ワークスペース API キー](#use-a-workspace-api-key): AWS Console で生成した長期間有効なキーで認証します35* [ワークスペース API キー](#use-a-workspace-api-key): AWS Console で生成した長期間有効なキーで認証します

224 36

225<h4 id="use-aws-credentials-with-sigv4">37#### SigV4 を使用した AWS 認証情報を使用する

226 SigV4 を使用した AWS 認証情報を使用する

227</h4>

228 38

229Claude Code は標準的な AWS 認証情報チェーンを使用して SigV4 でリクエストに署名します。環境変数、`~/.aws/credentials` の共有認証情報、IAM ロール、AWS SSO セッション、および AWS SDK がサポートするその他のソース。39Claude Code は標準的な AWS 認証情報チェーンを使用して SigV4 でリクエストに署名します。環境変数、`~/.aws/credentials` の共有認証情報、IAM ロール、AWS SSO セッション、および AWS SDK がサポートするその他のソース。

230 40

249 59

250`awsAuthRefresh` が設定されている場合、`/login` を実行し、**3rd-party platform** を選択してから、**Using 3rd-party platforms** の下で **Claude Platform on AWS · refresh credentials** を選択します。Claude Code は設定されたコマンドを実行し、再起動せずに AWS 認証情報を再度読み込みます。60`awsAuthRefresh` が設定されている場合、`/login` を実行し、**3rd-party platform** を選択してから、**Using 3rd-party platforms** の下で **Claude Platform on AWS · refresh credentials** を選択します。Claude Code は設定されたコマンドを実行し、再起動せずに AWS 認証情報を再度読み込みます。

251 61

252<h4 id="use-a-workspace-api-key">62#### ワークスペース API キーを使用する

253 ワークスペース API キーを使用する

254</h4>

255 63

256ワークスペース API キーは長期間有効なシークレットで、フェデレーション AWS 認証情報を管理したくない場合に便利です。AWS Console の **Claude Platform on AWS → API keys** で生成し、`ANTHROPIC_AWS_API_KEY` として設定します。64ワークスペース API キーは長期間有効なシークレットで、フェデレーション AWS 認証情報を管理したくない場合に便利です。AWS Console の **Claude Platform on AWS → API keys** で生成し、`ANTHROPIC_AWS_API_KEY` として設定します。

257 65

263 71

264ワークスペース API キーは他の本番認証情報と同様に扱ってください。[ユーザー設定ファイル](/docs/ja/settings) の `env` ブロックは、グローバルにエクスポートせずにキーをマシンにスコープするための便利な方法です。72ワークスペース API キーは他の本番認証情報と同様に扱ってください。[ユーザー設定ファイル](/docs/ja/settings) の `env` ブロックは、グローバルにエクスポートせずにキーをマシンにスコープするための便利な方法です。

265 73

266<Note>74> [!NOTE]

267 `/login` および `/logout` コマンドは Claude.ai サブスクリプションに対して Claude Platform on AWS にサインインしません。認証は AWS 認証情報またはワークスペース API キーを通じて実行されます。75>

268</Note>76> `/login` および `/logout` コマンドは Claude.ai サブスクリプションに対して Claude Platform on AWS にサインインしません。認証は AWS 認証情報またはワークスペース API キーを通じて実行されます。

269 77

270<h3 id="2-configure-claude-code">78### Claude Code を設定する

271 2. Claude Code を設定する

272</h3>

273 79

274Claude Code をデフォルトの Anthropic API ではなく AWS 上の Claude Platform を通じてルーティングする環境変数を設定します。80Claude Code をデフォルトの Anthropic API ではなく AWS 上の Claude Platform を通じてルーティングする環境変数を設定します。

275 81

285 91

286AWS 上の Claude Platform は、環境に AWS 認証情報が存在する場合でもオプトインです。Amazon Bedrock と Microsoft Foundry はプロバイダールーティングで優先されるため、設定されている場合は `CLAUDE_CODE_USE_BEDROCK` と `CLAUDE_CODE_USE_FOUNDRY` をアンセットします。92AWS 上の Claude Platform は、環境に AWS 認証情報が存在する場合でもオプトインです。Amazon Bedrock と Microsoft Foundry はプロバイダールーティングで優先されるため、設定されている場合は `CLAUDE_CODE_USE_BEDROCK` と `CLAUDE_CODE_USE_FOUNDRY` をアンセットします。

287 93

288<h3 id="3-pin-model-versions">94### モデルバージョンをピン留めする

289 3. モデルバージョンをピン留めする

290</h3>

291 95

292AWS 上の Claude Platform は、直接 Claude API と同じモデル ID を使用します。96AWS 上の Claude Platform は、直接 Claude API と同じモデル ID を使用します。

293 97

308 112

309メインの会話と Claude Code が実行するリクエストに異なる TTL を設定するには、[TTL を自分で選択](/docs/ja/prompt-caching#choose-the-ttl-yourself) してください。113メインの会話と Claude Code が実行するリクエストに異なる TTL を設定するには、[TTL を自分で選択](/docs/ja/prompt-caching#choose-the-ttl-yourself) してください。

310 114

311<h3 id="4-launch-and-verify">115### 起動して検証する

312 4. 起動して検証する

313</h3>

314 116

315Claude Code を起動し、ルーティングを確認します。117Claude Code を起動し、ルーティングを確認します。

316 118

320 122

321起動バナーはプロバイダーがアクティブな場合に `Claude Platform on AWS` を表示します。`/status` を実行して詳細を確認します。`API provider` 行は `Claude Platform on AWS` を読み取り、出力には `Workspace ID`、`AWS region`、およびオーバーライドを設定した場合は `Claude Platform on AWS base URL` が含まれます。123起動バナーはプロバイダーがアクティブな場合に `Claude Platform on AWS` を表示します。`/status` を実行して詳細を確認します。`API provider` 行は `Claude Platform on AWS` を読み取り、出力には `Workspace ID`、`AWS region`、およびオーバーライドを設定した場合は `Claude Platform on AWS base URL` が含まれます。

322 124

323<h2 id="use-the-agent-sdk">125## Agent SDK を使用する

324 Agent SDK を使用する

325</h2>

326 126

327[Agent SDK](/docs/ja/agent-sdk/overview) は CLI と同じ環境変数を読み取るため、Claude Code サブプロセスを生成するプログラムは、呼び出しの前に `CLAUDE_CODE_USE_ANTHROPIC_AWS`、`ANTHROPIC_AWS_WORKSPACE_ID`、および `ANTHROPIC_AWS_API_KEY` または AWS 認証情報をエクスポートすることで AWS 上の Claude Platform をターゲットにできます。127[Agent SDK](/docs/ja/agent-sdk/overview) は CLI と同じ環境変数を読み取るため、Claude Code サブプロセスを生成するプログラムは、呼び出しの前に `CLAUDE_CODE_USE_ANTHROPIC_AWS`、`ANTHROPIC_AWS_WORKSPACE_ID`、および `ANTHROPIC_AWS_API_KEY` または AWS 認証情報をエクスポートすることで AWS 上の Claude Platform をターゲットにできます。

328 128

340 140

341この例は SigV4 のアンビエント AWS 認証情報チェーンに依存しています。代わりにワークスペース API キーで認証するには、同じ方法で `ANTHROPIC_AWS_API_KEY` を設定します。より広い Agent SDK サーフェスについては、[Agent SDK 概要](/docs/ja/agent-sdk/overview)を参照してください。141この例は SigV4 のアンビエント AWS 認証情報チェーンに依存しています。代わりにワークスペース API キーで認証するには、同じ方法で `ANTHROPIC_AWS_API_KEY` を設定します。より広い Agent SDK サーフェスについては、[Agent SDK 概要](/docs/ja/agent-sdk/overview)を参照してください。

342 142

343<h2 id="route-through-a-corporate-proxy">143## 企業プロキシを通じてルーティングする

344 企業プロキシを通じてルーティングする

345</h2>

346 144

347プロキシまたは [LLM ゲートウェイ](/docs/ja/llm-gateway)を通じてトラフィックをルーティングするには、`ANTHROPIC_AWS_BASE_URL` をプロキシのアドレスに設定します。Claude Code は同じワークスペースと認証ヘッダーを使用してそのアドレスにリクエストを送信するため、それらを変更せずに転送するゲートウェイが機能します。145プロキシまたは [LLM ゲートウェイ](/docs/ja/llm-gateway)を通じてトラフィックをルーティングするには、`ANTHROPIC_AWS_BASE_URL` をプロキシのアドレスに設定します。Claude Code は同じワークスペースと認証ヘッダーを使用してそのアドレスにリクエストを送信するため、それらを変更せずに転送するゲートウェイが機能します。

348 146

361export ANTHROPIC_AWS_BASE_URL=https://anthropic-proxy.example.com159export ANTHROPIC_AWS_BASE_URL=https://anthropic-proxy.example.com

362```160```

363 161

364<h2 id="troubleshooting">162## トラブルシューティング

365 トラブルシューティング

366</h2>

367 163

368`/status` を実行して、解決されたプロバイダーと明示的に設定されたワークスペース ID、リージョン、ベース URL オーバーライド、および認証スキップ設定を確認します。これは Claude Code が AWS 上の Claude Platform をターゲットにしているかどうかを確認する最速の方法です。164`/status` を実行して、解決されたプロバイダーと明示的に設定されたワークスペース ID、リージョン、ベース URL オーバーライド、および認証スキップ設定を確認します。これは Claude Code が AWS 上の Claude Platform をターゲットにしているかどうかを確認する最速の方法です。

369 165

370<h3 id="403-forbidden-or-accessdenied-on-every-request">166### すべてのリクエストで `403 Forbidden` または `AccessDenied`

371 すべてのリクエストで `403 Forbidden` または `AccessDenied`

372</h3>

373 167

374Claude Code が解決した IAM プリンシパルは、ワークスペースで Anthropic サービスを呼び出す権限がない可能性があります。AWS プロファイルに接続されたロール、または Claude Code を開始したランナーを確認し、[IAM アクション参照](https://platform.claude.com/docs/ja/api/claude-platform-on-aws-iam-actions)に記載されている `aws-external-anthropic` アクションがあることを確認します。168Claude Code が解決した IAM プリンシパルは、ワークスペースで Anthropic サービスを呼び出す権限がない可能性があります。AWS プロファイルに接続されたロール、または Claude Code を開始したランナーを確認し、[IAM アクション参照](https://platform.claude.com/docs/ja/api/claude-platform-on-aws-iam-actions)に記載されている `aws-external-anthropic` アクションがあることを確認します。

375 169

376`ANTHROPIC_AWS_API_KEY` を設定した場合、キーは SigV4 よりも優先され、古いキーは同じエラーを生成します。AWS Console の **Claude Platform on AWS → API keys** でキーを再生成するか、変数をアンセットして AWS 認証情報にフォールバックします。170`ANTHROPIC_AWS_API_KEY` を設定した場合、キーは SigV4 よりも優先され、古いキーは同じエラーを生成します。AWS Console の **Claude Platform on AWS → API keys** でキーを再生成するか、変数をアンセットして AWS 認証情報にフォールバックします。

377 171

378<h3 id="requests-fail-with-a-missing-workspace-error">172### リクエストがワークスペース不足エラーで失敗する

379 リクエストがワークスペース不足エラーで失敗する

380</h3>

381 173

382`ANTHROPIC_AWS_WORKSPACE_ID` がアンセットまたは空の可能性があります。すべての AWS 上の Claude Platform リクエストにはワークスペース ID を含める必要があります。AWS 認証情報によって暗示されません。Claude Platform on AWS セットアップで ID を見つけ、Claude Code を開始する前にエクスポートします。174`ANTHROPIC_AWS_WORKSPACE_ID` がアンセットまたは空の可能性があります。すべての AWS 上の Claude Platform リクエストにはワークスペース ID を含める必要があります。AWS 認証情報によって暗示されません。Claude Platform on AWS セットアップで ID を見つけ、Claude Code を開始する前にエクスポートします。

383 175

384<h3 id="requests-still-go-to-api-anthropic-com">176### リクエストが依然として `api.anthropic.com` に送信される

385 リクエストが依然として `api.anthropic.com` に送信される

386</h3>

387 177

388`CLAUDE_CODE_USE_ANTHROPIC_AWS` がアンセットまたは truthy として解析されない値に設定されている可能性があります。`1` に設定し、`/status` を実行して解決されたプロバイダーを確認します。`CLAUDE_CODE_USE_BEDROCK` または `CLAUDE_CODE_USE_FOUNDRY` も設定されている場合、それらは AWS 上の Claude Platform よりも優先されます。178`CLAUDE_CODE_USE_ANTHROPIC_AWS` がアンセットまたは truthy として解析されない値に設定されている可能性があります。`1` に設定し、`/status` を実行して解決されたプロバイダーを確認します。`CLAUDE_CODE_USE_BEDROCK` または `CLAUDE_CODE_USE_FOUNDRY` も設定されている場合、それらは AWS 上の Claude Platform よりも優先されます。

389 179

390<h2 id="additional-resources">180## 追加リソース

391 追加リソース

392</h2>

393 181

394Claude Code を設定する前に行う AWS 上の Claude Platform サブスクリプション、ワークスペース、IAM セットアップはプラットフォームドキュメントで説明されています。182Claude Code を設定する前に行う AWS 上の Claude Platform サブスクリプション、ワークスペース、IAM セットアップはプラットフォームドキュメントで説明されています。

395 183

claude-platform-on-aws.md 2026-10-19 23:58 UTC to 2026-10-20 23:00 UTC

AWS 上の Claude Platform での Claude Code

前提条件

セットアップ

AWS 認証情報を設定する

SigV4 を使用した AWS 認証情報を使用する

ワークスペース API キーを使用する

Claude Code を設定する

モデルバージョンをピン留めする

起動して検証する

Agent SDK を使用する

企業プロキシを通じてルーティングする

トラブルシューティング

すべてのリクエストで 403 Forbidden または AccessDenied

リクエストがワークスペース不足エラーで失敗する

リクエストが依然として api.anthropic.com に送信される

追加リソース

すべてのリクエストで `403 Forbidden` または `AccessDenied`

リクエストが依然として `api.anthropic.com` に送信される