6 6
7> 설정, 구성 및 문제 해결을 포함하여 Microsoft Foundry를 통해 Claude Code를 구성하는 방법을 알아봅니다.7> 설정, 구성 및 문제 해결을 포함하여 Microsoft Foundry를 통해 Claude Code를 구성하는 방법을 알아봅니다.
8 8
9export const ContactSalesCard = ({surface}) => {9<h2 id="prerequisites">
10 const utm = content => `utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}`;10 필수 조건
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">11</h2>
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};
78
79<ContactSalesCard surface="foundry" />
80
81## 필수 조건
82 12
83Microsoft Foundry로 Claude Code를 구성하기 전에 다음을 확인하세요:13Microsoft Foundry로 Claude Code를 구성하기 전에 다음을 확인하세요:
84 14
90 Claude Code를 여러 사용자에게 배포하는 경우 Anthropic이 새 모델을 출시할 때 중단을 방지하기 위해 [모델 버전을 고정](#4-pin-model-versions)하세요.20 Claude Code를 여러 사용자에게 배포하는 경우 Anthropic이 새 모델을 출시할 때 중단을 방지하기 위해 [모델 버전을 고정](#4-pin-model-versions)하세요.
91</Note>21</Note>
92 22
93## 설정23<h2 id="setup">
24 설정
25</h2>
94 26
95### 1. Microsoft Foundry 리소스 프로비저닝27<h3 id="1-provision-microsoft-foundry-resource">
28 1. Microsoft Foundry 리소스 프로비저닝
29</h3>
96 30
97먼저 Azure에서 Claude 리소스를 만듭니다:31먼저 Azure에서 Claude 리소스를 만듭니다:
98 32
103 * Claude Sonnet37 * Claude Sonnet
104 * Claude Haiku38 * Claude Haiku
105 39
106### 2. Azure 자격 증명 구성40<h3 id="2-configure-azure-credentials">
41 2) Azure 자격 증명 구성
42</h3>
107 43
108Claude Code는 Microsoft Foundry에 대해 두 가지 인증 방법을 지원합니다. 보안 요구 사항에 가장 적합한 방법을 선택하세요.44Claude Code는 Microsoft Foundry에 대해 두 가지 인증 방법을 지원합니다. 보안 요구 사항에 가장 적합한 방법을 선택하세요.
109 45
130```66```
131 67
132<Note>68<Note>
133 Microsoft Foundry를 사용할 때 `/login` 및 `/logout` 명령은 Azure 자격 증명을 통해 인증이 처리되므로 비활성화됩니다.69 Microsoft Foundry를 사용할 때 `/logout` 명령은 Azure 자격 증명을 통해 인증이 처리되므로 사용할 수 없습니다.
134</Note>70</Note>
135 71
136### 3. Claude Code 구성72<h3 id="3-configure-claude-code">
73 3. Claude Code 구성
74</h3>
137 75
138Microsoft Foundry를 활성화하려면 다음 환경 변수를 설정합니다:76Microsoft Foundry를 활성화하려면 다음 환경 변수를 설정합니다:
139 77
147# export ANTHROPIC_FOUNDRY_BASE_URL=https://{resource}.services.ai.azure.com/anthropic85# export ANTHROPIC_FOUNDRY_BASE_URL=https://{resource}.services.ai.azure.com/anthropic
148```86```
149 87
150### 4. 모델 버전 고정88<h3 id="4-pin-model-versions">
89 4. 모델 버전 고정
90</h3>
151 91
152<Warning>92<Warning>
153 모든 배포에 대해 특정 모델 버전을 고정합니다. 고정하지 않고 모델 별칭(`sonnet`, `opus`, `haiku`)을 사용하면 Claude Code가 Foundry 계정에서 사용할 수 없는 최신 모델 버전을 사용하려고 시도하여 Anthropic이 업데이트를 출시할 때 기존 사용자가 중단될 수 있습니다. Azure 배포를 만들 때 "최신으로 자동 업데이트" 대신 특정 모델 버전을 선택합니다.93 모든 배포에 대해 특정 모델 버전을 고정합니다. 고정하지 않고 모델 별칭(`sonnet`, `opus`, `haiku`)을 사용하면 Claude Code가 Foundry 계정에서 사용할 수 없는 최신 모델 버전을 사용하려고 시도하여 Anthropic이 업데이트를 출시할 때 기존 사용자가 중단될 수 있습니다. Azure 배포를 만들 때 "최신으로 자동 업데이트" 대신 특정 모델 버전을 선택합니다.
155 95
156모델 변수를 1단계에서 만든 배포 이름과 일치하도록 설정합니다.96모델 변수를 1단계에서 만든 배포 이름과 일치하도록 설정합니다.
157 97
158`ANTHROPIC_DEFAULT_OPUS_MODEL`이 없으면 Foundry의 `opus` 별칭은 Opus 4.6으로 확인됩니다. 최신 모델을 사용하려면 Opus 4.7 ID로 설정합니다:98`ANTHROPIC_DEFAULT_OPUS_MODEL`이 없으면 Foundry의 `opus` 별칭은 Opus 4.6으로 확인됩니다. 최신 모델을 사용하려면 Opus 4.8 ID로 설정합니다:
159 99
160```bash theme={null}100```bash theme={null}
161export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-7'101export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'
162export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-4-6'102export ANTHROPIC_DEFAULT_SONNET_MODEL='claude-sonnet-4-6'
163export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'103export ANTHROPIC_DEFAULT_HAIKU_MODEL='claude-haiku-4-5'
164```104```
167 107
168현재 및 레거시 모델 ID는 [모델 개요](https://platform.claude.com/docs/en/about-claude/models/overview)를 참조하세요. 전체 환경 변수 목록은 [모델 구성](/ko/model-config#pin-models-for-third-party-deployments)을 참조하세요.108현재 및 레거시 모델 ID는 [모델 개요](https://platform.claude.com/docs/en/about-claude/models/overview)를 참조하세요. 전체 환경 변수 목록은 [모델 구성](/ko/model-config#pin-models-for-third-party-deployments)을 참조하세요.
169 109
170[Prompt caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching)은 자동으로 활성화됩니다. 기본 5분 대신 1시간 캐시 TTL을 요청하려면 다음 변수를 설정합니다. 1시간 TTL로 캐시 쓰기는 더 높은 요금으로 청구됩니다:110[Prompt caching](/ko/prompt-caching)은 자동으로 활성화됩니다. 기본 5분 대신 1시간 캐시 TTL을 요청하려면 다음 변수를 설정합니다. 1시간 TTL로 캐시 쓰기는 더 높은 요금으로 청구됩니다:
171 111
172```bash theme={null}112```bash theme={null}
173export ENABLE_PROMPT_CACHING_1H=1113export ENABLE_PROMPT_CACHING_1H=1
174```114```
175 115
176### 5. Claude Code 실행116<h3 id="5-run-claude-code">
117 5. Claude Code 실행
118</h3>
177 119
178환경 변수가 설정되면 프로젝트 디렉터리에서 Claude Code를 시작합니다:120환경 변수가 설정되면 프로젝트 디렉터리에서 Claude Code를 시작합니다:
179 121
183 125
184Claude Code는 환경에서 `CLAUDE_CODE_USE_FOUNDRY` 및 기타 Foundry 변수를 읽고 첫 번째 프롬프트에서 Azure 리소스에 연결합니다. Bedrock 및 Vertex AI와 달리 Foundry는 대화형 설정 마법사가 없으므로 3단계와 4단계의 환경 변수가 유일한 구성 경로입니다.126Claude Code는 환경에서 `CLAUDE_CODE_USE_FOUNDRY` 및 기타 Foundry 변수를 읽고 첫 번째 프롬프트에서 Azure 리소스에 연결합니다. Bedrock 및 Vertex AI와 달리 Foundry는 대화형 설정 마법사가 없으므로 3단계와 4단계의 환경 변수가 유일한 구성 경로입니다.
185 127
186## Azure RBAC 구성128<h2 id="azure-rbac-configuration">
129 Azure RBAC 구성
130</h2>
187 131
188`Azure AI User` 및 `Cognitive Services User` 기본 역할에는 Claude 모델을 호출하는 데 필요한 모든 권한이 포함됩니다.132`Azure AI User` 및 `Cognitive Services User` 기본 역할에는 Claude 모델을 호출하는 데 필요한 모든 권한이 포함됩니다.
189 133
203 147
204자세한 내용은 [Microsoft Foundry RBAC 설명서](https://learn.microsoft.com/en-us/azure/ai-foundry/concepts/rbac-azure-ai-foundry)를 참조하세요.148자세한 내용은 [Microsoft Foundry RBAC 설명서](https://learn.microsoft.com/en-us/azure/ai-foundry/concepts/rbac-azure-ai-foundry)를 참조하세요.
205 149
206## 문제 해결150<h2 id="troubleshooting">
151 문제 해결
152</h2>
207 153
208"Failed to get token from azureADTokenProvider: ChainedTokenCredential authentication failed" 오류가 발생하면:154"Failed to get token from azureADTokenProvider: ChainedTokenCredential authentication failed" 오류가 발생하면:
209 155
210* 환경에서 Entra ID를 구성하거나 `ANTHROPIC_FOUNDRY_API_KEY`를 설정합니다.156* 환경에서 Entra ID를 구성하거나 `ANTHROPIC_FOUNDRY_API_KEY`를 설정합니다.
211 157
212## 추가 리소스158<h2 id="additional-resources">
159 추가 리소스
160</h2>
213 161
214* [Microsoft Foundry 설명서](https://learn.microsoft.com/en-us/azure/ai-foundry/what-is-azure-ai-foundry)162* [Microsoft Foundry 설명서](https://learn.microsoft.com/en-us/azure/ai-foundry/what-is-azure-ai-foundry)
215* [Microsoft Foundry 모델](https://ai.azure.com/explore/models)163* [Microsoft Foundry 모델](https://ai.azure.com/explore/models)
